flash.net.drmVoucherAccessInfo Объект VoucherAccessInfo предоставляет информацию, которая требуется для успешного извлечения и использования ваучера, например типа проверки подлинности и домена содержимого сервера управления правами доступа к содержимому.Object Объект VoucherAccessInfo предоставляет информацию, которая требуется для успешного извлечения и использования ваучера, например типа проверки подлинности и домена содержимого сервера управления правами доступа к содержимому. authenticationMethod Тип аутентификации, которую необходимо пройти для получения ваучера на просмотр соответствующего содержимого.String Тип аутентификации, которую необходимо пройти для получения ваучера на просмотр соответствующего содержимого.

Поддерживаемые типы проверки подлинности:

AuthenticationMethod.ANONYMOUS — любой может получить ваучер.
AuthenticationMethod.USERNAME_AND_PASSWORD — пользователь должен ввести правильное имя и пароль учетной записи, которая авторизована для просмотра соответствующего содержимого.

Класс AuthenticationMethod содержит строковые константы для свойства authenticationMethod.

displayName Удобная для восприятия строка, которую можно использовать для ссылки на указанный объект VoucherAccessInfo в пользовательском интерфейсе.String Удобная для восприятия строка, которую можно использовать для ссылки на указанный объект VoucherAccessInfo в пользовательском интерфейсе.

Если файл метаданных для фрагмента медиасодержимого включает несколько ваучеров с разными объектами VoucherAccessInfo, пользователю потребуется решить, для какого ваучера проверять подлинность. Например, для просмотра содержимого может потребоваться ваучер на уровне подписки с высокими полномочиями, а также ваучер базового уровня с низкими полномочиями. Чтобы различать эти два ваучера, необходимо использовать описательную строку в свойстве displayName. Строка задается инструментом упаковки носителей (который упаковывает и шифрует медиасодержимое, подготавливая его для распределения с помощью сервера управления правами доступа к содержимому, такого как Flash Access).

Для локализованных приложений это свойство можно использовать как идентификатор. Приложение может определять локаль и выполнять соответствующую локализацию строк.

domain Домен содержимого на сервере управления правами доступа к содержимому, на котором пользователь должен пройти проверку подлинности, чтобы получить ваучер на просмотр соответствующего содержимого.String Домен содержимого на сервере управления правами доступа к содержимому, на котором пользователь должен пройти проверку подлинности, чтобы получить ваучер на просмотр соответствующего содержимого.

Если проверка подлинности требуется для домена по умолчанию или не требуется вовсе, свойство domainName будет иметь значение null.

Примечание. Домен, возвращаемый этим свойством, не имеет ничего общего с именами сетевых или Интернет-доменов. В этом случае доменом является группа содержимого или учетных записей пользователей. Например, один сервер может поддерживать несколько доменов, каждый из которых имеет собственный набор каналов содержимого и подписчиков.

DRMContentData Класс DRMContentData предоставляет информацию, необходимую для получения ваучера на просмотр содержимого с защитой по технологии DRM.Object Класс DRMContentData предоставляет информацию, необходимую для получения ваучера на просмотр содержимого с защитой по технологии DRM.

(Только AIR) Объект DRMContentData можно получить из экземпляра NetStream путем вызова метода NetStream preloadEmbeddedContent() и предоставления функции обратного вызова onDRMContentData для клиентского объекта NetStream. Используйте объект DRMContentData, переданный функции обратного вызова, в качестве параметра метода DRMManager loadVoucher().

Когда содержимое упаковывается с помощью Flash Access, можно сохранить метаданные содержимого в отдельном файле. Чтобы создать новый объект DRMContentData, получите эти метаданные с помощью объекта URLLoader и передайте их конструктору DRMContentData.

DRMContentData Конструктор.rawDataflash.utils:ByteArraynull Конструктор. getVoucherAccessInfo Извлекает массив объектов VoucherAccessInfo. Извлекает массив объектов VoucherAccessInfo. Массив содержит по крайней мере 1 объект VoucherAccessInfo, используемый по умолчанию.

