D-Bus интерфейс MediaPlayer1
Интерфейс позволяет управлять воспроизведением медиа.
| Шина: | системная |
| Служба: | org.bluez (у контроллера) |
| Объект: | [variable prefix]/{hci0,hci1,...}/dev_XX_XX_XX_XX_XX_XX/playerX |
| Интерфейс: | org.bluez.MediaPlayer1 |
Свойства
- Browsable : boolean [только для чтения]
- Device : object [только для чтения]
- Equalizer : string
- Name : string [только для чтения]
- Playlist : object
- Position : uint32 [только для чтения]
- Repeat : string
- Scan : string
- Searchable : boolean [только для чтения]
- Shuffle : string
- Status : string [только для чтения]
- Subtype : string [только для чтения]
- Track : dict [только для чтения]
- Type : string [только для чтения]
Методы
- FastForward()
- Hold(byte avc_key)
- Next()
- Pause()
- Play()
- Press(byte avc_key)
- Previous()
- Release()
- Rewind()
- Stop()
Подробное описание
Интерфейс содержит свойства и методы для управления воспроизведением медиа.
Описание свойств
Browsable : boolean [только для чтения]
Если присутствует, указывает на то, что проигрыватель можно просматривать с помощью интерфейса MediaFolder.
Возможные значения:
True- поддерживается и активен;
False- поддерживается, но неактивен.
Примечание. Если поддерживается, но неактивен, клиенты могут включить его с помощью интерфейса MediaFolder, но это может помешать воспроизведению других плееров.
Device : object [только для чтения]
Путь к объекту устройства.
Equalizer : string
Возможные значения: off или on.
Name : string [только для чтения]
Название плеера.
Playlist : object
Путь к объекту плейлиста.
Position : uint32 [только для чтения]
Позиция воспроизведения в миллисекундах.
Изменение позиции может генерировать дополнительные события,
которые будут отправлены на удалённое устройство.
Когда позиция равна 0, это означает, что трек начинается, а когда она больше
или равна продолжительности трека, он закончился.
Следует обратить внимание, что даже если продолжительность трека недоступна в метаданных,
можно сигнализировать о его окончании, установив для позиции максимальное значение типа uint32.
Repeat : string
Возможные значения: off, singletrack, alltracks или group.
Scan : string
Возможные значения: off, alltracks или group.
Searchable : boolean [только для чтения]
Если присутствует, указывает, что плеер можно найти с помощью интерфейса MediaFolder.
Возможные значения:
True- поддерживается и активен;
False- поддерживается, но неактивен.
Примечание. Если поддерживается, но неактивен, клиенты могут включить его с помощью интерфейса MediaFolder, но это может помешать воспроизведению других плееров.
Shuffle : string
Возможные значения: off, alltracks или group.
Status : string [только для чтения]
Возможный статус: playing, stopped, paused, forward-seek, reverse-seek или error.
Subtype : string [только для чтения]
Подтип плеера.
Возможные значения: Audio Book, Podcast.
Track : dict [только для чтения]
Метаданные трека. Возможные значения:
- string
Title - Название трека.
- string
Artist - Исполнитель.
- string
Album - Название альбома.
- string
Genre - Жанр.
- uint32
NumberOfTracks - Количество треков.
- uint32
TrackNumber - Номер трека.
- uint32
Duration - Продолжительность трека в миллисекундах.
Type : string [только для чтения]
Тип плеера.
Возможные значения: Audio, Video, Audio Broadcasting, Video Broadcasting.
Описание методов
FastForward()
Ускоренное воспроизведение вперёд. Это действие останавливается только при вызове другого метода в данном интерфейсе.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Hold(byte avc_key)
Обрабатывает нажатие и удерживание заданной клавиши в виде отправки в качестве сквозной команды.
После вызова данного метода необходимо вызвать Release().
Удерживаемая клавиша также будет отпущена при вызове любого другого метода в этом интерфейсе.
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Next()
Переходит к следующему элементу.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Pause()
Ставит воспроизведение медиа на паузу.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Play()
Продолжает воспроизведение медиа.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Press(byte avc_key)
Обрабатывает нажатие на заданную клавишу в виде отправки в качестве сквозной команды.
Ключ будет освобождён автоматически.
Если цель состоит в том, чтобы удерживать клавишу, вместо данного метода нужно применять
Hold().
Возможные ошибки:
org.bluez.Error.InvalidArguments,org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Previous()
Возвращается к предыдущему элементу.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Release()
Отпускает ранее удерживаемую клавишу, вызванную с помощью Hold().
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Rewind()
Воспроизведение в обратную сторону. Это действие останавливается только при вызове другого метода в данном интерфейсе.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.
Stop()
Останавливает воспроизведение медиа.
Возможные ошибки:
org.bluez.Error.NotSupported,org.bluez.Error.Failed.