（AIR のみ）
パッケージflash.net.drm
クラスpublic class DRMManager
継承DRMManager Inheritance EventDispatcher Inheritance Object

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

DRMManager は、DRM で保護されたコンテンツの表示に必要なバウチャーの取得および保存を管理します。

DRM で保護されたメディアファイルのメタデータから取得された DRMContentData オブジェクトを使用して、メディア著作権サーバーからバウチャーをプリロードできます。DRMContentData オブジェクトを使用して、ローカルキャッシュに個々のバウチャーを照会できます。また、すべてのバウチャーをリセットできます。ローカルキャッシュにあるすべてのバウチャーを列挙するためのメソッドは提供されていません。

アプリケーションでは DRMManager クラスのインスタンスを新規作成することはできません。静的 DRMManager.getDRMManager() を使用して、既存の DRMManager オブジェクトにアクセスします。

関連項目

flash.net.NetStream
flash.net.drm.DRMVoucher
flash.net.drm.DRMContentData

パブリックプロパティ
 プロパティ定義元
 Inheritedconstructor : Object
指定されたオブジェクトインスタンスのクラスオブジェクトまたはコンストラクタ関数への参照です。
Object
 Inheritedprototype : Object
[静的] クラスまたは関数オブジェクトのプロトタイプオブジェクトへの参照です。
Object
パブリックメソッド
 メソッド定義元
 Inherited
addEventListener(type:String, listener:Function, useCapture:Boolean = false, priority:int = 0, useWeakReference:Boolean = false):void
イベントリスナーオブジェクトを EventDispatcher オブジェクトに登録し、リスナーがイベントの通知を受け取るようにします。
EventDispatcher
  
AIR-only authenticate(serverURL:String, domain:String, username:String, password:String):void
ユーザーを認証します。
DRMManager
 Inherited
dispatchEvent(event:Event):Boolean
イベントをイベントフローに送出します。
EventDispatcher
  
AIR-only getDRMManager():DRMManager
[静的] シングルトン DRMManager オブジェクトのインスタンスを返します。
DRMManager
 Inherited
hasEventListener(type:String):Boolean
EventDispatcher オブジェクトに、特定のイベントタイプに対して登録されたリスナーがあるかどうかを確認します。
EventDispatcher
 Inherited
hasOwnProperty(name:String):Boolean
オブジェクトに指定されたプロパティが定義されているかどうかを示します。
Object
 Inherited
isPrototypeOf(theClass:Object):Boolean
Object クラスのインスタンスが、パラメータとして指定されたオブジェクトのプロトタイプチェーン内にあるかどうかを示します。
Object
  
AIR-only loadVoucher(contentData:DRMContentData, setting:String):void
メディア著作権サーバーまたはローカルバウチャーキャッシュからバウチャーをロードします。
DRMManager
 Inherited
propertyIsEnumerable(name:String):Boolean
指定されたプロパティが存在し、列挙できるかどうかを示します。
Object
 Inherited
removeEventListener(type:String, listener:Function, useCapture:Boolean = false):void
EventDispatcher オブジェクトからリスナーを削除します。
EventDispatcher
  
AIR-only resetDRMVouchers():void
ローカルにキャッシュされたすべてのDRM（デジタル著作権管理）バウチャーデータを削除します。
DRMManager
  
AIR-only setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void
指定されたサーバーおよびドメインとの通信に使用する認証トークンを設定します。
DRMManager
 Inherited
setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void
ループ処理に対するダイナミックプロパティの可用性を設定します。
Object
 Inherited
toString():String
指定されたオブジェクトのストリング表現を返します。
Object
 Inherited
valueOf():Object
指定されたオブジェクトのプリミティブな値を返します。
Object
 Inherited
willTrigger(type:String):Boolean
指定されたイベントタイプについて、この EventDispatcher オブジェクトまたはその祖先にイベントリスナーが登録されているかどうかを確認します。
EventDispatcher
イベント
 イベント 概要 定義元
 Inherited
activate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを取得して、アクティブになったときに送出されます。EventDispatcher
  
AIR-only authenticationComplete
authenticate() メソッドの呼出し後に Media Rights Server によってユーザーが認証される場合、DRMManager によって DRMAuthenticationCompleteEvent オブジェクトが送出されます。DRMManager
  
AIR-only authenticationError
authenticate() メソッドの呼出し後に Media Rights Server によってユーザーが認証されない場合、DRMManager によって DRMAuthenticationErrorEvent オブジェクトが送出されます。DRMManager
 Inherited
deactivate
[ブロードキャスト イベント] Flash Player または AIR アプリケーションがオペレーティングシステムのフォーカスを失って、非アクティブになったときに送出されます。EventDispatcher
  
AIR-only loadVoucherComplete
要求したバウチャーが Media Rights Server から取得された場合は、DRMManager によって DRMStatusEvent オブジェクトが送出されます。DRMManager
  
AIR-only loadVoucherError
要求したバウチャーを Media Rights Server から取得できない場合、DRMManager によって DRMErrorEvent オブジェクトが送出されます。DRMManager
メソッドの詳細
AIR-only authenticate()メソッド
public function authenticate(serverURL:String, domain:String, username:String, password:String):void

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

ユーザーを認証します。

authenticationComplete イベントおよび authenticationError イベントをリスンして、認証の結果を判別します。複数の authenticate() 呼び出しがキューに置かれます。authenticationComplete イベントに対して送出された AuthenticationCompleteEvent オブジェクトには、アプリケーションによって保存できる認証トークンが含まれています。

保存された認証トークンを使用するか、または他の手段でダウンロードされたトークンを使用して、メディア著作権サーバーで認証された将来のセッションを確立できます。トークンを使用してセッションを確立するには、DRMManager の setAuthenticationToken() メソッドを呼び出します。有効期限などのトークンのプロパティは、トークンを生成するサーバーの設定によって決定されます。

重要：ユーザーのインターネット接続が認証を必要とするプロキシサーバーを経由する場合、authenticate() メソッドは成功しません。そのようなユーザーは認証を必要とする DRM バウチャーをプリロードできませんが、再生を開始し、NetStream setAuthenticationCredentials() メソッドを使用してプロキシサーバーと Media Rights Server の両方にユーザーをログインさせることで、アプリケーションはバウチャーを取得できます。バウチャーを取得すると、コンテンツをオフラインで表示できます（バウチャーによって表されたライセンスがオフライン再生を許可している場合）。

パラメータ

serverURL:String — 保護されたコンテンツの表示のためのバウチャーを提供できるメディア著作権サーバーの URL
 
domain:String — サーバー上のドメイン（ネットワークまたはインターネットのドメイン名ではありません）
 
username:String — ユーザーアカウント名
 
password:String — ユーザーアカウントのパスワード

関連項目

flash.net.NetStream.setAuthenticationCredentials()
setAuthenticationToken()
AIR-only getDRMManager()メソッド 
public static function getDRMManager():DRMManager

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

シングルトン DRMManager オブジェクトのインスタンスを返します。

セキュリティドメインごとに 1 つの DRMManager インスタンスが存在します。

戻り値
DRMManager

関連項目

flash.system.SecurityDomain
AIR-only loadVoucher()メソッド 
public function loadVoucher(contentData:DRMContentData, setting:String):void

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

Media Rights Server またはローカルバウチャーキャッシュからバウチャーをロードします。

バウチャーは、setting パラメータに従ってロードされます。

LoadVoucherSetting クラスは、setting パラメータの値として使用するストリング定数を定義します。

バウチャーが正常にロードされると、DRMManager によって DRM ステータスイベントが送出されます。バウチャーがロードされると、アプリケーションではすぐに再生を開始できます。バウチャーは、送出された DRMStatusEvent オブジェクトの voucher プロパティで使用できます。このバウチャーオブジェクトを使用して、関連付けられたメディア著作権情報をユーザーに表示することができます。

メディア著作権サーバーからバウチャーをロードできなかった場合は、DRM エラーイベントが送出されます。送出された DRMErrorEvent オブジェクトの errorID プロパティは、エラーの理由を示します。一般的なエラーの原因には、オフラインのユーザーが FMRMS サーバーに接続しようとした場合や、ログインしていないユーザーがバウチャーをロードしようとした場合などが含まれます。アプリケーションでこれらのエラーに応答し、対応策を取ることができます。例えば、バウチャーのダウンロードに認証資格情報が必要な場合、ユーザーにアカウントのユーザー名とパスワードを要求し、DRMManager の authenticate() メソッドを呼び出した後、バウチャーのロードを再び試行できます。

バウチャーをローカルキャッシュから取得できず、localOnly 設定を使用している場合は、DRMErrorEvent は送出されません。代わりに、DRM ステータスイベントが送出されます。この DRMStatusEvent オブジェクトの detail プロパティは DRM.voucherObtained のままですが、voucher プロパティは null です。

