| 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):voiddrmUpdateNeeded | 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():BooleansubErrorID | 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():BooleanDRMErrorEvent | () | 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
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne