MediaKeySession

Baseline Widely available

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

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

Giao diện MediaKeySession của Encrypted Media Extensions API đại diện cho một ngữ cảnh trao đổi thông điệp với một module giải mã nội dung (CDM).

EventTarget MediaKeySession

Thuộc tính phiên bản

MediaKeySession.closed Read only

Trả về một Promise báo hiệu khi một MediaKeySession đóng. Promise này chỉ có thể được thực hiện và không bao giờ bị từ chối. Đóng một phiên có nghĩa là các giấy phép và khóa liên kết với nó không còn hợp lệ để giải mã dữ liệu phương tiện.

MediaKeySession.expiration Read only

Thời gian sau đó các khóa trong phiên hiện tại không còn có thể được sử dụng để giải mã dữ liệu phương tiện, hoặc NaN nếu không có thời gian như vậy. Giá trị này được xác định bởi CDM và được đo bằng mili giây kể từ ngày 1 tháng 1 năm 1970, UTC. Giá trị này có thể thay đổi trong suốt thời gian phiên, chẳng hạn như khi một hành động kích hoạt sự bắt đầu của một cửa sổ.

MediaKeySession.keyStatuses Read only

Chứa một tham chiếu đến một MediaKeyStatusMap chỉ đọc của các khóa của phiên hiện tại và trạng thái của chúng.

MediaKeySession.sessionId Read only

Chứa một chuỗi duy nhất được tạo bởi CDM cho đối tượng phương tiện hiện tại và các khóa hoặc giấy phép liên kết với nó.

Sự kiện

keystatuseschange

Kích hoạt khi có thay đổi trong các khóa của một phiên hoặc trạng thái của chúng.

message

Kích hoạt khi module giải mã nội dung đã tạo ra một thông điệp cho phiên.

Phương thức phiên bản

MediaKeySession.close()

Trả về một Promise sau khi thông báo rằng phiên phương tiện hiện tại không còn cần thiết và CDM nên giải phóng mọi tài nguyên liên quan đến đối tượng này và đóng nó.

MediaKeySession.generateRequest()

Trả về một Promise sau khi tạo yêu cầu giấy phép dựa trên dữ liệu khởi tạo.

MediaKeySession.load()

Trả về một Promise phân giải thành giá trị boolean sau khi tải dữ liệu cho một đối tượng phiên được chỉ định.

MediaKeySession.remove()

Trả về một Promise sau khi xóa mọi dữ liệu phiên liên quan đến đối tượng hiện tại.

MediaKeySession.update()

Trả về một Promise sau khi tải thông điệp và giấy phép vào CDM.

Ví dụ

js
// TBD

Thông số kỹ thuật

Specification
Encrypted Media Extensions
# mediakeysession-interface

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