MediaKeyStatusMap: phương thức get()
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.
Phương thức get() của giao diện MediaKeyStatusMap trả về giá trị trạng thái liên kết với khóa đã cho, hoặc undefined nếu không có.
Giá trị trạng thái cho biết liệu khóa cụ thể có thể được sử dụng để giải mã hay không.
Cú pháp
get(key)
Tham số
key-
Khóa có giá trị bạn muốn trả về.
Giá trị trả về
Một chuỗi chỉ định giá trị trạng thái liên kết với khóa đã cho, hoặc undefined.
Các giá trị trạng thái sau được phép:
usable-
Khóa hiện đang có thể sử dụng để giải mã.
expired-
Khóa không còn có thể sử dụng để giải mã vì thời gian hết hạn của nó đã qua.
released-
Khóa đã được giải phóng và không còn khả dụng cho CDM. Tuy nhiên, thông tin về khóa vẫn còn, chẳng hạn như hồ sơ hủy giấy phép.
output-restricted-
Có các hạn chế đầu ra liên kết với khóa dựa trên chính sách được chỉ định. Dữ liệu phương tiện được giải mã bằng khóa này có thể bị chặn hiển thị. Trạng thái cho biết kết nối giữa nguồn và đầu ra (ví dụ: máy tính và màn hình ngoài của bạn) không đáng tin cậy. Điều này có thể cho biết có sự không khớp phiên bản HDCP giữa nguồn, các thiết bị trung gian và đầu ra, hoặc các thiết bị kết nối trung gian như cáp HDMI hoặc bộ chia video bị hỏng hoặc không tuân thủ.
output-downscaled-
Có các hạn chế đầu ra liên kết với khóa dựa trên chính sách được chỉ định, nhưng các hạn chế này có thể được nới lỏng nếu nội dung được phát ở chất lượng thấp hơn. Nếu giá trị này được trả về, ứng dụng có thể phát nội dung ở độ phân giải thấp hơn.
usable-in-future-
Khóa sẽ trở nên có thể sử dụng để giải mã trong tương lai, khi đến thời gian bắt đầu của nó.
status-pending-
Trạng thái của khóa chưa được biết và đang được xác định.
internal-error-
Khóa hiện không thể sử dụng để giải mã do lỗi trong CDM. Ứng dụng không thể làm gì để xử lý trường hợp này.
Thông số kỹ thuật
| Thông số kỹ thuật |
|---|
| Encrypted Media Extensions> # dom-mediakeystatusmap-get> |