Interface Plug-in SDK: Difference between revisions
No edit summary |
No edit summary |
||
Line 23: | Line 23: | ||
The SDK includes an example, a Sleep Timer (C++). |
The SDK includes an example, a Sleep Timer (C++). |
||
[[Category:Developer]] |
Latest revision as of 05:49, 4 May 2015
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++).