MediaStream

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since September 2017.

Giao diện MediaStream của Media Capture and Streams API đại diện cho một luồng nội dung phương tiện. Một luồng bao gồm nhiều track, chẳng hạn như track video hoặc audio. Mỗi track được chỉ định dưới dạng một thực thể của MediaStreamTrack.

Bạn có thể lấy đối tượng MediaStream bằng cách sử dụng constructor hoặc bằng cách gọi các hàm như MediaDevices.getUserMedia(), MediaDevices.getDisplayMedia(), hoặc HTMLCanvasElement.captureStream() và HTMLMediaElement.captureStream().

Constructor

MediaStream(): Tạo và trả về một đối tượng MediaStream mới. Bạn có thể tạo một luồng rỗng, một luồng dựa trên một luồng hiện có, hoặc một luồng chứa danh sách các track được chỉ định (được chỉ định dưới dạng mảng các đối tượng MediaStreamTrack).

Thuộc tính instance

Giao diện này kế thừa các thuộc tính từ phần tử cha của nó, EventTarget.

MediaStream.active Read only: Một giá trị Boolean trả về true nếu MediaStream đang hoạt động, hoặc false nếu ngược lại.
MediaStream.id Read only: Một chuỗi chứa một định danh duy nhất phổ quát (UUID) gồm 36 ký tự cho đối tượng.

Phương thức instance

Giao diện này kế thừa các phương thức từ phần tử cha của nó, EventTarget.

MediaStream.addTrack(): Lưu trữ bản sao của MediaStreamTrack được truyền làm tham số. Nếu track đã được thêm vào đối tượng MediaStream, không có gì xảy ra.
MediaStream.clone(): Trả về một bản sao của đối tượng MediaStream. Tuy nhiên, bản sao sẽ có một giá trị duy nhất cho id.
MediaStream.getAudioTracks(): Trả về danh sách các đối tượng MediaStreamTrack được lưu trữ trong đối tượng MediaStream có thuộc tính kind được đặt thành audio. Thứ tự không được xác định, và có thể thay đổi không chỉ từ trình duyệt này sang trình duyệt khác, mà còn từ lần gọi này sang lần gọi khác.
MediaStream.getTrackById(): Trả về track có ID tương ứng với ID được truyền trong tham số trackId. Nếu không có tham số nào được truyền, hoặc nếu không có track nào có ID đó tồn tại, nó trả về null. Nếu nhiều track có cùng ID, nó trả về track đầu tiên.
MediaStream.getTracks(): Trả về danh sách tất cả các đối tượng MediaStreamTrack được lưu trữ trong đối tượng MediaStream, bất kể giá trị của thuộc tính kind. Thứ tự không được xác định, và có thể thay đổi không chỉ từ trình duyệt này sang trình duyệt khác, mà còn từ lần gọi này sang lần gọi khác.
MediaStream.getVideoTracks(): Trả về danh sách các đối tượng MediaStreamTrack được lưu trữ trong đối tượng MediaStream có thuộc tính kind được đặt thành "video". Thứ tự không được xác định, và có thể thay đổi không chỉ từ trình duyệt này sang trình duyệt khác, mà còn từ lần gọi này sang lần gọi khác.
MediaStream.removeTrack(): Xóa MediaStreamTrack được truyền làm tham số. Nếu track không phải là một phần của đối tượng MediaStream, không có gì xảy ra.

Sự kiện

addtrack: Được kích hoạt khi một đối tượng MediaStreamTrack mới được thêm vào.
removetrack: Được kích hoạt khi một đối tượng MediaStreamTrack đã bị xóa.
active Non-standard: Được kích hoạt khi MediaStream được kích hoạt.
inactive Non-standard: Được kích hoạt khi MediaStream bị vô hiệu hóa.

Thông số kỹ thuật

Specification
Media Capture and Streams # mediastream

Tương thích trình duyệt

Xem thêm

Help improve MDN

Learn how to contribute

This page was last modified on Jan 1, 1970 by MDN contributors.

View this page on GitHub • Report a problem with this content