Каждый объект VoucherAccessInfo представляет политику, которая содержит требования для извлечения ваучера с сервера DRM. Например, если сервер требует проверки подлинности пользователя, объект VoucherAccessInfo содержит метод проверки подлинности. Если сервер требует, чтобы компьютер был зарегистрирован на сервере области, объект содержит URL-адрес сервера области.

authenticationMethod Тип аутентификации, которую необходимо пройти для получения ваучера на просмотр соответствующего содержимого.String Тип аутентификации, которую необходимо пройти для получения ваучера на просмотр соответствующего содержимого.

Поддерживаемые типы проверки подлинности:

AuthenticationMethod.ANONYMOUS — любой может получить ваучер.
AuthenticationMethod.USERNAME_AND_PASSWORD — пользователь должен ввести правильное имя и пароль учетной записи, которая авторизована для просмотра соответствующего содержимого.

Класс AuthenticationMethod содержит строковые константы для свойства authenticationMethod.

licenseID Уникальный идентификатор содержимого, связанного с этими метаданными на сервере управления правами доступа к содержимому.String Уникальный идентификатор содержимого, связанного с этими метаданными на сервере управления правами доступа к содержимому. serverURL URL-адрес сервера управления правами доступа к содержимому, который предоставляет ваучер на просмотр соответствующего содержимого.String URL-адрес сервера управления правами доступа к содержимому, который предоставляет ваучер на просмотр соответствующего содержимого. DRMVoucher Класс DRMVoucher предназначен для обработки знака лицензии, позволяющего пользователю просматривать содержимое с защитой по технологии DRM.Object Класс DRMVoucher предназначен для обработки знака лицензии, позволяющего пользователю просматривать содержимое с защитой по технологии DRM.

Свойства DRMVoucher описывают предоставленные ваучером права на просмотр. Ваучер можно получить с помощью метода loadVoucher() объекта DRMManager. Этому методу требуется передать объект DRMContentData, полученный с помощью метода preloadEmbeddedMetadata() класса NetStream (только для AIR) или с помощью конструктора DRMContentData(). При использовании сервера DRM, например Flash Access, можно получить объект DRMContentData из метаданных, созданных инструментом упаковки медиасодержимого.

offlineLeaseEndDate Дата и время окончания срока действия ваучера для автономного воспроизведения.Date Дата и время окончания срока действия ваучера для автономного воспроизведения.

Если ваучер действует только на время текущего онлайн-сеанса, свойство offlineLeaseStartDate имеет значение null.

offlineLeaseStartDate Дата и время начала срока действия ваучера для автономного воспроизведения.Date Дата и время начала срока действия ваучера для автономного воспроизведения.

Если ваучер действует только на время текущего онлайн-сеанса, свойство offlineLeaseStartDate имеет значение null.

playbackTimeWindow Период времени с момента первого просмотра, в течение которого можно просматривать соответствующее содержимое.flash.net.drm:DRMPlaybackTimeWindow Период времени с момента первого просмотра, в течение которого можно просматривать соответствующее содержимое.

Период времени, выделенный для просмотра, начинается, когда пользователь впервые открывает содержимое, и заканчивается по истечении отведенного времени. Если время не задано, свойство playbackTimeWindow имеет значение null.

policies Динамический объект, который сообщает о политиках, определенных приложением.Object Динамический объект, который сообщает о политиках, определенных приложением.

Объект политики содержит пару «имя-значение» для каждой действующей политики.

voucherEndDate Дата окончания срока действия ваучера.Date Дата окончания срока действия ваучера. voucherStartDate Начало срока действия ваучера.Date Начало срока действия ваучера. DRMPlaybackTimeWindow Класс DRMPlaybackTimeWindow представляет период времени, в течение которого действует ваучер DRM.Object Класс DRMPlaybackTimeWindow представляет период времени, в течение которого действует ваучер DRM.

Свойства startDate и endDate имеют значение null до того, как пользователь начнет просматривать содержимое.

endDate Дата окончания периода времени, в течение которого действует ваучер DRM (окно воспроизведения).Date Дата окончания периода времени, в течение которого действует ваучер DRM (окно воспроизведения).

