メディアセッション

1. はじめに

このセクションは規範的ではありません。

メディアは今日広く利用されており、Webはメディアコンテンツを消費する主要な手段のひとつです。多くのプラットフォームは通知、メディアコントロールセンター、デバイスのロック画面、ウェアラブルデバイスなど、様々なUI要素上でタイトル、アーティスト、アルバム、アルバムアートなどのメディアメタデータを表示できます。本仕様は、ウェブページがプラットフォームUI上に表示されるメディアメタデータを指定し、プラットフォームUIやメディアキーからのメディアコントロールに応答できるようにすることで、ユーザー体験を向上させることを目的としています。

5. MediaSession インターフェース

[Exposed=Window]
partial interface Navigator {
  [SameObject] readonly attribute MediaSession mediaSession;
};

enum MediaSessionPlaybackState {
  "none",
  "paused",
  "playing"
};

enum MediaSessionAction {
  "play",
  "pause",
  "seekbackward",
  "seekforward",
  "previoustrack",
  "nexttrack",
  "skipad",
  "stop",
  "seekto",
  "togglemicrophone",
  "togglecamera",
  "togglescreenshare",
  "hangup",
  "previousslide",
  "nextslide",
  "enterpictureinpicture",
  "voiceactivity"
};

enum MediaSessionEnterPictureInPictureReason {
  "other",
  "useraction",
  "contentoccluded"
};

callback MediaSessionActionHandler = undefined(MediaSessionActionDetails details);

[Exposed=Window]
interface MediaSession {
  attribute MediaMetadata? metadata;

  attribute MediaSessionPlaybackState playbackState;

  undefined setActionHandler(MediaSessionAction action, MediaSessionActionHandler? handler);

  undefined setPositionState(optional MediaPositionState state = {});

  Promise<undefined> setMicrophoneActive(boolean active);

  Promise<undefined> setCameraActive(boolean active);

  Promise<undefined> setScreenshareActive(boolean active);
};

MediaSession オブジェクトは、あるドキュメントのメディアセッションを表し、ドキュメントが再生やその扱い方に関する情報をユーザーエージェントに伝えることを可能にします。

MediaSession には、metadata オブジェクト（MediaMetadataで表現）を関連付けます。初期値はnullです。

mediaSession 属性は、 MediaSession インスタンスを、Navigator オブジェクトに関連付けて返さなければなりません。

metadata 属性は、 MediaSessionの metadata を反映します。取得時は MediaSessionの metadata を返さなければなりません。設定時は新しい値valueで以下の手順を実行する必要があります：

1. MediaSessionの metadata がnullでない場合は、その media sessionをnullに設定する。
2. MediaSessionの metadata を valueに設定する。
3. MediaSessionの metadata がnullでない場合は、その media sessionを現在のMediaSessionに設定する。
4. 並行して、メタデータ更新アルゴリズムを実行する。

playbackState 属性は、media sessionの宣言された再生状態を表し、セッションがその 閲覧コンテキスト でメディアを再生しているかどうかを宣言します。初期値はnoneです。設定時は、有効な MediaSessionPlaybackState 値ならIDL属性に新しい値を設定しなければなりません。取得時は、最後に設定された有効な値を返す必要があります。 playbackState 属性は、閲覧コンテキストが再生中か一時停止中かを判断するためのヒントです。

playbackState を設定すると、実際の再生状態が変化する可能性があり、 メディアセッションアクション更新アルゴリズムが実行されることがあります。

MediaSessionPlaybackState 列挙型は、 閲覧コンテキストがメディアを再生中かどうかを示すために使われます。値は以下の通りです:

• none は、 閲覧コンテキストが再生・一時停止状態を指定しない場合を意味し、 playbackState 属性でのみ使えます。
• playing は、 閲覧コンテキストが現在メディアを再生中で、一時停止できることを意味します。
• paused は、 閲覧コンテキストがメディアを一時停止していて、再開可能なことを意味します。

setActionHandler(action, handler) メソッドは、呼び出されるとMediaSessionで actionとhandlerを使ってアクションハンドラー更新アルゴリズムを実行しなければなりません。

