AudioDecoder: phương thức configure()

Limited availability

This feature is not Baseline because it does not work in some of the most widely-used browsers.

Secure context: This feature is available only in secure contexts (HTTPS), in some or all supporting browsers.

Note: This feature is available in Dedicated Web Workers.

Phương thức configure() của giao diện AudioDecoder đưa một thông điệp điều khiển vào hàng đợi để cấu hình bộ giải mã âm thanh nhằm giải mã các đoạn dữ liệu.

Cú pháp

js
configure(config)

Tham số

config

Một đối tượng dictionary chứa các thành viên sau:

codec

Một chuỗi chứa chuỗi codec hợp lệ. Xem tham số "codecs" để biết chi tiết về cách xây dựng chuỗi codec.

sampleRate

Một số nguyên biểu diễn số mẫu khung trên giây.

numberOfChannels

Một số nguyên biểu diễn số kênh âm thanh.

description Optional

Một ArrayBuffer, TypedArray hoặc DataView chứa một chuỗi byte dành riêng cho codec, thường được gọi là extradata.

Note: Các đăng ký trong WebCodecs Codec Registry liên kết đến một đặc tả mô tả việc có nên điền và điền thành viên description tùy chọn như thế nào.

Giá trị trả về

Không có (undefined).

Ngoại lệ

TypeError

Được ném ra nếu config được cung cấp không hợp lệ.

InvalidStateError DOMException

Được ném ra nếu state"closed".

NotSupportedError DOMException

Được ném ra nếu config được cung cấp là hợp lệ nhưng user agent không thể cung cấp codec có thể giải mã cấu hình này.

Ví dụ

Ví dụ sau cấu hình audioDecoder với codec opus.

js
audioDecoder.configure({
  codec: "opus",
  sampleRate: 44100,
  numberOfChannels: 2,
});

Thông số kỹ thuật

Specification
WebCodecs
# dom-audiodecoder-configure

Khả năng tương thích trình duyệt