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
121
122
123
124
125
126
127
128
129
130
131
132
|
---
title: WebFM API
slug: WebAPI/WebFM_API
translation_of: Archive/B2G_OS/API/WebFM_API
---
<p>{{ non-standard_header() }}</p>
<p>{{ B2GOnlyHeader2('installed') }}</p>
<h2 id="요약">요약</h2>
<p>WebFM API를 이용하면 FM 라디오를 사용할 수 있습니다. 라디오를 켜고, 끄거나 라디오 방송국을 변경 할 수 있습니다. {{domxref("FMRadio")}} 객체의 {{domxref("window.navigator.mozFMRadio","navigator.mozFMRadio")}} 속성을 통해 사용할 수 있습니다.</p>
<h2 id="라디오_켜기끄기">라디오 켜기/끄기</h2>
<p>기본적으로 {{domxref("FMRadio.enable()")}} 메소드로 라디오를 켜고, {{domxref("FMRadio.disable()")}} 메소드로 라디오를 끌 수 있습니다.</p>
<p>라디오를 켜기 전에 안테나 사용 가능 여부를 체크하는 것이 좋습니다(안테나가 없으면 내장된 라디오가 신호를 받을 수 없습니다). {{domxref("FMRadio.antennaAvailable")}} 속성으로 안테나 사용 가능 여부를 확인할 수 있습니다. 모바일 기기에서는 헤드폰 케이블이 안테나 역할을 하는데, 헤드폰 케이블 연결 상태에 따라 안테나 사용 여부가 변경되면 {{event("antennaavailablechange")}} 이벤트가 발생됩니다.<br>
<br>
라디오를 켜기 위해서 주파수 번호(MHz 단위)를 {{domxref("FMRadio.enable()")}} 메소드에 넘겨 실행합니다.</p>
<pre class="brush: js">// The frequency of the radio station
// to listen express in MHz
var frequency = 99.1;
var radio = navigator.mozFMRadio;
if (radio.antennaAvailable) {
radio.enable(frenquency);
} else {
alert("You need to plug your headphone");
}
radio.addEventListener('antennaavailablechange', function () {
if (radio.antennaAvailable) {
radio.enable(frenquency);
} else {
radio.disable();
}
})
</pre>
<div class="note">
<p><strong>Note:</strong> The audio is output through the <code>normal</code> audio channel available on the device.</p>
</div>
<h2 id="주파수_변경하기">주파수 변경하기</h2>
<p>주파수는 직접 또는 자동으로 변경할 수 있습니다. 현재 내장 라디오의 주파수는 {{domxref("FMRadio.frequency")}} 속성으로 알 수 있으며 해당 속성 값은 MHz 단위의 숫자로 표현합니다.</p>
<h3 id="직접_변경하기">직접 변경하기</h3>
<p>{{domxref("FMRadio.setFrequency()")}} 메소드는 새로운 주파수를 할당할 때 사용합니다. 설정할 수 있는 주파수는 제한적입니다. 메소드 호출 후 성공 또는 실패 상황을 제어하는 {{domxref("DOMRequest")}} 객체를 반환합니다. 주파수는 다음의 요구사항을 만족해야 합니다.:</p>
<ul>
<li>주파수는 {{domxref("FMRadio.frequencyLowerBound")}}와 {{domxref("FMRadio.frequencyUpperBound")}}에 정의된 범위 내에 있어야 합니다. 이 범위를 벗어나면 에러가 반환됩니다.</li>
<li>주파수는 {{domxref("FMRadio.channelWidth")}}에 정의된 값만큼 이동해야 합니다. 그렇지 않으면 주파수는 반올림됩니다. 예를 들어 100MHz가 정상적인 주파수이고 {{domxref("FMRadio.channelWidth","channelWidth")}}가 0.2로 설정된 경우, 100.15 주파수로 설정하더라도 주파수는 100.2로 할당됩니다.</li>
</ul>
<pre class="brush: js">var change = radio.setFrequency(frequency);
change.onerror = function () {
var min = radio.frequencyLowerBound;
var max = radio.frequencyUpperBound;
console.warn('The frequency must be within the range [' + min + ',' + max + ']');
}
change.onsuccess = function () {
console.log('The frequency has been set to ' + radio.frequency);
}
</pre>
<h3 id="자동으로_찾기">자동으로 찾기</h3>
<p>WebFM API를 사용하면 편리하게 라디오 채널을 검색할 수 있습니다. {{domxref("FMRadio.seekUp()")}}(현재 주파수보다 높은 채널 찾기) {{domxref("FMRadio.seekDown()")}} 메소드를 사용합니다. 현재 주파수보다 높거나, 낮은 주파수의 라디오 채널을 찾을 때 사용합니다. 이 메소드들은 호출 후에 성공/실패를 제어할 수 있는 {{domxref("DOMRequest")}} 객체를 반환합니다.<br>
<br>
이 메소드들은 {{domxref("FMRadio.frequencyLowerBound","frequencyLowerBound")}}나 {{domxref("FMRadio.frequencyUpperBound","frequencyUpperBound")}} 값에 도달할 때까지 반복적으로 더 높거나, 낮은 주파수를 찾습니다. 새로운 라디오 채널을 찾으면 {{event("frequencychange")}} 이벤트가 발생되고 현재 주파수로 변경됩니다.<br>
<br>
동시에 두 메소드를 실행할 수 없으며(동시에 상위/하위 채널을 찾을 수 없습니다) 동시에 실행할 경우 에러가 반환됩니다. 더 이상 찾을 필요가 없을 때 {{domxref("FMRadio.cancelSeek()")}} 메소드를 호출합니다. 이 메소드 역시 {{domxref("DOMRequest")}} 객체를 반환합니다.</p>
<pre class="brush: js">var radio = navigator.mozFMRadio;
var seeking = false;
var UP = document.querySelector("button.up");
var DOWN = document.querySelector("button.down");
// When the frequency change, the seek
// functions automatically stop to seek.
radio.onfrequencychange = function () {
seeking = false;
}
function seek(direction) {
var cancel, search;
// If the radio is already seeking
// we will cancel the current search.
if (seeking) {
var cancel = radio.cancelSeek();
cancel.onsuccess = function () {
seeking = false;
// Once the radio no longer seek,
// we can try to seek as expected
seek(direction);
}
// Let's seek up
} else if (direction === 'up') {
// Just to be sure that the radio is turned on
if (!radio.enabled) {
radio.enable(radio.frequencyLowerBound);
}
search = radio.seekUp();
// Let's seek up
} else if (direction === 'down' {
// Just to be sure that the radio is turned on
if (!radio.enabled) {
radio.enable(radio.frequencyUpperBound);
}
search = radio.seekDown();
}
if (search) {
search.onsuccess = function () {
// Ok, we are seeking now.
seeking = true;
};
search.onerror = function () {
// Something goes wrong... ok, let's try again.
seek(direction);
}
}
}
UP.addEventListener('click', function () {
seek('up');
});
DOWN.addEventListener('click', function () {
seek('down');
});
</pre>
<h2 id="표준">표준</h2>
<p>Not part of any specification.</p>
<h2 id="참고자료">참고자료</h2>
<ul>
<li>{{domxref("FMRadio")}}</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">The FM app on Gaïa</a></li>
</ul>
|
