| Pakiet | flash.net.drm |
| Klasa | public class DRMManager |
| Dziedziczenie | DRMManager  EventDispatcher Object |
| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
DRMManager.getDRMManager() można uzyskać dostęp do istniejącego obiektu DRMManager w celu wykonania następujących zadań związanych z zarządzaniem mechanizmem DRM:
- Wstępne załadowanie kuponów z serwera uprawnień za pomocą obiektu DRMContentData.
- Sprawdzenie, czy w lokalnej pamięci podręcznej istnieje konkretny kupon, i odczytanie go za pomocą obiektu DRMContentData.
- Przywrócenie pierwotnego stanu wszystkich kuponów (tylko w środowisku AIR).
Nie jest dostępna metoda wyliczająca wszystkie kupony w lokalnej pamięci podręcznej.
Nie należy tworzyć instancji klasy DRMManager. Należy używać statycznej DRMManager.getDRMManager() w celu uzyskania dostępu do istniejącego obiektu DRMManager.
Obsługa profilów AIR: Ta funkcja jest obsługiwana we wszystkich komputerowych systemach operacyjnych oraz na urządzeniach telewizyjnych ze środowiskiem AIR, ale nie jest obsługiwana na urządzeniach przenośnych. W czasie wykonywania można sprawdzić, czy funkcja jest obsługiwana, odczytując właściwość DRMManager.isSupported. Więcej informacji o obsłudze elementów interfejsu API w różnych profilach można znaleźć w sekcji Obsługa profilów aplikacji AIR.
Powiązane elementy interfejsu API
Ukryj dziedziczone właściwości publiczne
Pokaż dziedziczone właściwości publiczne| Właściwość | Zdefiniowane przez | ||
|---|---|---|---|
 | constructor : Object
