FMRadio

Перевод не завершен. Пожалуйста, помогите перевести эту статью с английского.

Не стандартно
Эта возможность не является стандартной и стандартизировать её пока никто не собирается. Не используйте её на сайтах, смотрящих во внешний мир: она будет работать не у всех пользователей. Также могут присутствовать большие несовместимости между реализациями и её поведение может в будущем измениться.

This API is available on Firefox or Firefox OS for installed or higher privileged applications.

Summary

WebFM API предоставляет доступ к модулю FM радио устройства. Этот интерфейс поможет Вам включить или выключить FM радио и настроить его на нужную станцию. Это достижимо с помощью параметра navigator.mozFMRadio.

Обзор API

interface FMRadio : EventTarget {
   readonly attribute boolean enabled;
   readonly attribute boolean antennaAvailable;
   readonly attribute double frequency;
   readonly attribute double frequencyUpperBound;
   readonly attribute double frequencyLowerBound;
   readonly attribute double channelWidth;

   attribute Function onantennaavailablechange;
   attribute Function onfrequencychange;
   attribute Function onenabled;
   attribute Function ondisabled;

   DOMRequest enable(double frequency);
   DOMRequest disable();
   DOMRequest setFrequency(double frequency);
   DOMRequest seekUp();
   DOMRequest seekDown();
   DOMRequest cancelSeek();
}

Параметры

FMRadio.enabled
Показывает играет ли радио
FMRadio.antennaAvailable
Показывает доступна ли антенна
FMRadio.frequency
Текущая частота радио.
FMRadio.frequencyUpperBound
Максимальная частота по которой можно найти радиостанцию
FMRadio.frequencyLowerBound
Минимальная частота по которой можно найти радиостанцию
FMRadio.channelWidth
Частота текущей радиостанции, в МГц.

Event handlers

FMRadio.onenabled
A handler for the enabled event; It is triggered when the radio has been turned on
FMRadio.ondisabled
A handler for the disabled event; It is triggered when the radio has been turned off
FMRadio.onantennaavailablechange
A handler for the antennaavailablechange event; It is triggered when an antenna is plugged or unplugged
FMRadio.onfrequencychange
A handler for the frequencychange event; It is triggered whenever the radio frequency is changed

Методы

FMRadio.enable()
Turns on the radio on the given frequency. This function throws if called with no argument. Returns a DOMRequest for the success or error of the operation.
FMRadio.disable()
Turns the radio off. Returns a DOMRequest which success indicates that the radio has properly been disabled
FMRadio.setFrequency()
Asynchronously changes the radio frequency. The value has to be between frequencyLowerBound and frequencyUpperBound. Trying to set outside the bounds results in an error.
Returns a DOMRequest which success indicates the frequency has properly been changed.
FMRadio.seekUp()
Asks the radio to find a new frequency (usually greater than the current one). If one is successfully found, a frequencychange event is fired. Returns a DOMRequest which success indicates that the search has started. The search circles back to lower frequencies when the highest frequency has been reached.
FMRadio.seekDown()
Same as above, but searching in frequencies lower than the current one. The search cirlces back to higher frequencies when the lowest frequency has been reached.
FMRadio.cancelSeek()
Cancels the radio seek if one was happening. Returns a DOMRequest which success indicates that the frequency search has been cancelled.

Спецификация

Ещё нет спецификаций.

See also

Метки документа и участники

 Внесли вклад в эту страницу: iVAN2002, tryasko
 Обновлялась последний раз: iVAN2002,