パラメータ

contentData:DRMContentData — DRM で保護されたメディアファイルからの DRMContentData オブジェクト
 
setting:String — バウチャーをローカルキャッシュまたはメディア著作権サーバーのどちらから取得するかを決定します。

AIR-only resetDRMVouchers()メソッド 
public function resetDRMVouchers():void

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

ローカルにキャッシュされたすべてのDRM（デジタル著作権管理）バウチャーデータを削除します。

ユーザーが暗号化されたコンテンツにアクセスできるようにするには、アプリケーションが必要なバウチャーを再度ダウンロードする必要があります。この関数の呼び出しは、Netstream.resetDRMVouchers() () の呼び出しに相当します。


例外
IOError — バウチャーデータを削除できません。

関連項目

flash.net.NetStream.resetDRMVouchers()
AIR-only setAuthenticationToken()メソッド 
public function setAuthenticationToken(serverUrl:String, domain:String, token:ByteArray):void

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

指定されたサーバーおよびドメインとの通信に使用する認証トークンを設定します。

認証トークンは、DRMAuthenticationCompleteEvent オブジェクトの token プロパティから使用できますが、このオブジェクトは authenticate() メソッドの呼び出しが成功した後に送出されます。トークンはセッション用に自動的にキャッシュされますが、setAuthenticationToken() メソッドを使用してトークンを直接管理できます。

トークンを設定することにより、サーバーおよびドメイン用にキャッシュされている既存のトークンがすべて上書きされます。キャッシュされたトークンを消去するには、token パラメータを null に設定します。

パラメータ

serverUrl:String — メディア著作権サーバーの URL
 
domain:String — メディア著作権サーバー上のドメイン
 
token:ByteArray — 認証トークン

イベントの詳細
AIR-only authenticationComplete イベント
イベントオブジェクトの型: flash.events.DRMAuthenticationCompleteEvent
プロパティ DRMAuthenticationCompleteEvent.type = flash.events.DRMAuthenticationCompleteEvent.AUTHENTICATION_COMPLETE

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

DRMManager は、ユーザーが authenticate() メソッドの呼び出しの後で Media Rights Server に認証される場合は、DRMAuthenticationCompleteEvent オブジェクトを送出します。

イベントリスナーの追加および削除時に型パラメータで認証完了イベントに使用されるストリング定数。
AIR-only authenticationError イベント  
イベントオブジェクトの型: flash.events.DRMAuthenticationErrorEvent
プロパティ DRMAuthenticationErrorEvent.type = flash.events.DRMAuthenticationErrorEvent.AUTHENTICATION_ERROR

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

DRMManager は、ユーザーが authenticate() メソッドの呼び出しの後で Media Rights Server に認証されない場合は、DRMAuthenticationErrorEvent オブジェクトを送出します。

イベントリスナーの追加および削除時に型パラメータで認証エラーイベントに使用されるストリング定数。
AIR-only loadVoucherComplete イベント  
イベントオブジェクトの型: flash.events.DRMStatusEvent
プロパティ DRMStatusEvent.type = flash.events.DRMStatusEvent.LOAD_VOUCHER_COMPLETE

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

要求したバウチャーが Media Rights Server から取得された場合は、DRMManager によって DRMStatusEvent オブジェクトが送出されます。

AIR-only loadVoucherError イベント  
イベントオブジェクトの型: flash.events.DRMErrorEvent
プロパティ DRMErrorEvent.type = flash.events.DRMErrorEvent.LOAD_VOUCHER_ERROR

言語バージョン: ActionScript 3.0
ランタイムバージョン: AIR 1.5

要求したバウチャーを Media Rights Server から取得できない場合、DRMManager によって DRMErrorEvent オブジェクトが送出されます。

メモ：localOnly を source パラメータとして使用して、ローカルバウチャーキャッシュからのバウチャーのロードに失敗した場合、DRMErrorEvent オブジェクトは送出されません。代わりに、voucher プロパティが null に設定された DRMStatusEvent オブジェクトが送出されます。




© 2009 Adobe Systems Incorporated. All rights reserved.
Thu Mar 19 2009, 08:51 PM -07:00
 

 

このページに新しいコメントが追加された場合に、電子メールでの通知を希望する。 | コメントレポート

現在のページ: http://livedocs.adobe.com/flex/3_jp/langref/flash/net/drm/DRMManager.html