Uygulamalarda makbuzları ve medya hakları sunucu oturumlarını yönetmek için DRMManager sınıfını kullanın.
Makbuz yönetimi (yalnızca AIR)
Bir kullanıcı ne zaman korumalı içerik oynatmak istese, çalışma zamanı içeriğin görüntülenmesi için gereken lisansı elde edip ön belleğe alır. Uygulama dosyayı yerel olarak kaydediyorsa ve lisans çevrimdışı oynatmaya izin veriyorsa, kullanıcı içeriği AIR uygulamasında görüntüleyebilir. Bu tür yerel çevrimdışı oynatma işlemleri, medya hakları sunucusuna bağlantı olmasa bile başarılı olur. DRMManager ve NetStream
preloadEmbeddedMetadata()
yöntemi kullanılarak, makbuzu ön belleğe alabilirsiniz. Uygulama, içeriği görüntülemek için gereken lisansı elde etmek zorunda değildir. Örneğin, uygulamanız medya dosyasını indirebilir ve daha sonra kullanıcı halen çevrimiçiyken makbuzu alabilir.
Makbuzu önceden yüklemek için DRMContentData nesnesini almak amacıyla NetStream
preloadEmbeddedMetadata()
yöntemini kullanın. DRMContentData nesnesi, lisansı sağlayabilen ve kullanıcı kimlik doğrulamasının gerekli olup olmadığını açıklayan medya hakları sunucusunun URL'si ve etki alanını içerir. Bu bilgiyle, makbuzu almak ve önbelleğe kaydetmek için DRMManager
loadVoucher()
yöntemini çağırabilirsiniz. Makbuzların önceden yüklenmesine dair iş akışı
Çevrimdışı oynatma için makbuzları önceden yükleme
öğesinde daha ayrıntılı bir şekilde anlatılmıştır.
Oturum yönetimi
Medya hakları sunucusunda kullanıcının kimlik doğrulamasını yapmak ve kalıcı oturumları yönetmek için DRMManager da kullanabilirsiniz.
Medya hakları sunucusuyla bir oturum oluşturmak için DRMManager
authenticate()
yöntemini kullanın. Kimlik doğrulama başarıyla tamamlandığında, DRMManager bir DRMAuthenticationCompleteEvent nesnesi gönderir. Bu nesne bir oturum belirteci içerir. Bu belirteci daha sonraki oturumları oluşturmak için kaydedebilir ve kullanıcının hesap kimlik bilgilerini girmesine gerek kalmamasını sağlayabilirsiniz. Yeni bir kimliği doğrulanmış oturum oluşturmak için simgeyi
setAuthenticationToken()
yöntemine iletin. (İşareti oluşturan sunucunun ayarları işaretin süresinin dolma zamanını ve diğer nitelikleri belirler. Yapı gelecekteki AIR güncellemelerinde değişebileceğinden, AIR uygulama kodu işaret verisi yapısını yorumlamamalıdır.)
Kimlik doğrulama işaretleri diğer bilgisayarlara aktarılabilir. Belirteçleri korumak için AIR Şifreli Yerel Depo'ya kaydedebilirsiniz. Daha fazla bilgi için bkz.
Şifrelenmiş yerel depolama
.
DRMStatus Olayları
loadVoucher()
yöntemine yapılan çağrı başarıyla tamamlandıktan sonra, DRMManager bir DRMStatusEvent nesnesi gönderir.
Makbuz alındığında, event nesnesinin
detail
özelliği (yalnızca AIR) “DRM.voucherObtained” değerini alır ve
voucher
özelliği DRMVoucher nesnesini içerir.
Makbuz alınmazsa,
detail
özelliği (yalnızca AIR) “DRM.voucherObtained” değerinde kalır; ancak
voucher
özelliği
null
değerindedir. Örneğin,
localOnly
LoadVoucherSetting özelliğini kullanıyorsanız ve yerel olarak önbelleğe alınmış makbuz mevcut değilse, makbuz alınamaz.
loadVoucher()
çağrısı muhtemelen bir kimlik doğrulama veya iletişim hatası nedeniyle başarıyla tamamlanmadığında, DRMManager bunun yerine bir DRMErrorEvent veya DRMAuthenticationErrorEvent nesnesi gönderir.
DRMAuthenticationComplete olayları
authenticate()
yöntemine yapılan çağrı aracılığıyla kullanıcının kimlik doğrulaması başarıyla tamamladığında, DRMManager bir DRMAuthenticationCompleteEvent nesnesi gönderir.
DRMAuthenticationCompleteEvent nesnesi, uygulama oturumları boyunca kullanıcı kimlik doğrulaması için kalıcı olacak yeniden kullanılabilir bir belirteç içerir. Oturumu yeniden oluşturmak için bu belirteci DRMManager
setAuthenticationToken()
yöntemine aktarın. (Süre dolması gibi işaret niteliklerini işaret oluşturucusu ayarlar. Adobe, belirteç niteliklerini inceleme amaçlı API sağlamaz.)
DRMAuthenticationError olayları
Kullanıcının kimlik doğrulaması
authenticate()
veya
setAuthenticationToken()
yöntemleri aracılığıyla başarıyla tamamlandığında, DRMManager bir DRMAuthenticationErrorEvent nesnesi gönderir.
|
|
|