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