HN 日本語サマリー

← 一覧へ戻る
Web開発

<Usermedia> HTML 要素

The <Usermedia> HTML Element (developer.chrome.com)

64 pointsby twapi29 コメント

要約

Google Chromeは、Chrome 151から利用可能になる新しいHTML要素「<usermedia>」を導入します。この要素は、カメラとマイクへのアクセス権限リクエストを簡素化し、ボイラープレートコードの削減、セキュリティの強化、および以前にアクセスを拒否したユーザーに対するシームレスな復旧パスを提供します。<geolocation>要素に続くCapability Elementsスイートの一部であり、ユーザーの意図をより正確に把握し、権限管理とメディアストリームの取得を効率化します。

全文翻訳

<usermedia> HTML要素について

ユーザーメディアのアクセスを、HTML要素で整理して管理しましょう。優先順位に基づいてコンテンツを保存し、カテゴリ分けします。

メインコンテンツへスキップ

[画像: Mari Viana]

Mari Viana

[画像: Minh Le]

公開日: 2026年6月29日

Chrome 144で<geolocation>要素がリリースされた後、Capability Elementsスイートに続く機能的コントロールとして、<usermedia> HTML要素が登場しました。この要素はChrome 151から利用可能になり、カメラとマイクのストリームへのアクセスにおいて、一般的な許可要求から、よりターゲットを絞った機能的なコントロールへの移行を示しています。スクリプトによってトリガーされるプロンプトではなく、宣言的でユーザー主導の機能を使用することで、<usermedia>はボイラープレートコードを削減し、セキュリティを強化し、以前にアクセスを拒否したユーザーが簡単にアクセスを回復できるようにします。これにより、許可に関する問題に効果的に対処できます。

許可の管理から機能の制御へ

<usermedia>要素は、Capability Elementsスイートでリリースされる次の専用コントロールです。これに先立ち、<geolocation>がリリースされました。元の一般的な<permission>提案からこの移行は、PEPCイニシアチブの一環として行われ、ブラウザが個々のハードウェア機能の特定の複雑さと動作をより効果的に管理できるようにします。初期の提案では、許可の状態(許可または拒否)を管理することに主に焦点が当てられていましたが、Capability Elementsはデータメディエーターとして機能します。

<geolocation>要素は、場所情報オブジェクトをサイトに提供しますが、<usermedia>はカメラとマイクへのアクセスフロー全体を管理します。ユーザーの意図を捉え、ブラウザのプロンプトを管理し、アプリケーションにMediaStreamオブジェクトを配信します。この変更により、個別のgetUserMedia()呼び出しの必要がなくなり、実装が容易になります。また、ブラウザがユーザーの意図の信頼できるシグナルを持っていることを保証します。

コンセプトの検証

オリジナルトライアルからの実際のデータによると、コンテキストに応じたユーザー主導の許可コントロールは、ユーザーのタスク完了率を大幅に向上させることが示されています。

  • Ciscoは、最初に許可を拒否したユーザーのうち、レガシープロンプトを使用して許可を与えたのはわずか10%でしたが、新しい要素ではこの割合が65%を超えました。
  • Zoomは、要素を使用してカメラまたはマイクのキャプチャに関連するエラーが46.9%削減されたと報告しています(例: システムレベルでのブロックに関するエラー)。この要素は、ユーザーにエラーを修正する方法を案内するためにも使用されます。
  • Google Meetでは、「マイクが機能しない」という苦情が17%削減され、最初にアクセスを拒否したユーザーが許可を回復する機能を使用した数が131%増加しました。

<geolocation>が確立したパターンに基づき、<usermedia>要素は、AI機能の要求に関連する主な課題に対処します。メディア要求は、JavaScriptの呼び出しに依存することが多く、これらの呼び出しはしばしばコンテキスト外のプロンプトをトリガーします。誤ってサイトをブロックした場合、その決定を元に戻すにはブラウザの設定に移動して「許可の問題」を修正する必要があり、これにより機能の使用が停止することがよくあります。

<usermedia>要素は、次の機能を提供することでこれらの問題を解決します。

  • 明確な意図とタイミング: プロンプトは、ブラウザコントロールの要素をタップしたときにのみ表示されるため、意図の信頼できるシグナルが得られます。これにより、ブラウザはスクリプトトリガー要求が失敗する原因となるサイレントブロックをバイパスできます。
  • 簡単なアクセス回復: 以前にアクセスが拒否されていた場合、要素をタップするとアクセス回復プロセスが開始されます。これにより、ブラウザの複雑な設定にアクセスすることなく、ページ上でカメラまたはマイクへのアクセスを即座に回復できます。
  • ストリームへの直接アクセス: データメディエーターとして、この要素はメディアストリームを直接公開します。これにより、コールバックとエラー状態を処理するために必要な、アプリケーション内の小さなコードの変更が削減されます。
機能getUserMedia() JS API<usermedia> HTML要素
許可プロンプトをトリガーするイベント命令的なスクリプト実行 (getUserMedia)ユーザーがブラウザコントロールの要素をクリックする
ブラウザの役割状態とヒューリスティクスに基づいてプロンプトを決定するデータメディエーターとして機能し、同意を管理し、ストリームを配信する
サイトの責任JavaScript APIを手動で呼び出し、コールバックとエラーを管理するstreamイベントをリッスンし、streamプロパティにアクセスする
主な目標カメラとマイクへの基本的なアクセスストリームへの中断のないアクセス、許可の管理、ストリームの回復

実装