setPositionState(state) メソッドは、 呼び出された時、以下の手順を実行しなければなりません:

• stateが空の辞書なら、ポジション状態をクリアし、これらの手順を中断する。
• stateのduration が存在しなければ、TypeErrorを投げる。
• stateのduration が負またはNaNなら、TypeErrorを投げる。
• stateのposition が存在しなければ、ゼロに設定する。
• stateのposition が負またはdurationより大きければ、 TypeErrorを投げる。
• stateのplaybackRateが存在しなければ、1.0に設定する。
• stateのplaybackRate がゼロなら、 TypeErrorを投げる。
• ポジション状態および最後に位置が更新された時刻を更新する。

setMicrophoneActive(active) メソッドは、 ページが望むマイクキャプチャ状態（例：通話で音声送信していないので「非アクティブ」とみなすなど）をユーザーエージェントに通知します。呼び出すと以下の手順を実行しなければなりません：

1. documentをthisの関連グローバルオブジェクトの 関連付けられたDocumentとする。
2. captureKindに"microphone"を設定する。
3. キャプチャ状態更新アルゴリズムをdocument、active、captureKindで実行した結果を返す。

同様に、setCameraActive(active) メソッドは、ページが望むカメラキャプチャ状態をユーザーエージェントに通知します。呼び出されると以下の手順を実行しなければなりません：

1. documentをthisの関連グローバルオブジェクトの 関連付けられたDocumentとする。
2. captureKindに"camera"を設定する。
3. キャプチャ状態更新アルゴリズムをdocument、active、captureKindで実行した結果を返す。

同様に、setScreenshareActive(active) メソッドは、ページが望む画面共有キャプチャ状態をユーザーエージェントに通知します。呼び出されると以下の手順を実行しなければなりません：

1. documentをthisの関連グローバルオブジェクトの 関連付けられたDocumentとする。
2. captureKindに"screenshare"を設定する。
3. キャプチャ状態更新アルゴリズムをdocument、active、captureKindで実行した結果を返す。

キャプチャ状態更新アルゴリズムは、 document、active、captureKindで呼び出された時、以下の手順を実行しなければなりません：

1. documentが完全にアクティブでなければ、promiseをInvalidStateErrorで拒否して返す。
2. activeがtrueかつdocumentの visibility stateが"visible"でなければ、ユーザーエージェントは promiseを InvalidStateErrorで拒否して返してもよい。
3. pを新しいpromiseとする。
4. 並行して、次の手順を実行する:
   1. すべての入力ソース一時停止ポリシーをユーザーエージェントが captureKind型の入力ソースに対してUIで実装している場合はapplyPausePolicyをtrue、そうでなければfalseとする。
   2. applyPausePolicyがtrueなら次のサブステップを実行する:
      1. currentlyActive を、ユーザーエージェントが現在 captureKind 型の すべての入力ソースを一時停止している場合は false、それ以外の場合は true とする。
      2. active が currentlyActive と等しい場合、タスクをキューし、ユーザー操作タスクソースを使って p を undefined で解決し、これらの手順を終了する。
      3. active が true の場合、ユーザーエージェントは進行を待つことができる（例えばユーザーへのプロンプト表示など）。
      4. ユーザーエージェントがキャプチャ状態の更新要求を拒否した場合、タスクをキューし、ユーザー操作タスクソースを使って p を NotAllowedError で拒否し、これらの手順を終了する。
   3. ユーザーエージェントのキャプチャ状態UIをcaptureKindとactiveに基づき更新する。
   4. タスクをキューし、ユーザーインタラクションタスクソースでpをundefinedで解決する。
   5. applyPausePolicyがtrueなら次のサブステップを実行する:
      1. newMutedStateをactiveがfalseならtrue、そうでなければfalseとする。
      2. captureKind型の入力ソースを持つすべてのMediaStreamTrack について、タスクをキューし、ユーザーインタラクションタスクソースで トラックのミュート状態を設定する(newMutedState)。
5. pを返す。

