HTMLMediaElement : méthode setMediaKeys()
Baseline
Large disponibilité
Cette fonctionnalité est bien établie et fonctionne sur de nombreux appareils et versions de navigateurs. Elle est disponible sur tous les navigateurs depuis mars 2019.
Contexte sécurisé: Cette fonctionnalité est uniquement disponible dans des contextes sécurisés (HTTPS), pour certains navigateurs qui la prennent en charge.
La méthode setMediaKeys() de l'interface HTMLMediaElement définit les MediaKeys qui seront utilisés pour déchiffrer les médias pendant la lecture.
Elle retourne une promesse (Promise) qui se résout si les nouvelles clés sont correctement définies, ou se rejette si les clés ne peuvent pas être définies.
Syntaxe
setMediaKeys(mediaKeys)
Paramètres
mediaKeys-
Un objet
MediaKeysque leHTMLMediaElementpeut utiliser pour le déchiffrement des données médias pendant la lecture.
Valeur de retour
Exceptions
La promesse retournée peut rejeter une erreur :
InvalidStateErrorDOMException-
Les clés de média sont déjà en cours d'attachement, ou les clés précédentes ne peuvent pas être supprimées pour le moment (par exemple, parce que l'implémentation particulière ne permet pas la suppression pendant la lecture).
QuotaExceededError-
Les clés passées sont déjà utilisées par un autre élément, ou le navigateur ne peut pas les utiliser avec cet élément pour d'autres raisons.
NotSupportedErrorDOMException-
Les clés de média actuellement associées au média ne peuvent pas être dissociées, car cela n'est pris en charge ni par le CDM ni par le navigateur.
Spécifications
| Spécification |
|---|
| Encrypted Media Extensions # dom-htmlmediaelement-setmediakeys |