From 33058f2b292b3a581333bdfb21b8f671898c5060 Mon Sep 17 00:00:00 2001 From: Peter Bengtsson Date: Tue, 8 Dec 2020 14:40:17 -0500 Subject: initial commit --- files/ja/webapi/index.html | 124 ++++++++++++++++++++++++++ files/ja/webapi/proximity/index.html | 84 +++++++++++++++++ files/ja/webapi/using_light_events/index.html | 68 ++++++++++++++ 3 files changed, 276 insertions(+) create mode 100644 files/ja/webapi/index.html create mode 100644 files/ja/webapi/proximity/index.html create mode 100644 files/ja/webapi/using_light_events/index.html (limited to 'files/ja/webapi') diff --git a/files/ja/webapi/index.html b/files/ja/webapi/index.html new file mode 100644 index 0000000000..61f1e648a6 --- /dev/null +++ b/files/ja/webapi/index.html @@ -0,0 +1,124 @@ +--- +title: WebAPI +slug: WebAPI +tags: + - Apps + - DOM + - Firefox OS + - Mobile +translation_of: Web/API +--- +

WebAPI はデバイス間の互換性を提供する機能一式であり、Web アプリやコンテンツがデバイスに保存されているデータ (カレンダーや連絡先など) やデバイスハードウェア (バッテリーの状態やデバイスのバイブレーションハードウェアなど) へアクセスできるようにする API を指す用語です。これらの API を追加することにより今日の Web ができることを増やすとともに、従来はプロプライエタリなプラットフォームでしかできなかったことに広がることを望んでいます。

+ +
+

注記: 各バッジの簡単な説明については、パッケージ型アプリのドキュメントをご覧ください。

+
+ +
+
+

コミュニケーション API

+ +
+
Network Information API
+
接続速度など、現在のネットワーク接続に関する基本的な情報を提供します。
+
Bluetooth {{NonStandardBadge}}
+
WebBluetooth API は、デバイスのBluetooth ハードウェアに対する低水準のアクセス手段を提供します。
+
Mobile Connection API {{NonStandardBadge}}
+
信号強度やオペレーター情報など、デバイスのセルラー接続に関する情報を公開します。
+
Network Stats API {{NonStandardBadge}}
+
データの使用状況をモニタリングして、そのデータを特権アプリケーションに公開します。
+
Telephony {{NonStandardBadge}}
+
アプリが電話を発着信したり、内蔵の電話機能のユーザインターフェイスを使用したりすることが可能です。
+
WebSMS {{NonStandardBadge}}
+
アプリに対して、デバイスに保存しているメッセージのアクセスや管理だけでなく、SMS テキストメッセージの送受信を可能にします。
+
WiFi Information API {{NonStandardBadge}}
+
信号強度、現在接続しているネットワークの名称、利用可能な WiFi ネットワークなどの情報を提供する特権 API です。
+
+ +

ハードウェアアクセス API

+ +
+
Ambient Light Sensor API
+
環境光センサーへのアクセス手段を提供します。これにより、アプリがデバイス付近の環境光のレベルを検出できます。
+
Battery Status API
+
バッテリーの残量や、デバイスが電源に接続されて充電中であるかといった情報を提供します。
+
Geolocation API
+
デバイスの物理的な位置に関する情報を提供します。
+
Pointer Lock API
+
アプリがマウスへのアクセスをロックして、絶対座標ではなく移動量の差分にアクセスできます。これはゲームに対して重要です。
+
Proximity API
+
ユーザの顔など、近くにある物体とデバイスとの近接度を検出できます。
+
Device Orientation API
+
デバイスの向きが変化したときに通知します。
+
Screen Orientation API
+
スクリーンの向きが変化したときに通知します。この API は、アプリにとってどの向きが望ましいかを示すことにも使用できます。
+
Vibration API
+
ゲームでの触覚フィードバックなどのために、アプリがデバイスのバイブレーションハードウェアを制御できます。これは通知のためのバイブレーションといった用途向けではありません。通知については Alarm API をご覧ください。
+
Camera API {{NonStandardBadge}}
+
デバイス内蔵のカメラを使用して、アプリが写真や動画を撮影できます。
+
Power Management API {{NonStandardBadge}}
+
アプリがスクリーン、CPU、デバイスの電源などをオン・オフできるようにします。また、リソースロックイベントのリスニングや調査もサポートします。
+
+ +