setMicrophoneActive(active)、 setCameraActive(active) およびsetScreenshareActive(active)メソッドは、ユーザーエージェントの固有のヒューリスティックに基づき拒否されることがあります。特に、ウェブページがマイク・カメラ・画面共有のアクティブ化（ミュート解除）を要求した場合、ユーザーエージェントは一時的なアクティベーションを求めることがあります。また、実際の決定のためにプロンプトなどでユーザー入力を要求する場合もあります。

ユーザーエージェントはメディアセッションアクションのハンドラを呼び出すUIを表示してもよいです。

6. MediaMetadata インターフェース

[Exposed=Window]
interface MediaMetadata {
  constructor(optional MediaMetadataInit init = {});
  attribute DOMString title;
  attribute DOMString artist;
  attribute DOMString album;
  attribute FrozenArray<object> artwork;
  [SameObject] readonly attribute FrozenArray<ChapterInformation> chapterInfo;
};

dictionary MediaMetadataInit {
  DOMString title = "";
  DOMString artist = "";
  DOMString album = "";
  sequence<MediaImage> artwork = [];
  sequence<ChapterInformationInit> chapterInfo = [];
};

MediaMetadata オブジェクトは、MediaSession に関連付けられたメタデータを表し、ユーザーエージェントがカスタマイズされたユーザーインターフェースを提供するために利用できます。

MediaMetadata には、メディアセッションを関連付けることができます。

MediaMetadata には、タイトル、 アーティスト、 アルバム があり、型はDOMStringです。

MediaMetadata には、アートワーク画像のシーケンスがあり、型はMediaImageです。 また、MediaMetadata には、初期値がundefinedの 変換済みアートワーク画像が関連付けられます。

MediaMetadata には、 チャプター情報のリストが関連付けられます。

MediaMetadata がnullと等しいか、以下のすべての条件を満たす場合、空のメタデータであると言います：

• そのタイトルが空文字列である。
• そのアーティストが空文字列である。
• そのアルバムが空文字列である。
• そのアートワーク画像の長さが0である。
• そのチャプター情報の長さが0である。

MediaMetadata(init) コンストラクタが呼び出されたとき、以下の手順を実行しなければなりません：

1. metadataを新しいMediaMetadata オブジェクトとする。
2. metadataのtitle をinitのtitleに設定する。
3. metadataのartist をinitのartistに設定する。
4. metadataのalbum をinitのalbumに設定する。
5. アートワーク変換アルゴリズムをinitのartworkをinputとして実行し、 成功した場合はその結果をmetadataのアートワーク画像に設定する。
6. chaptersをChapterInformation型の空のリストとする。
7. initのchapterInfoの各entryについて、 ChapterInformationを作成しchaptersに追加する。
8. metadataのチャプター情報をchaptersから凍結配列を作成した結果に設定する。
9. metadataを返す。

アートワーク変換アルゴリズムがinputパラメータで呼び出された場合（inputはMediaImage型のシーケンス）、ユーザーエージェントは以下の手順を実行しなければなりません：

1. outputをMediaImage型の空のリストとする。
2. input（MediaImageリスト）の各entryについて、以下の手順を実行する：
   1. imageを新しいMediaImageとする。
   2. baseURLをentry settings objectで指定されたAPIのベースURLとする。
   3. Parse entryのsrc をbaseURLで行い、失敗でなければその値をimageのsrcに設定する。失敗なら TypeErrorを投げてこれらの手順を中断する。
   4. imageのsizesをentryのsizesに設定する。
   5. imageのtypeをentryのtypeに設定する。
   6. outputにimageを追加する。
3. outputを結果として返す。

title属性は MediaMetadataの タイトルを反映します。取得時は MediaMetadataの タイトルを返し、設定時は MediaMetadataの タイトルに与えられた値を設定する。

artist属性は MediaMetadataの アーティストを反映します。取得時は MediaMetadataの アーティストを返し、設定時は MediaMetadataの アーティストに与えられた値を設定する。

