mozilla
您的搜尋結果

    WebFM

    WebFM API 可存取裝置上的 FM 收音機功能。此介面可開啟/關閉 FM 收音機,亦可搜尋各個電台。

    進入點 (Entry point)

    if (navigator.mozFMRadio)
      navigator.mozFMRadio.enable();
    

    API

    interface FM : 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();
    }

    屬性 (Attribute)

    enabled
    表示目前是否開啟收音機
    antennaAvailable
    表示是否已插上天線並可使用天線
    frequency
    目前的收音機頻率
    frequencyUpperBound
    seek 函式搜尋收音機電台的最高頻率
    frequencyLowerBound
    seek 函式搜尋收音機電台的最低頻率
    channelWidth
    頻率範圍內的頻寬,以「MHz」為單位。常用數值為 0.05、0.1 (預設)、0.2 其中之一。
    指定了某一頻率之後,就會四捨五入到 channelWidth 所指定的最接近頻率。舉例來說,若 100 Mz 為有效頻率,且 channelWidth 為 0.2,則 100.2 與 99.8 將成為有效頻率。但若是 100.15 將四捨五入為 100.2。

    函式 (Method)

    enable(frequency)
    開啟收音機並轉為指定頻率。若沒有參數 (Argument) 就呼叫此函式,將隨即丟出錯誤。作業成功或錯誤均將回傳 DOMRequest。
    disable()
    關閉收音機。若回傳成功的 DOMRequest,則代表已正確關閉收音機。
    setFrenquecy(frequency)
    非同步變更收音機的頻率。此數值必須位於 frequencyLowerBoundfrequencyUpperBound 之間。若嘗試設定此範圍之外,將導致錯誤。
    若回傳成功的 DOMRequest,則代表已正確變更頻率。
    seekUp()
    要求收音機尋找新的頻率 (一般搜尋較目前頻率更高的頻率)。若成功搜尋到新的頻率,將隨即啟動 frequencychange 事件。若回傳成功的 DOMRequest,則代表已開始搜尋作業。一旦達到最高頻率,將回到較低頻率開始搜尋。
    seekDown()
    與上方函式的功能相同,但將搜尋較目前頻率更低的頻率。一旦達到最低頻率,將回到較高頻率開始搜尋。
    cancelSeek()
    取消目前的搜尋作業。若回傳成功的 DOMRequest,則代表已取消搜尋作業。

    事件 (Event)

    enabled
    開啟收音機時觸發此事件
    disabled
    關閉收音機時觸發此事件
    antennaavailablechange
    插上/拔除天線時觸發此事件
    frequencychange
    只要變更收音機頻率,均將觸發此事件

    另請參閱

    Gaia radio app

    Document Tags and Contributors

    Contributors to this page: MashKao
    最近更新: MashKao,