암호화된 미디어 확장

requestMediaKeySystemAccess() 는 문자열 encrypted-media로 식별되는 정책 제어 기능입니다. 그 기본 허용목록은 'self'입니다 [PERMISSIONS-POLICY].

WebIDL[Exposed=Window]
partial interface Navigator {
  [SecureContext] Promise<MediaKeySystemAccess> requestMediaKeySystemAccess (
      DOMString keySystem,
      sequence<MediaKeySystemConfiguration> supportedConfigurations);
};

WebIDLenum MediaKeysRequirement {
  "required",
  "optional",
  "not-allowed"
};

MediaKeysRequirement 열거형은 다음과 같이 정의됩니다:

WebIDLdictionary MediaKeySystemConfiguration {
  DOMString                               label = "";
  sequence<DOMString>                     initDataTypes = [];
  sequence<MediaKeySystemMediaCapability> audioCapabilities = [];
  sequence<MediaKeySystemMediaCapability> videoCapabilities = [];
  MediaKeysRequirement                    distinctiveIdentifier = "optional";
  MediaKeysRequirement                    persistentState = "optional";
  sequence<DOMString>                     sessionTypes;
};

MediaKeySystemConfiguration 사전은 다음 멤버들을 포함합니다:

label (DOMString 타입, 기본값 "")

MediaKeySystemConfiguration가 getConfiguration() 메서드로 반환될 때 보존되는 선택적 라벨입니다. MediaKeySystemAccess.

initDataTypes (sequence<DOMString> 타입, 기본값 [])

지원되는 Initialization Data Type 이름들의 목록입니다. 이 객체의 Initialization Data Type 기능은 목록이 비어 있거나 모든 다른 멤버들과 함께 지원되는 하나 이상의 값을 포함하면 지원된 것으로 간주됩니다(알고리즘에 의해 결정). 시퀀스의 값은 빈 문자열이 아니어야(MUST) 합니다.

audioCapabilities (sequence<MediaKeySystemMediaCapability> 타입, 기본값 [])

지원되는 오디오 타입 및 기능 쌍의 목록입니다. 이 객체의 오디오 기능은 목록이 비어 있거나 모든 다른 멤버들과 함께 지원되는 하나 이상의 값을 포함하면 지원된 것으로 간주됩니다(알고리즘에 의해 결정). 값들 간에 충돌이 있을 경우, 앞선 값이 선택됩니다. 빈 목록은 오디오 기능이 지원되지 않음을 의미합니다. 이 경우 videoCapabilities 요소는 비어 있으면 안 됩니다.

videoCapabilities (sequence<MediaKeySystemMediaCapability> 타입, 기본값 [])

지원되는 비디오 타입 및 기능 쌍의 목록입니다. 이 객체의 비디오 기능은 목록이 비어 있거나 모든 다른 멤버들과 함께 지원되는 하나 이상의 값을 포함하면 지원된 것으로 간주됩니다(알고리즘에 의해 결정). 값들 간에 충돌이 있을 경우, 앞선 값이 선택됩니다. 빈 목록은 비디오 기능이 지원되지 않음을 의미합니다. 이 경우 audioCapabilities 요소는 비어 있으면 안 됩니다.

distinctiveIdentifier (MediaKeysRequirement 타입, 기본값 "optional")

Distinctive Identifier(s) 사용이 필요한지 여부를 나타냅니다.

이 멤버가 "not-allowed"일 경우, 구현은 Distinctive Identifier(s) 또는 Distinctive Permanent Identifier(s) 사용을 이 구성에서 생성된 모든 객체의 연산에 대해 절대(MUST NOT) 사용해서는 안 됩니다.

persistentState (MediaKeysRequirement 타입, 기본값 "optional")

상태를 영구 저장하는 기능이 필요한지 여부입니다. 여기에는 세션 데이터 및 기타 유형의 상태가 포함됩니다.

이 멤버가 "not-allowed"일 때, CDM은 이 객체의 Document의 애플리케이션이나 origin과 관련된 어떤 상태도 영구 저장해서는 절대(MUST NOT) 안 됩니다.

참고

이 멤버의 목적상, 영구 상태는 Key System 구현에 의해 제어되는 영구 고유 식별자(Distinctive Identifiers)를 포함하지 않습니다. distinctiveIdentifier는 이 요구사항을 독립적으로 반영합니다.

영구 상태가 지원되지 않을 때는 "temporary" 세션만 생성할 수 있습니다.

참고

"temporary" 세션의 경우, 상태 저장의 필요성과 가능성은 Key System 구현에 따라 다르며, 사용되는 기능에 따라 달라질 수 있습니다.

참고

"temporary"가 아닌 세션을 생성하려는 애플리케이션은 required로 이 멤버를 설정하여 requestMediaKeySystemAccess()를 호출해야 합니다.

sessionTypes (sequence<DOMString> 타입)

반드시 지원되어야 하는 MediaKeySessionType들의 목록입니다. 모든 값은 지원되어야 합니다.

이 멤버가 사전에 존재하지 않을(not present) 경우, requestMediaKeySystemAccess()에 전달될 때, 이 사전은 이 멤버가 [ "temporary" ]로 설정된 것처럼 처리됩니다.

구현체는 이 사전에 멤버를 추가해서는 권장되지 않음(SHOULD NOT)니다. 만약 멤버가 추가된다면, 반드시(MUST) MediaKeysRequirement 타입이어야 하며, "optional"을 기본값으로 갖는 것이 권장됨(RECOMMENDED)니다. 이는 애플리케이션과 클라이언트 조합의 범위를 넓게 지원하기 위함입니다.

이 사전은 CDM에 상태나 데이터를 전달하는 데 절대(MUST NOT) 사용해서는 안 됩니다.

WebIDLdictionary MediaKeySystemMediaCapability {
  DOMString contentType = "";
  DOMString? encryptionScheme = null;
  DOMString robustness = "";
};

이 객체가 나타내는 기능이 지원되는 것으로 간주되려면, contentType은 빈 문자열이 아니어야 하며(MUST NOT), 코덱 전체 값이 robustness와 함께 반드시(MUST) 지원되어야 합니다.

keySystem 타입 DOMString, 읽기전용

사용 중인 Key System을 식별합니다.

getConfiguration()

requestMediaKeySystemAccess() 알고리즘에 의해 선택된 지원되는 구성 옵션 조합을 반환합니다.

반환된 객체는 약속을 이행한 해당 호출의 requestMediaKeySystemAccess() 호출에 전달된 첫 번째 만족 가능한 MediaKeySystemConfiguration 구성의 비엄격 부분집합(암시적 기본값 포함)입니다. 해당 구성에 명시되지 않은 기능(암시적 기본값 외)을 위한 값은 포함하지 않으므로 Key System 구현의 모든 기능을 반영하지 않을 수 있습니다. 구성 내의 모든 값은 어떤 조합으로든 사용할 수 있습니다. MediaKeysRequirement 타입의 멤버는 해당 기능이 어떤 조합에서 필수인지 반영합니다. "optional" 값은 가지지 않습니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 반드시(MUST) 실행해야 합니다:

1. 이 객체의 configuration 값을 반환합니다.

   참고

   이 메서드가 호출될 때마다 configuration로부터 새로운 객체가 생성 및 초기화됩니다.

   참고

   애플리케이션에서 encryptionScheme 를 제공하지 않은 경우에도, 누적된 configuration에는 encryptionScheme 필드가 반드시 null 값으로 포함되어야 하며, 이를 통해 polyfill에서 사용자 에이전트가 해당 필드를 지원하는지 특정 값을 지정하지 않고도 감지할 수 있습니다.

createMediaKeys()

keySystem에 대한 새로운 MediaKeys 객체를 생성합니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 반드시(MUST) 실행해야 합니다:

1. promise를 새 약속으로 둡니다.

2. 다음 단계를 병렬로 실행합니다:

   1. configuration을 이 객체의 configuration 값으로 둡니다.

   2. use distinctive identifier를 configuration의 distinctiveIdentifier 멤버 값이 "required"이면 true, 그 외에는 false로 둡니다.

   3. persistent state allowed를 configuration의 persistentState 멤버 값이 "required"이면 true, 그 외에는 false로 둡니다.

   4. 필요하다면, 이 객체의 cdm implementation 값으로 표시되는 Key System 구현을 로드 및 초기화합니다.

   5. instance를 이 객체의 cdm implementation 값으로 표시되는 Key System 구현의 새 인스턴스로 둡니다.

   6. instance를 configuration을 사용해 Key System 기능을 활성화, 비활성화, 선택할 수 있도록 초기화합니다.

   7. use distinctive identifier가 false이면, instance가 Distinctive Identifier(s) 및 Distinctive Permanent Identifier(s) 사용을 하지 못하도록 합니다.

   8. persistent state allowed가 false이면, instance가 이 객체의 origin이나 Document와 관련된 애플리케이션 상태를 영구 저장하지 못하도록 합니다.

   9. 앞선 단계 중 하나라도 실패하면, promise를 새로운 DOMException으로 적절한 에러 이름을 포함하여 거부합니다.

   10. media keys를 새 MediaKeys 객체로 만들고, 다음과 같이 초기화합니다:

       1. use distinctive identifier 값을 use distinctive identifier로 둡니다.

       2. persistent state allowed 값을 persistent state allowed로 둡니다.

       3. supported session types 값을 configuration의 sessionTypes 멤버의 값으로 둡니다.

       4. cdm implementation 값을 이 객체의 cdm implementation 값으로 둡니다.

       5. cdm instance 값을 instance로 둡니다.

   11. promise를 media keys로 이행(resolve)합니다.

3. promise를 반환합니다.

createSession()

새로운 MediaKeySession 객체를 반환합니다.

Note

sessionType 매개변수는 반환된 객체의 동작에 영향을 줍니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 반드시(MUST) 실행해야 합니다:

1. 이 객체의 supported session types 값이 sessionType을 포함하지 않으면, throw하여 [WEBIDL] 규정에 따라 NotSupportedError를 발생시킵니다.

   Note

   sessionType에 대해 Is persistent session type? 알고리즘이 true를 반환하는 값들은 이 객체의 persistent state allowed 값이 false이면 실패할 것입니다.

2. 구현체가 현재 상태에서 MediaKeySession 연산을 지원하지 않으면, throw하여 [WEBIDL] 규정에 따라 InvalidStateError를 발생시킵니다.

   Note

   일부 구현체는 이 MediaKeys 객체가 setMediaKeys()로 미디어 요소에 연결될 때까지 MediaKeySession 알고리즘을 실행할 수 없습니다. 이 단계는 애플리케이션이 그러한 드문 동작을 시도하기 전에 감지할 수 있도록 합니다.

3. session을 새 MediaKeySession 객체로 만들고, 다음과 같이 초기화합니다:

   1. sessionId 속성의 값을 빈 문자열로 둡니다.

   2. expiration 속성의 값을 NaN으로 둡니다.

   3. closed 속성의 값을 새 Promise로 둡니다.

   4. key status를 새 빈 MediaKeyStatusMap 객체로 두고, 다음과 같이 초기화합니다:

      1. size 속성의 값을 0으로 둡니다.

   5. session type 값을 sessionType으로 둡니다.

   6. uninitialized 값을 true로 둡니다.

   7. callable 값을 false로 둡니다.

   8. closing or closed 값을 false로 둡니다.

   9. use distinctive identifier 값을 이 객체의 use distinctive identifier 값으로 둡니다.

   10. cdm implementation 값을 이 객체의 cdm implementation으로 둡니다.

   11. cdm instance 값을 이 객체의 cdm instance로 둡니다.

4. session을 반환합니다.

getStatusForPolicy()

주어진 MediaKeysPolicy에 대한 MediaKeyStatus를 반환합니다.

WebIDLdictionary MediaKeysPolicy {
    DOMString minHdcpVersion;
};

MediaKeysPolicy 사전은 선택적 속성들로만 구성된 객체입니다. 각 속성은 정책 요구사항을 나타냅니다. 모든 요구사항을 기반으로 CDM이 암호 해제된 미디어 데이터를 재생하도록 허용하는 경우에만 정책이 충족된 것으로 간주됩니다.

HDCP 정책은 minHdcpVersion으로 표현됩니다. 시스템이 지정된 HDCP 버전 이상을 활성화할 수 있다면, 그 정책은 "usable"인 MediaKeyStatus를 반환합니다. [EME-HDCP-VERSION-REGISTRY]는 minHdcpVersion 값과 HDCP 명세 간의 매핑을 제공합니다.

Note

HDCP 상태의 판단은 재생 중 CDM이 그러한 제한을 집행하는 방식과 동일해야 합니다. 이렇게 하면 애플리케이션 개발자는 재생 시작을 위해 어떤 콘텐츠를 최적화하여 가져올지에 대한 합리적인 힌트를 얻을 수 있습니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 반드시(MUST) 실행해야 합니다:

1. If policy에 아무런 존재하는 사전 멤버가 없다면, 새로 생성된 TypeError로 거부된 Promise를 반환합니다.

2. promise를 새 Promise로 둡니다.

3. 다음 단계를 수행하는 작업(task)을 큐에 넣습니다:

   1. policy의 각 사전 멤버에 대해 다음 단계를 실행합니다:

      1. 키가 유효한 MediaKeysPolicy 멤버가 아니거나 값의 타입이 올바르지 않으면, promise를 TypeError로 거부하고 이 단계를 중단합니다.

   2. policy의 각 사전 멤버에 대해 다음 단계를 실행합니다:

      1. 만약 CDM이 해당 사전 멤버에 대한 MediaKeyStatus를 결정할 수 없다면, promise를 NotSupportedError로 거부하고 이 단계를 중단합니다.

   3. policy의 각 사전 멤버에 대해 다음 단계를 실행합니다:

      1. 만약 CDM이 해당 사전 멤버에 대해 암호 해제된 미디어 데이터의 재생을 차단할 것이라면, promise를 "output-restricted"로 이행(resolve)합니다.

   4. promise를 "usable"로 이행(resolve)합니다.

4. promise를 반환합니다.

setServerCertificate()

서버 인증서를 제공하여 라이선스 서버로 보내는 메시지의 암호화를 위해 사용합니다.

이러한 인증서를 사용하는 Key Systems는 또한 인증서를 서버에서 요청하는 기능을 Queue a "message" Event 알고리즘을 통해 지원해야 합니다.

Note

이 메서드는 애플리케이션이 CDM이 요청할 경우 발생할 추가 왕복을 피하기 위해 서버 인증서를 미리 제공할 수 있도록 허용합니다. 이는 최적화를 위한 것이며, 애플리케이션이 반드시 사용해야 하는 것은 아닙니다.

서버 인증서의 내용은 Key System별입니다. 인증서에는 실행 가능한 코드가 포함되어서는 안 됩니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계를 반드시(MUST) 실행해야 합니다:

1. 이 객체의 cdm implementation 값으로 표시되는 Key System 구현이 서버 인증서를 지원하지 않으면, false로 이행된 Promise를 반환합니다.

2. serverCertificate가 빈 배열이면, 새로 생성된 TypeError로 거부된 Promise를 반환합니다.

3. certificate를 serverCertificate 매개변수의 내용 복사본으로 둡니다.

4. promise를 새 Promise로 둡니다.