album属性は MediaMetadataの アルバムを反映します。取得時は MediaMetadataの アルバムを返し、設定時は MediaMetadataの アルバムに与えられた値を設定する。

artwork 属性はMediaMetadataの アートワーク画像を反映します。取得時は以下の手順を実行します：

1. MediaMetadataの 変換済みアートワーク画像がundefinedの場合、以下の手順を実行する：
   1. frozenArtworkをJavaScriptの配列値とする。
   2. MediaMetadataの アートワーク画像の各entryについて、以下の手順を実行する：
      1. imageをIDLからJavaScriptオブジェクトへの変換結果とする。
      2. SetIntegrityLevel(image, "frozen")を実行し、スクリプトによる偶発的な変更を防ぐ。
      3. frozenArtworkにimageを追加する。
   3. SetIntegrityLevel(frozenArtwork, "frozen")を実行する。
   4. MediaMetadataの 変換済みアートワーク画像にfrozenArtworkを設定する。
2. MediaMetadataの 変換済みアートワーク画像を返す。

設定時は、valueが新しい値として以下の手順を実行する：

1. convertedArtworkをECMAScriptからIDL値への変換でvalueをMediaImage型のシーケンスに変換する。
2. アートワーク変換アルゴリズムをconvertedArtworkで実行し、成功したらその結果をMediaMetadataの アートワーク画像に設定する。
3. MediaMetadataの 変換済みアートワーク画像をundefinedに設定する。

MediaMetadataの タイトル、 アーティスト、 アルバムまたは アートワーク画像が変更された場合、ユーザーエージェントは以下の手順を実行しなければなりません：

1. インスタンスに関連付けられたメディアセッションがなければ、これらの手順を中断する。
2. それ以外の場合は、タスクをキューして以下のサブステップを実行する：
   1. インスタンスに関連付けられたメディアセッションがなくなった場合は、これらの手順を中断する。
   2. それ以外の場合は、並行して、メタデータ更新アルゴリズムを実行する。

7. ChapterInformation インターフェース

[Exposed=Window]
interface ChapterInformation {
  readonly attribute DOMString title;
  readonly attribute double startTime;
  [SameObject] readonly attribute FrozenArray<MediaImage> artwork;
};

dictionary ChapterInformationInit {
  DOMString title = "";
  double startTime = 0;
  sequence<MediaImage> artwork = [];
};

ChapterInformation オブジェクトは、章ごとのメタデータ（セクションのタイトル、タイムスタンプ、このセクションのスクリーンショット画像データなど）を表し、ユーザーエージェントがカスタマイズされたユーザーインターフェースを提供するために利用できます。

ChapterInformation には、タイトル（DOMString型）が関連付けられます。

ChapterInformation には、 startTime（double型）が関連付けられます。

ChapterInformation には、 アートワーク画像のリストが関連付けられます。

ChapterInformation をinitで作成するには、以下の手順を実行します：

1. chapterInfoを新しいChapterInformation オブジェクトとする。
2. chapterInfoのtitle をinitのtitleに設定する。
3. chapterInfoのstartTime をinitのstartTimeに設定する。 startTimeが負またはdurationより大きい場合、TypeErrorを投げる。
4. artwork をinitのartworkを使い アートワーク変換アルゴリズムを実行した結果とする。
5. chapterInfoのアートワーク画像を、 artworkから凍結配列を作成した結果に設定する。
6. chapterInfoを返す。

title属性は ChapterInformationの タイトルを反映します。取得時は ChapterInformationの タイトルを返します。

startTime属性は ChapterInformationの startTime（秒単位）を反映します。取得時は ChapterInformationの startTimeを返します。

artwork 属性はChapterInformationの アートワーク画像を反映します。取得時は ChapterInformationの アートワーク画像を返します。

8. MediaImage 辞書

dictionary MediaImage {
  required USVString src;
  DOMString sizes = "";
  DOMString type = "";
};

MediaImage 辞書のメンバーは、ImageResource ([IMAGE-RESOURCE]) に触発されています。

src 辞書メンバーは、MediaImage オブジェクトのsourceを指定するために使用されます。これはユーザーエージェントが画像データを取得するためのURLです。

