aboutsummaryrefslogtreecommitdiff
path: root/files/zh-tw/web/api/devicemotionevent/index.html
blob: 03a8d593c6ed0e40320c62c3b2d9bee6bc311783 (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
---
title: DeviceMotionEvent
slug: Web/API/DeviceMotionEvent
translation_of: Web/API/DeviceMotionEvent
---
<p>{{apiref("Device Orientation Events")}}{{SeeCompatTable}}</p>

<h2 id="概要">概要</h2>

<p><code>DeviceMotionEvent</code> 提供了網頁開發者關於裝置位置及旋轉方向改變時的速度資訊。</p>

<div class="warning">
<p><strong>Warning:</strong> Currently, Firefox and Chrome does not handle the coordinates the same way. Take care about this while using them.</p>
</div>

<h2 id="屬性">屬性</h2>

<dl>
 <dt>{{domxref("DeviceMotionEvent.acceleration")}} {{readonlyinline}}</dt>
 <dd>An object giving the acceleration of the device on the three axis X, Y and Z. Acceleration is expressed in <a href="https://en.wikipedia.org/wiki/Meter_per_second_squared" title="https://en.wikipedia.org/wiki/Meter_per_second_squared">m/s<sup>2</sup></a>.</dd>
 <dt>{{domxref("DeviceMotionEvent.accelerationIncludingGravity")}} {{readonlyinline}}</dt>
 <dd>An object giving the acceleration of the device on the three axis X, Y and Z with the effect of gravity. Acceleration is expressed in <a href="https://en.wikipedia.org/wiki/Meter_per_second_squared" title="https://en.wikipedia.org/wiki/Meter_per_second_squared">m/s<sup>2</sup></a>.</dd>
 <dt>{{domxref("DeviceMotionEvent.rotationRate")}} {{readonlyinline}}</dt>
 <dd>An object giving the rate of change of the device's orientation on the three orientation axis alpha, beta and gamma. Rotation rate is express in degrees per seconds.</dd>
 <dt>{{domxref("DeviceMotionEvent.interval")}} {{readonlyinline}}</dt>
 <dd>A number representing the interval of time, in milliseconds, at which data is obtained from the device.</dd>
</dl>

<h2 id="範例">範例</h2>

<pre class="brush: js">window.addEventListener('devicemotion', function(event) {
  console.log(event.acceleration.x + ' m/s2');
});</pre>

<h2 id="規範">規範</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">Specification</th>
   <th scope="col">Status</th>
   <th scope="col">Comment</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('Device Orientation')}}</td>
   <td>{{Spec2('Device Orientation')}}</td>
   <td>Initial specification.</td>
  </tr>
 </tbody>
</table>

<h2 id="瀏覽器相容性">瀏覽器相容性</h2>

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

<h2 id="參見">參見</h2>

<ul>
 <li>{{ event("deviceorientation") }}</li>
 <li>{{ domxref("DeviceMotionEvent") }}</li>
 <li>{{ event("devicemotion") }}</li>
 <li><a href="/en-US/docs/WebAPI/Detecting_device_orientation" title="/en-US/docs/WebAPI/Detecting_device_orientation">Detecting device orientation</a></li>
 <li><a href="https://developer.mozilla.org/en/DOM/Orientation_and_motion_data_explained" title="Orientation and motion data explained">Orientation and motion data explained</a></li>
</ul>