86 lines
3.6 KiB
Plaintext
86 lines
3.6 KiB
Plaintext
|
|
OPC Music Bundle sample
|
|
=======================
|
|
|
|
This sample demonstrates how to use OPC APIs to produce and consume an OPC Package based on a custom defined OPC file format.
|
|
|
|
|
|
Sample Language Implementations
|
|
===============================
|
|
|
|
This sample is available in the following language implementations:
|
|
|
|
C++
|
|
|
|
|
|
Files
|
|
=====
|
|
|
|
MusicBundle.cpp - main entry point for the sample application
|
|
|
|
MusicBundle.h - main header file, also contains a description of the custom OPC file format used in the sample
|
|
|
|
MusicBundleProduction.cpp - contains sample code showing how to produce a package
|
|
|
|
MusicBundleConsumption.cpp - contains sample code showing how to consume a package
|
|
|
|
util.cpp / util.h - common utility functions for working with OPC packages & managing resources
|
|
|
|
MusicBundle.vcproj - build configuration for this sample
|
|
|
|
ConsumptionData\SampleMusicBundle.zip - An OPC package containing sample music files that can be consumed using the sample application.
|
|
.zip extension has been used to make content type of the entire package obvious. The content
|
|
creator can use another extension specific to their scenario.
|
|
|
|
ProductionData\TrackList.wpl
|
|
ProductionData\AlbumArt\jacqui.jpg
|
|
ProductionData\Lyrics\CrystalFree.txt
|
|
ProductionData\Lyrics\Sire.txt
|
|
ProductionData\Lyrics\SmallPines.txt
|
|
ProductionData\Lyrics\Valparaiso.txt
|
|
ProductionData\Tracks\CrystalFree.wma
|
|
ProductionData\Tracks\Sire.wma
|
|
ProductionData\Tracks\SmallPines.wma
|
|
ProductionData\Tracks\Valparaiso.wma
|
|
- sample music and other files required by the custom OPC file format in the correct directory structure. These can be used with the
|
|
sample application to produce an OPC music bundle package.
|
|
|
|
To build the sample using the command prompt:
|
|
=============================================
|
|
|
|
1. Open the Command Prompt window and navigate to the directory containing MusicBundle.vcproj
|
|
|
|
2. Type: msbuild MusicBundle.vcproj
|
|
|
|
|
|
To build the sample using Visual Studio 2008 (preferred method):
|
|
================================================================
|
|
|
|
1. Open Windows Explorer and navigate to the directory.
|
|
|
|
2. Double-click the icon for the MusicBundle.vcproj file to open the file in Visual Studio.
|
|
|
|
3. In the Build menu, select Build Solution. The application will be built in the default \Debug or \Release directory.
|
|
|
|
To run the sample:
|
|
==================
|
|
|
|
1. Open a command line window and navigate to the directory where the MusicBundle.exe is built.
|
|
|
|
2. To use the sample to produce a music bundle package use command:
|
|
|
|
MusicBundle.exe -p <Input Directory> <Output Package Path>
|
|
|
|
Input Directory : Provide full path to the directory with the files to be used as input to create a package. Use the ProductionData\*
|
|
files with the correct directory structure as provided with the sample.
|
|
|
|
Output Package Path : Provide full path and name for the package you want to create
|
|
|
|
3. To use the sample to consume a music bundle package use command:
|
|
|
|
MusicBundle.exe -c <Input Package Path> <Output Directory>
|
|
|
|
Input Package Path : Provide full path and name to the package you want to read. Use the ConsumptionData\SampleMusicBundle.zip
|
|
provided with sample.
|
|
|
|
Output Directory : Full path to the directory where you want the files read from the package to be placed. |