MediaKeySession
これはメディアキーセッションを表します。
詳細については、https://www.w3.org/TR/encrypted-media/#mediakeysession-interface（英語のみ）を参照してください。
拡張
プロパティ
sessionId
readonlysessionId:string
このオブジェクトおよび関連付けられているキーまたはライセンスに対応するセッションIDです。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-sessionid（英語のみ）を参照してください。
expiration
readonlyexpiration:number
CDMによって決定される、セッション内のすべてのキーの有効期限です。有効期限がない場合、またはライセンスが明示的に期限切れにならない場合はNaNを返します。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-expiration（英語のみ）を参照してください。
closed
readonlyclosed:Promise<void> | null
Session Closedアルゴリズムの実行結果としてオブジェクトが閉じられるときに通知します。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-closed（英語のみ）を参照してください。
keyStatuses
readonlykeyStatuses:MediaKeyStatusMap | null
セッションで認識されているキーIDと、それぞれに関連付けられているキーの現在のステータスを表す読み取り専用マップへの参照です。各エントリは一意のキーIDを持ちます。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-keystatuses（英語のみ）を参照してください。
onkeystatuseschange
onkeystatuseschange:
((this:MediaKeySession, ev:Event) => any) | null
「keystatuseschange」イベントのイベントハンドラーです。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-onkeystatuseschange（英語のみ）を参照してください。
onmessage
onmessage:
((this:MediaKeySession, ev: MediaKeyMessageEvent) => any) | null
「message」イベントのイベントハンドラーです。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-onmessage（英語のみ）を参照してください。
メソッド
generateRequest()
generateRequest(initDataType:
string, initData:ArrayBuffer):Promise<void>
initDataに基づいてライセンスリクエストを生成します。アルゴリズムが成功してPromiseが解決されると、常に"license-request"または"individualization-request"タイプのメッセージがキューに入れられます。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-generaterequest（英語のみ）を参照してください。
パラメーター
initDataType
string
initDataの初期化データ型。
initData
ArrayBuffer
初期化データ。
戻り値
Promise<void>
load()
load(sessionId:
string):Promise<boolean> | null
指定されたセッション用に保存されているデータをこのオブジェクトに読み込みます。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-load（英語のみ）を参照してください。
パラメーター
sessionId
string
読み込むセッションのセッションID。
戻り値
Promise<boolean> | null
update()
update(response:
ArrayBuffer):Promise<void>
ライセンスを含むメッセージをCDMに提供します。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-update（英語のみ）を参照してください。
パラメーター
response
ArrayBuffer
CDMに提供するメッセージ。メソッドが正常に実行されたときに解決されるPromise。内容はキーシステム固有です。実行コードを含めることはできません。
戻り値
Promise<void>
close()
close():
Promise<void> | null
アプリでセッションが不要になったため、CDMがセッションに関連するリソースをすべて解放して終了する必要があることを示します。永続化されたデータは解放も消去もされません。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-close（英語のみ）を参照してください。
戻り値
Promise<void> | null
remove()
remove():
Promise<void> | null
セッションに関連付けられているすべてのライセンスとキーを削除します。永続的なセッションタイプでは、update()によってメッセージ解放の確認が処理されると、各セッションタイプの定義に従ってその他のセッションデータが消去されます。
詳細については、https://www.w3.org/TR/encrypted-media/#dom-mediakeysession-remove（英語のみ）を参照してください。
戻り値
Promise<void> | null
addEventListener()
addEventListener(type:
K, listener:(this:MediaKeySession, ev: MediaKeySessionEventMap[K]) => any |EventListener, options?:boolean | AddEventListenerOptions | undefined):void
イベントリスナーを追加します。
パラメーター
type
K
イベントのタイプ。
listener
(this: MediaKeySession, ev: MediaKeySessionEventMap[K]) => any | EventListener
イベントハンドラー。
options?
boolean | AddEventListenerOptions | undefined
無視されます。
addEventListener()
addEventListener(type:
string, listener: EventListener, options?:boolean | AddEventListenerOptions | undefined):void
イベントリスナーを追加します。
パラメーター
type
string
イベントのタイプ。
listener
イベントハンドラー。
options?
boolean | AddEventListenerOptions | undefined
無視されます。
Last updated: 2026年7月22日
