AudioData
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Note: This feature is available in Dedicated Web Workers.
Giao diện AudioData của WebCodecs API biểu diễn một mẫu âm thanh.
AudioData là một đối tượng có thể chuyển giao.
Mô tả
Một rãnh âm thanh bao gồm một luồng các mẫu âm thanh, trong đó mỗi mẫu biểu diễn một khoảnh khắc âm thanh đã được ghi lại. Một đối tượng AudioData là cách biểu diễn của một mẫu như vậy. Khi làm việc cùng với các giao diện của Insertable Streams API, bạn có thể chia một luồng thành các đối tượng AudioData riêng lẻ bằng MediaStreamTrackProcessor, hoặc tạo một rãnh âm thanh từ một luồng khung mẫu bằng MediaStreamTrackGenerator.
Note: Tìm hiểu thêm về âm thanh trên web trong Các khái niệm về âm thanh số.
Tài nguyên đa phương tiện
Một đối tượng AudioData chứa một tham chiếu đến tài nguyên đa phương tiện được gắn kèm. Tài nguyên đa phương tiện này chứa dữ liệu mẫu âm thanh thực tế mà đối tượng mô tả. Một tài nguyên đa phương tiện được user agent duy trì cho đến khi không còn được một đối tượng AudioData nào tham chiếu tới nữa, ví dụ khi gọi AudioData.close().
Các mặt phẳng và định dạng âm thanh
Để lấy định dạng mẫu của một AudioData, hãy dùng thuộc tính AudioData.format. Định dạng có thể được mô tả là xen kẽ (interleaved) hoặc phẳng (planar). Trong các định dạng xen kẽ, các mẫu âm thanh từ những kênh khác nhau được bố trí trong một bộ đệm duy nhất, gọi là một plane. Plane này chứa số phần tử bằng AudioData.numberOfFrames * AudioData.numberOfChannels.
Trong định dạng phẳng, số lượng plane bằng AudioData.numberOfChannels, và mỗi plane là một bộ đệm chứa số phần tử bằng AudioData.numberOfFrames.
Hàm tạo
AudioData()-
Tạo một đối tượng
AudioDatamới.
Thuộc tính thể hiện
AudioData.formatRead only-
Trả về định dạng mẫu của âm thanh.
AudioData.sampleRateRead only-
Trả về tốc độ lấy mẫu của âm thanh theo Hz.
AudioData.numberOfFramesRead only-
Trả về số khung mẫu.
AudioData.numberOfChannelsRead only-
Trả về số kênh âm thanh.
AudioData.durationRead only-
Trả về thời lượng của âm thanh theo micro giây.
AudioData.timestampRead only-
Trả về dấu thời gian của âm thanh theo micro giây.
Phương thức thể hiện
AudioData.allocationSize()-
Trả về số byte cần thiết để chứa mẫu sau khi được lọc theo các tùy chọn truyền vào phương thức.
AudioData.copyTo()-
Sao chép các mẫu từ plane được chỉ định của đối tượng
AudioDatasang đích. AudioData.clone()-
Tạo một đối tượng
AudioDatamới có tham chiếu đến cùng tài nguyên đa phương tiện với đối tượng gốc. AudioData.close()-
Xóa mọi trạng thái và giải phóng tham chiếu đến tài nguyên đa phương tiện.
Thông số kỹ thuật
| Specification |
|---|
| WebCodecs> # audiodata-interface> |