5. 다음 단계를 병렬로 실행합니다:

   1. sanitized certificate를 certificate의 검증 및/또는 정제된 버전으로 둡니다.

      Note

      사용자 에이전트는 CDM에 전달하기 전에 인증서를 철저히 검증해야 합니다. 여기에는 값의 합리성 검사, 관련 없는 데이터나 필드 제거, 사전 파싱, 정제 또는 완전한 정제 버전 생성 등이 포함될 수 있습니다. 길이와 필드 값이 합리적인지 확인하고, 알 수 없는 필드는 거부하거나 제거해야 합니다.

   2. 이 객체의 cdm instance를 사용하여 sanitized certificate를 처리합니다.

   3. 앞 단계가 실패하면, 적절한 오류 이름을 가진 새 DOMException로 promise를 거부합니다.

   4. promise를 true로 이행(resolve)합니다.

6. promise를 반환합니다.

이 절은 저장소 및 영속성에 관련된 일반 요구사항을 설명합니다.

만약 어떤 MediaKeys 객체의 persistent state allowed 값이 false라면, 그 객체의 cdm instance는 이 객체 또는 그것이 생성하는 어떤 세션의 연산 결과로 상태를 영구 저장하거나 이전에 영구 저장된 상태에 접근해서는 안 됩니다(SHALL NOT).

만약 어떤 MediaKeys 객체의 persistent state allowed 값이 true라면, 그 객체의 cdm instance는 이 객체 또는 그것이 생성하는 어떤 세션의 연산 결과로 상태를 영구 저장하거나 이전에 영구 저장된 상태에 접근할 수 있습니다.

영구 저장된 데이터는 항상 이 객체의 origin만 접근할 수 있도록 저장되어야 합니다. 또한 그 데이터는 현재의 browsing profile에서만 접근 가능해야 하며, 다른 브라우징 프로필들, 사용자 에이전트들, 애플리케이션들은 저장된 데이터에 접근해서는 안 됩니다(MUST NOT). 저장된 정보에 대해서는 Information Stored on User Devices를 참조하세요.

영구 저장소를 지원할 때의 추가 고려사항은 10. Security 및 11. Privacy를 참조하세요.

sessionId 타입의 DOMString, 읽기 전용

이 객체와 연관된 키 또는 라이선스에 대한 세션 ID입니다.

expiration 타입의 unrestricted double, 읽기 전용

세션 내 모든 키의 만료 시간이며, 그러한 시간이 존재하지 않거나 CDM에 의해 라이선스가 명시적으로 만료되지 않는 것으로 결정된 경우에는 NaN입니다.

참고

이 값은 세션 수명 동안 변경될 수 있으며, 예를 들어 어떤 동작이 윈도우의 시작을 유발할 때 변경될 수 있습니다.

closed 타입의 Promise<MediaKeySessionClosedReason>, 읽기 전용

닫힘이 발생할 때를 알리는 신호로, 이는 세션 닫힘 알고리즘이 실행된 결과입니다. 이 약속은 오직 이행될 수 있으며 거부되지는 않습니다.

keyStatuses 타입의 MediaKeyStatusMap, 읽기 전용

세션에 키 ID로 알려진 항목들과 연관된 현재 키 상태를 나타내는 읽기 전용 맵에 대한 참조입니다. 각 항목은 고유한 키 ID를 가져야 합니다.

참고

맵 항목들과 그 값들은 이벤트 루프가 한 바퀴 돌 때마다 갱신될 수 있습니다. 맵은 절대로 불일치하거나 부분적으로만 갱신되어서는 안 되지만, 접근들 사이에 이벤트 루프가 도는 경우 접근 간에 변경될 수 있습니다. 키 ID는 load() 또는 update() 호출의 결과로 추가될 수 있습니다. 기존 키에 대한 지식이 제거되거나 기존 키 집합이 새 집합으로 대체되는 update() 호출의 결과로 키 ID가 제거될 수 있습니다. 키 ID는 만료와 같은 이유로 사용 불가능해졌다고 해서 제거되어서는 안 되며, 대신 그러한 키들은 "expired"와 같은 적절한 상태를 가져야 합니다.

참고

일부 오래된 플랫폼에는 키 ID를 노출하지 않는 Key System 구현체가 있어 준수하는 사용자 에이전트 구현을 제공하기 어렵습니다. 상호운용성을 최대화하기 위해, 그러한 CDM을 노출하는 사용자 에이전트 구현체는 이 멤버를 다음과 같이 구현하는 것이 권장됩니다: 비어있지 않은 목록이 적절한 경우(예: 이 객체로 표현되는 key session이 키를 포함할 수 있는 경우), 맵을 단일 쌍으로 채우되 단일 바이트 키 ID 0과 이 객체의 집계된 상태에 가장 적절한 MediaKeyStatus를 사용하세요.

onkeystatuseschange 타입의 EventHandler

keystatuseschange 이벤트에 대한 이벤트 핸들러입니다.

onmessage 타입의 EventHandler

message 이벤트에 대한 이벤트 핸들러입니다.

generateRequest()

initData를 기반으로 라이선스 요청을 생성합니다. 알고리즘이 성공하여 약속이 이행되면 타입이 "license-request" 또는 "individualization-request"인 message가 항상 큐에 추가됩니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계들을 반드시(MUST) 실행해야 합니다:

1. 만약 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 약속을 반환합니다.

2. 만약 이 객체의 uninitialized 값이 false이면, InvalidStateError로 거부된 약속을 반환합니다.

3. 이 객체의 uninitialized 값을 false로 둡니다.

4. 만약 initDataType이 빈 문자열이면, 새로 생성된 TypeError로 거부된 약속을 반환합니다.

5. 만약 initData가 빈 배열이면, 새로 생성된 TypeError로 거부된 약속을 반환합니다.

6. 이 객체의 cdm implementation 값으로 표시되는 Key System 구현이 initDataType를 Initialization Data Type으로 지원하지 않으면, NotSupportedError로 거부된 약속을 반환합니다. 문자열 비교는 대소문자 구분입니다.

7. init data를 initData 매개변수의 내용 복사본으로 둡니다.

8. session type을 이 객체의 session type으로 둡니다.

9. promise를 새 약속으로 둡니다.

