From MP3Car.com Wiki
This information applies to version 1.1.0.5 of StreetDeck and later and is preliminary. The BoomzBox HD SDK is still in BETA and may change. Version 1.1.1.0 will mark the release of the stable version.
Both the BoomzBox HD application and StreetDeck use the same development environment and developing for either application is largely similar. Features available only in the full version of StreetDeck will not work when running in the BoomzBox HD application and may cause errors when run in the BoomzBox HD application, but all HD radio functionality all base StreetDeck functions are availble for any program that integrates the BoomzBox HD application. Similarly, the BoomzBox HD application uses the same skin as StreetDeck, however, only the BoomzBox HD modules are shown. Skins can be interchanged between the BoomzBox HD application and StreetDeck and the StreetDeck Development Enviornment should be used to create skins for both the BoomzBox HD and StreetDeck.
For general information on developing for StreetDeck and therefore the BoomzBox HD application, please see the following thread.
StreetDeck Developers Table of Contents
[edit] How to Embed the BoomzBox HD
StreetDeck and the BoomzBox HD application are two different executables with a largely similar base and can be instantiated as an out of process COM server. This article will cover how to embed the BoomzBox HD application in another C# application and call most of the functions used for controlling the radio. It is assumed the reader is familiar with C# and COM in general.
When run as an embedded COM application, StreetDeck runs very much like an embedded ActiveX control would, however, it is NOT an ActiveX control. It is simply an automatable application that runs independantly of any program that embeds it. To embed the program, it must be started after the parent window of the embedding application is already started with the -embed command line parameter.
For example, the application should be started as:
C:\Program Files\StreetDeck\BoomzBox.exe -Embed:300,10,320,240,,StreetDeck BoomzBox App
This would embed the BoomzBox HD app in the window with the caption "StreetDeck BoomzBox App" at the position 300, 10 and a size of 320x240.
For more information on embedding STreetDeck, please see this article:
Embed StreetDeck in Another Application
[edit] Connecting to the BoomzBox HD through COM
After the BoomzBox HD window is embedded in your application, you can connect to it, to gain access to the radio manager functions through COM. To do this in C#, simply add a reference to BoomzBox.exe by right clicking on the References item in the solution explorer and choosing Add Reference, choose the COM tab, then browse to the C:\program files\StreetDeck\BoomzBox.exe application.
After the reference is added, you can connect to the running embedded BoomzBox HD application by instantiating the COM object for the BoomzBox HD application like so:
m_app = new StreetDeck.BoomzBoxHDAppClass();
If you call the above line before the BoomzBox HD application is started and embedded in your desired window, it will automatically start a new instance of the BoomzBox HD application and connect to it, which may or may not be desireable. If an instance of the BoomzBox HD application is already running, it will connect to it and control it.
[edit] Certifying your BoomzBox App
All applications that work with HD radio need to meet a series of different requirements set by iBiquity. These range from interface usability, look, feel, and appropriate trademark usage to audio quality. The BoomzBox HD application and StreetDeck already comply with all these requirements. To ensure these requirements are met, all applications should display the main application render window for primary display and control of the radio. Applications that do not meet this requirment are subject for removal from MP3Car.com and may be in violation of the BoomzBox HD license agreement.
[edit] C# Sample App
C# Sample App
