가 속도계

X, y및 z 방향에서 장치 동작을 캡처합니다.

메서드

• accelerometer.getCurrentAcceleration
• accelerometer.watchAcceleration
• accelerometer.clearWatch

인수

• accelerometerSuccess
• accelerometerError
• accelerometerOptions

(읽기 전용) 개체

• 가속

기능 액세스

버전 3.0, 코르도바 플러그인으로 장치 수준 Api를 구현합니다. CLI의 사용 plugin 명령 설명에 명령줄 인터페이스를 추가 하거나 프로젝트에 대 한이 기능을 제거 하려면:

    $ cordova plugin add https://git-wip-us.apache.org/repos/asf/cordova-plugin-device-motion.git
    $ cordova plugin rm org.apache.cordova.core.device-motion

이 명령은 모든 타겟된 플랫폼에 적용 하지만 플랫폼 관련 구성 설정을 아래에 설명 된 수정:

• (안 드 로이드app/res/xml/config.xml)

  <feature name="Accelerometer">
      <param name="android-package" value="org.apache.cordova.AccelListener" />
  </feature>
  

• 블랙베리 WebWorks

  (in www/plugins.xml)
  <feature name="Accelerometer">
      <param name="blackberry-package" value="org.apache.cordova.accelerometer.Accelerometer" />
  </feature>
  
  
  (in www/config.xml)
  <feature id="blackberry.system"  required="true" version="1.0.0.0" />
  <feature id="org.apache.cordova" required="true" version="1.0.0" />
  

• (iOSconfig.xml)

  <feature name="Accelerometer">
      <param name="ios-package" value="CDVAccelerometer" />
  </feature>
  

• (Windows PhoneProperties/WPAppManifest.xml)

  <Capabilities>
      <Capability Name="ID_CAP_SENSORS" />
  </Capabilities>
  

  참고: Windows Phone 대 한 응용 프로그램 매니페스트

일부 플랫폼은 특별 한 구성이 필요 없이이 기능을 지원할 수 있습니다. 플랫폼 지원에 대 한 참조.

---

accelerometer.getCurrentAcceleration

X, y및 z 축 따라 현재 가속도 얻을.

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

설명

가 속도계 3 차원 x, y및 z 축 따라 현재 장치 방향 기준으로 이동 (델타) 변경 내용을 감지 하는 모션 센서입니다.

이 가속도 값에 반환 되는 accelerometerSuccess 콜백 함수.

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8
• 윈도우 8

빠른 예제

function onSuccess(acceleration) {
    alert('Acceleration X: ' + acceleration.x + '\n' +
          'Acceleration Y: ' + acceleration.y + '\n' +
          'Acceleration Z: ' + acceleration.z + '\n' +
          'Timestamp: '      + acceleration.timestamp + '\n');
};

function onError() {
    alert('onError!');
};

navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Acceleration Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
    }

    // onSuccess: Get a snapshot of the current acceleration
    //
    function onSuccess(acceleration) {
        alert('Acceleration X: ' + acceleration.x + '\n' +
              'Acceleration Y: ' + acceleration.y + '\n' +
              'Acceleration Z: ' + acceleration.z + '\n' +
              'Timestamp: '      + acceleration.timestamp + '\n');
    }

    // onError: Failed to get the acceleration
    //
    function onError() {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>getCurrentAcceleration</p>
  </body>
</html>

iOS 단점

• iOS는 어떤 주어진된 시점에서 현재 가속도의 개념을 인식 하지 못합니다.

• 가속을 감시 하며 데이터 캡처에 주어진 시간 간격.

• 따라서,는 getCurrentAcceleration 에서 보고 된 마지막 값을 생성 하는 함수는 watchAccelerometer 전화.

---

accelerometer.watchAcceleration

정기적, x, y및 z 축 따라 가속도 얻을.

var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
                                                       accelerometerError,
                                                       [accelerometerOptions]);

설명

가 속도계는 현재 위치를 기준으로 운동 (델타) 변경 내용을 감지 하는 모션 센서입니다. 가 속도계는 x, y및 z 축을 따라 3D 이동을 검색할 수 있습니다.

accelerometer.watchAcceleration메서드는 장치의 현재 검색 Acceleration 일정 한 간격에 실행는 accelerometerSuccess 콜백 함수 때마다. 통해 밀리초 단위로 간격을 지정 된 acceleratorOptions 개체의 frequency 매개 변수.

반환 된 ID 참조가 속도계의 시계 간격, 시청과 함께 사용할 수 있습니다 accelerometer.clearWatch 가 속도계를 보고 중지 합니다.

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8
• 윈도우 8

빠른 예제

function onSuccess(acceleration) {
    alert('Acceleration X: ' + acceleration.x + '\n' +
          'Acceleration Y: ' + acceleration.y + '\n' +
          'Acceleration Z: ' + acceleration.z + '\n' +
          'Timestamp: '      + acceleration.timestamp + '\n');
};

function onError() {
    alert('onError!');
};

var options = { frequency: 3000 };  // Update every 3 seconds