10. 다음 단계들을 병렬로 실행합니다:

    1. 만약 init data가 initDataType에 대해 유효하지 않으면, 새로 생성된 TypeError로 promise를 거부합니다.

    2. sanitized init data를 init data의 검증되고 정제된 버전으로 둡니다.

       사용자 에이전트는 Initialization Data를 CDM에 전달하기 전에 철저히 검증해야 합니다. 여기에는 필드의 길이 및 값이 합리적인지 확인하고, 값이 합리적인 범위 내에 있는지 검증하며, 관련 없거나 지원되지 않거나 알 수 없는 데이터 또는 필드를 제거하는 것이 포함됩니다. 사용자 에이전트는 Initialization Data를 미리 파싱하고, 정제하며 완전한 정제 버전을 생성하는 것이 권장됨(RECOMMENDED)입니다. 만약 initDataType으로 지정된 Initialization Data 형식이 다중 항목을 지원하면, 사용자 에이전트는 CDM에 필요하지 않은 항목들을 제거해야(SHOULD) 합니다. 사용자 에이전트는 Initialization Data 내의 항목 순서를 변경해서는 안 됩니다(MUST NOT).

    3. 앞 단계가 실패하면, 새로 생성된 TypeError로 promise를 거부합니다.

    4. 만약 sanitized init data가 비어있다면, NotSupportedError로 promise를 거부합니다.

    5. session id를 빈 문자열로 둡니다.

    6. message를 null로 둡니다.

    7. message type를 null로 둡니다.

    8. cdm를 이 객체의 cdm instance 값으로 표시되는 CDM 인스턴스로 둡니다.

    9. 다음 단계를 수행하기 위해 cdm을 사용합니다:

       1. 만약 sanitized init data가 cdm에서 지원되지 않으면, NotSupportedError로 promise를 거부합니다.

       2. 다음 목록에서 session type 값에 대한 단계를 따릅니다:

          "temporary"

          requested license type을 임시 비영구 라이선스로 둡니다.

          참고

          반환되는 라이선스는 영구 저장 가능하거나 그것과 관련된 정보를 저장하도록 요구해서는 안 됩니다.

          "persistent-license"

          requested license type을 영구 저장 가능한 라이선스로 둡니다.

       3. session id를 고유한 Session ID 문자열로 둡니다.

          만약 session type에 대해 Is persistent session type? 알고리즘을 실행한 결과가 true이면, 해당 ID는 이 객체의 origin 내에서 시간이 지나도(다른 Document 및 브라우징 세션을 포함하여) 고유해야 합니다(MUST).

       4. 만약 sanitized init data로부터 requested license type에 대한 라이선스 요청을 생성할 수 있다면:

          1. message를 sanitized init data를 initDataType에 따라 해석하여 생성된 requested license type에 대한 라이선스 요청으로 둡니다.

             cdm은 sanitized init data로 제공되지 않은 스트림 관련 데이터(예: media data)를 사용해서는 안 됩니다(MUST NOT).

             cdm은 이 시점에서 세션 ID를 포함한 세션 데이터를 저장해서는 안 되는 것이 권장됨(SHOULD NOT)입니다. 자세한 내용은 Session Storage and Persistence를 참조하세요.

          2. message type을 "license-request"로 둡니다.

          그렇지 않으면:

          1. message를 sanitized init data에 기반한 라이선스 요청을 생성하기 전에 처리해야 하는 요청으로 둡니다.

             이후의 update() 호출에서, CDM은 initDataType에 따라 해석된 sanitized init data에 기반한 requested license type에 대한 라이선스 요청을 반드시 생성해야(MUST) 합니다.

          2. message type을 message의 타입을 반영하도록 설정합니다. 이는 "license-request"이거나 "individualization-request"입니다.

    10. 다음 단계들을 실행하는 작업(task)을 큐에 넣습니다:

        1. 만약 앞선 단계들 중 어떤 것이 자원 부족으로 실패했다면, QuotaExceededError로 promise를 거부합니다.

        2. 만약 앞선 단계들 중 어떤 것이 다른 이유로 실패했다면, 적절한 error name을 가진 새 DOMException로 promise를 거부합니다.

        3. sessionId 속성을 session id로 설정합니다.

        4. 이 객체의 callable 값을 true로 설정합니다.

        5. promise를 undefined로 이행(resolve)합니다.

        6. session에서 Queue a "message" Event 알고리즘을 실행하여 message type과 message를 제공합니다.

11. promise를 반환합니다.

load()

지정된 세션에 대해 저장된 데이터를 이 객체로 불러옵니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계들을 반드시(MUST) 실행해야 합니다:

1. 만약 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 약속을 반환합니다.

2. 만약 이 객체의 uninitialized 값이 false이면, InvalidStateError로 거부된 약속을 반환합니다.

3. 이 객체의 uninitialized 값을 false로 둡니다.

4. 만약 sessionId가 빈 문자열이면, 새로 생성된 TypeError로 거부된 약속을 반환합니다.

5. 만약 이 객체의 session type에 대해 Is persistent session type? 알고리즘을 실행한 결과가 false이면, 새로 생성된 TypeError로 거부된 약속을 반환합니다.

6. origin을 이 객체의 origin으로 둡니다.

7. promise를 새 약속으로 둡니다.

8. 다음 단계들을 병렬로 실행합니다:

   1. sanitized session ID를 sessionId의 검증 및/또는 정제된 버전으로 둡니다.

      참고

      사용자 에이전트는 sessionId 값을 CDM에 전달하기 전에 철저히 검증해야 합니다. 최소한 길이와 값이 합리적인지(예: 수십 문자보다 길지 않고 영숫자) 확인해야 합니다.

   2. 앞 단계가 실패했거나 sanitized session ID가 비어 있으면, 새로 생성된 TypeError로 promise를 거부합니다.

   3. 만약 이 객체의 MediaKeySession 객체 중 이 객체의 Document에 닫히지 않은 것이 있고 그 객체의 sessionId 속성이 sanitized session ID이면, QuotaExceededError로 promise를 거부합니다.

      참고

      다시 말해, 이 브라우징 컨텍스트에 대해 비-닫힘 세션(타입과 관계없이)이 이미 존재하면 세션을 생성하지 마십시오.

   4. expiration time을 NaN으로 둡니다.

   5. message를 null로 둡니다.

   6. message type를 null로 둡니다.

   7. cdm를 이 객체의 cdm instance 값으로 표시되는 CDM 인스턴스로 둡니다.

   8. 다음 단계를 수행하기 위해 cdm을 사용합니다:

      1. 만약 origin에 대해 sanitized session ID에 저장된 데이터가 없다면, promise를 false로 이행하고 이 단계들을 중단합니다.

      2. 저장된 세션의 session type이 현재 이 MediaKeySession의 session type과 다르면, 새로 생성된 TypeError로 promise를 거부합니다.

      3. session data를 origin에 sanitized session ID에 대해 저장된 데이터로 둡니다. 이 데이터는 다른 origin의 데이터나 origin과 연관되지 않은 데이터를 포함해서는 안 됩니다(MUST NOT).

      4. 만약 어떤 MediaKeySession 객체가 어떤 Document에서 닫히지 않았고 그 객체가 session data를 나타낸다면, QuotaExceededError로 promise를 거부합니다.

         참고

         다시 말해, 어떤 브라우징 컨텍스트에 대해 비-닫힘 영구 세션이 이미 존재하면 세션을 생성하지 마십시오.

      5. session data를 로드합니다.

      6. 만약 session data가 세션의 expiration time을 나타내면, expiration time을 그 만료 시간으로 둡니다.

      7. 만약 메시지를 전송할 필요가 있다면, 다음 단계를 실행합니다:

         1. message를 session data에 기반해 생성된 메시지로 둡니다.

         2. message type을 그 메시지에 적절한 MediaKeyMessageType로 둡니다.

   9. 다음 단계들을 실행하는 작업(task)을 큐에 넣습니다:

      1. 만약 앞선 단계들 중 어떤 것이 실패했으면, 적절한 error name으로 promise를 거부합니다.

      2. sessionId 속성을 sanitized session ID로 설정합니다.

      3. 이 객체의 callable 값을 true로 설정합니다.

      4. 만약 로드된 세션이 어떤 키들에 대한 정보를 포함한다면(알려진 키가 있는 경우), 각 키의 key ID와 적절한 MediaKeyStatus를 제공하여 session에 대해 Update Key Statuses 알고리즘을 실행합니다.

         키의 상태를 확실히 판단하기 위해 추가 처리가 필요하다면 "status-pending"를 사용하세요. 하나 이상의 키에 대한 추가 처리가 완료되면, 실제 상태들로 다시 Update Key Statuses 알고리즘을 실행합니다.

      5. Update Expiration 알고리즘을 session에 대해 실행하여 expiration time을 제공합니다.

      6. promise를 true로 이행(resolve)합니다.

      7. 만약 message가 null이 아니면, session에서 Queue a "message" Event 알고리즘을 실행하여 message type과 message를 제공합니다.

9. promise를 반환합니다.

update()

CDM에 메시지(라이선스 포함)를 제공합니다.

response 매개변수는 CDM에 제공될 메시지를 포함합니다. 내용은 Key System별이며 실행 가능한 코드를 포함해서는 안 됩니다(MUST NOT).

