使用 DRMStatusEvent 類別
Flash Player 10.1、Adobe AIR 1.0 以及更新的版本
開始順利播放受 Flash Access 保護的內容時,NetStream 物件會傳送 DRMStatusEvent 物件 (成功表示已驗證授權,而且使用者已獲驗證並授權檢視內容)。如果允許匿名使用者存取,也將傳送 DRMStatusEvent。在此情況下會檢查授權,以確認是否允許不需要驗證的匿名使用者存取與播放內容。匿名使用者可能會因各種原因而遭到拒絕存取。例如,匿名使用者無法在授權到期時存取內容。
DRMStatusEvent 物件包含與授權相關的資訊。這類資訊包括是否可以離線檢視內容,或者憑證何時到期且屆滿後再也無法檢視內容。應用程式可以利用這份資料,告知使用者其原則和權限的狀態。
DRMStatusEvent 屬性
DRMStatusEvent 類別包括下列屬性。在 1.0 以後的 AIR 版本中,可以使用部分屬性。如需完整版本資訊,請參閱「Adobe® Flash® Professional CS5 的 ActionScript® 3.0 參考」。
針對 Flash Player 10.1 不支援的屬性,DRMVoucher 類別會提供類似的 Flash Player 屬性。
屬性
|
說明
|
contentData
|
DRMContentData 物件,包含內嵌於內容中的 DRM 中繼資料。
|
detail (僅限 AIR)
|
用來說明狀態事件內容的字串。在 DRM 1.0 中,唯一有效的值為 DRM.voucherObtained。
|
isAnonymous (僅限 AIR)
|
指出使用者是否不需要提供驗證憑證就能存取受 Flash Access 保護的內容 (true = 是,false = 否)。false 值表示使用者提供的使用者名稱和密碼,必須與內容提供者已知且預期的憑證相符。
|
isAvailableOffline (僅限 AIR)
|
指出使用者是否可以離線使用受 Flash Access 保護的內容 (true = 是,false = 否)。如果要讓數位保護的內容可供離線檢視,其憑證必須快取至使用者的本機電腦。
|
isLocal
|
指出播放內容所需的憑證是否快取在本機中。
|
offlineLeasePeriod (僅限 AIR)
|
內容可供離線檢視的剩餘天數。
|
policies (僅限 AIR)
|
包含自訂 DRM 屬性的自訂物件。
|
voucher
|
DRMVoucher。
|
voucherEndDate (僅限 AIR)
|
憑證到期的絕對日期,屆滿後即再也無法檢視內容。
|
建立 DRMStatusEvent 處理常式
下列範例將為引發事件的 NetStream 物件建立事件處理常式,以輸出其 DRM 內容狀態資訊。這個事件處理常式會新增至指向受保護內容的 NetStream 物件。
function drmStatusEventHandler(event:DRMStatusEvent):void
{
trace(event);
}
function drmStatusEventHandler(event:DRMStatusEvent):void
{
trace(event);
}