mozilla-central/testing/web-platform/mozilla/tests/webcodecs/audioDecoder-codec-specific.https.any.js (file symbol)

Source code

Revision control

Copy as Markdown

Other Tools

Test Info:

// META: global=window,dedicatedworker
// META: script=/webcodecs/utils.js
// META: variant=?mp4_raw_aac_no_desc
// By spec, if the description is absent, the bitstream defaults to ADTS format.
// However, this is added to ensure compatibility and handle potential misuse cases.
const MP4_AAC_DATA_NO_DESCRIPTION = {
src: 'sfx-aac.mp4',
config: {
codec: 'mp4a.40.2',
sampleRate: 48000,
numberOfChannels: 1,
},
chunks: [
{offset: 44, size: 241},
{offset: 285, size: 273},
{offset: 558, size: 251},
{offset: 809, size: 118},
{offset: 927, size: 223},
{offset: 1150, size: 141},
{offset: 1291, size: 217},
{offset: 1508, size: 159},
{offset: 1667, size: 209},
{offset: 1876, size: 176},
],
duration: 21333
};
// Allows mutating `callbacks` after constructing the AudioDecoder, wraps calls
// in t.step().
function createAudioDecoder(t, callbacks) {
return new AudioDecoder({
output(frame) {
if (callbacks && callbacks.output) {
t.step(() => callbacks.output(frame));
} else {
t.unreached_func('unexpected output()');
}
},
error(e) {
if (callbacks && callbacks.error) {
t.step(() => callbacks.error(e));
} else {
t.unreached_func('unexpected error()');
}
}
});
}
// Create a view of an ArrayBuffer.
function view(buffer, {offset, size}) {
return new Uint8Array(buffer, offset, size);
}
let CONFIG = null;
let CHUNK_DATA = null;
let CHUNKS = null;
promise_setup(async () => {
const data = {
'?mp4_raw_aac_no_desc': MP4_AAC_DATA_NO_DESCRIPTION,
}[location.search];
// Don't run any tests if the codec is not supported.
assert_equals("function", typeof AudioDecoder.isConfigSupported);
let supported = false;
try {
const support = await AudioDecoder.isConfigSupported({
codec: data.config.codec,
sampleRate: data.config.sampleRate,
numberOfChannels: data.config.numberOfChannels
});
supported = support.supported;
} catch (e) {
}
assert_implements_optional(supported, data.config.codec + ' unsupported');
// Fetch the media data and prepare buffers.
const response = await fetch(data.src);
const buf = await response.arrayBuffer();
CONFIG = {...data.config};
if (data.config.description) {
CONFIG.description = view(buf, data.config.description);
}
CHUNK_DATA = [];
// For PCM, split in chunks of 1200 bytes and compute the rest
if (data.chunks.length == 0) {
let offset = data.offset;
// 1200 is divisible by 2 and 3 and is a plausible packet length
// for PCM: this means that there won't be samples split in two packet
let PACKET_LENGTH = 1200;
let bytesPerSample = 0;
switch (data.config.codec) {
case "pcm-s16": bytesPerSample = 2; break;
case "pcm-s24": bytesPerSample = 3; break;
case "pcm-s32": bytesPerSample = 4; break;
case "pcm-f32": bytesPerSample = 4; break;
default: bytesPerSample = 1; break;
}
while (offset < buf.byteLength) {
let size = Math.min(buf.byteLength - offset, PACKET_LENGTH);
assert_equals(size % bytesPerSample, 0);
CHUNK_DATA.push(view(buf, {offset, size}));
offset += size;
}
data.duration = 1000 * 1000 * PACKET_LENGTH / data.config.sampleRate / bytesPerSample;
} else {
CHUNK_DATA = data.chunks.map((chunk, i) => view(buf, chunk));
}
CHUNKS = CHUNK_DATA.map((encodedData, i) => new EncodedAudioChunk({
type: 'key',
timestamp: i * data.duration,
duration: data.duration,
data: encodedData
}));
});
promise_test(t => {
return AudioDecoder.isConfigSupported(CONFIG);
}, 'Test isConfigSupported()');
promise_test(t => {
// Define a valid config that includes a hypothetical 'futureConfigFeature',
// which is not yet recognized by the User Agent.
const validConfig = {
...CONFIG,
futureConfigFeature: 'foo',
};
// The UA will evaluate validConfig as being "valid", ignoring the
// `futureConfigFeature` it doesn't recognize.
return AudioDecoder.isConfigSupported(validConfig).then((decoderSupport) => {
// AudioDecoderSupport must contain the following properites.
assert_true(decoderSupport.hasOwnProperty('supported'));
assert_true(decoderSupport.hasOwnProperty('config'));
// AudioDecoderSupport.config must not contain unrecognized properties.
assert_false(decoderSupport.config.hasOwnProperty('futureConfigFeature'));
// AudioDecoderSupport.config must contiain the recognized properties.
assert_equals(decoderSupport.config.codec, validConfig.codec);
assert_equals(decoderSupport.config.sampleRate, validConfig.sampleRate);
assert_equals(
decoderSupport.config.numberOfChannels, validConfig.numberOfChannels);
if (validConfig.description) {
// The description must be copied.
assert_false(
decoderSupport.config.description === validConfig.description,
'description is unique');
assert_array_equals(
new Uint8Array(decoderSupport.config.description, 0),
new Uint8Array(validConfig.description, 0), 'description');
} else {
assert_false(
decoderSupport.config.hasOwnProperty('description'), 'description');
}
});
}, 'Test that AudioDecoder.isConfigSupported() returns a parsed configuration');
promise_test(async t => {
const decoder = createAudioDecoder(t);
decoder.configure(CONFIG);
assert_equals(decoder.state, 'configured', 'state');
}, 'Test configure()');
promise_test(t => {
const decoder = createAudioDecoder(t);
return testClosedCodec(t, decoder, CONFIG, CHUNKS[0]);
}, 'Verify closed AudioDecoder operations');
promise_test(async t => {
const callbacks = {};
const decoder = createAudioDecoder(t, callbacks);
let outputs = 0;
callbacks.output = frame => {
outputs++;
frame.close();
};
decoder.configure(CONFIG);
CHUNKS.forEach(chunk => {
decoder.decode(chunk);
});
await decoder.flush();
assert_equals(outputs, CHUNKS.length, 'outputs');
}, 'Test decoding');
promise_test(async t => {
const callbacks = {};
const decoder = createAudioDecoder(t, callbacks);
let outputs = 0;
callbacks.output = frame => {
outputs++;
frame.close();
};
decoder.configure(CONFIG);
decoder.decode(new EncodedAudioChunk(
{type: 'key', timestamp: -42, data: CHUNK_DATA[0]}));
await decoder.flush();
assert_equals(outputs, 1, 'outputs');
}, 'Test decoding a with negative timestamp');
promise_test(async t => {
const callbacks = {};
const decoder = createAudioDecoder(t, callbacks);
let outputs = 0;
callbacks.output = frame => {
outputs++;
frame.close();
};
decoder.configure(CONFIG);
decoder.decode(CHUNKS[0]);
await decoder.flush();
assert_equals(outputs, 1, 'outputs');
decoder.decode(CHUNKS[0]);
await decoder.flush();
assert_equals(outputs, 2, 'outputs');
}, 'Test decoding after flush');
promise_test(async t => {
const callbacks = {};
const decoder = createAudioDecoder(t, callbacks);
decoder.configure(CONFIG);
decoder.decode(CHUNKS[0]);
decoder.decode(CHUNKS[1]);
const flushDone = decoder.flush();
// Wait for the first output, then reset.
let outputs = 0;
await new Promise(resolve => {
callbacks.output = frame => {
outputs++;
assert_equals(outputs, 1, 'outputs');
decoder.reset();
frame.close();
resolve();
};
});
// Flush should have been synchronously rejected.
await promise_rejects_dom(t, 'AbortError', flushDone);
assert_equals(outputs, 1, 'outputs');
}, 'Test reset during flush');
promise_test(async t => {
const callbacks = {};
const decoder = createAudioDecoder(t, callbacks);
// No decodes yet.
assert_equals(decoder.decodeQueueSize, 0);
decoder.configure(CONFIG);
// Still no decodes.
assert_equals(decoder.decodeQueueSize, 0);
let lastDequeueSize = Infinity;
decoder.ondequeue = () => {
assert_greater_than(lastDequeueSize, 0, "Dequeue event after queue empty");
assert_greater_than(lastDequeueSize, decoder.decodeQueueSize,
"Dequeue event without decreased queue size");
lastDequeueSize = decoder.decodeQueueSize;
};
for (let chunk of CHUNKS)
decoder.decode(chunk);
assert_greater_than_equal(decoder.decodeQueueSize, 0);
assert_less_than_equal(decoder.decodeQueueSize, CHUNKS.length);
await decoder.flush();
// We can guarantee that all decodes are processed after a flush.
assert_equals(decoder.decodeQueueSize, 0);
// Last dequeue event should fire when the queue is empty.
assert_equals(lastDequeueSize, 0);
// Reset this to Infinity to track the decline of queue size for this next
// batch of decodes.
lastDequeueSize = Infinity;
for (let chunk of CHUNKS)
decoder.decode(chunk);
assert_greater_than_equal(decoder.decodeQueueSize, 0);
decoder.reset();
assert_equals(decoder.decodeQueueSize, 0);
}, 'AudioDecoder decodeQueueSize test');