이 메서드가 호출되면, 사용자 에이전트는 다음 단계들을 반드시(MUST) 실행해야 합니다:

1. 만약 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 약속을 반환합니다.

2. 만약 이 객체의 callable 값이 false이면, InvalidStateError로 거부된 약속을 반환합니다.

3. 만약 response가 빈 배열이면, 새로 생성된 TypeError로 거부된 약속을 반환합니다.

4. response copy를 response 매개변수의 내용 복사본으로 둡니다.

5. promise를 새 약속으로 둡니다.

6. 다음 단계들을 병렬로 실행합니다:

   1. sanitized response를 response copy의 검증 및/또는 정제된 버전으로 둡니다.

      참고

      사용자 에이전트는 CDM에 전달하기 전에 응답을 철저히 검증해야 합니다. 여기에는 값들이 합리적인 범위 내에 있는지 확인하고, 관련 없는 데이터나 필드를 제거하거나, 미리 파싱하거나, 정제하거나, 완전한 정제 버전을 생성하는 것이 포함될 수 있습니다. 길이와 필드 값이 합리적인지 확인하고 알 수 없는 필드는 거부하거나 제거해야 합니다.

   2. 앞 단계가 실패했거나 sanitized response가 비어 있으면, 새로 생성된 TypeError로 promise를 거부합니다.

   3. message를 null로 둡니다.

   4. message type를 null로 둡니다.

   5. session closed를 false로 둡니다.

   6. cdm를 이 객체의 cdm instance 값으로 표시되는 CDM 인스턴스로 둡니다.

   7. 다음 단계를 수행하기 위해 cdm을 사용합니다:

      1. 만약 sanitized response의 형식이 어떤 면에서든 유효하지 않으면, 새로 생성된 TypeError로 promise를 거부합니다.

      2. sanitized response를 처리하되, 다음 목록에서 첫 번째로 일치하는 조건의 규정을 따릅니다:

         만약 sanitized response가 라이선스나 키를 포함한다면

         참고

         여기에는 초기 라이선스, 업데이트된 라이선스 및 라이선스 갱신 메시지가 포함됩니다.

         다음 목록에서 첫 번째로 일치하는 조건의 규정을 따르며 sanitized response를 처리합니다:

         만약 sessionType이 "temporary" 이고 sanitized response가 포함된 어떤 세션 데이터(라이선스, 키 등)를 저장해야 한다고 명시하지 않으면

         sanitized response를 처리하되 어떤 세션 데이터도 저장하지 않습니다.

         만약 sessionType이 "persistent-license" 이고 sanitized response가 영구 저장 가능한 라이선스를 포함하면

         sanitized response를 처리하여 그 안에 포함된 라이선스/키 및 관련 세션 데이터를 저장합니다. 그러한 데이터는 이 객체의 origin만 접근할 수 있도록 저장되어야 합니다(MUST).

         그렇지 않으면

         새로 생성된 TypeError로 promise를 거부합니다.

         또한 Session Storage and Persistence를 참조하세요.

         각 세션의 상태 정보(키 포함)는 한 세션을 닫는 것이 다른 세션들의 관찰 가능한 상태에 영향을 주지 않도록 저장되어야 합니다. 이는 키 ID가 겹치더라도 적용됩니다(MUST).

         참고

         sanitized response가 키 및/또는 관련 데이터를 포함하면, cdm은 아마 키와 관련 데이터를 키 ID로 인덱싱하여 (메모리에) 저장할 것입니다.

         참고

         세션 내에서의 교체 알고리즘은 Key System에 따라 다릅니다.

         참고

         CDM 구현체가 각 MediaKeySession 객체당 표준적이고 합리적으로 높은 최소 키 수, 표준 교체 알고리즘 및 표준적이고 합리적으로 높은 최소 MediaKeySession 객체 수를 지원하는 것이 권장됨(RECOMMENDED)입니다. 이는 다양한 스트림을 같은 요소에서 서로 다른 키로 사용하는 사용 사례(예: 적응형 스트림, 다양한 오디오 및 비디오 트랙)에서 재생 중단 가능성을 줄이는 데 도움이 됩니다.

         만약 sanitized response가 record of license destruction 확인을 포함하고 sessionType이 "persistent-license"인 경우

         다음 단계들을 실행합니다:

         1. 이 객체와 연관된 key session을 닫고, 이 객체와 연관된 모든 저장된 세션 데이터를 삭제합니다. 여기에는 sessionId 및 record of license destruction이 포함됩니다.

            참고

            이후에 이 객체의 load() 를 이 객체의 sessionId 값으로 호출하면 해당 세션 ID에 대해 저장된 데이터가 없으므로 실패합니다.

         2. Set session closed to true.

         그렇지 않으면

         sanitized response를 처리하되 어떤 세션 데이터도 저장하지 않습니다.

         참고

         예를 들어, sanitized response가 또 다른 message 이벤트를 생성하는 데 사용될 정보를 포함할 수 있습니다. 이 경우에는 sessionType에 대해 내용을 검증할 필요가 없습니다.

      3. 만약 메시지를 전송할 필요가 있으면, 다음 단계를 실행합니다:

         1. message를 해당 메시지로 둡니다.

         2. message type을 그 메시지에 적절한 MediaKeyMessageType로 둡니다.

   8. 다음 단계들을 실행하는 작업(task)을 큐에 넣습니다:

      1. 만약 session closed가 true이면:

         이 객체에서 이유를 "release-acknowledged"로 하여 Session Closed 알고리즘을 실행합니다.

         그렇지 않으면:

         다음 단계들을 실행합니다:

         1. 만약 이 객체에 대해 CDM가 알고 있는 키(known)가 변경되었거나 어떤 키의 상태가 변경되었다면, session에 대해 Update Key Statuses 알고리즘을 실행하여 각 알려진 키의 key ID와 적절한 MediaKeyStatus를 제공합니다.

            키의 상태를 확정적으로 판단하기 위해 추가 처리가 필요하면 "status-pending"를 사용합니다. 추가 처리가 완료되면 실제 상태로 다시 Update Key Statuses 알고리즘을 실행합니다.

         2. 만약 세션의 expiration time이 변경되었으면, session에 대해 Update Expiration 알고리즘을 실행하여 새로운 만료 시간을 제공합니다.

         3. 앞선 단계들 중 어떤 것이 실패하면, 적절한 error name을 가진 새 DOMException로 promise를 거부합니다.

         4. 만약 message가 null이 아니면, session에서 Queue a "message" Event 알고리즘을 실행하여 message type과 message를 제공합니다.

      2. promise를 undefined로 이행(resolve)합니다.

7. promise를 반환합니다.

close()

애플리케이션이 더 이상 세션을 필요로 하지 않음을 나타내며, CDM가 세션과 관련된 자원을 해제하고 세션을 닫아야 함을 의미합니다. 영구 저장된 데이터는 해제되거나 삭제되어서는 안 됩니다.

참고

반환된 약속은 요청이 처리되었을 때 이행되며, 세션이 닫힐 때 closed 속성의 약속이 "closed-by-application"로 이행될 때 해결됩니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계들을 반드시(MUST) 실행해야 합니다:

1. 만약 이 객체의 closing or closed 값이 true이면, undefined로 이행된 약속을 반환합니다.

2. 만약 이 객체의 callable 값이 false이면, InvalidStateError로 거부된 약속을 반환합니다.

3. promise를 새 약속으로 둡니다.

4. 이 객체의 closing or closed 값을 true로 설정합니다.

