| Пакет | flash.events |
| Класс | public class DRMAuthenticateEvent |
| Наследование | DRMAuthenticateEvent  Event Object |
| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Обработчик DRMAuthenticateEvent отвечает за сбор необходимых учетных данных (имени пользователя, пароля, типа) и передачу значений методу NetStream.setDRMAuthenticationCredentials() для проверки подлинности. Каждое приложение AIR должно предусматривать механизм получения учетных данных пользователя. Например, приложение может открывать простой пользовательский интерфейс для ввода имени пользователя и пароля и, по необходимости, типа.
При неудачной проверке подлинности пользователя приложение попытается проверить подлинность повторно и отправит новое событие DRMAuthenticateEvent для объекта NetStream.
Связанные элементы API
Скрыть унаследованные общедоступные свойства
Показать унаследованные общедоступные свойства| Свойство | Определено | ||
|---|---|---|---|
| authenticationType : String [только для чтения]
Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. | DRMAuthenticateEvent | ||
 | bubbles : Boolean [только для чтения]
Определяет, является ли событие событием восходящей цепочки. | Event | |
| cancelable : Boolean [только для чтения]
Указывает, можно ли предотвратить поведение, связанное с событием. | Event | |
| constructor : Object
Ссылка на объект класса или функцию конструктора для данного экземпляра объекта. | Object | |
| currentTarget : Object [только для чтения]
Объект, активно обрабатывающий объект Event с помощью прослушивателя событий. | Event | |
| eventPhase : uint [только для чтения]
Текущая фаза в потоке событий. | Event | |
| header : String [только для чтения]
Заголовок файла с зашифрованным содержимым, передаваемый сервером. | DRMAuthenticateEvent | ||
| netstream : NetStream [только для чтения]
Объект NetStream, инициировавший событие. | DRMAuthenticateEvent | ||
| passwordPrompt : String [только для чтения]
Запрос пароля пользователя, передаваемый сервером. | DRMAuthenticateEvent | ||
| target : Object [только для чтения]
Целевой объект события. | Event | |
| type : String [только для чтения]
Тип события. | Event | |
| urlPrompt : String [только для чтения]
Запрос строки URL-адреса, представленного сервером. | DRMAuthenticateEvent | ||
| usernamePrompt : String [только для чтения]
Запрос имени пользователя, передаваемый сервером. | DRMAuthenticateEvent | ||
| Метод | Определено | ||
|---|---|---|---|
DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)
Создает объект Event, содержащий данные о событиях проверки подлинности DRM. | DRMAuthenticateEvent | ||
[переопределить]
Создает копию объекта DRMAuthenticateEvent и задает значение каждого свойства, совпадающее с оригиналом. | DRMAuthenticateEvent | ||
|
Служебная функция для реализации метода toString() в пользовательских классах ActionScript 3.0 Event. | Event | |
|
Показывает, определено ли заданное свойство для объекта. | Object | |
|
Проверяет, выполнялся ли для события вызова метода preventDefault(). | Event | |
|
Показывает, есть ли экземпляр класса Object в цепи прототипов объекта, заданного в качестве параметра. | Object | |
|
Отменяет поведение по умолчанию для события, если такое поведение можно отменить. | Event | |
|
Показывает наличие заданного свойства и его перечисляемость. | Object | |
|
Задает доступность динамического свойства для операций цикла. | Object | |
|
Отменяет обработку прослушивателей событий в текущем узле, а также во всех узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Отменяет обработку прослушивателей событий в узлах, которые следуют в потоке событий за текущим узлом. | Event | |
|
Возвращает строковое представление этого объекта, отформатированного в соответствии со стандартами, принятыми для данной локали. | Object | |
[переопределить]
Возвращает строку, содержащую все свойства объекта DRMAuthenticateEvent. | DRMAuthenticateEvent | ||
|
Возвращает элементарное значение заданного объекта. | Object | |
| Константа | Определено | ||
|---|---|---|---|
| AUTHENTICATION_TYPE_DRM : String = "drm" [статические]
Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM определяет значение свойства authenticationType объекта DRMAuthenticateEvent. | DRMAuthenticateEvent | ||
| AUTHENTICATION_TYPE_PROXY : String = "proxy" [статические]
Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY определяет значение свойства authenticationType объекта DRMAuthenticateEvent. | DRMAuthenticateEvent | ||
| DRM_AUTHENTICATE : String = "drmAuthenticate" [статические]
Константа DRMAuthenticateEvent.DRM_AUTHENTICATE определяет значение свойства type объекта DRMAuthenticateEvent. | DRMAuthenticateEvent | ||
authenticationType | свойство |
authenticationType:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. Например, вариант proxy позволяет приложению выполнять проверку подлинности на прокси-сервере, если организация требует от пользователя выполнения этого шага перед выходом в Интернет. Если не используется анонимная проверка подлинности, то после проверки подлинности на прокси-сервере пользователю все равно нужно пройти авторизацию FMRMS, чтобы получить ваучер и воспроизвести содержимое. Метод setDRMAuthenticationcredentials() можно использовать во второй раз с параметром drm для проверки подлинности FMRMS.
Реализация
public function get authenticationType():String header | свойство |
netstream | свойство |
passwordPrompt | свойство |
urlPrompt | свойство |
usernamePrompt | свойство |
usernamePrompt:String [только для чтения] | Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Запрос имени пользователя, передаваемый сервером. Строка может содержать инструкции для типа запрашиваемого имени пользователя. Например, поставщик содержимого может запросить в качестве имени пользователя электронный адрес.
Реализация
public function get usernamePrompt():String DRMAuthenticateEvent | () | Конструктор |
public function DRMAuthenticateEvent(type:String, bubbles:Boolean = false, cancelable:Boolean = false, header:String = "", userPrompt:String = "", passPrompt:String = "", urlPrompt:String = "", authenticationType:String = "", netstream:NetStream = null)| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Создает объект Event, содержащий данные о событиях проверки подлинности DRM. Объекты Event передаются прослушивателям событий в качестве параметров.
Параметрыtype:String — Тип события. Прослушиватели событий могут получать эту информацию через унаследованное свойство type. Существует только один тип события DRMAuthenticate: DRMAuthenticateEvent.DRM_AUTHENTICATE.
| |
bubbles:Boolean (default = false)bubbles.
| |
cancelable:Boolean (default = false)cancelable.
| |
header:String (default = " | |
userPrompt:String (default = " | |
passPrompt:String (default = " | |
urlPrompt:String (default = " | |
authenticationType:String (default = " | |
netstream:NetStream (default = null) |
clone | () | метод |
override public function clone():Event| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Создает копию объекта DRMAuthenticateEvent и задает значение каждого свойства, совпадающее с оригиналом.
ВозвращаетEvent — Новый объект DRMAuthenticateEvent, значения свойств которого соответствуют значениям оригинала.
|
toString | () | метод |
override public function toString():String| Версии среды выполнения: | AIR 1.0 |
Возвращает строку, содержащую все свойства объекта DRMAuthenticateEvent. Строка имеет следующий формат:
[DRMAuthenticateEvent type=value bubbles=value cancelable=value eventPhase=value header=value usernamePrompt=value passwordPrompt=value urlPrompt=value] authenticationType=value
String — Строка, содержащая все свойства объекта DRMAuthenticateEvent.
|
AUTHENTICATION_TYPE_DRM | Константа |
public static const AUTHENTICATION_TYPE_DRM:String = "drm"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_DRM определяет значение свойства authenticationType объекта DRMAuthenticateEvent.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
authenticationType | Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. |
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
header | Заголовок файла с зашифрованным содержимым, передаваемый сервером. |
netstream | Объект NetStream, инициировавший событие. |
passwordPrompt | Запрос пароля пользователя, передаваемый сервером. |
target | Объект NetStream. |
urlPrompt | Запрос URL-адреса для отображения, передаваемый сервером. |
usernamePrompt | Запрос имени пользователя, передаваемый сервером. |
Связанные элементы API
AUTHENTICATION_TYPE_PROXY | Константа |
public static const AUTHENTICATION_TYPE_PROXY:String = "proxy"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Константа DRMAuthenticateEvent.AUTHENTICATION_TYPE_PROXY определяет значение свойства authenticationType объекта DRMAuthenticateEvent.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
authenticationType | Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. |
bubbles | false |
cancelable | false; поведение по умолчанию, подлежащее отмене, не определено. |
header | Заголовок файла с зашифрованным содержимым, передаваемый сервером. |
netstream | Объект NetStream, инициировавший событие. |
passwordPrompt | Запрос пароля пользователя, передаваемый сервером. |
target | Объект NetStream. |
urlPrompt | Запрос URL-адреса для отображения, передаваемый сервером. |
usernamePrompt | Запрос имени пользователя, передаваемый сервером. |
Связанные элементы API
DRM_AUTHENTICATE | Константа |
public static const DRM_AUTHENTICATE:String = "drmAuthenticate"| Язык версии: | ActionScript 3.0 |
| Версии среды выполнения: | AIR 1.0 |
Константа DRMAuthenticateEvent.DRM_AUTHENTICATE определяет значение свойства type объекта DRMAuthenticateEvent.
Это событие имеет следующие свойства:
| Свойство | Значение |
|---|---|
authenticationType | Указывает, должны ли предоставленные учетные данные проверяться сервером Flash Media Rights Management Server (FMRMS) или прокси-сервером. |
bubbles | false |
cancelable | false; нет поведения по умолчанию для отмены. |
header | Заголовок файла с зашифрованным содержимым, передаваемый сервером. |
netstream | Объект NetStream, инициировавший событие. |
passwordPrompt | Запрос пароля пользователя, передаваемый сервером. |
target | Объект NetStream. |
urlPrompt | Запрос URL-адреса для отображения, передаваемый сервером. |
usernamePrompt | Запрос имени пользователя, передаваемый сервером. |
Связанные элементы API
package
{
import flash.display.Sprite;
import flash.events.AsyncErrorEvent;
import flash.events.NetStatusEvent;
import flash.events.DRMAuthenticateEvent;
import flash.media.Video;
import flash.net.NetConnection;
import flash.net.NetStream;
public class DRMAuthenticateEventExample extends Sprite
{
var videoURL:String = "Video.flv";
var videoConnection:NetConnection;
var videoStream:NetStream;
var video:Video = new Video();
public function DRMAuthenticateEventExample()
{
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(DRMAuthenticateEvent.DRM_AUTHENTICATE, drmAuthenticateEventHandler);
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 drmAuthenticateEventHandler(event:DRMAuthenticateEvent):void {
videoStream.setDRMAuthenticationCredentials("User", "password", "drm");
}
}
}
Tue Jun 12 2018, 11:34 AM Z