Korzystanie z klasy DRMStatusEvent

Flash Player 10.1, Adobe AIR 1.0 i nowsze wersje

Obiekt NetStream wywołuje obiekt DRMStatusEvent przy pomyślnym rozpoczęciu odtwarzania treści chronionych przez moduł Adobe Access. (Pomyślne rozpoczęcie oznacza, że licencja została zweryfikowana oraz że użytkownik został uwierzytelniony i autoryzowany do wyświetlania treści). Obiekt DRMStatusEvent jest także wywoływany w przypadku użytkowników anonimowych, którym zezwolono na dostęp. Licencja jest sprawdzana w celu zweryfikowania, czy użytkownik anonimowy, który nie wymaga uwierzytelnienia, ma prawo odtwarzać treść. Istnieje możliwość odmówienia dostępu anonimowym użytkownikom z różnych powodów. Na przykład użytkownik anonimowy może nie mieć dostępu do treści, po utracie ważności licencji.

Obiekt DRMStatusEvent zawiera informacje powiązane z licencją. Informacje dotyczące licencji określają, czy może ona być udostępniana w trybie offline, lub jaki jest termin ważności kuponu, po którym zawartości nie można już wyświetlać. Aplikacja może na podstawie tych danych poinformować użytkownika o obowiązujących go zasadach i uprawnieniach.

Właściwości klasy DRMStatusEvent

Klasa DRMStatusEvent zawiera następujące właściwości. Niektóre właściwości zostały udostępnione w wersjach środowiska AIR nowszych niż 1.0. Pełne informacje dotyczące wersji zawiera Skorowidz ActionScript 3.0 .

W przypadku właściwości nieobsługiwanych w programie Flash Player 10.1, klasa DRMVoucher udostępnia podobne właściwości dla środowiska Flash Player.

Właściwość

Opis

contentData

Obiekt DRMContentData zawierający metadane DRM osadzone w treści.

detail (tylko środowisko AIR)

Ciąg znaków opisujący kontekst zdarzenia statusu. W przypadku mechanizmu DRM 1.0 jedyną poprawną wartością jest ciąg znaków DRM.voucherObtained.

isAnonymous (tylko środowisko AIR)

Wskazuje, czy treść chroniona przy użyciu modułu Adobe Access jest dostępna dla użytkowników bez konieczności podawania poświadczeń uwierzytelniania (true), czy nie jest w ten sposób dostępna (false). Wartość false oznacza, że użytkownik musi podać nazwę użytkownika i hasło zgodne z danymi, jakie zna i jakich oczekuje dostawca zawartości.

isAvailableOffline (tylko środowisko AIR)

Określa, czy treść chroniona przy użyciu modułu Adobe Access może być udostępniana w trybie offline (true), czy nie (false). Aby treść chroniona przy użyciu mechanizmu DRM była dostępna w trybie offline, jej kupon musi być zapisany w pamięci podręcznej na komputerze lokalnym użytkownika.

isLocal

Wskazuje, czy kupon potrzebny do odtworzenia treści jest buforowany lokalnie.

offlineLeasePeriod (tylko środowisko AIR)

Pozostała liczba dni, przez jaką treść może być wyświetlana w trybie offline.

policies (tylko środowisko AIR)

Obiekt niestandardowy może zawierać niestandardowe właściwości związane z mechanizmem DRM.

voucher

Obiekt DRMVoucher.

voucherEndDate (tylko środowisko AIR)

Bezwzględna data, w której kupon traci ważność, a treść przestaje być dostępna do wyświetlania.

Tworzenie funkcji obsługi zdarzenia DRMStatusEvent

W poniższym przykładzie tworzona jest funkcja obsługi zdarzeń, która wyświetla informacje o statusie treści DRM dla obiektu NetStream, z którego pochodzi zdarzenie. Tę funkcję obsługi zdarzeń należy dodać do obiektu NetStream, który wskazuje na treść chronioną.

function drmStatusEventHandler(event:DRMStatusEvent):void  
{ 
    trace(event); 
} 
function drmStatusEventHandler(event:DRMStatusEvent):void  
{ 
    trace(event); 
}