すべて見る...

+
+ +
+

データ管理 API

+ +
+
FileHandle API {{NonStandardBadge}}
+
ロック機能とともに、書き込み可能なファイルをサポートします。
+
IndexedDB
+
パフォーマンスが高い検索機能をサポートする、クライアントサイドの構造化データ用ストレージです。
+
Settings API {{NonStandardBadge}}
+
デバイスへ永続的に保存されるシステム全体の設定オプションを、アプリが調査したり変更したりすることが可能です。
+
+ +

その他の API

+ +
+
Alarm API
+
アプリが通知を予定することが可能です。特定の時刻にアプリを自動起動する機能もサポートします。
+
Simple Push API
+
プラットフォームが特定のアプリケーションに通知メッセージを送信できます。
+
Web Notifications
+
アプリケーションが、システムレベルで表示される通知を送信できます。
+
Apps API {{NonStandardBadge}}
+
Open WebApps API は、Web アプリのインストールや管理をサポートします。また、アプリが課金情報を調べることを可能にします。
+
Web Activities {{NonStandardBadge}}
+
あるアプリが別のアプリにアクティビティを渡すことができます。例えばあるアプリが別のアプリに対して、写真を選択 (または作成) して返すように依頼するでしょう。一般的に、ユーザはどのアクティビティにどのアプリを使用するかを設定できます。
+
WebPayment API {{NonStandardBadge}}
+
Web コンテンツが、仮想的な物品に対する支払いや払い戻しの処理を開始できます。
+
Browser API {{NonStandardBadge}}
+
Web 技術を完全に使用する Web ブラウザの構築をサポートします (要するに、ブラウザの中にあるブラウザです)。
+
Idle API
+
ユーザが能動的にデバイスを使用していないときに、アプリが通知を受け取れます。
+
Permissions API {{NonStandardBadge}}
+
集中化された場所で、アプリの許可設定を管理します。設定アプリで使用されます。
+
Time/Clock API {{NonStandardBadge}}
+
現在時刻の設定をサポートします。タイムゾーンは Settings API で設定します。
+
+ +

WebAPI コミュニティ

+ +

これらの API について支援が必要になったとしても、それらの使用方法について他の開発者と語る手段がいくつかあります。

+ +
    +
  • WebAPI フォーラムで相談する: {{DiscussionList("dev-webapi", "mozilla.dev.webapi")}}
    • +
  • WebAPI IRC チャンネルを訪問する: #webapi
    • +
+ +

ネチケットを忘れないでください...

+ + + +
    +
  • Document Object Model (DOM) は、HTML ドキュメントをツリーとして表現するものです。
    • +
  • JavaScript - Web 向けのスクリプト言語です。
    • +
  • Doc status: WebAPI のトピック一覧と、それらのドキュメント化の状況です。
    • +
+
+
+ +

 

diff --git a/files/ja/webapi/proximity/index.html b/files/ja/webapi/proximity/index.html new file mode 100644 index 0000000000..633d2a7cfb --- /dev/null +++ b/files/ja/webapi/proximity/index.html @@ -0,0 +1,84 @@ +--- +title: Proximity Events +slug: WebAPI/Proximity +tags: + - API + - Experimental + - Proximity Events + - Reference +translation_of: Web/API/Proximity_Events +--- +

{{DefaultAPISidebar("Proximity Events")}}{{ SeeCompatTable }}

+ +

proximity events は、ユーザーが端末の近くにいるときを知るのに便利な手段です。これらのイベントは近接度の変化への対応、例えばユーザーがスマートフォンを耳の近くに持ってきて電話をしているときにスクリーンを休止することを可能にします。

+ +
+

メモ: この API は端末に近接センサーを必要とすることが明らかです。近接センサーは、たいていモバイル端末のみで使用できます。センサーを搭載していない端末もイベントをサポートするかもしれませんが、イベントは発生しません。

