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.