5. 다음 단계들을 병렬로 실행합니다:

   1. cdm를 이 객체의 cdm instance 값으로 표시되는 CDM 인스턴스로 둡니다.

   2. cdm를 사용하여 이 객체와 연관된 key session을 닫습니다.

      참고

      key session을 닫으면 명시적으로 저장되지 않은 모든 라이선스와 키들이 파기됩니다.

   3. 다음 단계들을 실행하는 작업(task)을 큐에 넣습니다:

      1. promise를 undefined로 이행(resolve)합니다.

      2. 이유를 "closed-by-application"로 하여 이 객체에서 Session Closed 알고리즘을 실행합니다.

6. promise를 반환합니다.

remove()

세션과 연관된 모든 라이선스와 키를 제거합니다. 영구 세션 타입의 경우, 릴리스 메시지 확인이 update()에 의해 처리되면 각 세션 타입에 대해 정의된 대로 기타 세션 데이터가 삭제됩니다.

이 메서드가 호출되면, 사용자 에이전트는 다음 단계들을 반드시(MUST) 실행해야 합니다:

1. 만약 이 객체의 closing or closed 값이 true이면, InvalidStateError로 거부된 약속을 반환합니다.

2. 만약 이 객체의 callable 값이 false이면, InvalidStateError로 거부된 약속을 반환합니다.

3. promise를 새 약속으로 둡니다.

4. 다음 단계들을 병렬로 실행합니다:

   1. cdm를 이 객체의 cdm instance 값으로 표시되는 CDM 인스턴스로 둡니다.

   2. message를 null로 둡니다.

   3. message type를 null로 둡니다.

   4. 다음 단계를 수행하기 위해 cdm을 사용합니다:

      1. 만약 세션과 연관된 어떤 라이선스나 키가 있다면:

         1. 세션과 연관된 라이선스 및/또는 키를 파기합니다.

            참고

            이는 메모리나 영구 저장소에 있든지 간에 해당 라이선스 및/또는 키를 파기하는 것을 의미합니다.

         2. 이 객체의 session type 값에 대한 다음 목록의 단계를 따릅니다:

            "temporary"

            다음 단계들을 계속 진행합니다.

            "persistent-license"

            1. record of license destruction를 이 객체가 나타내는 라이선스에 대한 record of license destruction으로 둡니다.

            2. 그 record of license destruction를 저장합니다.

            3. message를 record of license destruction를 포함하거나 반영하는 메시지로 둡니다.

   5. 다음 단계들을 실행하는 작업(task)을 큐에 넣습니다:

      1. Update Key Statuses 알고리즘을 session에 대해 실행하여 세션 내 모든 key ID들에 대해 각 키에 대해 "released" MediaKeyStatus 값을 제공합니다.

      2. Update Expiration 알고리즘을 session에 대해 실행하여 NaN을 제공합니다.

      3. 앞선 단계들 중 어떤 것이 실패하면, 적절한 error name을 가진 새 DOMException로 promise를 거부합니다.

      4. message type을 "license-release"로 둡니다.

      5. promise를 undefined로 이행(resolve)합니다.

      6. 만약 message가 null이 아니면, session에서 Queue a "message" Event 알고리즘을 실행하여 message type과 message를 제공합니다.

5. promise를 반환합니다.

MediaKeyStatusMap 객체는 key IDs에서 해당 키의 현재 상태로 가는 읽기 전용 맵입니다.

키의 상태는 해당 키가 현재 사용 중인지 여부나 미디어 데이터와는 독립적입니다.

WebIDL[Exposed=Window, SecureContext] interface MediaKeyStatusMap {
  iterable<BufferSource,MediaKeyStatus>;
  readonly attribute unsigned long size;
  boolean has (BufferSource keyId);
  (MediaKeyStatus or undefined) get (BufferSource keyId);
};

WebIDLenum MediaKeyStatus {
  "usable",
  "expired",
  "released",
  "output-restricted",
  "output-downscaled",
  "usable-in-future",
  "status-pending",
  "internal-error"
};

MediaKeyStatus 열거형은 다음과 같이 정의됩니다:

MediaKeyMessageEvent 객체는 message 이벤트에 사용됩니다.

WebIDLenum MediaKeyMessageType {
  "license-request",
  "license-renewal",
  "license-release",
  "individualization-request"
};

MediaKeyMessageType는 다음과 같이 정의됩니다:

WebIDL[Exposed=Window, SecureContext]
interface MediaKeyMessageEvent : Event {
  constructor(DOMString type, MediaKeyMessageEventInit eventInitDict);
  readonly attribute MediaKeyMessageType messageType;
  readonly attribute ArrayBuffer         message;
};

WebIDLdictionary MediaKeyMessageEventInit : EventInit {
  required MediaKeyMessageType messageType;
  required ArrayBuffer         message;
};

메서드는 반환된 promise를 단순 예외 [WEBIDL] 또는 DOMException으로 거부(reject)함으로써 오류를 보고합니다. 다음의 [WEBIDL]에 정의된 단순 예외 및 DOMException 이름이 알고리즘에서 사용됩니다. 알고리즘에서 명시된 원인들은 각 이름 옆에 나열되어 있지만, 이 이름들은 다른 이유로도 사용될 수 있습니다.

이 절은 알고리즘을 보완하는 세션 저장 및 영속성 개요를 제공합니다.

다음 요구사항은 Storage and Persistence에서의 요구사항 외에도 적용됩니다.

이 객체의 session type에 대해 Is persistent session type? 알고리즘을 실행한 결과가 false이면, 사용자 에이전트 및 CDM은 어떠한 시점에서도 세션과 관련된 기록이나 데이터를 저장해서는 안 됩니다(MUST NOT). 여기에는 라이선스, 키, record(s) of license destruction 및 Session ID가 포함됩니다.

이 절의 나머지 부분은 Is persistent session type? 알고리즘이 true를 반환하는 세션 타입에 적용됩니다.

CDM은 세션 데이터(세션 ID 포함)를 첫 update() 호출 이전에 저장해서는 안 됩니다(SHOULD NOT). 즉, generateRequest() 알고리즘 중 세션 데이터를 저장해서는 안 됩니다(SHOULD NOT). 이는 애플리케이션이 세션을 인지하고, 결국 세션을 제거해야 함을 알 수 있게 합니다.

세션과 관련된 모든 데이터는 세션이 삭제될 때 반드시 삭제되어야 합니다(MUST). 예를 들어 update()에서 record of license destruction 확인을 처리할 때가 이에 해당합니다. 자세한 내용은 Persistent Data를 참조하세요.

CDM은 특정 세션에 대한 데이터가 MediaKeySession 객체 중 닫히지 않은 객체에서 하나만 존재하도록 보장해야 합니다(MUST). 즉, load()는 해당 sessionId를 나타내는 MediaKeySession가 이미 존재하면 반드시 실패해야 합니다(MUST). 이 객체는 generateRequest()로 생성되어 아직 활성 상태이거나, load()로 다른 객체에 로드된 상태일 수 있습니다. 세션은 해당 세션을 나타내는 모든 객체가 closed된 경우에만 다시 로드할 수 있습니다(MAY).

Is persistent session type? 알고리즘이 true를 반환하는 타입으로 세션을 생성한 애플리케이션은 나중에 remove()를 사용해 제거 프로세스를 시작하고, 메시지 교환 등으로 제거 프로세스가 성공적으로 완료되었는지 확인하여 저장된 데이터를 제거해야 합니다(SHOULD). CDM도 필요에 따라 세션을 제거할 수 있지만, 애플리케이션은 이에 의존해서는 안 됩니다(SHOULD NOT).

영구 저장소 지원 시 추가 고려사항은 10. 보안(Security) 및 11. 개인정보(Privacy)를 참조하세요.

mediaKeys 타입 MediaKeys, 읽기 전용, nullable

이 미디어 요소의 암호화된 미디어 데이터를 복호화할 때 사용되는 MediaKeys입니다.

onencrypted 타입 EventHandler

