이 API는 단말의 방향계 정보를 제공합니다. 방향계 센서는 단말의 회전 방향 정보를 세 종류의 축으로 나누어 제공하는 센서입니다.각 축은 accelerometer 모듈과 동일하게 사용됩니다.
x축: x축은 스크린에 수평이며 오른쪽을 향해 양수입니다.
y축: y축은 스크린에 수평이며 상단을 향해 양수입니다.
z축: z축은 스크린에 수직이며 위쪽으로 양수입니다.각 축에서 제공하는 정보는 다음과 같습니다.
• Alpha (또는 azimuth) : Alpha는 z축을 중심으로 자북 방향과 장치의 y축 사이의 회전각입니다. 반 시계 방향으로 각도 단위로 측정되며 0과 360 사이의 값입니다.
• Beta (또는 pitch) : Beta는 단말이 스크린을 위로 하여 평면에 놓여 있을 때 x축을 중심으로 y축과 장치의 y축 사이의 회전각입니다. 반 시계 방향으로 각도 단위로 측정되며 -180과 180 사이의 값입니다.
• Gamma (또는 roll) : Gamma는 단말이 스크린을 위로 하여 평면에 놓여 있을 때 단말의 y축을 중심으로 x축과 단말의 x축 사이의 회전각입니다. 반 시계 방향으로 각도 단위로 측정되며 -90과 90 사이의 값입니다.
※ W3C DeviceOrientation Event Specification 참고
각도는 항상 회전축의 양의 방향에서 바라보았을 때 반 시계 방향으로 측정됩니다. 예를 들어 단말이 스크린을 위로 하여 평면에 놓여져 있고 스크린의 상단이 북쪽을 향할 때 alpha, beta, gamma는 모두 0 입니다. 그 상태에서 단말을 회전시켜 스크린의 상단이 서쪽을 가리키게 되면 alpha의 값은 90이 됩니다.
이 API는 현재의 방향계 값을 제공할 뿐 아니라 센서에 의해 단말 방향의 변화가 감지되었을 때 이에 대한 통지 이벤트를 전달 받을 수 있습니다.
http://wacapps.net/api/orientation 피쳐 혹은 이 피쳐의 하위 피쳐들이 요청되면 Orientation 인터페이스의 인스턴스가 deviceapis. orientation 으로 전역 네임 스페이스에 생성됩니다.
※ Appspresso는 파일을 직접 편집하지 않고도 피쳐를 선언할 수 있는 그래픽 편집기를 제공합니다. 그래픽 편집기를 이용한 피쳐 선언 방법은 Getting Started를 참고하십시오.
다음은 위젯의 config.xml 파일을 통해 이 API의 피쳐들을 선언하기 위한 URI의 목록입니다. http://wacapps.net/api/orientation
방향 센서의 정보에 접근합니다. 이 피쳐는 이 모듈의 모든 인터페이스, 메소드, 속성에 관련됩니다.
※ Appspresso는 WAC 위젯 외에도 Android와 iOS 앱을 개발할 수 있도록 하기 위해 config.xml 대신 플랫폼 중립적인 메타 정보를 정의할 수 있도록 project.xml 파일을 제공합니다. Appspresso에서 개발한 앱을 WAC 위젯으로 내보낼 때 Appspresso SDK는 project.xml 파일을 기초로 config.xml 파일을 자동 생성하여 WAC 위젯에 포함시킵니다. 이 문서에서는 WAC의 Waikiki API를 설명하기 위해 config.xml에 대한 설명을 그대로 옮깁니다.
