Справочник по ActionScript® 3.0 для платформы Adobe® Flash®
Домашняя страница  |  Скрыть список пакетов и классов |  Пакеты  |  Классы  |  Что нового  |  Указатель  |  Приложения  |  Почему по-английски?
Фильтры: Получение данных с сервера...
Получение данных с сервера...
flash.events 

DRMErrorEvent  - AS3

Пакетflash.events
Классpublic class DRMErrorEvent
НаследованиеDRMErrorEvent Inheritance ErrorEvent Inheritance TextEvent Inheritance Event Inheritance Object

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 10.1

Класс DRMErrorEvent предоставляет информацию об ошибках, которые происходят при воспроизведении файлов, защищенных DRM-шифрованием.

Среда выполнения отправляет объект DRMErrorEvent, когда объект NetStream пытается воспроизвести файл с DRM-шифрованием и сталкивается с ошибкой, связанной с управлением цифровыми правами (DRM). Например, объект DRMErrorEvent отправляется, когда поставщик содержимого не поддерживает приложение для просмотра или когда пользователь не может пройти авторизацию, возможно, потому что не приобрел права доступа к содержимому.

Если используются недействительные учетные данные пользователя, объект DRMAuthenticateEvent обрабатывает ошибку путем многократной отправки события, пока пользователь не введет правильные учетные данные или пока приложение не отклонит последующие попытки. Приложение должно прослушивать все остальные события ошибок DRM, чтобы выявлять, распознавать и обрабатывать ошибки, имеющие отношения к DRM.

Этот класс содержит свойства, содержащие объект, выдавший исключение, код ошибки и, если применимо, дополнительный код ошибки, а также текстовое сообщение, содержащее информацию об ошибке. Описание кодов ошибок, связанных с DRM, см. в разделе Коды ошибок во время выполнения. Коды ошибок, связанных с DRM, начинаются с ошибки 3300.

Посмотреть примеры

Связанные элементы API



Общедоступные свойства
 СвойствоОпределено
 Inheritedbubbles : Boolean
[только для чтения] Определяет, является ли событие событием восходящей цепочки.
Event
 Inheritedcancelable : Boolean
[только для чтения] Указывает, можно ли предотвратить поведение, связанное с событием.
Event
 Inheritedconstructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта.
Object
  contentData : DRMContentData
Объект DRMContentData для медиафайла.
DRMErrorEvent
 InheritedcurrentTarget : Object
[только для чтения] Объект, активно обрабатывающий объект Event с помощью прослушивателя событий.
Event
  drmUpdateNeeded : Boolean
[только для чтения] Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить DRM.
DRMErrorEvent
 InheritederrorID : int
[только для чтения] Содержит ссылочный номер, связанный с конкретной ошибкой.
ErrorEvent
 InheritedeventPhase : uint
[только для чтения] Текущая фаза в потоке событий.
Event
  subErrorID : int
[только для чтения] Идентификатор ошибки, сообщающий более подробную информацию о вызывавшей ее проблеме.
DRMErrorEvent
  systemUpdateNeeded : Boolean
[только для чтения] Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить систему.
DRMErrorEvent
 Inheritedtarget : Object
[только для чтения] Целевой объект события.
Event
 Inheritedtext : String
Для события textInput — введенный пользователем знак или последовательность знаков.
TextEvent
 Inheritedtype : 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
 Inherited
formatToString(className:String, ... arguments):String
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event.
Event
 Inherited
Показывает, определено ли заданное свойство для объекта.
Object
 Inherited
Проверяет, выполнялся ли для события вызова метода preventDefault().
Event
 Inherited
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра.
Object
 Inherited
Отменяет поведение по умолчанию для события, если такое поведение можно отменить.
Event
 Inherited
Показывает наличие заданного свойства и его перечисляемость.
Object
 Inherited
Задает доступность динамического свойства для операций цикла.
Object
 Inherited
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом.
Event
 Inherited
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали.
Object
  
[переопределить] Возвращает строку, содержащую все свойства объекта DRMErrorEvent.
DRMErrorEvent
 Inherited
Возвращает элементарное значение заданного объекта.
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

свойство 
drmUpdateNeeded:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2, Flash Player 10.1

Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить DRM.



Реализация
    public function get drmUpdateNeeded():Boolean

subErrorID

свойство 
subErrorID:int  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 1.0, Flash Player 10.1

Идентификатор ошибки, сообщающий более подробную информацию о вызывавшей ее проблеме.



Реализация
    public function get subErrorID():int

systemUpdateNeeded

свойство 
systemUpdateNeeded:Boolean  [только для чтения]

Язык версии: ActionScript 3.0
Версии среды выполнения: AIR 2, Flash Player 10.1

Указывает, что для воспроизведения содержимого с DRM-шифрованием требуется обновить систему.



Реализация
    public function get systemUpdateNeeded():Boolean
Сведения о конструкторе

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.

Это событие имеет следующие свойства:

СвойствоЗначение
bubblesfalse
cancelablefalse; поведение по умолчанию, подлежащее отмене, не определено.
errorIDЧисловой код ошибки, присвоенный проблеме.
subErrorIDКод ошибки, содержащий более подробную информацию о возникшей проблеме.
targetОбъект NetStream.

Связанные элементы API

DRM_LOAD_DEVICEID_ERROR

Константа 
public static const DRM_LOAD_DEVICEID_ERROR:String = "drmLoadDeviceIdError"

DRMErrorEventExample.as

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());
        }
     }
}




[ X ]Почему по-английски?
Содержимое Справочника ActionScript 3.0 отображается на английском языке

Не все части Справочника ActionScript 3.0 переводятся на все языки. Если какой-то текстовый элемент не переведен, он отображается на английском языке. Например, компонент ga.controls.HelpBox не переведен ни на один из языков. Это значит, что в русской версии справки компонент ga.controls.HelpBox будет отображаться на английском языке.