encrypted 이벤트에 대한 이벤트 핸들러입니다. 모든 HTMLMediaElement에서 content attribute와 IDL attribute 모두로 반드시(MUST) 지원되어야 합니다.

onwaitingforkey 타입 EventHandler

waitingforkey 이벤트에 대한 이벤트 핸들러입니다. 모든 HTMLMediaElement에서 content attribute와 IDL attribute 모두로 반드시(MUST) 지원되어야 합니다.

setMediaKeys()

재생 중 미디어 데이터를 복호화할 때 사용할 MediaKeys를 제공합니다.

참고

재생 중에 연관된 MediaKeys 객체를 지우거나 교체하는 것의 지원은 구현 품질에 따라 다릅니다. 많은 경우 나쁜 사용자 경험이나 promise 거부가 발생할 수 있습니다.

이 메서드를 호출하면, 사용자 에이전트는 다음 단계를 반드시(MUST) 실행해야 합니다:

1. 이 객체의 attaching media keys 값이 true이면, InvalidStateError로 거부된 promise를 반환합니다.

2. mediaKeys와 mediaKeys 속성이 동일 객체라면, undefined로 이행된 promise를 반환합니다.

3. 이 객체의 attaching media keys 값을 true로 설정합니다.

4. promise를 새 promise로 둡니다.

5. 다음 단계들을 병렬로 실행합니다:

   1. 다음 조건이 모두 참이면:

      • mediaKeys가 null이 아니고,

      • mediaKeys가 나타내는 CDM 인스턴스가 이미 다른 미디어 요소에서 사용 중이고,

      • 사용자 에이전트가 해당 요소와 함께 사용할 수 없는 경우

      이 객체의 attaching media keys 값을 false로 설정하고, promise를 QuotaExceededError로 거부합니다.

   2. mediaKeys 속성이 null이 아니면, 다음 단계들을 실행합니다:

      1. 사용자 에이전트 또는 CDM이 연관 제거를 지원하지 않으면, attaching media keys 값을 false로 하고, promise를 NotSupportedError로 거부합니다.

      2. 현재 연관을 제거할 수 없으면, attaching media keys 값을 false로 하고, promise를 InvalidStateError로 거부합니다.

         참고

         일부 구현체는 재생 중에 연관 제거를 허용하지 않을 수 있습니다.

      3. CDM 인스턴스를 사용하여, mediaKeys 속성에 연관된 미디어 데이터 복호화를 중단하고, 미디어 요소와의 연관을 제거합니다.

      4. 앞 단계가 실패하면, attaching media keys 값을 false로 하고, promise를 적절한 error name으로 거부합니다.

   3. mediaKeys가 null이 아니면, 다음 단계들을 실행합니다:

      1. CDM 인스턴스를 미디어 요소에 연관시켜 미디어 데이터 복호화에 사용할 수 있도록 합니다.

      2. 앞 단계가 실패하면, 다음 단계들을 실행합니다:

         1. mediaKeys 속성을 null로 설정합니다.

         2. attaching media keys 값을 false로 설정합니다.

         3. promise를 적절한 error name을 가진 새 DOMException으로 거부합니다.

      3. Queue a task를 사용하여 미디어 요소에서 Attempt to Resume Playback If Necessary 알고리즘을 실행합니다.

   4. mediaKeys 속성을 mediaKeys로 설정합니다.

   5. attaching media keys 값을 false로 설정합니다.

   6. promise를 undefined로 이행(resolve)합니다.

6. promise를 반환합니다.

MediaEncryptedEvent 객체는 encrypted 이벤트에 사용됩니다.

WebIDL[Exposed=Window]
interface MediaEncryptedEvent : Event {
    constructor(DOMString type, optional MediaEncryptedEventInit eventInitDict = {});
    readonly        attribute DOMString    initDataType;
    readonly        attribute ArrayBuffer? initData;
};

WebIDLdictionary MediaEncryptedEventInit : EventInit {
  DOMString    initDataType = "";
  ArrayBuffer? initData = null;
};

사용자 에이전트 구현자는 CDMs가 이 명세서의 기능을 사용해 보호된 미디어 재생에 합리적으로 필요한 범위를 벗어나는 정보, 저장소 또는 시스템 기능에 접근하지 않도록 보장해야 합니다. 구체적으로, CDM은 다음을 SHALL NOT 합니다:

• 사용자 에이전트를 통해 명시적으로 허용된 경우를 제외하고, 로컬 또는 원격의 네트워크 자원에 접근하지 않습니다.

• 보호된 미디어 재생에 합리적으로 필요한 경우를 제외하고 저장소(예: 디스크나 메모리)에 접근하지 않습니다.

• CDM 상태 및 persistent data 이외의 사용자 데이터에 접근하지 않습니다.

• 보호된 미디어 재생에 합리적으로 필요한 경우를 제외하고 하드웨어 구성 요소나 장치에 접근하지 않습니다.

사용자 에이전트 구현자는 위 요구사항을 충족하기 위해 다양한 기법을 사용할 수 있습니다. 예를 들어, 자체적으로 CDM를 구현하는 사용자 에이전트라면 해당 구성요소에 대한 설계 요구사항으로 위 조항을 포함할 수 있습니다. 서드파티 CDM를 사용하는 경우, 제약된 환경(예: "sandbox")에서 실행되도록 하여 금지된 정보와 구성요소에 접근하지 못하게 보장할 수 있습니다.

CDM와의 모든 메시지 및 통신(예: CDM과 라이선스 서버 간)은 반드시 사용자 에이전트를 통해 전달되어야 합니다. CDM은 직접적인 밴드 외 네트워크 요청을 해서는 안 됩니다(MUST NOT). Direct Individualization에서 설명된 경우를 제외한 모든 메시지와 통신은 애플리케이션을 통해 이 명세서에 정의된 API로 전달되어야 합니다(MUST). 특히 애플리케이션이 지정한 URL로 전송되거나 그 오리진에 기반한, 애플리케이션·오리진·컨텐츠 관련 정보를 포함하는 모든 통신은 API를 통해 전달되어야 합니다. 이는 모든 라이선스 교환 메시지를 포함합니다.

Persistent Data는 CDM 또는 사용자 에이전트가 CDM를 대신하여 저장한, MediaKeys 객체가 파기된 이후에도 존재하는 모든 데이터를 포함합니다. 구체적으로, 식별자(또는 Distinctive Identifier(s)를 포함), 라이선스, 키, 키 ID, 또는 record(s) of license destruction 등이 CDM 또는 사용자 에이전트에 의해 저장된 경우가 이에 해당합니다.

애플리케이션에 노출되거나 CDM의 사용을 통해 추론 가능한 값들은, 설계 목적과 상관없이 클라이언트나 사용자를 식별하는 데 사용될 수 있습니다. 이 절은 그러한 우려를 피하거나 완화하기 위한 요구사항을 정의합니다. Identifiers에 대한 추가 요구사항도 존재합니다.

구현체에서 식별자(특히 Distinctive Identifier(s) 또는 Distinctive Permanent Identifier(s))를 사용하는 것은 프라이버시 문제를 일으킬 수 있습니다. 이 절은 그러한 우려를 피하거나 완화하기 위한 요구사항을 정의합니다. Values Exposed to the Application의 요구사항은 애플리케이션에 노출되는 식별자에도 적용됩니다.

식별자, 특히 Distinctive Identifiers는 때때로 개별화(individualization) 또는 프로비저닝(provisioning)이라고 불리는 과정을 통해 생성되거나 획득됩니다. 그 결과로 얻어진 식별자들은 MUST 애플리케이션에 의해 연관될 수 없어야(non-associable by applications) 하며, 이들의 사용은 MUST 단일 프로파일의 단일 오리진에만 노출되어야 합니다. 이 과정은 식별자가 지워진 후와 같이 여러 번 수행될 수 있습니다(MAY).

