aboutsummaryrefslogtreecommitdiff
path: root/files/zh-tw/webapi/index.html
blob: 70683109e6a14de3bde61ba74119364af77ff1a3 (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
121
122
123
124
125
126
---
title: WebAPI
slug: WebAPI
translation_of: Web/API
---
<p><strong>WebAPI</strong> 是指一系列的存取與裝置相容性 API,讓 Web App 及其內容能夠存取裝置的硬體 (例如電池狀態或裝置的振動硬體),亦可存取裝置所儲存的資料 (例如行事曆或聯絡人清單)。在添加這些 API 之後,我們希望 Web 能跳脫目前的功能,並打破專利平台的限制。</p>

<div class="note">
<p><strong>注意:</strong>我們實際撰寫的內容,其實比本頁所列出的 API 還多,而且仍有許多連結尚未補齊。我們將持續補完相關內容,以提供更完整的資訊。可參閱 <a href="https://developer.mozilla.org/en-US/docs/WebAPI/Doc_status" title="WebAPI/Doc_status">WebAPI 文件狀態頁面</a>,隨時追蹤目前的 WebAPI 說明文件。</p>
</div>

<div class="note">
<p><strong>注意:</strong>若要了解小標圖的意義,可先參閱<a href="https://developer.mozilla.org/zh-TW/docs/%E6%87%89%E7%94%A8%E7%A8%8B%E5%BC%8F-840092-dup/Packaged_apps?redirectlocale=en-US&amp;redirectslug=Apps%2FPackaged_apps" title="Web/Apps/Packaged_apps#Types_of_packaged_apps">《封裝式 (Packaged) App》</a>一文。</p>
</div>

<div class="row topicpage-table">
<div class="section">
<h2 class="Documentation" id="Communication_APIs" name="Communication_APIs">通訊 API</h2>

<dl>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Network_Information" title="WebAPI/Network_Information">Network Information API</a></dt>
 <dd>提供目前網路連線的基本資訊,如連線速度。</dd>
 <dt><a href="/en-US/docs/WebAPI/WebBluetooth" title="WebAPI/WebBluetooth">Bluetooth</a></dt>
 <dd>The WebBluetooth API provides low-level access to the device's Bluetooth hardware.</dd>
 <dt><a href="/en-US/docs/WebAPI/Mobile_Connection" title="WebAPI/Mobile_Connection">Mobile Connection API</a> {{NonStandardBadge}}</dt>
 <dd>Exposes information about the device's cellular connectivity, such as signal strength, operator information, and so forth.</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Network_Stats" title="WebAPI/Network_Stats">Network Stats API</a> {{NonStandardBadge}}</dt>
 <dd>監控資料使用情形,並將此資料提供給 Privileged App。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/TCP_Socket" title="WebAPI/TCP_Socket">TCP Socket API</a> {{NonStandardBadge}}</dt>
 <dd>提供初階的 Socket 與 SSL 支援功能。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/Web/Guide/Telephony" title="WebAPI/WebTelephony">Telephony</a> {{NonStandardBadge}}</dt>
 <dd>讓 App 可撥/接電話,並使用內建電話的使用者介面。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/WebSMS" title="WebAPI/WebSMS">WebSMS </a>{{NonStandardBadge}}</dt>
 <dd>讓 App 能收/發 SMS 文字簡訊,並能存取/管理裝置所儲存的訊息。</dd>
 <dt><a href="/en-US/docs/WebAPI/WiFi_Information" title="WebAPI/WiFi_Information">WiFi Information API</a> {{NonStandardBadge}}</dt>
 <dd>A privileged API which provides information about signal strength, the name of the current network, available WiFi networks, and so forth.</dd>
</dl>

<h2 class="Documentation" id="Hardware_access_APIs" name="Hardware_access_APIs">硬體存取 API</h2>

<dl>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Using_Light_Events">Ambient Light Sensor API</a></dt>
 <dd>可存取環境光線感測器,讓 App 可偵測裝置四周的環境光線強度。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Battery_Status" title="WebAPI/Battery_Status">Battery Status API</a></dt>
 <dd>不論是否插電進行充電,均將提供電池充電容量的相關資訊。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/Using_geolocation" title="Using_geolocation">Geolocation API</a></dt>
 <dd>提供裝置實際位置的相關資訊。</dd>
 <dt><a href="/zh-TW/docs/WebAPI/Pointer_Lock" title="API/Pointer_Lock_API">Pointer Lock API</a></dt>
 <dd>讓 App 能鎖定存取滑鼠,並取得「隨著時間推移的滑鼠位移 (即 deltas)」,而不只是絕對座標而已。特別適用遊戲類 App。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Proximity" title="WebAPI/Proximity">Proximity API</a></dt>
 <dd>測得裝置與物體 (如使用者的臉部) 之間的距離。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Detecting_device_orientation" title="Detecting_device_orientation">Device Orientation API</a></dt>
 <dd>當裝置的方向改變時,送出通知。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Managing_screen_orientation" title="Detecting_device_orientation">Screen Orientation API</a></dt>
 <dd>在畫面方向改變時發出通知。另透過此 API,可讓 App 呈現其所偏好的方向。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Vibration" title="WebAPI/WebBluetooth">Vibration API</a></dt>
 <dd>可讓 App 控制裝置上的振動硬體,用於如遊戲中的觸控回饋。此 API <strong>並非</strong>用於如「通知」的振動事件。若需要通知的振動事件,請參閱 <a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Alarm" title="WebAPI/Alarm">Alarm API</a></dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Camera" title="WebAPI/Camera">Camera API</a> {{NonStandardBadge}}</dt>
 <dd>讓 App 透過裝置內建的相機,即可拍照或錄製影片。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Power_Management" title="WebAPI/Power_Management">Power Management API</a> {{NonStandardBadge}}</dt>
 <dd>讓 App 能開/關 CPU、螢幕、裝置電力,與類似資源。另可進一步監聽或檢視資源鎖定事件。</dd>
</dl>

<p><span class="alllinks"><a href="/en-US/docs/tag/WebAPI" title="tag/CSS">View All...</a></span></p>
</div>

<div class="section">
<h2 class="Documentation" id="Data_management_APIs" name="Data_management_APIs">資料管理 API</h2>

<dl>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/FileHandle" title="WebAPI/FileHandle_API">FileHandle API</a></dt>
 <dd>支援可寫入的檔案,並搭配鎖存功能。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/IndexedDB" title="IndexedDB">IndexedDB</a></dt>
 <dd>於用戶端儲存結構性的資料,並支援高效率的搜尋功能。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Settings" title="WebAPI/Settings">Settings API</a> {{NonStandardBadge}}</dt>
 <dd>App 可檢查並更改系統的相關設定;而這些設定選項均屬於永久儲存性質。</dd>
</dl>

<h2 class="Documentation" id="Other_APIs" name="Other_APIs">其他 API</h2>

<dl>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Alarm" title="WebAPI/Alarm">Alarm API</a></dt>
 <dd>App 可排定通知,亦可於特定時間自行啟動 App。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Simple_Push" title="WebAPI/Push_Notifications">Simple Push API</a></dt>
 <dd>讓平台傳送通知訊息至特定 App。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Using_Web_Notifications" title="/en-US/docs/WebAPI/Using_Web_Notifications">Web Notifications</a></dt>
 <dd>讓 App 傳送通知並於系統層級顯示。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/%E6%87%89%E7%94%A8%E7%A8%8B%E5%BC%8F-840092-dup" title="Apps">Apps API</a> {{NonStandardBadge}}</dt>
 <dd>Open WebApps API 可安裝並管理 Web App。此外,亦可讓 App 決定付款資訊。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Web_Activities" title="WebAPI/Web_Activities">Web Activities</a> {{NonStandardBadge}}</dt>
 <dd>讓 App 可委派某個 Activity 給其他 App。舉例來說,XX App 可能要求 YY App 選擇並回傳相片。使用者一般均可設定 Activity 所應搭配使用的  App。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Browser" title="DOM/Using_the_Browser_API"><strong>Browser API</strong></a> {{NonStandardBadge}}</dt>
 <dd>完全透過 Web 技術,支援建構 Web 瀏覽器 (可說是瀏覽器中再建構出瀏覽器)。</dd>
</dl>

<dl>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Idle" title="WebAPI/Device_Storage_API">Idle API</a></dt>
 <dd>使用者並未使用裝置時,讓 App 接收通知。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Permissions" title="WebAPI/Permissions">Permissions API</a> {{NonStandardBadge}}</dt>
 <dd>集中管理 App 的權限 (Permission)。由設定類 (Settings) 的 App 所使用。</dd>
 <dt><a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Time_and_Clock" title="WebAPI/Time_and_Clock">Time/Clock API</a> {{NonStandardBadge}}</dt>
 <dd>可設定目前時間。另透過 <a href="https://developer.mozilla.org/zh-TW/docs/WebAPI/Settings" title="WebAPI/Settings">Settings API</a> 設定時區。</dd>
</dl>

<h2 class="Community" id="Community" name="Community">WebAPI 社群</h2>

<p>如果需要這些 API 的相關協助,則有許多方法可諮詢其他開發人員。</p>

<ul>
 <li>在 WebAPI 討論區中提出問題: {{DiscussionList("dev-webapi", "mozilla.dev.webapi")}}</li>
 <li>到 WebAPI IRC channel 逛逛:<a href="irc://irc.mozilla.org/webapi" title="irc://irc.mozilla.org/webapi">#webapi</a></li>
</ul>

<p><span class="alllinks"><a href="http://www.catb.org/~esr/faqs/smart-questions.html" title="http://www.catb.org/~esr/faqs/smart-questions.html">Don't forget about the <em>netiquette</em>...</a></span></p>

<h2 class="Related_Topics" id="Related_Topics" name="Related_Topics">相關主題</h2>

<ul>
 <li>The <a href="/en-US/docs/Document_Object_Model_(DOM)" title="Document Object Model (DOM)">Document Object Model (DOM)</a> is the representation of an HTML document as a tree.</li>
 <li><a href="/en-US/docs/JavaScript" title="JavaScript">JavaScript</a> - Scripting language for the Web.</li>
 <li><a href="/en-US/docs/WebAPI/Doc_status" title="WebAPI/Doc_status">Doc status</a>: A list of WebAPI topics and their documentation status.</li>
</ul>
</div>
</div>

<p> </p>