DRMManager sınıfını kullanma

Flash Player 10.1 ve üstü, Adobe AIR 1.5 ve üstü

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ı önceden yüklemeye ilişkin iş akışı daha ayrıntılı biçimde Çevrimdışı oynatma için makbuzları önceden yükleme bölümünde açıklanmış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. Kimlik doğrulaması yapılmış yeni bir oturum oluşturmak için belirteci setAuthenticationToken() yöntemine aktarın. (İş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.