この要素を統合するには、レガシーJavaScript APIと比較して、はるかに少ないボイラープレートコードで済みます。<geolocation>要素によって確立された宣言的なパターンに従って、HTMLに<usermedia>タグを追加し、setConstraints()メソッドを使用してハードウェアの要件を構成できます。

<usermedia id="media-ctrl">
  <button>Enable camera and microphone</button>
</usermedia>
const el = document.getElementById('media-ctrl');

// Specify hardware preferences before user interaction:
el.setConstraints({
    video: { width: 1280, height: 720 },
    audio: { echoCancellation: true }
});

// Handle successful stream acquisition:
el.addEventListener('stream', () => {
  videoPreview.srcObject = el.stream;
});

// Handle stream acquisition failure:
el.addEventListener('error', () => {
  console.error(`Access failed: ${el.error?.name}`);
});

// Handle prompt cancellation or dismissal:
el.addEventListener('cancel', () => {
  console.log('Permission prompt was dismissed by the user.');
});
主要な属性とプロパティ
  • stream: 読み取り専用プロパティで、ユーザーがアクセスを許可した後にMediaStreamオブジェクトを提供します。
  • setConstraints(): 開発者がユーザー操作の前にハードウェア設定(例: deviceIdまたは解像度)を更新できるメソッドです。
  • error: 読み取り専用プロパティで、要求が失敗または拒否された場合にDOMException(例: NotAllowedError)を返します。
  • onstream: メディアトラックが取得された直後にトリガーされるイベントハンドラーです。
  • onerror: ストリーム取得の試行が失敗したときにトリガーされるイベントハンドラーです。
  • oncancel: ユーザーが取得中に許可要求プロンプトをキャンセルまたは却下したときにトリガーされるイベントハンドラーです。
スタイリングに関する制約

ユーザーの信頼を維持し、誤解を招くデザインパターンを防ぐために、<usermedia>要素には、他のCapability Elementsと同様のスタイリング制限が適用されます。

  • 可読性: ブラウザは、テキストと背景色のコントラストをチェックします。コントラストは少なくとも3:1である必要があり、要求は常に読み取れるようにします。アルファチャンネル(opacity)は1に設定する必要があり、要素が不正に透明になるのを防ぎます。
  • サイズとスペーシング: ブラウザは、width、height、font-sizeに最小および最大制限を適用します。ネガティブマージンやアウトラインオフセットは無効になり、要素が視覚的に隠されるのを防ぎます。
  • 視覚的整合性: ブラウザは、画像を変形させる効果を制限します。たとえば、transformは2D変換とプロポーショナルスケーリングでのみ機能します。
  • CSS疑似クラス: 要素は、状態に基づいたスタイリングをサポートします。たとえば、:granted(許可が付与され、ストリームが取得された後にアクティブになります)や、:hoverおよび:activeなどの標準的なインタラクション状態です。

段階的な拡張と移行戦略

<geolocation>によって確立された設計パターンに従って、<usermedia>要素は段階的な非推奨となるように設計されています。<usermedia>要素をサポートしないブラウザは、それをHTMLUnknownElementとして扱い、子要素をレンダリングします。これにより、すべてのユーザーにフォールバックエクスペリエンスを提供できます。

カスタムフォールバックパターン

JavaScriptで<usermedia>要素のサポートをプログラムで検出できます。

if ('HTMLUserMediaElement' in window) {
  // Use modern <usermedia> element logic
} else {
  // Fallback to legacy getUserMedia() API
}

getUserMedia() APIをトリガーするために<usermedia>要素に標準ボタンを追加するには、このロジックを使用します。

<usermedia id="stream-handler">
    <button id="fallback-stream-handler">
        Enable Camera and Mic
    </button>
</usermedia>
// Function for handling video/audio streams:
function handleStream (event) {
  /* ... */
}

if ('HTMLUserMediaElement' in window) {
  // In this case, we have <usermedia> element support:
  const streamHandler = document.getElementById('stream-handler');

  streamHandler.addEventListener('stream', event => {
    handleStream(event);
  });
} else {
  // <usermedia> element support is missing, so fall back instead:
  const fallbackStreamHandler = document.getElementById('fallback-stream-handler');

  fallbackStreamHandler.addEventListener('click', event => {
    navigator.mediaDevices.getUserMedia({video: true, audio: true}).then(handleStream);
  });
}
オリジナルトライアル参加者向けの移行

オリジナルトライアル中に実験的に利用可能であった一般的な<permission>要素を統合した開発者にとって、<usermedia>への移行プロセスは簡素化されています。

  1. タグの更新: <permission type="camera microphone">を<usermedia>に置き換えて、<permission>要素をターゲットにしていたすべてのセレクターが<usermedia>要素を使用するように更新されていることを確認します。
  2. 機能検出の更新: HTMLPermissionElementからHTMLUserMediaElementへの更新。

今後のロードマップ

<usermedia>要素は、オーディオとビデオの複合要求を管理します。しかし、将来利用可能になるCapability Elementsのロードマップには、以下が含まれます。

  • <camera>: ビデオのみのコンテンツに焦点を当てます。
  • <microphone>: オーディオのみの広告に焦点を当てます。

これらのCapability-specific Elementsが、開発者がよりスムーズで信頼性の高いメディアエクスペリエンスを提供する方法をご覧ください。詳細については、Capability Elementsの技術ガイドを参照してください。

別途明記されていない限り、このページのコンテンツはCreative Commons Attribution 4.0 Licenseの下でライセンスされ、コードサンプルはApache 2.0 Licenseの下でライセンスされています。詳細については、Google Developersサイトポリシーを参照してください。Oracleおよび/またはその関連会社は、Javaは登録商標です。

最終更新日: 2026-06-29 (UTC)