tree: f39596b2ae9c88f7328e74ffb9c1a4f5632cc0a3 [path history] [tgz]
  1. index.md
  2. README.md
doc/pl/README.md

cordova-plugin-device-motion

Build Status

Ten plugin umożliwia dostęp do akcelerometru. Akcelerometr jest czujnikiem ruchu, który wykrywa zmiany (delta) w ruchu względem bieżącej orientacji urządzenia, w trzech wymiarach na osi x, yi z .

Dostęp odbywa się za pomocą obiektu globalnego navigator.accelerometer.

Mimo, że obiekt jest dołączony do globalnego zakresu navigator, to nie dostępne dopiero po zdarzeniu deviceready.

document.addEventListener("deviceready", onDeviceReady, false);
function onDeviceReady() {
    console.log(navigator.accelerometer);
}

Instalacja

cordova plugin add cordova-plugin-device-motion

Obsługiwane platformy

  • Amazon Fire OS
  • Android
  • BlackBerry 10
  • Przeglądarka
  • Firefox OS
  • iOS
  • Tizen
  • Windows Phone 8
  • Windows

Metody

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

Obiekty

  • Acceleration

navigator.accelerometer.getCurrentAcceleration

Uzyskać aktualne przyspieszenie wzdłuż osi x, y i z.

Te wartości przyspieszenia są zwracane do funkcji wywołania zwrotnego accelerometerSuccess.

navigator.accelerometer.getCurrentAcceleration(accelerometerSuccess, accelerometerError);

Przykład

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);

Quirks przeglądarki

Wartości dla osi X, Y, Z ruchu są losowo generowane w celu symulacji akcelerometr.

Dziwactwa iOS

  • W iOS nie wprowadzono możliwości zmierzenia aktualnego przyspieszenia w dowolnym punkcie.

  • Musisz obserwować przyspieszenie i odbierać wyniki w określonych odstępach czasu.

  • Podsumowując, funkcja getCurrentAcceleration zwraca ostatnią wartość zgłoszoną przez wywołanie watchAccelerometer.

navigator.accelerometer.watchAcceleration

Pobiera bieżącego urządzenia Acceleration w regularnych odstępach czasu, wykonywanie funkcji wywołania zwrotnego accelerometerSuccess każdorazowe. Określ interwał w milisekundach przez parametr obiektu acceleratorOptions frequency.

Identyfikator zwrócony zegarek odwołuje akcelerometr zegarek interwał i może być używany z navigator.accelerometer.clearWatch, aby zatrzymać obejrzeniu akcelerometru.

var watchID = navigator.accelerometer.watchAcceleration(accelerometerSuccess,
                                                       accelerometerError,
                                                       accelerometerOptions);
  • accelerometerOptions: Obiekt z następującymi opcjonalnymi kluczami:
    • okres: żądany okres wzywa do accelerometerSuccess z danych przyspieszenia w milisekundach. (Liczba) (Domyślnie: 10000)

Przykład

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);

Dziwactwa iOS

Interfejs API wymaga sukcesu funkcji wywołania zwrotnego w interwał żądana, ale ogranicza zakres żądania do urządzenia między 40ms i 1000ms. Na przykład jeśli poprosisz o odstępie 3 sekundy (3000ms), interfejs API żądania danych z urządzenia co 1 sekundę, ale tylko wykonuje wywołanie zwrotne sukces co 3 sekundy.

navigator.accelerometer.clearWatch

Przestać oglądać Acceleration określany przez parametr watchID.

navigator.accelerometer.clearWatch(watchID);
  • watchID: Identyfikator zwrócony przez navigator.accelerometer.watchAcceleration.

Przykład

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

// ... later on ...

navigator.accelerometer.clearWatch(watchID);

Acceleration

Zawiera Accelerometer dane przechwycone w określonym czasie. Wartości przyśpieszenia to efekt grawitacji (9.81 m/s ^ 2), tak, że kiedy urządzenie znajduje się płaska i górę, x, y, i z wartości zwracane powinno być , i 9.81.

Właściwości

  • x: Wartość przyśpieszenia na osi x. (w m/s^2) (Liczba)
  • y: Wartość przyśpieszenia na osi y. (w m/s^2) (Liczba)
  • z: Wartość przyśpieszenia na osi z. (w m/s^2) (Liczba)
  • timestamp: Znacznik czasu w milisekundach. (DOMTimeStamp)