미디어 기능

2.3.1. MediaCapabilitiesEncodingInfo 생성

MediaCapabilitiesEncodingInfo 생성을 위해, MediaEncodingConfiguration configuration이 주어졌을 때 다음 단계를 실행한다. 이들은 MediaCapabilitiesEncodingInfo를 반환한다:

1. info를 새로운 MediaCapabilitiesEncodingInfo 인스턴스로 한다. 별도의 언급이 없다면 이후 단계에서 info를 읽고 쓴다.
2. configuration 을 새로운 MediaEncodingConfiguration으로 설정한다. configuration의 각각의 속성에 대해 같은 이름과 값을 가진 새로운 속성을 configuration에 생성한다.
3. videoSupported를 unknown으로 한다.
4. video 가 configuration에 존재하면, 다음 단계를 실행한다:
   1. videoMimeType을 MIME 타입 파싱을 configuration의 contentType으로 실행한 결과로 한다.
   2. videoSupported를 MIME 타입 지원 여부 확인을 videoMimeType과 configuration의 type으로 실행한 결과로 한다.
5. audioSupported를 unknown으로 한다.
6. audio 가 configuration에 존재하면, 다음 단계를 실행한다:
   1. audioMimeType을 MIME 타입 파싱을 configuration의 contentType으로 실행한 결과로 한다.
   2. audioSupported를 MIME 타입 지원 여부 확인을 audioMimeType과 configuration의 type으로 실행한 결과로 한다.
7. videoSupported 또는 audioSupported가 unsupported인 경우 supported 를 false, smooth 를 false, powerEfficient 를 false로 설정하고 info를 반환한다.
8. 그 외의 경우 supported 를 true로 설정한다.
9. 사용자 에이전트가 configuration이 나타내는 미디어를 지정된 프레임레이트로 인코딩할 수 있다면 smooth 를 true로 설정한다. 그렇지 않으면 false로 설정한다.
10. 사용자 에이전트가 configuration이 나타내는 미디어를 전력 효율적으로 인코딩할 수 있다면 powerEfficient 를 true로 설정한다. 그렇지 않으면 false로 설정한다.
11. info를 반환한다.

2.3.2. MediaCapabilitiesDecodingInfo 생성

MediaCapabilitiesDecodingInfo 생성을 위해, MediaDecodingConfiguration configuration이 주어졌을 때 다음 단계를 실행한다. 이들은 MediaCapabilitiesDecodingInfo를 반환한다:

1. info를 새로운 MediaCapabilitiesDecodingInfo 인스턴스로 한다. 별도의 언급이 없다면 이후 단계에서 info를 읽고 쓴다.
2. configuration 을 새로운 MediaDecodingConfiguration으로 설정한다. configuration의 각각의 속성에 대해 같은 이름과 값을 가진 새로운 속성을 configuration에 생성한다.
3. configuration.keySystemConfiguration이 존재하면:
   1. keySystemAccess 를 암호화된 디코딩 지원 확인 알고리즘을 configuration으로 실행한 결과로 설정한다.
   2. keySystemAccess 가 null이면 supported 를 false, smooth 를 false, powerEfficient 를 false로 설정하고 info를 반환한다.
   3. 그렇지 않으면 supported 를 true로 설정하고 6단계로 진행한다.
4. 그 외의 경우 다음 단계를 실행한다:
   1. keySystemAccess 를 null로 설정한다.
   2. videoSupported를 unknown으로 한다.
   3. video 가 configuration에 존재하면, 다음 단계를 실행한다:
      1. videoMimeType을 MIME 타입 파싱을 configuration의 contentType으로 실행한 결과로 한다.
      2. videoSupported를 MIME 타입 지원 여부 확인을 videoMimeType, configuration의 type, configuration의 colorGamut, configuration의 transferFunction으로 실행한 결과로 한다.
   4. audioSupported를 unknown으로 한다.
   5. audio 가 configuration에 존재하면, 다음 단계를 실행한다:
      1. audioMimeType을 MIME 타입 파싱을 configuration의 contentType으로 실행한 결과로 한다.
      2. audioSupported를 MIME 타입 지원 여부 확인을 audioMimeType과 configuration의 type으로 실행한 결과로 한다.
   6. videoSupported 또는 audioSupported가 unsupported인 경우 supported 를 false, smooth 를 false, powerEfficient 를 false로 설정하고 info를 반환한다.
5. supported 를 true로 설정한다.
6. 사용자 에이전트가 configuration이 나타내는 미디어를 지정된 프레임레이트로 프레임 드롭 없이 디코딩할 수 있다면 smooth 를 true로 설정한다. 그렇지 않으면 false로 설정한다.
7. 사용자 에이전트가 configuration이 나타내는 미디어를 전력 효율적으로 디코딩할 수 있다면 powerEfficient 를 true로 설정한다. 그렇지 않으면 false로 설정한다.
8. info를 반환한다.

2.3.3. MIME 타입 유효성 검사

MIME 타입 유효성 검사를 위해 MIME 타입 레코드 mimeType과 문자열 media가 주어졌을 때 다음 단계를 실행한다:

