使用 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); 
}