SUDImageDecoder.decode
JS
Promise<Object> SUDImageDecoder.decode(Object options)功能描述
按帧下标取出一张完整合成后的画布,包装成独立的 VideoFrame。
参数
- Object options: 取帧参数,可省略。省略、
undefined或null时按frameIndex = 0、completeFramesOnly = true处理。传入非对象时同步抛TypeError
options 的属性说明:
| 属性 | 键值类型 | 默认值 | 是否必填 | 说明 |
|---|---|---|---|---|
| frameIndex | number | 0 | 否 | 帧下标,从 0 开始。必须是大于等于 0 的整数 |
| completeFramesOnly | boolean | true | 否 | 是否只返回完整帧。为 true 时等到完整帧才 resolve;为 false 时允许返回部分帧。 |
返回值
- Promise: 成功时 resolve 为解码结果对象
返回结果的属性说明:
| 属性 | 类型 | 说明 |
|---|---|---|
| image | VideoFrame | 完整合成后的 RGBA 画布帧 |
| complete | boolean | 是否为完整帧。当前产出帧均为完整帧,成功路径为 true |
示例:
JS
const result = await decoder.decode({ frameIndex: 0 });
ctx.drawImage(result.image, 0, 0);
result.image.close();