sizes 辞書メンバーは、MediaImage オブジェクトのsizesを指定します。 この値はHTML link 要素の sizes属性の仕様に従い、順序のない、スペース区切りの一意なトークン集合（ASCII大文字小文字区別なし）で、画像の寸法を表します。 キーワードは "any" とのASCII大文字小文字区別なし一致、または先頭がU+0030（0）でない2つの非負整数をU+0078（x）またはU+0058（X）で区切ったものです。キーワードは生ピクセル単位のアイコンサイズを表します。複数の画像オブジェクトがある場合、ユーザーエージェントは表示状況に最適なアイコンを選択するためにこの値を用いることがあり、不適切なものは無視されます。sizes属性のパース手順はHTML link 要素の sizes 属性のパース手順に従わなければなりません。

type 辞書メンバーは、MediaImage オブジェクトのMIMEタイプを指定します。これは画像のメディアタイプのヒントであり、ユーザーエージェントがサポートしていないメディアタイプの画像を無視できるようにするための属性です。

9. MediaPositionState 辞書

dictionary MediaPositionState {
  unrestricted double duration;
  double playbackRate;
  double position;
};

MediaPositionState 辞書は、MediaSession に紐付いた現在の再生位置を表し、ユーザーエージェントが再生位置や再生時間を表示するユーザーインターフェースを提供するために利用できます。

duration 辞書メンバーは、再生時間（秒単位）を指定します。常に正値でなければならず、終端のないメディア（ライブ再生など）には正の無限大を使うことができます。

playbackRate 辞書メンバーは再生速度を指定します。正値で順再生、負値で逆再生を表すことができます。ゼロにはすべきではありません。

position 辞書メンバーは、最後に報告された再生位置（秒単位）を指定します。常に正値でなければなりません。

10. MediaSessionActionDetails 辞書

dictionary MediaSessionActionDetails {
  required MediaSessionAction action;
  double seekOffset;
  double seekTime;
  boolean fastSeek;
  boolean isActivating;
  MediaSessionEnterPictureInPictureReason enterPictureInPictureReason;
};

MediaSessionActionHandler は、辞書型MediaSessionActionDetailsのdetailsパラメータ付きで実行されなければなりません。

action 辞書メンバーは、メディアセッションアクションを指定し、MediaSessionActionHandlerと関連付けられます。

seekOffset 辞書メンバーは、メディアセッションアクション がseekbackward またはseekforwardのときに指定できる秒数です。存在すれば必ず正値でなければならず、指定されていない場合はサイト側で適切な時間（例：数秒）を選択します。

メディアセッションアクションがseektoの場合：

• seekTime 辞書メンバーは必須で、再生時間を移動する秒数を指定します。
• fastSeek 辞書メンバーは指定可能で、actionがシーケンスの一部として複数回呼び出されており、今回がその最後でない場合にtrueとなります。

isActivating 辞書メンバーは、ユーザーエージェントがキャプチャ関連の アクションに対して すべての入力ソースを一時停止 しようとしている場合falseとなり、それ以外の場合はtrueとなります。 この辞書メンバーは、ユーザーエージェントが すべての入力ソースの一時停止 ポリシーを実装しており、かつメディアセッションアクションが togglecamera、 togglemicrophone、 togglescreenshare の場合は必ず存在しなければなりません。

メディアセッションアクションがenterpictureinpictureの場合、 enterPictureInPictureReason 辞書メンバーは必須で、UAがこのアクションを発火した理由を表します。

enterPictureInPictureReason は以下の値を持つことができます：

• other：ピクチャインピクチャに入る理由が既存の列挙値に当てはまらない場合
• useraction：ユーザーがUAのUIでピクチャインピクチャボタンをクリックするなど、明示的な操作を行った場合
• contentoccluded：タブ切替やタブの最小化などでページが不可視になったためUAがピクチャインピクチャを要求した場合

11. Permissions Policy統合

本仕様は、"mediasession"という文字列で識別されるポリシー制御機能を定義します。そのデフォルト許可リストは*です。

