blob: 84880d4d922f3dbd17ba570a024bde38e1e6e4fc (
plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
|
---
title: FMRadio
slug: Web/API/FMRadio
tags:
- API
- B2G
- Firefox OS
- Non Standard
- Reference
- WebAPI
- WebFM
translation_of: Archive/B2G_OS/API/FMRadio
---
<p>{{ non-standard_header() }}</p>
<p>{{ B2GOnlyHeader2('installed') }}</p>
<h2 id="概要">概要</h2>
<p>WebFM API は、端末の FM ラジオへのアクセスを提供します。このインターフェースは、FM ラジオの ON、OFF およびチューニングにより他の局への切り替えを可能にします。これらは {{domxref("window.navigator.mozFMRadio","navigator.mozFMRadio")}} プロパティを通してアクセスできます。</p>
<h2 id="API_概観">API 概観</h2>
<pre>interface FMRadio : 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>
<h2 id="プロパティ">プロパティ</h2>
<dl>
<dt>
{{domxref("FMRadio.enabled")}}</dt>
<dd>
ラジオが再生中かどうかを示します。</dd>
<dt>
{{domxref("FMRadio.antennaAvailable")}}</dt>
<dd>
アンテナが接続され利用可能かどうかを示します。</dd>
<dt>
{{domxref("FMRadio.frequency")}}</dt>
<dd>
現在のラジオ周波数を示します。</dd>
<dt>
{{domxref("FMRadio.frequencyUpperBound")}}</dt>
<dd>
<code>seek</code> メソッドで検索するラジオ局の周波数の最大値。</dd>
<dt>
{{domxref("FMRadio.frequencyLowerBound")}}</dt>
<dd>
<code>seek</code> メソッドで検索するラジオ局の周波数の最小値。</dd>
<dt>
{{domxref("FMRadio.channelWidth")}}</dt>
<dd>
周波数の範囲のチャンネル幅 (MHz 単位)。</dd>
</dl>
<h3 id="イベントハンドラ">イベントハンドラ</h3>
<dl>
<dt>
{{domxref("FMRadio.onenabled")}}</dt>
<dd>
{{event("enabled")}} イベントのためのハンドラ。ラジオが ON になった時に発火します。</dd>
<dt>
{{domxref("FMRadio.ondisabled")}}</dt>
<dd>
{{event("disabled")}} イベントのためのハンドラ。ラジオが OFF になった時に発火します。</dd>
<dt>
{{domxref("FMRadio.onantennaavailablechange")}}</dt>
<dd>
{{event("antennaavailablechange")}} イベントのためのハンドラ。アンテナが抜き差しされた時に発火します。</dd>
<dt>
{{domxref("FMRadio.onfrequencychange")}}</dt>
<dd>
{{event("frequencychange")}} イベントのためのハンドラ。ラジオ周波数が変更されるたびに発火します。</dd>
</dl>
<h2 id="メソッド">メソッド</h2>
<dl>
<dt>
{{domxref("FMRadio.enable()")}}</dt>
<dd>
与えられた周波数でラジオを ON にします。この関数は、引数なしで呼ばれた場合にエラーを投げます。命令の成功またはエラーを扱う {{domxref("DOMRequest")}} を返します。</dd>
<dt>
{{domxref("FMRadio.disable()")}}</dt>
<dd>
ラジオを OFF にします。{{domxref("DOMRequest")}} を返し、これが成功の場合、ラジオが正しく無効化されたことを示します。</dd>
<dt>
{{domxref("FMRadio.setFrequency()")}}</dt>
<dd>
非同期でラジオの周波数を変更します。周波数の値は、<code>frequencyLowerBound</code> と <code>frequencyUpperBound</code> の間にしなければなりません。この範囲外の値をセットしようとするとエラーになります。</dd>
<dd>
{{domxref("DOMRequest")}} を返し、これが成功の場合、周波数が正しく変更されたことを示します。</dd>
<dt>
{{domxref("FMRadio.seekUp()")}}</dt>
<dd>
次の周波数を探索します (通常は現在よりも高いほうの周波数)。ラジオチャンネルが見つかると、<code>frequencychange</code> イベントが発生します。{{domxref("DOMRequest")}} を返し、これが成功の場合、探索が開始されたことを示します。探索する周波数が上限に達すると、低い周波数に折り返して探索されます。</dd>
<dt>
{{domxref("FMRadio.seekDown()")}}</dt>
<dd>
上記と同じですが、現在よりも低いほうの周波数を探索します。探索する周波数が下限に達すると、高い周波数に折り返して探索されます。</dd>
<dt>
{{domxref("FMRadio.cancelSeek()")}}</dt>
<dd>
ラジオチャンネルの探索をキャンセルします。{{domxref("DOMRequest")}} を返し、これが成功の場合、周波数の探索がキャンセルされたことを示します。</dd>
</dl>
<h2 id="仕様書">仕様書</h2>
<p>仕様はありません。</p>
<h2 id="参照">参照</h2>
<ul>
<li><a href="/docs/WebAPI/WebFM_API" title="/en-US/docs/WebAPI/WebFM_API">WebFM API</a></li>
<li><a href="https://github.com/mozilla-b2g/gaia/tree/master/apps/fm" title="https://github.com/mozilla-b2g/gaia/tree/master/apps/fm">Gaia の FM ラジオアプリ</a></li>
</ul>
|
