Paket | flash.net.drm |
Sınıf | public class DRMManager |
Miras Alma | DRMManager EventDispatcher Object |
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
DRMManager.getDRMManager()
yöntemiyle mevcut DRMManager nesnesine erişebilirsiniz:
- Bir DRMContentData nesnesi kullanarak bir medya hakları sunucusundan fişleri önyükleyin.
- Bir DRMContentData nesnesi kullanarak ayrı bir fiş için yerel önbelleği sorgulayın.
- Tüm fişleri sıfırlayın (yalnızca AIR)
Yerel önbellekteki tüm fişleri numaralandırmak için bir yöntem sağlanmamıştır.
DRMManager sınıfının bir örneğini oluşturmayın. Var olan DRMManager nesnesine erişmek için statik DRMManager.getDRMManager()
öğesini kullanın.
AIR profil desteği: Bu özellik tüm masaüstü işletim sistemlerinde ve AIR for TV aygıtlarında desteklenir ancak mobil aygıtlarda desteklenmez. Desteği çalışma zamanında DRMManager.isSupported
özelliğini kullanarak test edebilirsiniz. Birden fazla profilde API desteği ile ilgili daha fazla bilgi için bkz. AIR Profil Desteği.
İlgili API Öğeleri
Özellik | Tanımlayan: | ||
---|---|---|---|
constructor : Object
Belirli bir nesne örneği için sınıf nesnesine veya yapıcı işlevine bir başvuru. | Object | ||
isSupported : Boolean [statik] [salt okunur]
isSupported özelliği, DRMManager sınıfı geçerli platformda destekleniyorsa true olarak, aksi halde false olarak ayarlanır. | DRMManager | ||
networkIdleTimeout : Number [statik] | DRMManager |
Yöntem | Tanımlayan: | ||
---|---|---|---|
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
EventDispatcher nesnesi olan bir olay dinleyici nesnesini, dinleyicinin bir olayın bildirimini alması için kaydeder. | EventDispatcher | ||
şu anda çalışmakta olan aygıtı bir aygıt grubuna ekler. | DRMManager | ||
Kullanıcının kimlik denetimini yapar. | DRMManager | ||
Olay akışına bir olay gönderir. | EventDispatcher | ||
[statik]
Tekli DRMManager nesnesinin bir örneğini döndürür. | DRMManager | ||
EventDispatcher nesnesinin belirli bir olay türü için kayıtlı dinleyicisi olup olmadığını kontrol eder. | EventDispatcher | ||
Bir nesnenin belirli bir özelliğinin tanımlı olup olmadığını gösterir. | Object | ||
Object sınıfının bir örneğinin parametre olarak belirtilen nesnenin prototip zincirinde olup olmadığını gösterir. | Object | ||
Lisans sunucusundan, bir kullanıcının belirli bir bilgisayarda içerik oynatabileceğini doğrulamasına izin vermek için kullanabileceğiniz bir önizleme fişi alır. | DRMManager | ||
Medya hakları sunucusundan veya yerel fiş önbelleğinden bir fiş yükler. | DRMManager | ||
Belirtilen özelliğin bulunup bulunmadığını ve numaralandırılabilir olup olmadığını gösterir. | Object | ||
EventDispatcher nesnesinden bir dinleyiciyi kaldırır. | EventDispatcher | ||
Şu anda çalışmakta olan aygıtı bir aygıt grubundan kaldırır. | DRMManager | ||
Bu, AIR uygulamalarında yerel olarak önbelleğe alınmış tüm dijital hak yönetimi (DRM) makbuz verilerini siler. | DRMManager | ||
Lisans sunucusuna belirtilen tüm kriterleri karşılayan tüm makbuzları döndürür. | DRMManager | ||
Belirli bir sunucu ve etki alanıyla iletişim için kullanılacak kimlik denetimi belirtecini ayarlar. | DRMManager | ||
Dinamik bir özelliğin döngü işlemlerinde kullanılabilirliğini ayarlar. | Object | ||
DRMManager | |||
Bu nesnenin, yerel ayara özel kurallara göre biçimlendirilmiş dize temsilini döndürür. | Object | ||
Belirtilen nesnenin dize olarak temsil edilen halini döndürür. | Object | ||
Belirtilen nesnenin temel değerini döndürür. | Object | ||
Bir olay dinleyicisinin bu EventDispatcher nesnesiyle mi, yoksa onun belirtilen olay türüne yönelik üst öğelerinden biriyle mi kayıtlı olduğunu kontrol eder. | EventDispatcher |
Olay | Özet | Tanımlayan: | ||
---|---|---|---|---|
[broadcast olayı] Flash Player veya AIR uygulaması işletim sistemi odağına gelip etkin olduğunda gönderilir. | EventDispatcher | |||
authenticate() yöntemine yapılan çağrıdan sonra medya hakları sunucusu tarafından kullanıcı kimlik denetimi tamamlandığında, DRMManager öğesi bir DRMAuthenticationCompleteEvent nesnesi gönderir. | DRMManager | |||
authenticate() yöntemine yapılan çağrıdan sonra medya hakları sunucusu tarafından kullanıcının kimlik doğrulaması yapılamadığında, DRMManager öğesi bir DRMAuthenticationErrorEvent nesnesi gönderir. | DRMManager | |||
[broadcast olayı] Çalışan Flash Player veya AIR uygulaması sistem odağını kaybettiğinde ve etkin olmayan duruma geldiğinde gönderilir. | EventDispatcher | |||
İstenen fiş medya hakları sunucusundan alınamadığında, DRMManager öğesi bir DRMErrorEvent nesnesi gönderir. | DRMManager | |||
İstenen fiş medya hakları sunucusundan alındığında, DRMManager öğesi bir DRMStatusEvent nesnesi gönderir. | DRMManager |
isSupported | özellik |
networkIdleTimeout | özellik |
addToDeviceGroup | () | yöntem |
public function addToDeviceGroup(deviceGroup:DRMDeviceGroup, forceRefresh:Boolean = false):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3.0, Flash Player 11.9 |
şu anda çalışmakta olan aygıtı bir aygıt grubuna ekler.
Parametreler
deviceGroup:DRMDeviceGroup | |
forceRefresh:Boolean (default = false )
|
authenticate | () | yöntem |
public function authenticate(serverURL:String, domain:String, username:String, password:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
Kullanıcının kimlik denetimini yapar.
Kimlik denetimi denemesinin sonucunu belirlemek için authenticationComplete
ve authenticationError
olaylarını dinleyin. Birden çok authenticate()
çağrısı kuyruğa alındı. authenticationComplete
olayı için gönderilen AuthenticationCompleteEvent nesnesi, uygulamanızın kaydedebileceği bir kimlik denetimi belirteci içeriyor.
Kaydedilen veya diğer yollarla indirilen bir belirteci, gelecekte medya hakları sunucusunda kimlik denetimi yapılmış bir oturum oluşturmak için kullanabilirsiniz. Belirteç kullanarak bir oturum oluşturmak için DRMManager setAuthenticationToken()
yöntemini çağırın. Belirtecin, süre sonu tarihi gibi özellikleri, belirteci oluşturan sunucunun ayarları tarafından belirlenir.
Önemli (yalnızca AIR): Kullanıcının İnternet bağlantısı kimlik doğrulama isteyen bir proxy sunucusundan geçerse authenticate()
yöntemi başarısız olur. Bu tip kullanıcılar kimlik doğrulama gerektiren bir DRM fişini önyükleyemese de uygulamanız oynatmaya başlayarak ve kullanıcının hem proxy'ye hem de medya hakları sunucularına oturum açmasını sağlamak için NetStream setAuthenticationCredentials()
yöntemini kullanarak fişi alabilir. Fiş alındığında, kullanıcı içeriği çevrimdışı olarak da görüntüleyebilir (fişin temsil ettiği lisans çevrimdışı oynatmaya izin verdiği sürece).
Parametreler
serverURL:String — Korumalı içeriğin görüntülenmesi için fiş sağlayabilen medya hakları sunucusunun URL'si
| |
domain:String — Sunucuda bir etki alanı (ağ veya İnternet etki alanı adı değil)
| |
username:String — Kullanıcı adı
| |
password:String — Kullanıcı şifresi
|
İlgili API Öğeleri
getDRMManager | () | yöntem |
public static function getDRMManager():DRMManager
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
Tekli DRMManager nesnesinin bir örneğini döndürür.
Her güvenlik etki alanı için bir DRMManager örneği mevcuttur.
DöndürürDRMManager |
İlgili API Öğeleri
loadPreviewVoucher | () | yöntem |
public function loadPreviewVoucher(contentData:DRMContentData):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 2, Flash Player 10.1 |
Lisans sunucusundan, bir kullanıcının belirli bir bilgisayarda içerik oynatabileceğini doğrulamasına izin vermek için kullanabileceğiniz bir önizleme fişi alır. Bu özellik kullanıcıların içeriği satın alıp indirmeden önce içeriği bilgisayarlarında oynatabileceklerini doğrulamalarına izin verir. Bu, kullanıcının bilgisayarı içeriği oynatmak için gerekli çıktı koruma yeteneklerine veya gerekli yazılıma sahip olmadığında kullanışlıdır.
loadVoucher()
gibi, bu yöntem senkronize olmayan bir çağrıdır ve işlem tamamlandığında bir DRMStatusEvent veya hata durumlarında bir DRMErrorEvent dağıtır.
Parametreler
contentData:DRMContentData |
loadVoucher | () | yöntem |
public function loadVoucher(contentData:DRMContentData, setting:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
Medya hakları sunucusundan veya yerel fiş önbelleğinden bir fiş yükler.
Fiş, setting
parametresine göre yüklenir:
- LoadVoucherSetting.FORCE_REFRESH: Fiş her zaman medya hakları sunucusundan indirilir.
- LoadVoucherSetting.LOCAL_ONLY: Fiş yalnızca yerel önbellekten yüklenir.
- LoadVoucherSetting.ALLOW_SERVER: Fiş mümkünse bir yerel önbellekten yüklenir, yoksa sunucudan yüklenir.
LoadVoucherSetting sınıfı, setting
parametresine ilişkin değerler olarak kullanılacak dize sabitlerini tanımlar.
Fiş başarıyla yüklendiğinde, DRMManager öğesi bir DRM durum olayı gönderir. Uygulamanız, fiş yüklenir yüklenmez oynatmaya başlar. Yüklenen fiş, gönderilen DRMStatusEvent nesnesinin voucher
özelliğinde bulunur. Bu voucher nesnesini, ilişkili medya hakları bilgisini kullanıcıya görüntülemek için kullanabilirsiniz.
Fiş bir medya hakları sunucusundan yüklenemiyorsa bir DRM hata olayı gönderilir. Gönderilen DRMErrorEvent nesnesinin errorID
özelliği hatanın nedenini belirtir. Kullanıcı çevrimdışıyken medya hakları sunucusuna bağlanmaya çalışmak ve kullanıcının oturumu kapalıyken bir fiş yüklemeye çalışmak hata oluşmasının genel nedenlerinden bazılarıdır. Uygulamanız bu hataları yanıtlayabilir ve düzeltme eylemleri uygulayabilir. Örneğin, fişin indirilmesi için kimlik denetimi kimlik bilgileri gerekiyorsa, kullanıcıdan hesap kullanıcı adı ve parolasına ilişkin bilgi isteminde bulunabilir, DRMManager authenticate()
yöntemini çağırabilir ve daha sonra fişi yüklemeyi yeniden deneyebilirsiniz.
Bir fiş yerel önbellekten alınamıyorsa ve localOnly
ayarı kullanılıyorsa, bir DRMErrorEvent öğesi gönderilmez. Bunun yerine, bir DRM durum olayı gönderilir. Bu DRMStatusEvent nesnesinin detail
özelliği hala DRM.voucherObtained
olarak kalır, ancak voucher
özelliği null
değerindedir.
Parametreler
contentData:DRMContentData — DRM korumalı bir medya dosyasından DRMContentData nesnesi
| |
setting:String — Fişin yerel önbellekten mi, yoksa medya hakları sunucusundan mı alındığını belirler.
|
removeFromDeviceGroup | () | yöntem |
public function removeFromDeviceGroup(deviceGroup:DRMDeviceGroup):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 3.0, Flash Player 11.9 |
Şu anda çalışmakta olan aygıtı bir aygıt grubundan kaldırır.
Parametreler
deviceGroup:DRMDeviceGroup |
resetDRMVouchers | () | yöntem |
public function resetDRMVouchers():void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 11.8 |
Bu, AIR uygulamalarında yerel olarak önbelleğe alınmış tüm dijital hak yönetimi (DRM) makbuz verilerini siler. Tarayıcı tabanlı uygulamalarda bu yalnızca 3322, 3346, 3323, 3326 hataları sırasında kullanılabilir ve Korumalı İçerik Oynatma Ayarları paneli gibi davranır.
Kullanıcının şifrelenmiş içeriğe erişebilmesi için, uygulama gerekli fişleri yeniden indirmelidir. Bu işlevin çağrılması Netstream.resetDRMVouchers()
işlevinin çağrılmasıyla eşdeğerdir.
Atar
IOError — Fiş verileri silinemez.
|
İlgili API Öğeleri
returnVoucher | () | yöntem |
public function returnVoucher(inServerURL:String, immediateCommit:Boolean, licenseID:String, policyID:String):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | Flash Player 11.8, AIR 3.8 |
Lisans sunucusuna belirtilen tüm kriterleri karşılayan tüm makbuzları döndürür. Makbuz geri döndürüldüğünde disk depolama biriminden ve bellekten kaldırılır. Bu, o anda video oynatma işlemi için geri döndürülen makbuzları kullanan Netstreams ve AVStreams olaylarını kesmez ancak gelecekte oynatılmalarını yasaklar. DRMManager öğesi işlem başarılı olduğunda DRMReturnVoucherCompleteEvent, işlem başarısız olduğunda ise bir DRMReturnVoucherErrorEvent düzenler. inServerURL öğesi null ise ya da hem licenseID hem de policyID null ise ArgumentError verir.
Parametreler
inServerURL:String — Geri döndürülen lisansların indirildiği lisans sunucusu URL'leri.
| |
immediateCommit:Boolean — Ayrıldı. Desteklenen tek değer true'dur.
| |
licenseID:String — (isteğe bağlı) Bu licenseID ile eşleşen makbuzlar geri döndürülür. null ise, bunun yerine policyID öğesi kullanılır.
| |
policyID:String — (isteğe bağlı) Bu policyID ile eşleşen makbuzlar geri döndürülür. null ise, bunun yerine licenseID öğesi kullanılır. Hem licenseID hem de policyID öğesi null değilse, yalnızca licenseID ve policyID öğelerinin her ikisiyle eşleşen bir makbuz döndürülür.
|
setAuthenticationToken | () | yöntem |
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
Belirli bir sunucu ve etki alanıyla iletişim için kullanılacak kimlik denetimi belirtecini ayarlar.
Kimlik denetimi belirteçleri, authenticate()
yöntemine yapılan başarılı bir çağrıdan sonra gönderilen DRMAuthenticationCompleteEvent nesnesinin token
özelliğinden kullanılabilir. Belirteç, oturum için otomatik olarak önbelleğe alınır, ancak belirteçleri doğrudan yönetmek için setAuthenticationToken()
yöntemini kullanabilirsiniz.
Belirtecin ayarlanması, sunucu ve etki alanına ilişkin var olan önbelleğe alınmış herhangi bir belirtecin üzerine yazar. Önbelleğe alınan belirteci temizlemek için token
parametresini null
olarak ayarlayın.
Parametreler
serverUrl:String — Medya hakları sunucusunun URL'si
| |
domain:String — DRMContentData
| |
token:ByteArray — Kimlik denetimi belirteci
|
storeVoucher | () | yöntem |
authenticationComplete | Olay |
flash.events.DRMAuthenticationCompleteEvent
özellik DRMAuthenticationCompleteEvent.type =
flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
authenticate()
yöntemine yapılan çağrıdan sonra, medya hakları sunucusu tarafından kimlik denetimi tamamlandığında, DRMManager öğesi bir DRMAuthenticationCompleteEvent nesnesi gönderir.
authenticationError | Olay |
flash.events.DRMAuthenticationErrorEvent
özellik DRMAuthenticationErrorEvent.type =
flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
authenticate()
yöntemine yapılan çağrıdan sonra medya hakları sunucusu tarafından kullanıcının kimlik doğrulaması yapılamadığında, DRMManager öğesi bir DRMAuthenticationErrorEvent nesnesi gönderir.
drmError | Olay |
flash.events.DRMErrorEvent
özellik DRMErrorEvent.type =
flash.events.DRMErrorEvent.DRM_ERROR
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
İstenen fiş medya hakları sunucusundan alınamadığında, DRMManager öğesi bir DRMErrorEvent nesnesi gönderir.
Not: Yerel fiş önbelleğinden bir fiş yüklemeye çalışırken (localOnly
öğesini source
parametresi olarak kullanarak) işlem başarısız olursa, bir DRMErrorEvent nesnesi gönderilmez. Bunun yerine, voucher
özelliği null
olarak ayarlanmış bir DRMStatusEvent nesnesi gönderilir.
DRMErrorEvent.DRM_ERROR
sabiti, drmError
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
errorID | Probleme atanan sayısal bir hata kodu. |
subErrorID | Temel sorun hakkında daha ayrıntılı bilgi belirten bir hata kodu. |
target | NetStream nesnesi. |
drmStatus | Olay |
flash.events.DRMStatusEvent
özellik DRMStatusEvent.type =
flash.events.DRMStatusEvent.DRM_STATUS
Dil Sürümü: | ActionScript 3.0 |
Çalışma Zamanı Sürümleri: | AIR 1.5, Flash Player 10.1 |
İstenen fiş medya hakları sunucusundan alındığında, DRMManager öğesi bir DRMStatusEvent nesnesi gönderir.
DRMStatusEvent.DRM_STATUS
sabiti, drmStatus
olay nesnesinin type
özelliği değerini tanımlar.
Bu olay şu özelliklere sahiptir:
Özellik | Değer |
---|---|
bubbles | false |
cancelable | false ; iptal edilecek varsayılan davranış yoktur. |
detail | Status olayının bağlamını açıklayan bir dize. |
isAnonymous | DRM şifrelemesi ile korunan içeriğin kullanıcının kimlik doğrulama bilgilerini sağlaması gerekmeden kullanılabilir olup olmadığını belirtir. |
isAvailableOffline | DRM şifrelemesi ile korunan içeriğin çevrimdışı kullanılabilir olup olmadığını belirtir. |
offlineLeasePeriod | İçeriğin çevrimdışı görüntülenebileceği kalan gün sayısı. |
policies | DRM status olayının özel bir nesnesi. |
target | NetStream nesnesi. |
voucherEndDate | Fiş süresinin dolacağı ve artık içeriğin kullanıcılar tarafından görüntülenemeyeceği kesin tarih. |
contentData | İçerik için DRMContentData |
voucher | İçerik için DRMVoucher nesnesi. |
isLocal | İçeriğin yerel dosya sisteminde saklanıp saklanmadığını gösterir |
Tue Jun 12 2018, 01:09 PM Z