ドキュメントのPermissions Policyによって、そのドキュメント内のコンテンツがMediaSession APIを使用できるかどうかが決定されます。ドキュメントで無効化されている場合、ユーザーエージェントはそのドキュメントのメディアセッションをアクティブなメディアセッションとして選択してはなりません。

12. 例

このセクションは規範的ではありません。

navigator.mediaSession.metadata = new MediaMetadata({
  title: "Episode Title",
  artist: "Podcast Host",
  album: "Podcast Title",
  artwork: [{src: "podcast.jpg"}],
  chapterInfo: [
    {title: "Chapter 1", startTime: 0, artwork: [{src: "chapter1.jpg"}]},
    {title: "Chapter 2", startTime: 120, artwork: [{src: "chapter2.jpg"}]}
  ]
});

navigator.mediaSession.metadata = new MediaMetadata({
  title: "Episode Title",
  artist: "Podcast Host",
  album: "Podcast Title",
  artwork: [
    {src: "podcast.jpg", sizes: "128x128", type: "image/jpeg"},
    {src: "podcast_hd.jpg", sizes: "256x256"},
    {src: "podcast_xhd.jpg", sizes: "1024x1024", type: "image/jpeg"},
    {src: "podcast.png", sizes: "128x128", type: "image/png"},
    {src: "podcast_hd.png", sizes: "256x256", type: "image/png"},
    {src: "podcast.ico", sizes: "128x128 256x256", type: "image/x-icon"}
  ],
  chapterInfo: [
    {title: "Chapter 1", startTime: 0, artwork: [
       {src: "chapter1_a.jpg", sizes: "128x128", type: "image/jpeg"},
       {src: "chapter1_b.png", sizes: "256x256", type: "image/png"}
     ]},
    {title: "Chapter 2", startTime: 120, artwork: [
       {src: "chapter2_a.jpg", sizes: "128x128", type: "image/jpeg"},
       {src: "chapter2_b.png", sizes: "256x256", type: "image/png"}
     ]}
  ]
});

var audio1 = document.createElement("audio");
audio1.src = "chapter1.mp3";

var audio2 = document.createElement("audio");
audio2.src = "chapter2.mp3";

audio1.play();
audio1.addEventListener("ended", function() {
  audio2.play();
});

function updateMetadata(event) {
  navigator.mediaSession.metadata = new MediaMetadata({
    title: event.target == audio1 ? "Chapter 1" : "Chapter 2",
    artist: "An Author",
    album: "A Book",
    artwork: [{src: "cover.jpg"}]
  });
}

audio1.addEventListener("play", updateMetadata);
audio2.addEventListener("play", updateMetadata);

var tracks = ["chapter1.mp3", "chapter2.mp3", "chapter3.mp3"];
var trackId = 0;

var audio = document.createElement("audio");
audio.src = tracks[trackId];

function updatePlayingMedia() {
  audio.src = tracks[trackId];
  // メタデータの更新（省略）
}

navigator.mediaSession.setActionHandler("previoustrack", function() {
  trackId = (trackId + tracks.length - 1) % tracks.length;
  updatePlayingMedia();
});

navigator.mediaSession.setActionHandler("nexttrack", function() {
  trackId = (trackId + 1) % tracks.length;
  updatePlayingMedia();
});

navigator.mediaSession.setActionHandler("seekto", function(details) {
  audio.currentTime = details.seekTime;
});

var adFrame;
var audio = document.createElement("audio");
audio.src = "foo.mp3";

function resetActionHandlers() {
  navigator.mediaSession.setActionHandler("play", _ => audio.play());
  navigator.mediaSession.setActionHandler("pause", _ => audio.pause());
}

resetActionHandlers();

// このメソッドはページが広告再生を行いたい場合に呼ばれます。
function pauseAudioAndPlayAd() {
  audio.pause();
  navigator.mediaSession.playbackState = "playing";
  setUpAdFrame();
  adFrame.contentWindow.postMessage("play_ad");
  navigator.mediaSession.setActionHandler("pause", pauseAd);
}

