aboutsummaryrefslogtreecommitdiff
path: root/files/zh-tw/archive/b2g_os/api/fmradio/index.html
diff options
context:
space:
mode:
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.html110
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>