이 과정은 사용자 에이전트에 의해 직접 수행되거나 애플리케이션을 통해 수행되어야 합니다(MUST). 두 가지 유형의 개별화에 대한 메커니즘, 흐름 및 제약은 아래 섹션에 설명된 바와 같이 서로 다릅니다. 어떤 방법이 사용되는지는 CDM 구현과 이 명세의 요구사항, 특히 아래 요구사항의 적용에 따라 달라집니다.

구현체는 각 MediaKeySession 객체에서 다중 키를 지원해야 합니다(MUST).

구현체는 재생 중 키 간의 원활한 전환을 지원해야 합니다(MUST). 여기에는 동일한 MediaKeySession 내의 키와 별도의 MediaKeySession 객체 간의 키 전환이 포함됩니다.

이 절은 이 명세의 구현체가 지원하는 콘텐츠(미디어 리소스)의 속성을 정의합니다.

"org.w3.clearkey" Key System은 평문 clear(암호화되지 않은) key들을 사용하여 소스를 복호화합니다. 추가적인 클라이언트 측 콘텐츠 보호는 필요하지 않습니다. 이 Key System은 아래에 설명되어 있습니다.

{
  "kids": [
    "LwVHf8JLtPrv2GUXFW2v_A",
    "0DdtU9od-Bh5L3xbv0Xf_A"
  ],
  "type": "temporary"
}

{
  "keys": [{
    "kty": "oct",
    "k": "tQ0bJVWb6b0KPL6KtZIy_A",
    "kid": "LwVHf8JLtPrv2GUXFW2v_A"
  }],
  "type": "temporary"
}

{
  "kids": [ "LwVHf8JLtPrv2GUXFW2v_A", "0DdtU9od-Bh5L3xbv0Xf_A" ]
}

{
  "kids": [
    "LwVHf8JLtPrv2GUXFW2v_A",
    "0DdtU9od-Bh5L3xbv0Xf_A"
  ]
}

User Agent 및 Key System 구현체는 MUST 미디어 데이터(media data), Initialization Data, update()에 전달된 데이터, 라이선스, 키 데이터 및 애플리케이션이 제공하는 기타 모든 데이터를 신뢰할 수 없는 콘텐츠이자 잠재적 공격 벡터로 고려해야 합니다. 그들은 관련 위협을 완화하기 위해 적절한 보호조치를 사용하고 그러한 데이터를 안전하게 구문 분석하고 복호화하는 등의 주의를 기울여야 합니다. User Agent는 SHOULD 데이터를 CDM에 전달하기 전에 검증해야 합니다.

구현체는 애플리케이션에 활성 콘텐츠나 프로그램 제어 흐름에 영향을 미치는 수동 콘텐츠를 반환해서는 안 됩니다(MUST NOT).

User Agent는 사용자가 웹을 안전하게 탐색할 수 있도록 제공할 책임이 있습니다. 이 책임은 서드파티의 기능을 포함하여 User Agent가 사용하는 모든 기능에 적용됩니다. User agent 구현자는 MUST Key System 구현자들로부터 통합의 보안 영향을 적절히 평가할 수 있는 충분한 정보를 얻어야 합니다. User agent 구현자는 MUST CDM 구현체가 사용자 에이전트를 위해 보안을 제공할 수 있도록 충분한 제어를 제공 및/또는 지원하는지 보장해야 합니다. 또한 User agent 구현자는 보안 취약점이 발견될 경우 CDM 구현체가 신속하고 능동적으로 업데이트될 수 있고 업데이트될 것임을 보장해야 합니다.

완전히 샌드박스되지 않았거나 플랫폼 기능을 사용하는 CDM 구현체를 악용하면 공격자가 OS나 플랫폼 기능에 접근하거나 권한을 상승시켜(예: 시스템 또는 root로 실행) 드라이버, 커널, 펌웨어, 하드웨어 등에 접근할 수 있습니다. 이러한 기능, 소프트웨어 및 하드웨어는 적대적인 소프트웨어나 웹 기반 공격에 대해 견고하게 작성되지 않았을 수 있으며, 특히 사용자 에이전트와 비교했을 때 보안 수정이 적용되지 않았을 수 있습니다. CDM 구현체의 보안 취약점에 대한 수정이 부족하거나 드물거나 느린 경우 위험이 증가합니다. 이러한 CDM 구현체 및 이를 노출하는 UA는 MUST 모든 보안 영역에서 특히 신중해야 하며, 모든 데이터의 구문 분석을 포함합니다.

사용자가 충분히 샌드박스되지 않거나 다른 방식으로 보안이 확보될 수 없는 Key System 구현체를 지원하기로 선택하는 경우, user agent는 로드하거나 호출하기 전에 사용자가 완전히 정보 제공을 받거나 명시적 동의를 제공하도록 SHOULD 해야 합니다(보안 관련 이유로서).

EME 및 Key Systems가 공개하는 정보에 대한 우려는 두 가지 범주로 나뉩니다: (a) 사용자 에이전트나 장치의 지문 추출 가능성에 기여할 수 있는 비특정적 정보에 대한 우려와 (b) 사용자 추적에 직접 사용될 수 있는 사용자 특정 정보입니다.

악의적인 애플리케이션은 지원되는 Key Systems의 목록과 관련 정보를 감지하거나 열거함으로써 사용자나 사용자 에이전트의 지문을 추출할 수 있습니다. 적절한 출처(origin) 보호가 제공되지 않으면 여기에는 방문한 사이트의 감지나 해당 사이트에 대해 저장된 정보의 식별이 포함될 수 있습니다. 특히, Key Systems는 origins 간에 키나 기타 데이터를 공유해서는 안 됩니다(MUST).

사용자 에이전트는 사용자 익명성을 유지하거나/또는 탐색 기록이 클라이언트에 영속되지 않도록 하기 위한 동작 모드(예: 개인 브라우징)를 지원할 수 있습니다. 이전 섹션에서 논의된 개인정보 우려는 이러한 모드를 사용하는 사용자에게 특히 중요할 수 있습니다.

이러한 모드들을 지원하는 사용자 에이전트 구현자는 SHOULD 해당 모드에서 Key Systems에 대한 접근을 비활성화해야 하는지 신중히 고려해야 합니다. 예를 들어, 이러한 모드는 MediaKeySystemAccess 객체의 생성 중에 persistentState 또는 distinctiveIdentifier를 지원하거나 사용하는 MediaKeySystemAccess 객체의 생성을 금지할 수 있습니다(이는 CDM 구현의 일부이거나 애플리케이션이 이를 "required"로 표시한 경우를 포함합니다). 구현이 이러한 생성을 금지하지 않는다면, 사용자가 해당 모드의 예상되는 개인정보 특성에 미치는 영향과 잠재적 결과를 이해하도록 정보를 제공한 후에만 사용을 허용해야 합니다(SHOULD).

이 사양에 정의된 API는 보안 출처에서만 지원되어 이전 섹션에서 논의된 정보를 보호합니다. 식별자는 또한 Encrypt Identifiers에 명시된 대로 암호화됩니다.

애플리케이션 및 이들이 사용하는 서버들은 CDM의 데이터나 메시지를 포함하거나 관련된 모든 트래픽에 대해, SHOULD 보안 전송을 사용해야 합니다. 여기에는 message 이벤트에서 전달되는 모든 데이터와 update()로 전달되는 데이터 등이 포함되며 이에 국한되지 않습니다.

모든 사용자 에이전트는 보안 출처 및 전송을 적용하려 할 때 불안전한 콘텐츠나 전송에 노출되는 것을 피하기 위해 혼합 콘텐츠[MIXED-CONTENT]를 적절히 처리해야 합니다(MUST).