Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Web/API/HTMLMediaElement/sinkId を更新 #22730

Merged
merged 1 commit into from
Jul 31, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
26 changes: 21 additions & 5 deletions files/ja/web/api/htmlmediaelement/sinkid/index.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,27 @@
---
title: HTMLMediaElement.sinkId
title: "HTMLMediaElement: sinkId プロパティ"
short-title: sinkId
slug: Web/API/HTMLMediaElement/sinkId
l10n:
sourceCommit: 277e5969c63b97cfb55ab4a0e612e8040810f49b
sourceCommit: 3df177b401e00e3a855c40fc074b5ef2469b700d
---

{{SeeCompatTable}}{{APIRef("HTML DOM")}}
{{APIRef("Audio Output Devices API")}}{{securecontext_header}}

**`HTMLMediaElement.sinkId`** は読み取り専用プロパティで、出力を配信する音声機器の固有の ID である文字列を返します。ユーザーエージェントの既定で使用されている場合は、空文字列を返します。この ID は {{domxref("MediaDevices.enumerateDevices()")}}、`id-multimedia`、`id-communications` から返される値のいずれかである必要があります。
**`sinkId`** は {{domxref("HTMLMediaElement")}} インターフェイスの読み取り専用プロパティで、出力を配信する音声機器の固有の ID である文字列を返します。

この ID は {{domxref("MediaDevices.enumerateDevices()")}} から返される {{domxref("MediaDeviceInfo.deviceId")}} の値、`id-multimedia`、`id-communications` のいずれかである必要があります。
ユーザーエージェントの既定の機器が使用されている場合は、空文字列を返します。

## 値

文字列です。
出力を配信する音声機器の固有の ID である文字列を返します。ユーザーエージェントの既定の機器が使用されている場合は、空文字列を返します。

## セキュリティの要件

このプロパティにアクセスするには、以下の制約があります。

- このプロパティは、[安全なコンテキスト](/ja/docs/Web/Security/Secure_Contexts)で呼び出す必要があります。

## 仕様書

Expand All @@ -20,3 +30,9 @@ l10n:
## ブラウザーの互換性

{{Compat}}

## 関連情報

- [オーディオ出力機器 API](/ja/docs/Web/API/Audio_Output_Devices_API)
- {{domxref("MediaDevices.selectAudioOutput()")}}
- {{domxref("HTMLMediaElement.setSinkId()")}}