Pakiet | flash.events |
Klasa | public class DRMErrorEvent |
Dziedziczenie | DRMErrorEvent ErrorEvent TextEvent Event Object |
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Środowisko wykonawcze wywołuje DRMErrorEvent, gdy obiekt NetStream próbujący odtwarzać plik zaszyfrowany przy użyciu mechanizmu DRM (Digital Rights Management) napotka błąd związany z mechanizmem DRM. Obiekt DRMErrorEvent jest wywoływany na przykład w sytuacji, gdy dostawca treści nie obsługuje aplikacji wyświetlającej lub gdy autoryzacja użytkownika nie powiedzie się, np. dlatego, że użytkownik nie zakupił treści.
W przypadku niepoprawnych poświadczeń użytkownika obiekt DRMAuthenticateEvent obsługuje błąd, co polega na wielokrotnym wywoływaniu zdarzenia, dopóki użytkownik nie wprowadzi poprawnych poświadczeń lub aplikacja w środowisku wykonawczym nie odmówi podejmowania dalszych prób. Aplikacja powinna reagować na wszelkie inne zdarzenia błędów DRM w celu wykrywania, identyfikowania i obsługiwania błędów związanych z mechanizmem DRM.
Ta klasa udostępnia właściwości zawierające obiekt wywołujący wyjątek, kod błędu oraz, tam gdzie ma to zastosowanie, podrzędny kod błędu i komunikat tekstowy zawierający informacje związane z błędem. Opisy kodów błędów związanych z mechanizmem DRM zawiera sekcja Kody błędów czasu wykonywania. Kody błędów dotyczących mechanizmu DRM rozpoczynają się od numeru 3300.
Powiązane elementy interfejsu API
Właściwość | Zdefiniowane przez | ||
---|---|---|---|
bubbles : Boolean [tylko do odczytu]
Określa, czy zdarzenie może przechodzić fazę propagacji. | Event | ||
cancelable : Boolean [tylko do odczytu]
Wskazuje, czy można uniemożliwić operacje skojarzone ze zdarzeniem. | Event | ||
constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | ||
contentData : DRMContentData
Obiekt DRMContentData dla pliku multimedialnego. | DRMErrorEvent | ||
currentTarget : Object [tylko do odczytu]
Obiekt przetwarzający aktywnie obiekt Event za pomocą detektora zdarzeń. | Event | ||
drmUpdateNeeded : Boolean [tylko do odczytu]
Wskazuje, czy do odtwarzania treści chronionej przez mechanizm DRM wymagana jest aktualizacja oprogramowania DRM. | DRMErrorEvent | ||
errorID : int [tylko do odczytu]
Zawiera numer referencyjny skojarzony z konkretnym błędem. | ErrorEvent | ||
eventPhase : uint [tylko do odczytu]
Bieżąca faza przepływu zdarzeń. | Event | ||
subErrorID : int [tylko do odczytu]
Identyfikator błędu wskazujący bardziej szczegółowe informacje na temat problemu będącego przyczyną błędu. | DRMErrorEvent | ||
systemUpdateNeeded : Boolean [tylko do odczytu]
Wskazuje, czy do odtwarzania treści chronionej przez mechanizm DRM wymagana jest aktualizacja systemu. | DRMErrorEvent | ||
target : Object [tylko do odczytu]
Miejsce docelowe zdarzenia. | Event | ||
text : String
W przypadku zdarzenia textInput jest to znak lub sekwencja znaków wprowadzonych przez użytkownika. | TextEvent | ||
type : String [tylko do odczytu]
Typ zdarzenia. | Event |
Metoda | Zdefiniowane przez | ||
---|---|---|---|
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)
Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach dotyczących błędów DRM. | DRMErrorEvent | ||
[przesłanianie]
Tworzy kopię obiektu DRMErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału. | DRMErrorEvent | ||
Funkcja narzędziowa umożliwiająca implementację metody toString() w niestandardowych klasach Event w języku ActionScript 3.0. | Event | ||
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | ||
Sprawdza, czy w odniesieniu do tego zdarzenia wywołano metodę preventDefault(). | Event | ||
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | ||
Anuluje domyślne ustawienia zdarzenia, o ile zachowanie to może być anulowane. | Event | ||
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | ||
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węźle bieżącym i węzłach następujących po nim. | Event | ||
Zapobiega przetwarzaniu wszelkich detektorów zdarzeń w węzłach następujących po węźle bieżącym w przepływie zdarzeń. | Event | ||
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | ||
[przesłanianie]
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu DRMErrorEvent. | DRMErrorEvent | ||
Zwraca pierwotną wartość dla określonego obiektu. | Object |
Stała | Zdefiniowane przez | ||
---|---|---|---|
DRM_ERROR : String = "drmError" [statyczny]
Stała DRMErrorEvent.DRM_ERROR definiuje wartość właściwości type obiektu zdarzenia drmError. | DRMErrorEvent | ||
DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError" [statyczny] | DRMErrorEvent |
contentData | właściwość |
contentData:DRMContentData
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Obiekt DRMContentData dla pliku multimedialnego.
Obiektu wskazanego we właściwości contentData
można użyć do pobrania powiązanego kuponu DRM z pamięci podręcznej kuponów obiektu DRMManager. Właściwości kuponu opisują rodzaj licencji dostępnej dla użytkownika i mogą wyjaśniać powody, dla których nie jest możliwe wyświetlenie treści chronionej przez mechanizm DRM.
Implementacja
public function get contentData():DRMContentData
public function set contentData(value:DRMContentData):void
drmUpdateNeeded | właściwość |
drmUpdateNeeded:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2, Flash Player 10.1 |
Wskazuje, czy do odtwarzania zawartości chronionej przez mechanizm DRM wymagana jest aktualizacja oprogramowania DRM.
Implementacja
public function get drmUpdateNeeded():Boolean
subErrorID | właściwość |
systemUpdateNeeded | właściwość |
systemUpdateNeeded:Boolean
[tylko do odczytu] Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 2, Flash Player 10.1 |
Wskazuje, czy do odtwarzania zawartości chronionej przez mechanizm DRM wymagana jest aktualizacja systemu.
Implementacja
public function get systemUpdateNeeded():Boolean
DRMErrorEvent | () | Konstruktor |
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)
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Tworzy obiekt Event, który zawiera określone informacje o zdarzeniach dotyczących błędów DRM. Obiekty Event są przekazywane jako parametry do detektorów zdarzeń.
Parametrytype:String (default = NaN ) — Typ zdarzenia. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości type . Istnieje tylko jeden typ zdarzenia DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE .
| |
bubbles:Boolean (default = false ) — Określa, czy obiekt Event uczestniczy w etapie propagacji przepływu zdarzeń. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości bubbles .
| |
cancelable:Boolean (default = false ) — Określa, czy obiekt Event może zostać anulowany. Detektory zdarzeń mogą uzyskiwać dostęp do tej informacji za pośrednictwem dziedziczonej właściwości cancelable .
| |
inErrorDetail:String (default = " ") — Szczegóły składniowe błędu, o ile mają zastosowanie.
| |
inErrorCode:int (default = 0 ) — Główny kod błędu.
| |
insubErrorID:int (default = 0 ) — Drugorzędny identyfikator błędu.
| |
inMetadata:DRMContentData (default = null )
| |
inSystemUpdateNeeded:Boolean (default = false )
| |
inDrmUpdateNeeded:Boolean (default = false )
|
clone | () | metoda |
override public function clone():Event
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Tworzy kopię obiektu DRMErrorEvent i ustawia wartości poszczególnych właściwości zgodnie z właściwościami oryginału.
ZwracaEvent — Nowy obiekt DRMErrorEvent z wartościami właściwości zgodnymi z oryginałem.
|
toString | () | metoda |
override public function toString():String
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Zwraca ciąg znaków, który zawiera wszystkie właściwości obiektu DRMErrorEvent. Format ciągu znaków jest następujący:
[DRMErrorEvent type=wartość bubbles=wartość cancelable=wartość eventPhase=wartość errroID=wartość subErrorID=wartość text=wartość
String — Ciąg znaków, który zawiera wszystkie właściwości obiektu DRMErrorEvent.
|
DRM_ERROR | Stała |
public static const DRM_ERROR:String = "drmError"
Wersja języka: | ActionScript 3.0 |
Wersje środowiska wykonawczego: | AIR 1.0, Flash Player 10.1 |
Stała DRMErrorEvent.DRM_ERROR
definiuje wartość właściwości type
obiektu zdarzenia drmError
.
To zdarzenie ma następujące właściwości:
Właściwość | Wartość |
---|---|
bubbles | false |
cancelable | false ; nie ma domyślnego zachowania, które można byłoby anulować. |
errorID | Liczbowy kod błędu przypisany do problemu. |
subErrorID | Kod błędu określający bardziej szczegółowe informacje na temat problemu będącego przyczyną błędu. |
target | Obiekt NetStream. |
Powiązane elementy interfejsu API
DRM_LOAD_DEVICEID_ERROR | Stała |
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, 12:06 PM Z