진동 API

비규범적으로 표시된 섹션뿐만 아니라, 이 명세서의 모든 작성 지침, 도표, 예시, 주석은 비규범적입니다. 그 외의 모든 내용은 규범적입니다.

이 문서에서 키워드 MAY, MUST, SHOULD는 BCP 14 [RFC2119] [RFC8174] 문서에서 이 단어들이 전부 대문자로 표시될 때, 그리고 그때에만 이 키워드들이 설명한 대로 해석됩니다.

이 명세는 하나의 제품에 적용되는 적합성 기준을 정의합니다: 이 명세에 포함된 인터페이스를 구현하는 user agent입니다.

이 명세에서 정의된 API를 ECMAScript로 구현하는 경우, Web IDL 명세 [WEBIDL-1]에 정의된 ECMAScript 바인딩에 따라 구현해야 합니다. 이 명세서는 해당 명세와 용어를 사용합니다.

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

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

vibrate() 메서드는 진동 패턴 처리 알고리즘을 실행합니다. 진동 패턴은 VibratePattern 객체로 표현됩니다.

진동 패턴 처리의 규칙은 다음 알고리즘에 따릅니다:

1. pattern을 vibrate() 메서드의 첫 번째 인자로 지정합니다.
2. valid pattern을 pattern을 검증 및 정규화에 전달한 결과로 지정합니다.
3. document의 visibility state 가 visible이 아니면 false를 반환하고 종료합니다.
   참고

   운영체제의 기능과 긴밀히 통합된 신뢰할 수 있는(특권을 가진) 애플리케이션은 해당 애플리케이션이 전혀 보이지 않는 경우에도 디바이스를 진동시킬 수 있으며, 이전 단계를 무시할 수 있습니다.
4. 진동 수행을 this의 관련 글로벌 객체 및 valid pattern과 함께 실행합니다.

검증 및 정규화를 진동 패턴 pattern에 대해 수행하려면, 다음 단계로 진행합니다:

1. pattern이 리스트라면 다음 단계로 진행합니다. 아니라면 아래 하위 단계를 실행합니다:
   1. list를 빈 리스트로 만들고 pattern을 list에 추가합니다.
   2. pattern을 list로 설정합니다.
2. max length를 10으로 지정합니다.
3. pattern의 길이가 max length보다 크면, pattern을 잘라내어 처음 max length 항목만 남깁니다.
   참고

   pattern의 길이가 짝수이고 0이 아니라면, 패턴의 마지막 항목은 효과가 없으므로 구현체는 이 단계에서 이를 pattern에서 제거할 수 있습니다.
4. max duration을 10000으로 지정합니다.
5. pattern의 각 항목 값이 max duration보다 크면, 해당 항목의 값을 max duration으로 설정합니다.
6. pattern을 반환합니다.

진동 수행을 global object global 및 진동 패턴 pattern을 사용하여 수행하려면, 다음 단계로 진행합니다:

1. global이 sticky activation을 갖지 않으면, false를 반환하고 종료합니다.
2. 구현체는 MAY false를 반환하고 종료할 수 있습니다.
   참고

   예를 들어, 구현체는 진동 하드웨어가 없거나, 사용자가 특정 origin의 페이지에서 디바이스 진동을 비활성화하도록 설정했거나, 구현체가 페이지가 진동시킬 수 있는 총 시간을 제한하고 이를 초과하는 요청을 거부할 수 있기 때문에 알고리즘을 중단할 수 있습니다.
3. 다른 진동 수행 알고리즘 인스턴스가 이미 실행 중이면, 아래 하위 단계를 실행합니다:
   1. 다른 진동 수행 알고리즘 인스턴스가 있다면 중단합니다.
   2. pattern이 빈 리스트이거나, 값이 0인 단일 항목이거나, 디바이스가 진동할 수 없으면 true를 반환하고 종료합니다.
4. true를 반환하고, 이후 단계는 비동기로 계속 실행합니다.
5. pattern의 각 time에 대해 아래 하위 단계를 실행합니다:
   1. time의 인덱스가 짝수(첫 항목은 0)면, 디바이스를 time 밀리초 동안 진동시킵니다.
   2. 그 외에는 time 밀리초 동안 대기합니다.

user agent가 visibility state가 top-level browsing context의 Document에서 변경되었다고 판단하면, 이미 실행 중인 진동 패턴 처리 알고리즘을 중단해야 합니다(MUST).

Vibration API 자체는 데이터를 생성하지 않으므로 웹에서 소비할 수 있는 데이터를 직접 제공하지 않습니다. 하지만 다른 API의 이벤트 소스로 활용될 수 있는 것이 알려져 있습니다. 특히, 가속도계나 자이로스코프와 같은 특정 센서는 제조 과정에서 미세한 불완전성을 가질 수 있습니다. 이로 인해 진동 API를 통해 생성된 진동 자극을 이용해 이러한 센서가 지문(surface)이 되어 정보가 악용될 수 있습니다. 이런 관점에서 Vibration API는 다른 메커니즘과 결합될 때 간접적으로 개인정보 위험을 제공합니다. 이는 예상치 못한 개인정보 위험(디바이스 간 추적, 통신 등)을 유발할 수 있습니다. 또한 진동 중인 디바이스는 외부 관찰자에게 물리적으로 식별될 수 있고, 사용자의 추적이 가능해질 수 있습니다.

이러한 이유로 user agent는 API가 사용될 때 사용자에게 알리고, API를 원천적으로(혹은 origin별로) 비활성화(실질적으로 아무 동작도 하지 않도록)할 수 있는 메커니즘을 제공할 수 있습니다(MAY).

user agent는 일정 기간(예: 1분 또는 1시간 등) 내에 진동 요청 횟수를 제한함으로써 과도한 사용을 방지하기 위해 글로벌 레이트 리미팅을 적용해야 합니다(SHOULD).