Package | flash.events |
Classe | public class DRMErrorEvent |
Héritage | DRMErrorEvent ErrorEvent TextEvent Event Object |
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
Le moteur d’exécution distribue un objet DRMErrorEvent lorsqu’un objet NetStream détecte une erreur DRM alors qu’il tente de lire un fichier chiffré DRM. Par exemple, un objet DRMErrorEvent est distribué lorsque le fournisseur de contenu ne prend pas en charge l’application d’affichage, ou en cas d’échec de l’autorisation de l’utilisateur, probablement parce que l’utilisateur n’a pas acheté le contenu.
En cas d’informations utilisateur non valides, l’objet DRMAuthenticateEvent gère l’erreur par des distributions répétées jusqu’à ce que l’utilisateur entre des informations d’identification valides, ou l’application refuse toute autre tentative. L’application doit écouter tout autre événement d’erreur DRM de façon à détecter, identifier et gérer les erreurs DRM.
Cette classe fournit des propriétés contenant l’objet qui renvoie l’exception, le code d’erreur et, le cas échéant, un code de sous-erreur et le message textuel contenant des informations relatives à l’erreur. Pour obtenir une description des codes d’erreur associés à la gestion des droits numériques, voir la rubrique Codes d’erreur d’exécution. Les codes d’erreur associés à la gestion des droits numériques commencent à partir de l’erreur 3300.
Plus d’exemples
Eléments de l’API associés
Propriété | Défini par | ||
---|---|---|---|
bubbles : Boolean [lecture seule]
Indique si un événement peut se propager vers le haut (bubbling). | Event | ||
cancelable : Boolean [lecture seule]
Indique si le comportement associé à l’événement peut être évité. | Event | ||
constructor : Object
Référence à l’objet de classe ou à la fonction constructeur d’une occurrence donnée d’un objet. | Object | ||
contentData : DRMContentData
DRMContentData pour le fichier multimédia. | DRMErrorEvent | ||
currentTarget : Object [lecture seule]
L’objet qui traite activement l’objet Event avec un écouteur d’événements. | Event | ||
drmUpdateNeeded : Boolean [lecture seule]
Indique si une mise à jour DRM est nécessaire pour lire le contenu protégé par DRM. | DRMErrorEvent | ||
errorID : int [lecture seule]
Contient le numéro de référence associé à l’erreur spécifique. | ErrorEvent | ||
eventPhase : uint [lecture seule]
Phase actuelle du flux d’événements. | Event | ||
subErrorID : int [lecture seule]
Un ID d’erreur qui indique des informations détaillées supplémentaires sur le problème sous-jacent. | DRMErrorEvent | ||
systemUpdateNeeded : Boolean [lecture seule]
Indique si une mise à jour système est nécessaire pour lire le contenu protégé par DRM. | DRMErrorEvent | ||
target : Object [lecture seule]
Cible de l’événement. | Event | ||
text : String
Dans le cas d’un événement textInput, caractère ou suite de caractères entré par l’utilisateur. | TextEvent | ||
type : String [lecture seule]
Type d’événement. | Event |
Méthode | Défini par | ||
---|---|---|---|
DRMErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, inErrorDetail:String = "", inErrorCode:int = 0, insubErrorID:int = 0, inMetadata:DRMContentData = null, inSystemUpdateNeeded:Boolean = false, inDrmUpdateNeeded:Boolean = false)
Crée un objet Event contenant des informations spécifiques sur les événements d’erreur DRM. | DRMErrorEvent | ||
[override]
Crée une copie de l’objet DRMErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine. | DRMErrorEvent | ||
Fonction d’un utilitaire permettant d’implémenter la méthode toString() dans des classes Event ActionScript 3.0 personnalisées. | Event | ||
Indique si la propriété spécifiée d’un objet est définie. | Object | ||
Vérifie si la méthode preventDefault() a été appelée pour l’événement. | Event | ||
Indique si une occurrence de la classe Object figure dans la chaîne de prototype de l’objet spécifié en tant que paramètre. | Object | ||
Annule le comportement par défaut d’un événement si cette opération est possible. | Event | ||
Indique si la propriété spécifiée existe et est énumérable. | Object | ||
Définit la disponibilité d’une propriété dynamique pour les opérations en boucle. | Object | ||
Bloque le traitement des écouteurs d’événement dans le nœud actuel et les suivants dans le flux d’événements. | Event | ||
Bloque le traitement des écouteurs d’événement dans les nœuds qui suivent le nœud actuel dans le flux d’événements. | Event | ||
Renvoie la représentation de chaîne de cet objet, formatée selon les paramètres régionaux en vigueur. | Object | ||
[override]
Renvoie une chaîne répertoriant toutes les propriétés de l’objet DRMErrorEvent. | DRMErrorEvent | ||
Renvoie la valeur primitive de l’objet spécifié. | Object |
Constante | Défini par | ||
---|---|---|---|
DRM_ERROR : String = "drmError" [statique]
La constante DRMErrorEvent.DRM_ERROR définit la valeur de la propriété type d’un objet événement drmError. | DRMErrorEvent | ||
DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError" [statique] | DRMErrorEvent |
contentData | propriété |
contentData:DRMContentData
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.5, Flash Player 10.1 |
DRMContentData pour le fichier multimédia.
Vous pouvez utiliser l’objet référencé par la propriété contentData
pour récupérer le voucher DRM associé à partir de la mémoire cache du voucher DRMManager. Les propriétés du voucher décrivent la licence proposée à l’utilisateur et peuvent expliquer les raisons pour lesquelles il est impossible d’afficher le contenu protégé par DRM.
Implémentation
public function get contentData():DRMContentData
public function set contentData(value:DRMContentData):void
drmUpdateNeeded | propriété |
subErrorID | propriété |
systemUpdateNeeded | propriété |
DRMErrorEvent | () | Constructeur |
public function DRMErrorEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, inErrorDetail:String = "", inErrorCode:int = 0, insubErrorID:int = 0, inMetadata:DRMContentData = null, inSystemUpdateNeeded:Boolean = false, inDrmUpdateNeeded:Boolean = false)
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
Crée un objet Event contenant des informations spécifiques sur les événements d’erreur DRM. Les objets Event sont transmis en tant que paramètres aux écouteurs d’événements.
Paramètrestype:String (default = NaN ) — Type de l’événement. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété type héritée. Il n’existe qu’un seul type d’événement DRMAuthenticate : DRMAuthenticateEvent.DRM_AUTHENTICATE .
| |
bubbles:Boolean (default = false ) — Détermine si l’objet Event prend part à la phase de propagation du flux d’événements. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété bubbles héritée.
| |
cancelable:Boolean (default = false ) — Détermine si l’objet Event peut être annulé. Les écouteurs d’événement peuvent accéder à cette information par le biais de la propriété cancelable héritée.
| |
inErrorDetail:String (default = " ") — Le cas échéant, les détails syntaxiques spécifiques de l’erreur.
| |
inErrorCode:int (default = 0 ) — Le code d’erreur principal.
| |
insubErrorID:int (default = 0 ) — L’ID d’erreur mineure.
| |
inMetadata:DRMContentData (default = null )
| |
inSystemUpdateNeeded:Boolean (default = false )
| |
inDrmUpdateNeeded:Boolean (default = false )
|
clone | () | méthode |
override public function clone():Event
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
Crée une copie de l’objet DRMErrorEvent et définit la valeur de chaque propriété de sorte qu’elle corresponde à la valeur d’origine.
Valeur renvoyéeEvent — Nouvel objet DRMErrorEvent dont les propriétés ont la même valeur que celles de l’objet d’origine.
|
toString | () | méthode |
override public function toString():String
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
Renvoie une chaîne répertoriant toutes les propriétés de l’objet DRMErrorEvent. La chaîne est écrite au format suivant :
[DRMErrorEvent type=valeur bubbles=valeur cancelable=valeur eventPhase=valeur errroID=valeur subErrorID=valeur text=valeur
String — Chaîne répertoriant toutes les propriétés de l’objet DRMErrorEvent.
|
DRM_ERROR | Constante |
public static const DRM_ERROR:String = "drmError"
Version du langage: | ActionScript 3.0 |
Versions du moteur d’exécution: | AIR 1.0, Flash Player 10.1 |
La constante DRMErrorEvent.DRM_ERROR
définit la valeur de la propriété type
d’un objet événement drmError
.
Les propriétés de cet événement sont les suivantes :
Propriété | Valeur |
---|---|
bubbles | false |
cancelable | false ; il n’existe aucun comportement par défaut à annuler. |
errorID | Un code d’erreur numérique correspondant au problème. |
subErrorID | Un code d’erreur qui indique des informations détaillées supplémentaires sur le problème sous-jacent. |
target | L’objet NetStream. |
Eléments de l’API associés
DRM_LOAD_DEVICEID_ERROR | Constante |
public static const DRM_LOAD_DEVICEID_ERROR:String = "drmLoadDeviceIdError"
package { import flash.display.Sprite; import flash.events.AsyncErrorEvent; import flash.events.NetStatusEvent; import flash.events.DRMErrorEvent; import flash.media.Video; import flash.net.NetConnection; import flash.net.NetStream; public class DRMVideoExample extends Sprite { var videoURL:String = "Video.flv"; var videoConnection:NetConnection; var videoStream:NetStream; var video:Video = new Video(); public function DRMVideoExample() { videoConnection = new NetConnection(); videoConnection.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoConnection.connect(null); } private function connectStream():void { videoStream = new NetStream(videoConnection); videoStream.addEventListener(NetStatusEvent.NET_STATUS, netStatusHandler); videoStream.addEventListener(AsyncErrorEvent.ASYNC_ERROR, asyncErrorHandler); videoStream.addEventListener(DRMErrorEvent.DRM_ERROR, drmErrorEventHandler); video.attachNetStream(videoStream); videoStream.play(videoURL); addChild(video); } private function netStatusHandler(event:NetStatusEvent):void { switch (event.info.code) { case "NetConnection.Connect.Success": connectStream(); break; case "NetStream.Play.StreamNotFound": trace("Unable to locate video: " + videoURL); break; } } private function asyncErrorHandler(event:AsyncErrorEvent):void { // ignore AsyncErrorEvent events. } private function drmErrorEventHandler(event:DRMErrorEvent):void { trace(event.toString()); } } }
Tue Jun 12 2018, 09:30 AM Z