Interface Plug-in SDK: Difference between revisions
No edit summary |
|||
Line 3: | Line 3: | ||
This SDK contains everything you need to create your own interface plug-in for Media Center. An interface plug-in is a plug-in that seamlessly integrates into Media Center's interface to provide added functionality. An interface plug-in can be just about anything you can imagine: an advanced tagging studio, an HTML control server, a playlist management tool, and on and on. You can build on all of Media Center's established power. |
This SDK contains everything you need to create your own interface plug-in for Media Center. An interface plug-in is a plug-in that seamlessly integrates into Media Center's interface to provide added functionality. An interface plug-in can be just about anything you can imagine: an advanced tagging studio, an HTML control server, a playlist management tool, and on and on. You can build on all of Media Center's established power. |
||
[http://www. |
[http://www.jriver.com/DevZone/MediaCenterSDK.rar Download the SDK] |
||
The SDK consists of a single file: the MCPlayerLib.tlb type library, and a Sleep Timer example. |
The SDK consists of a single file: the MCPlayerLib.tlb type library, and a Sleep Timer example. |
Revision as of 18:56, 28 September 2011
Introduction
This SDK contains everything you need to create your own interface plug-in for Media Center. An interface plug-in is a plug-in that seamlessly integrates into Media Center's interface to provide added functionality. An interface plug-in can be just about anything you can imagine: an advanced tagging studio, an HTML control server, a playlist management tool, and on and on. You can build on all of Media Center's established power.
The SDK consists of a single file: the MCPlayerLib.tlb type library, and a Sleep Timer example.
Writing a component
The first thing you need to do to create an Interface plug-in is to choose a language. Any language that supports COM should work fine. (C++, VB, etc.) Once that's out of the way, you need to create a new COM control that has a user interface. Then, there are two requirements for your COM control:
- It must enter information in the registry to let Media Center know it exists. In C++, this can simply be a block of code added to the DllRegisterServer function. In VB, you will have to make a .reg file for the user to run on their machine. (see the included samples for examples of this)
- It must implement a function called Init(...) that Media Center will call when starting the plug-in to give you an object to control Media Center with. (the object is a dispatch pointer (IMJAutomation *))
You will need to import the MCPlayerLib.tlb type library into your plug-in for IMJAutomation to be defined.
See Media Center Automation for a complete description of the capabilities available to your plug-in.
If you create a Registry Key called "Enabled", it will be reported on the System Info. This is useful for plugins that are Active but turned off.
Examples
The SDK includes an example, a Sleep Timer (C++).