Свойство endDate имеет значение null, если период воспроизведения еще не начат.

period Период времени в секундах, в течение которого действует ваучер DRM (окно воспроизведения).uint Период времени в секундах, в течение которого действует ваучер DRM (окно воспроизведения). startDate Дата начала периода времени, в течение которого действует ваучер DRM (окно воспроизведения).Date Дата начала периода времени, в течение которого действует ваучер DRM (окно воспроизведения).

Свойство startDate имеет значение null, если период воспроизведения еще не начат.

LoadVoucherSetting Класс LoadVoucherSetting предоставляет строковые константы для использования с параметром settings метода loadVoucher() класса DRMManager.Определяет константы для настройки параметров загрузки ваучера DRMManager. Object Класс LoadVoucherSetting предоставляет строковые константы для использования с параметром settings метода loadVoucher() класса DRMManager. ALLOW_SERVER Загружает ваучер из локального кэша, если это возможно; загружает ваучер с сервера управления правами доступа к содержимому, только если его копия не сохранена в локальном кэше.allowServerString Загружает ваучер из локального кэша, если это возможно; загружает ваучер с сервера управления правами доступа к содержимому, только если его копия не сохранена в локальном кэше. FORCE_REFRESH Загружает ваучер только с сервера управления правами доступа к содержимому.forceRefreshString Загружает ваучер только с сервера управления правами доступа к содержимому. Не загружает ваучер из локального кэша. LOCAL_ONLY Загружает ваучер только из локального кэша.localOnlyString Загружает ваучер только из локального кэша. Не загружает ваучер с сервера управления правами доступа к содержимому. AuthenticationMethod Класс AuthenticationMethod содержит строковые константы, обозначающие различные типы аутентификации, используемые в свойстве authenticationMethod класса DRMContentData.Object Класс AuthenticationMethod содержит строковые константы, обозначающие различные типы аутентификации, используемые в свойстве authenticationMethod класса DRMContentData. ANONYMOUS Указывает, что проверка подлинности не требуется.anonymousString Указывает, что проверка подлинности не требуется. USERNAME_AND_PASSWORD Указывает, что необходимо ввести правильное имя пользователя и пароль.usernameAndPasswordString Указывает, что необходимо ввести правильное имя пользователя и пароль. DRMManager DRMManager управляет получением и хранением ваучеров, необходимых для просмотра содержимого с защитой по технологии DRM.flash.events:EventDispatcher DRMManager управляет получением и хранением ваучеров, необходимых для просмотра содержимого с защитой по технологии DRM. С помощью статического метода DRMManager.getDRMManager() можно обращаться к существующему объекту DRMManager для выполнения следующих задач, связанных с управлением правами DRM:

предварительная загрузка ваучеров с сервера управления правами доступа к содержимому можно выполнять с помощью объекта DRMContentData;
запрос отдельного ваучера из локального кэша с помощью объекта DRMContentData;
сброс всех ваучеров (только для AIR).

Метода, с помощью которого можно получить список всех ваучеров в локальном кэше, не существует.

Не создавайте экземпляр класса DRMManager. С помощью статического метода DRMManager.getDRMManager() можно получить доступ к существующему объекту DRMManager.

Поддержка в профилях AIR: эта функция поддерживается во всех компьютерных операционных системах и среде AIR для телевизионных устройств, но не поддерживается на мобильных устройствах. Используйте свойство DRMManager.isSupported, чтобы проверить наличие поддержки в среде выполнения. Дополнительные сведения о поддержке API-интерфейса в разных профилях см. в разделе «Поддержка в профилях AIR».

drmError DRMManager отправляет объект DRMErrorEvent, если запрошенный ваучер невозможно получить с сервера управления правами доступа к содержимому.flash.events.DRMErrorEvent.DRM_ERRORflash.events.DRMErrorEvent DRMManager отправляет объект DRMErrorEvent, если запрошенный ваучер невозможно получить с сервера управления правами доступа к содержимому.