+
+ +

Proximity Event

+ +

端末の近接センサーが端末と物体との距離の変化を検出すると、それをブラウザーに通知します。ブラウザーが通知を受けると、あらゆる変化について {{domxref("DeviceProximityEvent")}} イベントが、またよりおおざっぱな変化の場合に {{domxref("UserProximityEvent")}} イベントが発生します。

+ +

このイベントは {{domxref("EventTarget.addEventListener","addEventListener")}} メソッド (イベント名 {{event("deviceproximity")}} または {{event("userproximity")}} を使用) を使用するか、イベントハンドラーを {{domxref("window.ondeviceproximity")}} プロパティまたは {{domxref("window.onuserproximity")}} プロパティに接続することにより、window オブジェクトレベルで取得できます。

+ +

イベントを取得すると、イベントオブジェクトでさまざまな種類の情報にアクセスできます。

+ + + +

例

+ +
window.addEventListener('userproximity', function(event) {
+  if (event.near) {
+    // スクリーンの電源を切る
+    navigator.mozPower.screenEnabled = false;
+  } else {
+    // スクリーンの電源を入れる
+    navigator.mozPower.screenEnabled = true;
+  }
+});
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName('Proximity Events', '', 'Proximity Events')}}{{Spec2('Proximity Events')}}初回定義
+ +

ブラウザーの対応

+ +

DeviceProximityEvent

+ + + +

{{Compat("api.DeviceProximityEvent")}}

+ +

UserProximityEvent

+ + + +

{{Compat("api.UserProximityEvent")}}

+ +

関連情報

+ + diff --git a/files/ja/webapi/using_light_events/index.html b/files/ja/webapi/using_light_events/index.html new file mode 100644 index 0000000000..be70ad2612 --- /dev/null +++ b/files/ja/webapi/using_light_events/index.html @@ -0,0 +1,68 @@ +--- +title: Ambient Light Events +slug: WebAPI/Using_Light_Events +tags: + - Ambient Light +translation_of: Web/API/Ambient_Light_Events +--- +
{{DefaultAPISidebar("Ambient Light Events")}}{{SeeCompatTable}}
+ +

ambient light event は、光の強さの変化をウェブページやアプリケーションに気づかせるのに便利な手段です。これによりユーザーインターフェイスのコントラストを変えたり写真を撮るために必要な露出時間を変えたりするなど、ウェブページやアプリケーションが光量の変化に対応できるようになります。

+ +

Light Event

+ +

端末の光センサーが光量の変化を検出すると、それをブラウザーに通知します。ブラウザーがその通知を受け取ると、正確な光の強度に関する情報を提供する {{domxref("DeviceLightEvent")}} イベントを発生させます。

+ +

このイベントは {{domxref("EventTarget.addEventListener","addEventListener")}} メソッド (イベント名 {{event("devicelight")}} を使用) を使用するか、イベントハンドラーを {{domxref("window.ondevicelight")}} プロパティに接続することにより、 window オブジェクトレベルで取得できます。

+ +

イベントを取得するとイベントオブジェクトの {{domxref("DeviceLightEvent.value")}} プロパティを通して、{{interwiki("wikipedia", "ルクス")}}で表した照度にアクセスできます。

+ +

例

+ +
if ('ondevicelight' in window) {
+  window.addEventListener('devicelight', function(event) {
+    var body = document.querySelector('body');
+    if (event.value < 50) {
+      body.classList.add('darklight');
+      body.classList.remove('brightlight');
+    } else {
+      body.classList.add('brightlight');
+      body.classList.remove('darklight');
+    }
+  });
+} else {
+  console.log('devicelight event not supported');
+}
+
+ +

仕様書

+ + + + + + + + + + + + + + + + +
仕様書状態備考
{{SpecName("AmbientLight", "", "Ambient Light Events")}}{{Spec2("AmbientLight")}}初回定義
+ +

ブラウザーの対応

+ + + +

{{Compat("api.DeviceLightEvent")}}

+ +

関連情報

+ + -- cgit v1.2.3-54-g00ecf