| <!doctype html> |
| <meta charset=utf-8> |
| <title>RTCRtpTransceiver.prototype.setCodecPreferences</title> |
| <script src="/resources/testharness.js"></script> |
| <script src="/resources/testharnessreport.js"></script> |
| <script> |
| 'use strict'; |
| |
| // Test is based on the following editor draft: |
| // https://w3c.github.io/webrtc-pc/archives/20170605/webrtc.html |
| |
| /* |
| 5.4. RTCRtpTransceiver Interface |
| interface RTCRtpTransceiver { |
| ... |
| void setCodecPreferences(sequence<RTCRtpCodecCapability> codecs); |
| }; |
| |
| setCodecPreferences |
| - Setting codecs to an empty sequence resets codec preferences to any |
| default value. |
| |
| - The codecs sequence passed into setCodecPreferences can only contain |
| codecs that are returned by RTCRtpSender.getCapabilities(kind) or |
| RTCRtpReceiver.getCapabilities(kind), where kind is the kind of the |
| RTCRtpTransceiver on which the method is called. Additionally, the |
| RTCRtpCodecParameters dictionary members cannot be modified. If |
| codecs does not fulfill these requirements, the user agent MUST throw |
| an InvalidAccessError. |
| */ |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const capabilities = RTCRtpSender.getCapabilities('audio'); |
| transceiver.setCodecPreferences(capabilities.codecs); |
| |
| }, `setCodecPreferences() on audio transceiver with codecs returned from RTCRtpSender.getCapabilities('audio') should succeed`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('video'); |
| const capabilities = RTCRtpReceiver.getCapabilities('video'); |
| transceiver.setCodecPreferences(capabilities.codecs); |
| |
| }, `setCodecPreferences() on video transceiver with codecs returned from RTCRtpReceiver.getCapabilities('video') should succeed`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const capabilities1 = RTCRtpSender.getCapabilities('audio'); |
| const capabilities2 = RTCRtpReceiver.getCapabilities('audio'); |
| transceiver.setCodecPreferences([...capabilities1.codecs, ... capabilities2.codecs]); |
| |
| }, `setCodecPreferences() with both sender receiver codecs combined should succeed`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| transceiver.setCodecPreferences([]); |
| |
| }, `setCodecPreferences([]) should succeed`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const capabilities = RTCRtpSender.getCapabilities('audio'); |
| const { codecs } = capabilities; |
| |
| if(codecs.length >= 2) { |
| const tmp = codecs[0]; |
| codecs[0] = codecs[1]; |
| codecs[1] = tmp; |
| } |
| |
| transceiver.setCodecPreferences(codecs); |
| |
| }, `setCodecPreferences() with reordered codecs should succeed`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const capabilities = RTCRtpSender.getCapabilities('video'); |
| assert_throws(() => transceiver.setCodecPreferences(capabilities.codecs)); |
| |
| }, `setCodecPreferences() on audio transceiver with codecs returned from getCapabilities('video') should throw InvalidAccessError`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const codecs = [{ |
| mimeType: 'audio/piepiper', |
| clockRate: 2000, |
| channels: 2, |
| sdpFmtpLine: 'a=fmtp:98 0-15' |
| }]; |
| |
| assert_throws(() => transceiver.setCodecPreferences(codecs)); |
| |
| }, `setCodecPreferences() with user defined codec should throw InvalidAccessError`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const capabilities = RTCRtpSender.getCapabilities('audio'); |
| const codecs = [ |
| ...capabilities.codecs, |
| { |
| mimeType: 'audio/piepiper', |
| clockRate: 2000, |
| channels: 2, |
| sdpFmtpLine: 'a=fmtp:98 0-15' |
| }]; |
| |
| assert_throws(() => transceiver.setCodecPreferences(codecs)); |
| |
| }, `setCodecPreferences() with user defined codec together with codecs returned from getCapabilities() should throw InvalidAccessError`); |
| |
| test(() => { |
| const pc = new RTCPeerConnection(); |
| const transceiver = pc.addTransceiver('audio'); |
| const capabilities = RTCRtpSender.getCapabilities('audio'); |
| |
| const { codecs } = capabilities; |
| assert_greater_than(codecs.length, 0, |
| 'Expect at least one codec available'); |
| |
| const [ codec ] = codecs; |
| const { channels=2 } = codec; |
| codec.channels = channels+1; |
| |
| assert_throws(() => transceiver.setCodecPreferences(codecs)); |
| |
| }, `setCodecPreferences() with modified codecs returned from getCapabilities() should throw InvalidAccessError`); |
| |
| </script> |
