org.apache.cordova.device-orientation

이 플러그인 디바이스의 나침반에 대 한 액세스를 제공합니다. 나침반 방향 또는 표제는 장치 지적 이다, 일반적으로 장치 위에서 감지 하는 센서입니다. 359.99, 0가 북쪽을 0에서도에서 머리글을 측정 합니다.

설치

cordova plugin add org.apache.cordova.device-orientation

지원 되는 플랫폼

  • 아마존 화재 운영 체제
  • 안 드 로이드
  • 블랙베리 10
  • 브라우저
  • Firefox 운영 체제
  • iOS
  • Tizen
  • Windows Phone 7, 8 (사용 가능한 경우 하드웨어)
  • 윈도우 8

메서드

  • navigator.compass.getCurrentHeading
  • navigator.compass.watchHeading
  • navigator.compass.clearWatch

navigator.compass.getCurrentHeading

현재 나침반 제목 좀. 나침의 표제를 통해 반환 되는 CompassHeading 개체를 사용 하는 compassSuccess 콜백 함수.

navigator.compass.getCurrentHeading (compassSuccess, compassError);

예를 들어

function onSuccess(heading) {
    alert('Heading: ' + heading.magneticHeading);
};

function onError(error) {
    alert('CompassError: ' + error.code);
};

navigator.compass.getCurrentHeading(onSuccess, onError);

navigator.compass.watchHeading

정기적 장치의 현재 머리글을 가져옵니다. 제목 검색 때마다는 headingSuccess 콜백 함수를 실행 합니다.

반환 된 시계 ID 나침반 시계 간격을 참조합니다. ID와 함께 사용 될 수 있습니다 시계 navigator.compass.clearWatch 는 navigator.compass를 보고 그만.

var watchID = navigator.compass.watchHeading(compassSuccess, compassError, [compassOptions]);

compassOptions다음 키를 포함할 수 있습니다.

  • 주파수: 자주 밀리초에서 나침반 머리글을 검색 하는 방법. (수) (기본값: 100)
  • 필터:도 watchHeading 성공 콜백을 시작 하는 데 필요한 변경. 이 값을 설정 하는 경우 주파수 는 무시 됩니다. (수)

예를 들어

function onSuccess(heading) {
    var element = document.getElementById('heading');
    element.innerHTML = 'Heading: ' + heading.magneticHeading;
};

function onError(compassError) {
    alert('Compass error: ' + compassError.code);
};

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

var watchID = navigator.compass.watchHeading(onSuccess, onError, options);

브라우저 만지면

현재 제목에 대 한 값은 나침반을 시뮬레이션 하기 위해 임의로 생성 됩니다.

iOS 단점

단 하나 watchHeading iOS에서 한 번에 적용에서 될 수 있습니다. 경우는 watchHeading 필터를 사용 하 여 호출 getCurrentHeading 또는 watchHeading 기존 필터 값을 사용 하 여 제목 변화를 지정 합니다. 필터와 제목 변화를 보고 시간을 간격으로 보다 더 효율적입니다.

아마존 화재 OS 단점

  • filter지원 되지 않습니다.

안 드 로이드 단점

  • 대 한 지원filter.

파이어 폭스 OS 단점

  • 대 한 지원filter.

Tizen 특수

  • 대 한 지원filter.

Windows Phone 7, 8 특수

  • 대 한 지원filter.

navigator.compass.clearWatch

시계 ID 매개 변수에서 참조 하는 나침반을 보고 중지 합니다.

navigator.compass.clearWatch(watchID);
  • watchID: ID 반환navigator.compass.watchHeading.

예를 들어

var watchID = navigator.compass.watchHeading(onSuccess, onError, options);

// ... later on ...

navigator.compass.clearWatch(watchID);

CompassHeading

A CompassHeading 개체에 반환 되는 compassSuccess 콜백 함수.

속성

  • magneticHeading: 단일 시점에서 0-359.99에서도 제목. (수)

  • trueHeading: 단일 시점에서 0-359.99에서에서 지리적 북극을 기준으로 향하고. 음수 값을 나타냅니다 진정한 표제를 확인할 수 없습니다. (수)

  • headingAccuracy: 보고 된 머리글 사이의 진정한 제목도 편차. (수)

  • 타임 스탬프:이 제목 결정 하는 시간. (밀리초)

아마존 화재 OS 단점

  • trueHeading지원 되지 않습니다 하지만 같은 값으로 보고magneticHeading

  • headingAccuracy항상 0 사이 차이가 있기 때문에 magneticHeading 와trueHeading

안 드 로이드 단점

  • trueHeading속성은 지원 되지 않습니다 하지만 같은 값으로 보고magneticHeading.

  • headingAccuracy속성은 항상 0 사이 차이가 있기 때문에 magneticHeading 와trueHeading.

파이어 폭스 OS 단점

  • trueHeading속성은 지원 되지 않습니다 하지만 같은 값으로 보고magneticHeading.

  • headingAccuracy속성은 항상 0 사이 차이가 있기 때문에 magneticHeading 와trueHeading.

iOS 단점

  • trueHeading속성을 통해 위치 서비스에 대 한 반환만navigator.geolocation.watchLocation().

  • IOS 4 장치에 대 한 위의 제목 소자의 현재 방향에서 요인 그리고, 그 방향을 지 원하는 애플 리 케이 션에 대 한 그것의 절대 위치를 참조 하지 않습니다.

CompassError

A CompassError 개체에 반환 됩니다는 compassError 콜백 함수 오류가 발생 합니다.

속성

  • 코드: 미리 정의 된 오류 코드 중 하나가 아래에 나열 된.

상수

  • CompassError.COMPASS_INTERNAL_ERR
  • CompassError.COMPASS_NOT_SUPPORTED