diff options
Diffstat (limited to 'files/zh-tw/archive/b2g_os/api/fmradio/index.html')
-rw-r--r-- | files/zh-tw/archive/b2g_os/api/fmradio/index.html | 110 |
1 files changed, 0 insertions, 110 deletions
diff --git a/files/zh-tw/archive/b2g_os/api/fmradio/index.html b/files/zh-tw/archive/b2g_os/api/fmradio/index.html deleted file mode 100644 index ec662a0029..0000000000 --- a/files/zh-tw/archive/b2g_os/api/fmradio/index.html +++ /dev/null @@ -1,110 +0,0 @@ ---- -title: WebFM -slug: Archive/B2G_OS/API/FMRadio -translation_of: Archive/B2G_OS/API/FMRadio ---- -<p>WebFM API 可存取裝置上的 FM 收音機功能。此介面可開啟/關閉 FM 收音機,亦可搜尋各個電台。</p> -<h2 id="Syntax" name="Syntax">進入點 (Entry point)</h2> -<pre class="eval"><span class="nx">if (navigator.mozFMRadio) - navigator</span><span class="p">.</span><span class="nx">mozFMRadio.enable()</span>; -</pre> -<h2 id="API">API</h2> -<pre>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(); -}</pre> -<h3 id="屬性_(Attribute)">屬性 (Attribute)</h3> -<dl> - <dt> - enabled</dt> - <dd> - 表示目前是否開啟收音機</dd> - <dt> - antennaAvailable</dt> - <dd> - 表示是否已插上天線並可使用天線</dd> - <dt> - frequency</dt> - <dd> - 目前的收音機頻率</dd> - <dt> - frequencyUpperBound</dt> - <dd> - 以 <code>seek</code> 函式搜尋收音機電台的最高頻率</dd> - <dt> - frequencyLowerBound</dt> - <dd> - 以 <code>seek</code> 函式搜尋收音機電台的最低頻率</dd> - <dt> - channelWidth</dt> - <dd> - 頻率範圍內的頻寬,以「MHz」為單位。常用數值為 0.05、0.1 (預設)、0.2 其中之一。</dd> - <dd> - 指定了某一頻率之後,就會四捨五入到 channelWidth 所指定的最接近頻率。舉例來說,若 100 Mz 為有效頻率,且 channelWidth 為 0.2,則 100.2 與 99.8 將成為有效頻率。但若是 100.15 將四捨五入為 100.2。</dd> -</dl> -<h3 id="函式_(Method)">函式 (Method)</h3> -<dl> - <dt> - enable(frequency)</dt> - <dd> - 開啟收音機並轉為指定頻率。若沒有參數 (Argument) 就呼叫此函式,將隨即丟出錯誤。作業成功或錯誤均將回傳 DOMRequest。</dd> - <dt> - disable()</dt> - <dd> - 關閉收音機。若回傳成功的 DOMRequest,則代表已正確關閉收音機。</dd> - <dt> - setFrenquecy(frequency)</dt> - <dd> - 非同步變更收音機的頻率。此數值必須位於 <code>frequencyLowerBound</code> 與 <code>frequencyUpperBound</code> 之間。若嘗試設定此範圍之外,將導致錯誤。</dd> - <dd> - 若回傳成功的 DOMRequest,則代表已正確變更頻率。</dd> - <dt> - seekUp()</dt> - <dd> - 要求收音機尋找新的頻率 (一般搜尋較目前頻率更高的頻率)。若成功搜尋到新的頻率,將隨即啟動 <code>frequencychange</code> 事件。若回傳成功的 DOMRequest,則代表已開始搜尋作業。一旦達到最高頻率,將回到較低頻率開始搜尋。</dd> - <dt> - seekDown()</dt> - <dd> - 與上方函式的功能相同,但將搜尋較目前頻率更低的頻率。一旦達到最低頻率,將回到較高頻率開始搜尋。</dd> - <dt> - cancelSeek()</dt> - <dd> - 取消目前的搜尋作業。若回傳成功的 DOMRequest,則代表已取消搜尋作業。</dd> -</dl> -<h3 id="事件_(Event)">事件 (Event)</h3> -<dl> - <dt> - enabled</dt> - <dd> - 開啟收音機時觸發此事件</dd> - <dt> - disabled</dt> - <dd> - 關閉收音機時觸發此事件</dd> - <dt> - antennaavailablechange</dt> - <dd> - 插上/拔除天線時觸發此事件</dd> - <dt> - frequencychange</dt> - <dd> - 只要變更收音機頻率,均將觸發此事件</dd> -</dl> -<h2 id="另請參閱">另請參閱</h2> -<p><a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/fm" title="https://github.com/mozilla-b2g/gaia/tree/master/apps/fm">Gaia radio app</a></p> |