Пакет | flash.events |
Класс | public class DRMErrorEvent |
Наследование | DRMErrorEvent ErrorEvent TextEvent Event Object |
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 10.1 |
Среда выполнения отправляет объект DRMErrorEvent, когда объект NetStream пытается воспроизвести файл с DRM-шифрованием и сталкивается с ошибкой, связанной с управлением цифровыми правами (DRM). Например, объект DRMErrorEvent отправляется, когда поставщик содержимого не поддерживает приложение для просмотра или когда пользователь не может пройти авторизацию, возможно, потому что не приобрел права доступа к содержимому.
Если используются недействительные учетные данные пользователя, объект DRMAuthenticateEvent обрабатывает ошибку путем многократной отправки события, пока пользователь не введет правильные учетные данные или пока приложение не отклонит последующие попытки. Приложение должно прослушивать все остальные события ошибок DRM, чтобы выявлять, распознавать и обрабатывать ошибки, имеющие отношения к DRM.
Этот класс содержит свойства, содержащие объект, выдавший исключение, код ошибки и, если применимо, дополнительный код ошибки, а также текстовое сообщение, содержащее информацию об ошибке. Описание кодов ошибок, связанных с DRM, см. в разделе Коды ошибок во время выполнения. Коды ошибок, связанных с DRM, начинаются с ошибки 3300.
Связанные элементы API
Свойство | Определено | ||
---|---|---|---|
bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | ||
cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | ||
constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | ||
contentData : DRMContentData
Объект DRMContentData для медиафайла. | DRMErrorEvent | ||
currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | ||
drmUpdateNeeded : Boolean [только для чтения]
Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить DRM. | DRMErrorEvent | ||
errorID : int [только для чтения]
Содержит ссылочный номер, связанный с конкретной ошибкой. | ErrorEvent | ||
eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | ||
subErrorID : int [только для чтения]
Идентификатор ошибки, сообщающий более подробную информацию о вызывавшей ее проблеме. | DRMErrorEvent | ||
systemUpdateNeeded : Boolean [только для чтения]
Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить систему. | DRMErrorEvent | ||
target : Object [только для чтения]
Целевой объект события. | Event | ||
text : String
Для события textInput — введенный пользователем знак или последовательность знаков. | TextEvent | ||
type : String [только для чтения]
Тип события. | Event |
Метод | Определено | ||
---|---|---|---|
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)
Создает объект Event, содержащий данные о событиях ошибок DRM. | DRMErrorEvent | ||
[переопределить]
Создает копию объекта DRMErrorEvent и задает значение каждого свойства, совпадающее с оригиналом. | DRMErrorEvent | ||
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | ||
Показывает, определено ли заданное свойство для объекта. | Object | ||
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | ||
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | ||
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | ||
Показывает наличие заданного свойства и его перечисляемость. | Object | ||
Задает доступность динамического свойства для операций цикла. | Object | ||
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | ||
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | ||
[переопределить]
Возвращает строку, содержащую все свойства объекта DRMErrorEvent. | DRMErrorEvent | ||
Возвращает элементарное значение заданного объекта. | Object |
Константа | Определено | ||
---|---|---|---|
DRM_ERROR : String = "drmError" [статические]
Константа DRMErrorEvent.DRM_ERROR определяет значение свойства type для объекта события drmError. | DRMErrorEvent | ||
DRM_LOAD_DEVICEID_ERROR : String = "drmLoadDeviceIdError" [статические] | DRMErrorEvent |
contentData | свойство |
contentData:DRMContentData
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.5, Flash Player 10.1 |
Объект DRMContentData для медиафайла.
С помощью объекта, на который ссылается свойство contentData
, можно получить соответствующий ваучер DRM из кэша ваучеров DRMManager. Свойства ваучера описывают лицензию, доступную для пользователя, и могут указать причину, по которой запрещен просмотр содержимого с защитой по технологии DRM.
Реализация
public function get contentData():DRMContentData
public function set contentData(value:DRMContentData):void
drmUpdateNeeded | свойство |
subErrorID | свойство |
systemUpdateNeeded | свойство |
DRMErrorEvent | () | Конструктор |
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)
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 10.1 |
Создает объект Event, содержащий данные о событиях ошибок DRM. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String (default = NaN ) — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type . Существует только один тип события DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE .
| |
bubbles:Boolean (default = false ) — Определяет, участвует ли объект Event в фазе восходящей цепочки потока событий. Прослушиватели событий могут получать эту информацию через унаследованное свойство bubbles .
| |
cancelable:Boolean (default = false ) — Определяет, можно ли отменить объект Event. Прослушиватели событий могут получать эту информацию через унаследованное свойство cancelable .
| |
inErrorDetail:String (default = " ") — Конкретные синтаксические сведения об ошибке, если это применимо.
| |
inErrorCode:int (default = 0 ) — Основной код ошибки.
| |
insubErrorID:int (default = 0 ) — Второстепенный идентификатор ошибки.
| |
inMetadata:DRMContentData (default = null )
| |
inSystemUpdateNeeded:Boolean (default = false )
| |
inDrmUpdateNeeded:Boolean (default = false )
|
clone | () | метод |
override public function clone():Event
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 10.1 |
Создает копию объекта DRMErrorEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект DRMErrorEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 10.1 |
Возвращает строку, содержащую все свойства объекта DRMErrorEvent. Строка имеет следующий формат:
[DRMErrorEvent type=value bubbles=value cancelable=value eventPhase=value errroID=value subErrorID=value text=value
String — Строка, содержащая все свойства объекта DRMErrorEvent.
|
DRM_ERROR | Константа |
public static const DRM_ERROR:String = "drmError"
Язык версии: | ActionScript 3.0 |
Версии среды выполнения: | AIR 1.0, Flash Player 10.1 |
Константа DRMErrorEvent.DRM_ERROR
определяет значение свойства type
для объекта события drmError
.
Это событие имеет следующие свойства:
Свойство | Значение |
---|---|
bubbles | false |
cancelable | false ; поведение по умолчанию, подлежащее отмене, не определено. |
errorID | Числовой код ошибки, присвоенный проблеме. |
subErrorID | Код ошибки, содержащий более подробную информацию о возникшей проблеме. |
target | Объект NetStream. |
Связанные элементы API
DRM_LOAD_DEVICEID_ERROR | Константа |
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, 11:34 AM Z