1 files changed, 110 insertions, 0 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
new file mode 100644
index 0000000000..ec662a0029
--- /dev/null
+++ b/files/zh-tw/archive/b2g_os/api/fmradio/index.html
@@ -0,0 +1,110 @@
+---
+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>