From 218934fa2ed1c702a6d3923d2aa2cc6b43c48684 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:43:23 -0500 Subject: initial commit --- files/zh-tw/archive/b2g_os/api/fmradio/index.html | 110 +++++++++++++++ files/zh-tw/archive/b2g_os/api/index.html | 156 ++++++++++++++++++++++ 2 files changed, 266 insertions(+) create mode 100644 files/zh-tw/archive/b2g_os/api/fmradio/index.html create mode 100644 files/zh-tw/archive/b2g_os/api/index.html (limited to 'files/zh-tw/archive/b2g_os/api') 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 +--- +

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)
+
+ 非同步變更收音機的頻率。此數值必須位於 frequencyLowerBound 與 frequencyUpperBound 之間。若嘗試設定此範圍之外，將導致錯誤。
+
+ 若回傳成功的 DOMRequest，則代表已正確變更頻率。
+
+ seekUp()
+
+ 要求收音機尋找新的頻率 (一般搜尋較目前頻率更高的頻率)。若成功搜尋到新的頻率，將隨即啟動 frequencychange 事件。若回傳成功的 DOMRequest，則代表已開始搜尋作業。一旦達到最高頻率，將回到較低頻率開始搜尋。
+
+ seekDown()
+
+ 與上方函式的功能相同，但將搜尋較目前頻率更低的頻率。一旦達到最低頻率，將回到較高頻率開始搜尋。
+
+ cancelSeek()
+
+ 取消目前的搜尋作業。若回傳成功的 DOMRequest，則代表已取消搜尋作業。
+
+

事件 (Event)

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

另請參閱

+

Gaia radio app

diff --git a/files/zh-tw/archive/b2g_os/api/index.html b/files/zh-tw/archive/b2g_os/api/index.html new file mode 100644 index 0000000000..706080ff54 --- /dev/null +++ b/files/zh-tw/archive/b2g_os/api/index.html @@ -0,0 +1,156 @@ +--- +title: B2G OS APIs +slug: Archive/B2G_OS/API +tags: + - API + - B2G API + - NeedsTranslation + - TopicStub + - b2g os api's +translation_of: Archive/B2G_OS/API +--- +

List of B2G OS APIs 

+ +

+A +B +C +D + + +F + + +H + + + + + + + + +M +N + + +P + + + + +S +T +U + + +W + + + + + + + +

-- cgit v1.2.3-54-g00ecf