Odwołanie do obiektu klasy lub funkcji konstruktora, dotyczące danej instancji obiektu. | Object | |
| isSupported : Boolean [statyczny] [tylko do odczytu]
Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest obsługiwana klasa DRMManager; w przeciwnym razie ma wartość false. | DRMManager | ||
| networkIdleTimeout : Number [statyczny] | DRMManager | ||
| Metoda | Zdefiniowane przez | ||
|---|---|---|---|
| addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
Rejestruje obiekt detektora zdarzeń w obiekcie EventDispatcher, dzięki czemu detektor będzie otrzymywał powiadomienia o zdarzeniu. | EventDispatcher | |
Dodaje aktualnie uruchomione urządzenie do grupy urządzeń. | DRMManager | ||
Uwierzytelnia użytkownika. | DRMManager | ||
|
Wywołuje zdarzenie, tj. kieruje je do przepływu zdarzeń. | EventDispatcher | |
[statyczny]
Zwraca instancję obiektu singletonowego DRMManager. | DRMManager | ||
|
Sprawdza, czy obiekt EventDispatcher zawiera jakiekolwiek detektory zarejestrowane dla konkretnego typu zdarzeń. | EventDispatcher | |
|
Wskazuje, czy dla obiektu zdefiniowano określoną właściwość. | Object | |
|
Wskazuje, czy instancja klasy Object należy do łańcucha prototypów obiektu określonego jako parametr. | Object | |
Pobiera z serwera licencji kupon na podgląd, który można wykorzystać, aby umożliwić użytkownikowi sprawdzenie, czy może on odtwarzać treść na konkretnym komputerze. | DRMManager | ||
Wczytuje kupon z serwera uprawnień lub lokalnego bufora kuponów. | DRMManager | ||
|
Wskazuje, czy określona właściwość istnieje i jest przeliczalna. | Object | |
|
Usuwa detektor z obiektu EventDispatcher. | EventDispatcher | |
Usuwa aktualnie uruchomione urządzenie z grupy urządzeń. | DRMManager | ||
W aplikacjach AIR powoduje to usunięcie wszystkich buforowanych lokalnie danych kuponów zarządzania prawami cyfrowymi (DRM). | DRMManager | ||
Zwraca na serwer licencji wszystkie kupony spełniające określone kryteria. | DRMManager | ||
Określa token uwierzytelnienia, który ma być używany do komunikacji z określonym serwerem i wskazaną domeną. | DRMManager | ||
|
Ustawia dostępność właściwości dynamicznej używanej w pętlach. | Object | |
| DRMManager | |||
|
Zwraca ciąg reprezentujący obiekt — sformatowany zgodnie z konwencjami właściwymi dla ustawień regionalnych. | Object | |
|
Zwraca ciąg reprezentujący określony obiekt. | Object | |
|
Zwraca pierwotną wartość dla określonego obiektu. | Object | |
|
Sprawdza, czy detektor zdarzeń określonego typu jest zarejestrowany w tym obiekcie EventDispatcher lub jego elementach macierzystych. | EventDispatcher | |
| Zdarzenie | Podsumowanie | Zdefiniowane przez | ||
|---|---|---|---|---|
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja środowiska wykonawczego AIR uzyskuje fokus w systemie operacyjnym i przechodzi w stan aktywny. | EventDispatcher | ||
| Obiekt DRMManager wywołuje obiekt zdarzenia DRMAuthenticationCompleteEvent, gdy użytkownik zostanie uwierzytelniony przez serwer uprawnień po wywołaniu metody authenticate(). | DRMManager | |||
| Obiekt DRMManager wywołuje obiekt zdarzenia DRMAuthenticationErrorEvent, gdy użytkownik nie zostanie uwierzytelniony przez serwer uprawnień po wywołaniu metody authenticate(). | DRMManager | |||
| [zdarzenie broadcast] Wywoływane, gdy program Flash Player lub aplikacja AIR traci fokus w systemie operacyjnym i przechodzi w stan nieaktywny. | EventDispatcher | ||
| Obiekt DRMManager wywołuje obiekt zdarzenia DRMErrorEvent, gdy nie jest możliwe uzyskanie żądanego kuponu z serwera uprawnień. | DRMManager | |||
| Obiekt DRMManager wywołuje obiekt zdarzenia DRMStatusEvent, gdy żądany kupon zostanie uzyskany z serwera uprawnień. | DRMManager | |||
isSupported | właściwość |
isSupported:Boolean [tylko do odczytu] | Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 10.1, AIR 2 |
Właściwość isSupported ma wartość true, jeśli na bieżącej platformie jest obsługiwana klasa DRMManager; w przeciwnym razie ma wartość false.
Implementacja
public static function get isSupported():BooleannetworkIdleTimeout | właściwość |
addToDeviceGroup | () | metoda |
public function addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.0, Flash Player 11.9 |
Dodaje aktualnie uruchomione urządzenie do grupy urządzeń.
Parametry
deviceGroup:DRMDeviceGroup | |
forceRefresh:Boolean (default = false) |
authenticate | () | metoda |
public function authenticate(serverURL:String, domain:String, username:String, password:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Uwierzytelnia użytkownika.
W celu określenia wyniku próby uwierzytelnienia należy wykrywać zdarzenia authenticationComplete i authenticationError. Następujące po sobie wywołania metody authenticate() są ustawiane w kolejce. Obiekt zdarzenia AuthenticationCompleteEvent wywoływany w związku ze zdarzeniem authenticationComplete zawiera token uwierzytelnienia, który aplikacja może zapisać.
Zapisany token uwierzytelnienia lub token pobrany w inny sposób może w przyszłości posłużyć do nawiązania uwierzytelnionej sesji z serwerem uprawnień. Aby nawiązać sesję przy użyciu tokenu, należy wywołać metodę setAuthenticationToken() obiektu DRMManager. Właściwości tokenu, takie jak data ważności, są określone przez ustawienia serwera, który wygenerował token.
Ważne (tylko w środowisku AIR): Wywołanie metody authenticate() zakończy się niepowodzeniem, jeśli połączenie internetowe użytkownika przechodzi przez serwer proxy wymagający uwierzytelnienia. Wprawdzie tacy użytkownicy nie mogą wstępnie załadować kuponu DRM wymagającego uwierzytelnienia, jednak aplikacja może uzyskać kupon, rozpoczynając odtwarzanie i korzystając z metody setAuthenticationCredentials() obiektu NetStream w celu zalogowania użytkownika zarówno na serwerze proxy, jak i na serwerze uprawnień. Po uzyskaniu kuponu użytkownik może wyświetlać treść w trybie offline (o ile zezwala na to licencja reprezentowana przez kupon).
Parametry
serverURL:String — Adres URL serwera uprawnień, który może udostępnić kupon uprawniający do wyświetlania chronionej treści.
| |
domain:String — Domena na serwerze (nie domena sieciowa ani internetowa).
| |
username:String — Nazwa użytkownika.
| |
password:String — Hasło użytkownika.
|
Powiązane elementy interfejsu API
getDRMManager | () | metoda |
public static function getDRMManager():DRMManager| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Zwraca wystąpienie pojedynczego obiektu DRMManager.
Dla każdej domeny zabezpieczeń istnieje jedna instancja klasy DRMManager.
ZwracaDRMManager |
Powiązane elementy interfejsu API
loadPreviewVoucher | () | metoda |
public function loadPreviewVoucher(contentData:DRMContentData):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 2, Flash Player 10.1 |
Pobiera z serwera licencji kupon na podgląd, który można wykorzystać, aby umożliwić użytkownikowi sprawdzenie, czy może on odtwarzać treść na konkretnym komputerze. W ten sposób użytkownik może sprawdzić, czy będzie mógł odtwarzać treść na swoim komputerze, zanim ją zakupi i pobierze. Takie rozwiązanie jest przydatne, jeśli komputer użytkownika nie jest wyposażony w odpowiednie urządzenia wyjściowe lub oprogramowanie potrzebne do odtwarzania treści.
Podobnie jak loadVoucher(), ta metoda działa asynchronicznie i wywołuje zdarzenie DRMStatusEvent po zakończeniu lub DRMErrorEvent w wypadku błędów.
Parametry
contentData:DRMContentData |
loadVoucher | () | metoda |
public function loadVoucher(contentData:DRMContentData, setting:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Ładuje kupon z serwera uprawnień lub lokalnej pamięci podręcznej kuponów.
Kupon jest ładowany zgodnie z wartością parametru setting:
- LoadVoucherSetting.FORCE_REFRESH: kupon jest pobierany zawsze z serwera uprawnień.
- LoadVoucherSetting.LOCAL_ONLY: kupon jest ładowany zawsze z lokalnej pamięci podręcznej.
- LoadVoucherSetting.ALLOW_SERVER: kupon jest ładowany z lokalnej pamięci podręcznej, jeśli jest to możliwe, a w przeciwnym razie jest pobierany z serwera.
Klasa LoadVoucherSetting definiuje stałe ciągi znaków używane w charakterze wartości parametru setting.
Gdy kupon zostanie pomyślnie załadowany, obiekt DRMManager wywołuje zdarzenie statusu DRM. Aplikacja może rozpocząć odtwarzanie, gdy tylko kupon zostanie załadowany. Załadowany kupon jest dostępny we właściwości voucher wywołanego obiektu DRMStatusEvent. Można użyć tego obiektu kuponu do wyświetlenia dla użytkownika powiązanych informacji o uprawnieniach do treści multimedialnych.
Jeśli nie jest możliwe załadowanie kuponu z serwera uprawnień, wywoływane jest zdarzenie błędu DRM. Właściwość errorID wywołanego obiektu DRMErrorEvent określa przyczynę niepowodzenia. Typowe przyczyny niepowodzenia to próba nawiązania połączenia z serwerem uprawnień, gdy użytkownik pracuje w trybie offline, oraz próba załadowania kuponu, gdy użytkownik nie jest zalogowany. Aplikacja może reagować na te zdarzenia i podejmować działania naprawcze. Na przykład, jeśli do pobrania kuponu są wymagane poświadczenia uwierzytelniania, można wyświetlić zapytanie o nazwę użytkownika i hasło do konta, wywołać metodę authenticate() obiektu i ponownie spróbować załadować kupon.
Jeśli nie jest możliwe uzyskanie kuponu z lokalnej pamięci podręcznej, a obowiązuje ustawienie localOnly, zdarzenie DRMErrorEvent nie jest wywoływane. Zamiast tego wywoływane jest zdarzenie statusu DRM. Właściwość detail odpowiedniego obiektu DRMStatusEvent wciąż ma wartość DRM.voucherObtained, ale właściwość voucher jest równa null.
Parametry
contentData:DRMContentData — Obiekt DRMContentData z pliku multimedialnego zabezpieczonego przy użyciu mechanizmu DRM.
| |
setting:String — Określa, czy kupon jest pobierany z lokalnej pamięci podręcznej, czy z serwera uprawnień.
|
removeFromDeviceGroup | () | metoda |
public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 3.0, Flash Player 11.9 |
Usuwa aktualnie uruchomione urządzenie z grupy urządzeń.
Parametry
deviceGroup:DRMDeviceGroup |
resetDRMVouchers | () | metoda |
public function resetDRMVouchers():void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 11.8 |
W aplikacjach AIR powoduje to usunięcie wszystkich buforowanych lokalnie danych kuponów zarządzania prawami cyfrowymi (DRM). W przypadku aplikacji działających w przeglądarkach ta funkcja jest dostępna tylko w kontekście błędów 3322, 3346, 3323, 3326 i działa analogicznie do panelu ustawień odtwarzania zawartości chronionej.
Aby użytkownik mógł uzyskać dostęp do zaszyfrowanej treści, aplikacja musi pobrać wymagane kupony. Wywołanie tej funkcji jest równoważne wywołaniu Netstream.resetDRMVouchers().
Zgłasza
IOError — Danych kuponów nie można usunąć.
|
Powiązane elementy interfejsu API
returnVoucher | () | metoda |
public function returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | Flash Player 11.8, AIR 3.8 |
Zwraca na serwer licencji wszystkie kupony spełniające określone kryteria. Gdy kupon jest zwracany, następuje jego usunięcie z dysku i pamięci. Nie przerywa to działania strumieni sieciowych (NetStream) i audio/wideo (AVStream) używających w danej chwili zwróconych kuponów do odtwarzania wideo, ale uniemożliwia przyszłe odtwarzanie. Obiekt DRMManager generuje zdarzenie DRMReturnVoucherCompleteEvent w przypadku powodzenia lub zdarzenie DRMReturnVoucherErrorEvent — w przypadku błędu. Jeśli właściwość inServerURL ma wartość null lub obie właściwości licenseID i policyID mają wartości null, generowany jest wyjątek ArgumentError.
Parametry
inServerURL:String — Adresy URL serwerów licencji, z których pobrano zwracane licencje.
| |
immediateCommit:Boolean — Zarezerwowany. Jedyna obsługiwana wartość to true.
| |
licenseID:String — (Opcjonalnie) Kupony o tym identyfikatorze licencji (licenseID) zostaną zwrócone. W przypadku wartości null będzie używany identyfikator licencji (licenseID).
| |
policyID:String — (Opcjonalnie) Kupony o tym identyfikatorze zasad (policyID) zostaną zwrócone. W przypadku wartości null będzie używany identyfikator zasad (policyID). Jeśli identyfikatory licencji (licenseID) i zasad (policyID) mają wartości inne niż null, zwracany jest tylko kupon o zgodnych obu identyfikatorach.
|
setAuthenticationToken | () | metoda |
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Określa token uwierzytelnienia, który ma być używany do komunikacji z określonym serwerem i domeną.
Tokeny uwierzytelnienia są dostępne za pośrednictwem właściwości token obiektu zdarzenia DRMAuthenticationCompleteEvent wywoływanego po pomyślnym wywołaniu metody authenticate(). Token jest automatycznie zapisywany w pamięci podręcznej na potrzeby sesji, ale możliwe jest bezpośrednie zarządzanie tokenami za pomocą metody setAuthenticationToken().
Określenie tokenu powoduje nadpisanie ewentualnego istniejącego tokenu dla serwera i domeny w pamięci podręcznej. Aby wyczyścić token w pamięci podręcznej, należy ustawić parametr token na null.
Parametry
serverUrl:String — Adres URL serwera uprawnień DRM.
| |
domain:String — Obiekt DRMContentData
| |
token:ByteArray — Token uwierzytelnienia.
|
storeVoucher | () | metoda |
authenticationComplete | Zdarzenie |
flash.events.DRMAuthenticationCompleteEventwłaściwość DRMAuthenticationCompleteEvent.type =
flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Obiekt DRMManager wywołuje obiekt zdarzenia DRMAuthenticationCompleteEvent, gdy użytkownik zostanie uwierzytelniony przez serwer uprawnień po wywołaniu metody authenticate().
authenticationError | Zdarzenie |
flash.events.DRMAuthenticationErrorEventwłaściwość DRMAuthenticationErrorEvent.type =
flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Obiekt DRMManager wywołuje obiekt zdarzenia DRMAuthenticationErrorEvent, gdy użytkownik nie zostanie uwierzytelniony przez serwer uprawnień po wywołaniu metody authenticate().
drmError | Zdarzenie |
flash.events.DRMErrorEventwłaściwość DRMErrorEvent.type =
flash.events.DRMErrorEvent.DRM_ERROR| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Obiekt DRMManager wywołuje obiekt zdarzenia DRMErrorEvent, gdy nie jest możliwe uzyskanie żądanego kuponu z serwera uprawnień.
Uwaga: Gdy próba załadowania kuponu z lokalnej pamięci podręcznej kuponów (przy użyciu wartości localOnly dla parametru source) nie powiedzie się, obiekt zdarzenia DRMErrorEvent NIE jest wywoływany. Zamiast tego wywoływany jest obiekt zdarzenia DRMStatusEvent z właściwością voucher ustawioną na null.
DRMErrorEvent.DRM_ERROR definiuje wartość właściwości type obiektu zdarzenia drmError.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
errorID | Liczbowy kod błędu przypisany do problemu. |
subErrorID | Kod błędu określający bardziej szczegółowe informacje na temat problemu będącego przyczyną błędu. |
target | Obiekt NetStream. |
drmStatus | Zdarzenie |
flash.events.DRMStatusEventwłaściwość DRMStatusEvent.type =
flash.events.DRMStatusEvent.DRM_STATUS| Wersja języka: | ActionScript 3.0 |
| Wersje środowiska wykonawczego: | AIR 1.5, Flash Player 10.1 |
Obiekt DRMManager wywołuje obiekt zdarzenia DRMStatusEvent, gdy żądany kupon zostanie uzyskany z serwera uprawnień.
StałaDRMStatusEvent.DRM_STATUS definiuje wartość właściwości type obiektu zdarzenia drmStatus.
To zdarzenie ma następujące właściwości:
| Właściwość | Wartość |
|---|---|
bubbles | false |
cancelable | false; nie ma domyślnego zachowania, które można byłoby anulować. |
detail | Ciąg objaśniający kontekst zdarzenia dotyczącego stanu. |
isAnonymous | Określa, czy treść chroniona szyfrowaniem DRM jest dostępna bez konieczności podawania przez użytkownika poświadczeń uwierzytelniania. |
isAvailableOffline | Określa, czy treść chroniona szyfrowaniem DRM jest dostępna w trybie offline. |
offlineLeasePeriod | Pozostały czas (liczba dni), przez jaki zawartość może być jeszcze wyświetlana w trybie offline. |
policies | Niestandardowy obiekt zdarzenia dotyczącego stanu DRM. |
target | Obiekt NetStream. |
voucherEndDate | Data bezwzględna wygaśnięcia kuponu, po której użytkownicy nie będą już mogli wyświetlać treści. |
contentData | Obiekt DRMContentData dla treści. |
voucher | Obiekt DRMVoucher dla treści. |
isLocal | Określa, czy treść jest przechowywana w lokalnym systemie plików |
Tue Jun 12 2018, 12:06 PM Z