1. [RFC9110] 기준에서 mimeType의 타입이 media 또는 application이 아니면 false를 반환한다.
2. mimeType의 type과 subtype 멤버가 단일 미디어 코덱을 허용하고 parameters 멤버가 비어 있지 않으면 false를 반환한다.
3. mimeType의 type과 subtype 멤버가 다중 미디어 코덱을 허용한다면 다음 단계를 실행한다:
   1. mimeType의 parameters 멤버에 "codecs"라는 단일 키가 없으면 false를 반환한다.

      단일 미디어 코덱이 나열되는 것이 왜 중요한가? [Issue #235]

   2. mimeType.parameters["codecs"] 값이 단일 미디어 코덱을 설명하지 않으면 false를 반환한다.
4. true를 반환한다.

이 논리가 webrtc에도 적용되는가? [Issue #238]

2.3.4. MIME 타입 지원 여부 확인

MIME 타입 지원 여부 확인을 실행하려면, MIME type record mimeType, MediaEncodingType 또는 MediaDecodingType encodingOrDecodingType, 선택적 colorGamut (colorGamut), 그리고 선택적 transferFunction (transferFunction) 이 주어질 때, 다음 단계를 수행한다. MIME 타입이 사용자 에이전트에 의해 지원된다면 supported를, 지원되지 않으면 unsupported를 반환한다:

1. encodingOrDecodingType이 webrtc (MediaEncodingType) 또는 webrtc (MediaDecodingType) 이고, mimeType이 RTP에서 사용하는 타입이 아니면 ([IANA-MEDIA-TYPES] [RFC6838] 참고), unsupported를 반환한다.

   코덱 이름은 보통 subtype에 명시되며, 코덱에 따라 0개 이상의 파라미터가 있을 수 있다.

2. colorGamut이 있고, mimeType에 올바르지 않으면 unsupported를 반환한다.
3. transferFunction이 있고, mimeType에 올바르지 않으면 unsupported를 반환한다.

   사용자 에이전트는 mimeType에서 명명된 비디오 코덱의 명세를 참고하여 colorGamut과 transferFunction의 올바른 값을 결정해야 한다.

   여기의 검증 단계에서 상호운용성을 어떻게 보장할 수 있을까? [Issue #245]

4. mimeType이 사용자 에이전트에 의해 지원되지 않으면 unsupported를 반환한다.
5. supported를 반환한다.

2.3.5. 암호화된 디코딩 지원 확인

암호화된 디코딩 지원 확인을 실행하려면 MediaDecodingConfiguration config가 주어지고, keySystemConfiguration 이 존재하면, 다음 단계를 수행한다. 결과는 MediaKeySystemAccess 또는 null이다:

1. keySystem 멤버가 config.keySystemConfiguration에 있고, Key Systems 중 사용자 에이전트가 지원하는 시스템이 아니면 null을 반환한다. 문자열 비교는 대소문자 구분.
2. origin을 호출 컨텍스트의 origin으로 한다. Document 기준.
3. implementation을 config.keySystemConfiguration.keySystem의 구현체로 한다.
4. emeConfiguration을 새로운 MediaKeySystemConfiguration으로 하고 다음과 같이 초기화한다:
   1. initDataTypes 속성을 config.keySystemConfiguration.initDataType을 포함하는 시퀀스로 설정한다.
   2. distinctiveIdentifier 속성을 config.keySystemConfiguration.distinctiveIdentifier로 설정한다.
   3. persistentState 속성을 config.keySystemConfiguration.peristentState로 설정한다.
   4. sessionTypes 속성을 config.keySystemConfiguration.sessionTypes로 설정한다.
   5. audio 가 config에 존재하면, audioCapabilities 속성을 단일 MediaKeySystemMediaCapability로 이루어진 시퀀스로 설정하며, 다음과 같이 초기화한다:
      1. contentType 속성을 config.audio.contentType로 설정한다.
      2. config.keySystemConfiguration.audio가 존재하면:
         1. config.keySystemConfiguration.audio.robustness가 존재하고 null이 아니면, robustness 속성을 config.keySystemConfiguration.audio.robustness로 설정한다.
         2. encryptionScheme 속성을 config.keySystemConfiguration.audio.encryptionScheme로 설정한다.
   6. video 가 config에 존재하면, videoCapabilities 속성을 단일 MediaKeySystemMediaCapability로 이루어진 시퀀스로 설정하며, 다음과 같이 초기화한다:
      1. contentType 속성을 config.video.contentType로 설정한다.
      2. config.keySystemConfiguration.video가 존재하면:
         1. config.keySystemConfiguration.video.robustness가 존재하고 null이 아니면, robustness 속성을 config.keySystemConfiguration.video.robustness로 설정한다.
         2. encryptionScheme 속성을 config.keySystemConfiguration.video.encryptionScheme로 설정한다.
5. supported configuration을 Get Supported Configuration 알고리즘([ENCRYPTED-MEDIA])을 implementation, emeConfiguration, origin에 대해 실행한 결과로 한다.
6. supported configuration이 NotSupported이면 null을 반환한다.
7. access를 새로운 MediaKeySystemAccess 객체로 하고, 다음과 같이 초기화한다:
   1. keySystem 속성을 emeConfiguration.keySystem로 설정한다.
   2. configuration 값을 supported configuration으로 한다.
   3. cdm implementation 값을 implementation으로 한다.
8. access를 반환한다.