목차

• 1. 소개
• 2. 적합 요구사항
• 3. 용어
• 4. 진동 인터페이스
• 5. 예제
• A. 감사의 말
• B. 참고 문서
  • B.1 표준 참고 문서
  • B.2 정보 참고 문서

2. 적합 요구사항

이 스펙문서 안에서 모든 다이어그램, 예제, 노트 및 표준이 아니라 명시한 섹션은 모두 표준이 아닙니다. 그 외의 모든 내용은 표준입니다.

MAY와 MUST 키워드는 [RFC2119]에서 소개하는 대로 해석합니다.

이 스펙문서는 단일 프로덕트에서 적용할 수 있는 적합성 기준을 정의합니다: 포함된 인터페이스를 구현하는 유저 에이전트

이 스펙문서는 Web IDL의 스펙과 용어를 사용합니다. [WEBIDL] 구현자는 이 스펙문서에서 정의하는 API를 ECMAScript를 사용해 구현할 때 Web IDL 스펙에서 정의하는 ECMAScript 바인딩와 일치하는 방법으로 구현해야 합니다.

3. 용어

browsing context와 spin the event loop는 [HTML5]에서 정의하는 내용을 따릅니다.

4. 진동 인터페이스

typedef (unsigned long or sequence<unsigned long>) VibratePattern;

partial interface Navigator {
    boolean vibrate (VibratePattern pattern);
};

vibrate() 메서드는, 호출할 때, 반드시 진동 패턴 처리 알고리즘을 동작시켜야 합니다. [must]

진동 패턴 처리 규칙은 아래 알고리즘을 따릅니다.

1. vibrate() 메서드의 첫번째 메서드 인수로 pattern을 넣습니다.
2. 밸리데이션 및 정상화에 pattern 패싱 결과로 valid pattern을 넣습니다.
3. 만약 hidden 속성[PAGE-VISIBILITY]이 true라면, false를 반환하고 아래의 스텝을 제거합니다.
   노트

   오퍼레이팅 시스템의 기능에 밀접하게 접근하는 신뢰 가능한 (혹은 면제된) 어플리케이션은 어플리케이션이 전혀 보이지 않는 상태에서 디바이스에 진동을 주거나, 이전 스텝을 무시할 수 있습니다.
4. valid pattern과 함께 진동을 수행합니다.

pattern이 주어진 진동 패턴의 밸리데이션 및 정상화는 아래 단계로 동작시킵니다.

1. 만약 pattern이 리스트라면 다음 단계로 넘어갑니다. 그 외의 경우 아래 서브스텝을 실행합니다.
   1. list를 빈 목록으로 초기화한뒤, list에 pattern을 넣습니다
   2. pattern을 list로 설정합니다.
2. max length를 구현체에 의존한 pattern의 최대값으로 지정합니다.
   노트

   만약 패턴의 길이가 이 API 구현체 최대 길이보다 크다면, 최대 길이를 넘어 무시하기보다는, 같은 효과를 내부적으로 달성하기 위해 여러 짧은 요청으로 효율적으로 요청을 나누는 걸 고려해야합니다. 여러 케이스가 있을 수 있으며, 최대 길이를 초과한 패턴을 거부하는 게 적절할 수도 있습니다. 예제는 만약 길이가 너무 길어 유저에게 효과적으로 서비스 어택 거부를 생성할 수도 있는 예제입니다. 웹 어플리케이션은 패턴 사이의 허용할 수 있는 갭이나 몇몇 구현체에서 길이가 너무 긴 경우 여러개의 요청으로 나누는 걸 허용할 수 있습니다.
3. 만약 pattern의 길이가 max length보다 길다면, pattern을 절단하고, 첫번째 max length 엔트리만 남겨둡니다.
   노트

   pattern의 길이가 짝수이며 0이 아니라면 패턴 내 마지막 엔트리는 효력이 없으며 구현체가 이 포인트에서 pattern에서 지울 수 있습니다.
4. pattern 내 단일 진동 엔트리를 위해 구현체 의존 최대 길이를 max-duration에 지정합니다.
5. max duration보다 큰 pattern 내 각 엔트리 값을 위해, 엔트리 값을 max duration으로 설정합니다.
6. pattern을 반환합니다.

pattern을 사용하는 perform vibration은, 아래 스텝을 밟습니다:

1. 구현체는 false를 반환하고 이 스텝을 끝낼 수도 있습니다. [MAY]
   노트

   예를 들어, 구현체에서 유저가 기기상 진동을 허용하지 않은 origin에서 페이지를 나타내는 경우 취소할 수 있으며, 구현체에서 제한을 지난 요청을 거부하고 디바이스에서 진동 페이지 시간 총량이 마무리 지어질 수도 있습니다.
2. perform vibration 알고리즘의 다른 인스턴스가 이미 동작하고 있는 경우, 아래 서브스텝을 작동합니다.
   1. 존재한다면, perform vibration 알고리즘의 다른 인스턴스를 취소합니다.
   2. 만약 pattern이 빈 목록이라면, 0 값 싱글 엔트리를 포함하거나, 디바이스가 진동을 사용할 수 있다면, true를 반환하고 이 스텝을 제거합니다.
3. true를 반환하고, 이 스텝을 비동기적으로 계속해서 동작합니다.
4. pattern 내 각 time은, 아래 서브스텝대로 동작합니다.
   1. 만약 time의 인덱스가 짝수라면 (첫번째 엔트리 인덱스는 0입니다), time 밀리세컨드동안 기기를 진동시킵니다.
   2. 그 외의 경우 time 밀리세컨드동안 기다립니다.

browsing context 내 Document에서 visibilitychange 이벤트 [PAGE-VISIBILITY]가 포착되었을 때, 유저 에이전트는 반드시 이미 동작하고 있는 진동 패턴 처리를 취소해야합니다. [MUST]