Примечание. В случае неудачной попытки загрузить ваучер из локального кэша (с использованием localOnly в качестве параметра source) объект DRMErrorEvent не отправляется. Вместо этого отправляется объект DRMStatusEvent, свойство voucher которого имеет значение null.

drmStatus DRMManager отправляет объект DRMStatusEvent, если запрошенный ваучер получен с сервера управления правами доступа к содержимому.flash.events.DRMStatusEvent.DRM_STATUSflash.events.DRMStatusEvent DRMManager отправляет объект DRMStatusEvent, если запрошенный ваучер получен с сервера управления правами доступа к содержимому. authenticationError DRMManager отправляет объект DRMAuthenticationErrorEvent, если пользователь не прошел аутентификацию на сервере управления правами доступа к содержимому после вызова метода authenticate().flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERRORflash.events.DRMAuthenticationErrorEventОтправляется объектом DRMManager, когда не удается выполнить проверку подлинности. DRMManager отправляет объект DRMAuthenticationErrorEvent, если пользователь не прошел аутентификацию на сервере управления правами доступа к содержимому после вызова метода authenticate(). authenticationComplete DRMManager отправляет объект DRMAuthenticationCompleteEvent, если пользователь прошел аутентификацию на сервере управления правами доступа к содержимому после вызова метода authenticate().flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETEflash.events.DRMAuthenticationCompleteEventОтправляется объектом DRMManager после успешного выполнения проверки подлинности. DRMManager отправляет объект DRMAuthenticationCompleteEvent, если пользователь прошел аутентификацию на сервере управления правами доступа к содержимому после вызова метода authenticate(). authenticate Выполняет аутентификацию пользователя.serverURLStringURL-адрес сервера управления правами доступа к содержимому, который может предоставить ваучер на просмотр защищенного содержимого. domainStringДомен на сервере (не имя сетевого или Интернет-домена) usernameStringИмя пользователя passwordStringПароль пользователя Выполняет аутентификацию пользователя.

Чтобы узнать о результате предпринятой попытки аутентификации, необходимо прослушивать события authenticationComplete и authenticationError. Из нескольких вызовов метода authenticate() образуется очередь. Объект AuthenticationCompleteEvent, отправляемый для события authenticationComplete, содержит маркер аутентификации, который может сохранить приложение.

Сохраненный или загруженный иным образом маркер аутентификации можно использовать в будущем для создания проверенного сеанса на сервере управления правами доступа к содержимому. Для создания сеанса с помощью маркера необходимо вызвать метод setAuthenticationToken() объекта DRMManager. Свойства маркера, такие как дата окончания срока действия, определяются настройками сервера, создавшего маркер.

Важно! (Только для AIR) Вызов метода authenticate() не будет успешным, если Интернет-подключение пользователя осуществляется через прокси-сервер, запрашивающий проверку подлинности. Несмотря на то что такие пользователи не могут предварительно загрузить ваучер DRM, требующий проверки подлинности, приложение может получить такой ваучер, начав воспроизведение и использовав метод NetStream setAuthenticationCredentials() для регистрации пользователя, как на прокси-сервере, так и на сервере управления правами доступа к содержимому. После получения ваучера пользователь может просматривать содержимое автономно (в течение времени, предусмотренного лицензией, представленной ваучером).

getDRMManager Возвращает экземпляр единственного объекта DRMManager.flash.net.drm:DRMManager Возвращает экземпляр единственного объекта DRMManager.

Для каждого домена защиты существует один экземпляр DRMManager.

loadPreviewVoucher Получает ваучер предварительного просмотра с сервера лицензий, который позволяет проверить, можно ли воспроизвести содержимое на определенном компьютере.contentDataflash.net.drm:DRMContentData Получает ваучер предварительного просмотра с сервера лицензий, который позволяет проверить, можно ли воспроизвести содержимое на определенном компьютере. Эта возможность позволяет пользователям проверить, можно ли воспроизвести содержимое на данном компьютере, прежде чем оплачивать и загружать его. Она полезна, когда компьютер пользователя не оснащен необходимыми возможностями защиты вывода или программным обеспечением для воспроизведения содержимого.

