Share via

Использование скинов с элементом управления Медиаплеер Windows

  • Статья

[Функция, связанная с этой страницей, Медиаплеер Windows SDK, является устаревшей функцией. Он был заменен MediaPlayer. MediaPlayer оптимизирован для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует по возможности использовать MediaPlayer вместо пакета SDK для Медиаплеер Windows. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

При внедрении элемента управления Медиаплеер Windows в программу C++ можно настроить пользовательский интерфейс проигрывателя, применив к нему файл определения обложки. Файл определения обложки — это xml-документ, указывающий макет стандартных и настраиваемых компонентов пользовательского интерфейса и любых сопутствующих графических элементов. С помощью Microsoft JScript можно указать поведение этих компонентов и управлять элементом управления Медиаплеер Windows без дополнительных затрат на синтаксис C++ и COM.

Обложки обеспечивают простой способ разделения кода пользовательского интерфейса и кода main программы, чтобы их можно было обслуживать и разрабатывать независимо друг от друга. Вы также можете повторно использовать скины, изначально предназначенные для использования автономным проигрывателем в режиме обложки. Код кожи, который вы разрабатываете специально для программ C++, может взаимодействовать с программами через объект, доступный для сценариев, который может предоставить программа.

Чтобы включить режим обложки для элемента управления Медиаплеер Windows, программа должна реализовать интерфейс IWMPRemoteMediaServices. Хотя можно одновременно использовать обложки с элементом управления и удаленного управления, этот интерфейс можно использовать для включения любой из функций, не включая другую. Чтобы отключить удаленное взаимодействие, просто передайте значение Local в качестве параметра out метода GetServiceType и верните HRESULT E_NOTIMPL из метода GetApplicationName .

Чтобы переключить элемент управления Медиаплеер Windows в режим обложки, вызовите метод IWMPPlayer::p ut_uiMode, передав значение custom. Укажите путь и имя файла определения обложки для использования, возвращая его из метода IWMPRemoteMediaServices::GetCustomUIMode .

Если вы хотите предоставить объект с доступом к скриптам для обмена данными между обложкой и программой, передайте имя и указатель на указатель IDispatch в качестве двух параметров out метода IWMPRemoteMediaServices::GetScriptableObject . Затем ваша обложка может вызывать объект, доступный для сценариев, используя указанное имя, как если бы это был глобальный атрибут, аналогичный глобальному атрибуту игрока .

Обложка, примененная к удаленному элементу управления Медиаплеер Windows, может получить доступ к объекту PlayerApplication с помощью другого глобального атрибута, называемого playerApplication. Так как скины не могут получить доступ к свойству Player.playerApplication , необходимо использовать этот глобальный атрибут, если требуется, чтобы код кожи управлял закреплением и отстыковкой.

Примеры

Пакет установки пакета SDK для Медиаплеер Windows устанавливает пример, демонстрирующий применение обложки к элементу управления Медиаплеер Windows. Дополнительные сведения см. в примере RemoteSkin.

Примеры

Использование элемента управления Медиаплеер Windows в программе C++