function pauseAd() {
  adFrame.contentWindow.postMessage("pause_ad");
  navigator.mediaSession.playbackState = "paused";
  navigator.mediaSession.setActionHandler("play", resumeAd);
}

function resumeAd() {
  adFrame.contentWindow.postMessage("resume_ad");
  navigator.mediaSession.playbackState = "playing";
  navigator.mediaSession.setActionHandler("pause", pauseAd);
}

window.onmessage = function(e) {
  if (e.data === "ad finished") {
    removeAdFrame();
    navigator.mediaSession.playbackState = "none";
    resetActionHandlers();
  }
}

function setUpAdFrame() {
  adFrame = document.createElement("iframe");
  adFrame.src = "https://example.com/ad-iframe.html";
  document.body.appendChild(adFrame);
}

function removeAdFrame() {
  adFrame.remove();
}

// メディアがロードされたら、durationをセット
navigator.mediaSession.setPositionState({
  duration: 60
});

// 冒頭からメディア再生開始
navigator.mediaSession.playbackState = "playing";

// 10秒地点から2倍速で再生開始
navigator.mediaSession.setPositionState({
  duration: 60,
  playbackRate: 2,
  position: 10
});

// メディアが一時停止
navigator.mediaSession.playbackState = "paused";

// メディアがリセット
navigator.mediaSession.setPositionState(null);

var isMicrophoneActive = false;
var isCameraActive = false;

navigator.mediaSession.setMicrophoneActive(isMicrophoneActive);
navigator.mediaSession.setCameraActive(isCameraActive);

navigator.mediaSession.setActionHandler("togglemicrophone", function() {
  if (isMicrophoneActive) {
    // マイクをミュートする（実装省略）
  } else {
    // マイクをミュート解除する（実装省略）
  }
  isMicrophoneActive = !isMicrophoneActive;
  navigator.mediaSession.setMicrophoneActive(isMicrophoneActive);
});

navigator.mediaSession.setActionHandler("togglecamera", function() {
  if (isCameraActive) {
    // カメラを無効化（実装省略）
  } else {
    // カメラを有効化（実装省略）
  }
  isCameraActive = !isCameraActive;
  navigator.mediaSession.setCameraActive(isCameraActive);
});

navigator.mediaSession.setActionHandler("hangup", function() {
  // 通話終了（実装省略）
});

var currentSlideIndex = 0;

navigator.mediaSession.setActionHandler("previousslide", function() {
  currentSlideIndex--;
  // 現在のスライドをセット（実装省略）
});

navigator.mediaSession.setActionHandler("nextslide", function() {
  currentSlideIndex++;
  // 現在のスライドをセット（実装省略）
});

navigator.mediaSession.setActionHandler("enterpictureinpicture", function() {
  remoteVideo.requestPictureInPicture();
});

// 音声有効でMediaStream作成
const stream = await navigator.mediaDevices.getUserMedia({audio:true});
const track = stream.getAudioTracks()[0];
navigator.mediaSession.setActionHandler("voiceactivity", function() {
  if (track.muted) {
    // ミュート解除通知を表示。ユーザーが解除許可したらsetMicrophoneActive(true)でミュート解除。
  }
});

謝辞

編集者は、Paul Adenot、Jake Archibald、Tab Atkins、Jonathan Bailey、François Beaufort、Marcos Caceres、Domenic Denicola、Ralph Giles、Anne van Kesteren、Tobie Langel、Michael Mahemoff、Jer Noble、Elliott Sprehn、Chris Wilson、Jörn Zaefferer の技術的議論への参加に感謝します。これらの議論が本仕様の成立を可能にしました。

特に、Philip Jägenstedt と David Vest にはメディアセッションのあらゆる設計面での協力と、初期設計課題の解決における無限とも思える忍耐に感謝します。また、Jer Noble にはiOSのオーディオフォーカスモデルにも適合するモデル構築への協力に、Mounir Lamouri と Anton Vayvod には初期段階での関与、フィードバック、仕様成立への支援に特別な謝意を表します。