Как и loadVoucher(), данный метод представляет собой асинхронный вызов, после успешного выполнения которого отправляется событие DRMStatusEvent, а в случае ошибки — DRMErrorEvent.

loadVoucher Загружает ваучер с сервера управления правами доступа к содержимому или из локального кэша ваучеров.contentDataflash.net.drm:DRMContentDataОбъект DRMContentData из мультимедийного файла, защищенного по технологии DRM settingStringОпределяет, загружается ваучер из локального ваучера или с сервера управления правами доступа к содержимому Загружает ваучер с сервера управления правами доступа к содержимому или из локального кэша ваучеров.

Ваучер загружается согласно значению параметра setting:

LoadVoucherSetting.FORCE_REFRESH: ваучер всегда загружается с сервера управления правами доступа к содержимому.
LoadVoucherSetting.LOCAL_ONLY: ваучер загружается только из локального кэша.
LoadVoucherSetting.ALLOW_SERVER: ваучер загружается из локального кэша, если это возможно. В противном случае он загружается с сервера.

Класс LoadVoucherSetting определяет строковые константы, используемые в качестве значений параметра setting.

После успешной загрузки ваучера DRMManager отправляет событие DRM status. Приложение может начать воспроизведение сразу после загрузки ваучера. Загруженный ваучер доступен в свойстве voucher отправленного объекта DRMStatusEvent. С помощью этого объекта ваучера можно показать пользователю соответствующую информацию о правах доступа к содержимому.

Если не удалось загрузить ваучер с сервера управления правами доступа к содержимому, то отправляется событие ошибки DRM. Свойство errorID отправленного объекта DRMErrorEvent указывает на причину ошибки. Типичной причиной ошибки является попытка подключения к серверу правления правами доступа к содержимому, когда пользователь находится не в сети, а также попытка загрузить ваучер, когда пользователь не выполнил вход. Приложение может ответить на эти ошибки и выполнить корректирующее действие. Например, если для загрузки ваучера необходимо предоставить учетные данные аутентификации, можно запросить пользователя предоставить имя пользователя и пароль, вызвать метод DRMManager authenticate() и попытаться загрузить ваучер снова.

Если при использовании настройки localOnly не удается получить ваучер из локального кэша, объект DRMErrorEvent не отправляется. Вместо этого отправляется событие DRM status. Свойство detail этого объекта DRMStatusEvent все еще имеет значение DRM.voucherObtained, но свойство voucher имеет значение null.

resetDRMVouchers Удаляет все данные ваучера DRM из локального кэша.DRMManager, resetDRMVouchers Невозможно удалить данные ваучера. IOErrorflash.errors:IOError Удаляет все данные ваучера DRM из локального кэша.

Чтобы пользователь мог снова получить доступ к зашифрованному содержимому, приложение должно снова загрузить необходимые ваучеры. Вызов этой функции равнозначен вызову Netstream.resetDRMVouchers().

setAuthenticationToken Задает маркер аутентификации для использования при обмене данными с указанным сервером и доменом.serverUrlStringURL-адрес сервера управления правами доступа к содержимому domainStringДомен сервера управления правами доступа к содержимому. tokenflash.utils:ByteArrayМаркер аутентификации Задает маркер аутентификации для использования при обмене данными с указанным сервером и доменом.

Маркеры аутентификации указаны в свойстве token объекта DRMAuthenticationCompleteEvent, отправляемого при успешном вызове метода authenticate(). Маркер сеанса записывается в кэш автоматически, но с помощью метода setAuthenticationToken() можно напрямую управлять маркерами.

Если задать маркер таким образом, он перезапишет существующий в кэше маркер для сервера и домена. Для очистки кэшированного маркера задайте параметру token значение null.

isSupported Свойству isSupported задается значение true, если текущая платформа поддерживает класс DRMManager, в противном случае задается значение false.BooleanУказывает, поддерживается ли класс DRMManager в клиентской системе. Свойству isSupported задается значение true, если текущая платформа поддерживает класс DRMManager, в противном случае задается значение false.