var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Acceleration Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // The watch id references the current `watchAcceleration`
    var watchID = null;

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        startWatch();
    }

    // Start watching the acceleration
    //
    function startWatch() {

        // Update acceleration every 3 seconds
        var options = { frequency: 3000 };

        watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
    }

    // Stop watching the acceleration
    //
    function stopWatch() {
        if (watchID) {
            navigator.accelerometer.clearWatch(watchID);
            watchID = null;
        }
    }

    // onSuccess: Get a snapshot of the current acceleration
    //
    function onSuccess(acceleration) {
        var element = document.getElementById('accelerometer');
        element.innerHTML = 'Acceleration X: ' + acceleration.x         + '<br />' +
                            'Acceleration Y: ' + acceleration.y         + '<br />' +
                            'Acceleration Z: ' + acceleration.z         + '<br />' +
                            'Timestamp: '      + acceleration.timestamp + '<br />';
    }

    // onError: Failed to get the acceleration
    //
    function onError() {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <div id="accelerometer">Waiting for accelerometer...</div>
  </body>
</html>

iOS 단점

API 요청 간격 성공 콜백 함수를 호출 하지만 40ms 사이 장치에 요청의 범위를 제한 하 고 1000ms. 예를 들어 (3000ms) 3 초의 간격을 요청 하는 경우 API 마다 1 초 장치에서 데이터를 요청 하지만 성공 콜백을 3 초 마다 실행 됩니다.

---

accelerometer.clearWatch

보고 중지는 Acceleration 에 의해 참조 되는 watchID 매개 변수.

navigator.accelerometer.clearWatch(watchID);

• watchID: ID 반환accelerometer.watchAcceleration.

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8
• 윈도우 8

빠른 예제

var watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);

// ... later on ...

navigator.accelerometer.clearWatch(watchID);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Acceleration Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // The watch id references the current `watchAcceleration`
    var watchID = null;

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        startWatch();
    }

    // Start watching the acceleration
    //
    function startWatch() {

        // Update acceleration every 3 seconds
        var options = { frequency: 3000 };

        watchID = navigator.accelerometer.watchAcceleration(onSuccess, onError, options);
    }

    // Stop watching the acceleration
    //
    function stopWatch() {
        if (watchID) {
            navigator.accelerometer.clearWatch(watchID);
            watchID = null;
        }
    }

    // onSuccess: Get a snapshot of the current acceleration
    //
    function onSuccess(acceleration) {
        var element = document.getElementById('accelerometer');

        element.innerHTML = 'Acceleration X: ' + acceleration.x + '<br />' +
                            'Acceleration Y: ' + acceleration.y + '<br />' +
                            'Acceleration Z: ' + acceleration.z + '<br />' +
                            'Timestamp: '      + acceleration.timestamp + '<br />';
    }

    // onError: Failed to get the acceleration
    //
    function onError() {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <div id="accelerometer">Waiting for accelerometer...</div>
        <button onclick="stopWatch();">Stop Watching</button>
  </body>
</html>

---

가속

포함 Accelerometer 특정 시점에 캡처된 데이터가.

속성

• x: x 축에 가속의 금액. (m/s에서 ^2) (수)
• y: y 축에 가속의 금액. (m/s에서 ^2) (수)
• z: z 축의 가속도의 금액. (m/s에서 ^2) (수)
• 타임 스탬프: 생성 타임 스탬프 (밀리초)입니다. (DOMTimeStamp)

설명

Acceleration개체 채워집니다 및 API에 의해 반환 된 Accelerometer 방법. 가속도 값 포함 중력의 효과 (9.81 m/s ^2) 때 장치 거짓말 평평 하 고 x, y, 최대 직면 하 고 z 값 반환 되어야 합니다 있도록, , , 그리고9.81.

지원 되는 플랫폼

• 안 드 로이드
• 블랙베리 WebWorks (운영 체제 5.0와 더 높은)
• iOS
• Tizen
• Windows Phone 7과 8
• 윈도우 8

빠른 예제

function onSuccess(acceleration) {
    alert('Acceleration X: ' + acceleration.x + '\n' +
          'Acceleration Y: ' + acceleration.y + '\n' +
          'Acceleration Z: ' + acceleration.z + '\n' +
          'Timestamp: '      + acceleration.timestamp + '\n');
};

function onError() {
    alert('onError!');
};

navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);

전체 예제

<!DOCTYPE html>
<html>
  <head>
    <title>Acceleration Example</title>

    <script type="text/javascript" charset="utf-8" src="cordova.js"></script>
    <script type="text/javascript" charset="utf-8">

    // Wait for device API libraries to load
    //
    document.addEventListener("deviceready", onDeviceReady, false);

    // device APIs are available
    //
    function onDeviceReady() {
        navigator.accelerometer.getCurrentAcceleration(onSuccess, onError);
    }

    // onSuccess: Get a snapshot of the current acceleration
    //
    function onSuccess(acceleration) {
        alert('Acceleration X: ' + acceleration.x + '\n' +
              'Acceleration Y: ' + acceleration.y + '\n' +
              'Acceleration Z: ' + acceleration.z + '\n' +
              'Timestamp: '      + acceleration.timestamp + '\n');
    }

    // onError: Failed to get the acceleration
    //
    function onError() {
        alert('onError!');
    }

    </script>
  </head>
  <body>
    <h1>Example</h1>
    <p>getCurrentAcceleration</p>
  </body>
</html>

---

accelerometerSuccess

onSuccess 콜백 함수를 제공 하는 Acceleration 정보.

function(acceleration) {
    // Do something
}

매개 변수

• 가속: 단일 시점에서 가속. (가속도)

예를 들어

function onSuccess(acceleration) {
    alert('Acceleration X: ' + acceleration.x + '\n' +
          'Acceleration Y: ' + acceleration.y + '\n' +
          'Acceleration Z: ' + acceleration.z + '\n' +
          'Timestamp: '      + acceleration.timestamp + '\n');
};

---

accelerometerError

가속 기능에 대 한 onError 콜백 함수입니다.

function() {
    // Handle the error
}

---

accelerometerOptions

가 속도계 값의 검색을 사용자 지정 하는 선택적 매개 변수.

옵션

• 주파수: 검색 하는 Acceleration (밀리초)입니다. (수) (기본: 10000)