fuchsia.media.target

用於在裝置之間轉送媒體的通訊協定程式庫。

這個程式庫以「目標」為基礎，也就是可轉譯媒體工作階段的裝置或裝置群組。如要進一步瞭解媒體工作階段，請參閱 fuchsia.media.sessions2。

用戶端可透過 Discovery 通訊協定探索網路上可用的媒體目標，並選取這些目標算繪媒體工作階段。

已新增：7

專家

探索

定義於 fuchsia.media.target/target_discovery.fidl

用於探索媒體目標的通訊協定。

BindGroupTarget

在 target_ids 指定的一組目標上轉譯 session_id 指定的媒體工作階段。

這可能會建立一個新的群組目標，其中包含所有指定的目標 (如果目標不存在)。群組目標可能是暫時性的，只會在播放的生命週期內存在，無法透過 Discovery 搜尋。

要求

名稱類型
session_id fuchsia.media.sessions2/SessionId
target_ids vector<uint64>[100]

回應

名稱類型
payload Selector_BindGroupTarget_Result

BindTarget

在 target_id 指定的目標上顯示 session_id 指定的媒體工作階段。

要求

名稱類型
session_id fuchsia.media.sessions2/SessionId
target_id Id

回應

名稱類型
payload Selector_BindTarget_Result

ConnectToTarget

透過 ID 連結至目標。如果沒有這類目標，就會捨棄指定管道。

要求

名稱類型
target_id Id
target_request server_end<Target>

WatchSessionBindings

觀察媒體工作階段與目標的繫結。

媒體工作階段會顯示在繫結的目標上。

繫結會以手錶呼叫之間的差異傳回，請保持要求靜止不動，才能取得最新更新內容。

要求

<EMPTY>

回應

名稱類型
event SessionBindingsWatchEvent

WatchTargets

監控已註冊目標組合的變更。請保留要求，在發生變更時取得回覆。新客戶就會跟上世界狀態有關

目標會做為手錶呼叫之間的差異傳回。

要求

<EMPTY>

回應

名稱類型
targets_watch_event TargetsWatchEvent

Group

定義於 fuchsia.media.target/target_discovery.fidl

監控群組成員的通訊協定。

WatchTargets

監控已註冊目標組合的變更。請保留要求，在發生變更時取得回覆。新客戶就會跟上世界狀態有關

目標會做為手錶呼叫之間的差異傳回。

要求

<EMPTY>

回應

名稱類型
targets_watch_event TargetsWatchEvent

GroupEditor

定義於 fuchsia.media.target/target_discovery.fidl

用於新增及移除群組目標成員的通訊協定。

AddTarget

將目標新增至這個群組目標。

如果新增的目標是一組裝置，則該群組中的所有裝置都會加入這個群組。群組本身不能是群組成員。

如果為完成這項要求而建立新群組，則傳回新目標的 ID。

要求

名稱類型
target_id Id

回應

名稱類型
payload GroupEditor_AddTarget_Result

RemoveTarget

從這個群組中移除目標。如為完成這項要求而建立新群組，會傳回新目標的 ID。

要求

名稱類型
target_id Id

回應

名稱類型
payload GroupEditor_RemoveTarget_Result

選取器

定義於 fuchsia.media.target/target_discovery.fidl

用於選取媒體目標的通訊協定。這個通訊協定的指令可能會變更轉譯媒體工作階段的目標。

BindGroupTarget

在 target_ids 指定的一組目標上轉譯 session_id 指定的媒體工作階段。

這可能會建立一個新的群組目標，其中包含所有指定的目標 (如果目標不存在)。群組目標可能是暫時性的，只會在播放的生命週期內存在，無法透過 Discovery 搜尋。

要求

名稱類型
session_id fuchsia.media.sessions2/SessionId
target_ids vector<uint64>[100]

回應

名稱類型
payload Selector_BindGroupTarget_Result

BindTarget

在 target_id 指定的目標上顯示 session_id 指定的媒體工作階段。

要求

名稱類型
session_id fuchsia.media.sessions2/SessionId
target_id Id

回應

名稱類型
payload Selector_BindTarget_Result

目標

定義於 fuchsia.media.target/target_discovery.fidl

「目標」是指可以轉譯媒體的裝置或一組裝置，例如可算繪音訊的揚聲器。

AddTarget

將目標新增至這個群組目標。

如果新增的目標是一組裝置，則該群組中的所有裝置都會加入這個群組。群組本身不能是群組成員。

如果為完成這項要求而建立新群組，則傳回新目標的 ID。

要求

名稱類型
target_id Id

回應

名稱類型
payload GroupEditor_AddTarget_Result

BindMemberVolumeControl

以指定群組成員的身分繫結至目標的音量控制項。 如果要求管道的目標不是群組成員，則要求管道會遭到捨棄。

只有在這個目標為群組成員時，這個音量控制項才會影響音量。可用來調整群組成員之間的音量平衡。這些設定在目標的生命週期內

要求

名稱類型
group Id
volume_control_request server_end<fuchsia.media.audio/VolumeControl>

BindVolumeControl

繫結至目標的音量控制項。如果這個目標是群組，則所有成員數量都會受到影響。這些設定會在目標的生命週期內保留下來。

要求

名稱類型
volume_control_request server_end<fuchsia.media.audio/VolumeControl>

RemoveTarget

從這個群組中移除目標。如為完成這項要求而建立新群組，會傳回新目標的 ID。

要求

名稱類型
target_id Id

回應

名稱類型
payload GroupEditor_RemoveTarget_Result

WatchTargets

監控已註冊目標組合的變更。請保留要求，在發生變更時取得回覆。新客戶就會跟上世界狀態有關

目標會做為手錶呼叫之間的差異傳回。

要求

<EMPTY>

回應

名稱類型
targets_watch_event TargetsWatchEvent

VolumeControl

定義於 fuchsia.media.target/target_discovery.fidl

控制目標音量的通訊協定。

BindMemberVolumeControl

以指定群組成員的身分繫結至目標的音量控制項。 如果要求管道的目標不是群組成員，則要求管道會遭到捨棄。

只有在這個目標為群組成員時，這個音量控制項才會影響音量。可用來調整群組成員之間的音量平衡。這些設定在目標的生命週期內

要求

名稱類型
group Id
volume_control_request server_end<fuchsia.media.audio/VolumeControl>

BindVolumeControl

繫結至目標的音量控制項。如果這個目標是群組，則所有成員數量都會受到影響。這些設定會在目標的生命週期內保留下來。

要求

名稱類型
volume_control_request server_end<fuchsia.media.audio/VolumeControl>

結構

GroupEditor_AddTarget_Response

定義於 fuchsia.media.target/target_discovery.fidl

欄位類型說明預設
target_change TargetChange? 無預設

GroupEditor_RemoveTarget_Response

定義於 fuchsia.media.target/target_discovery.fidl

欄位類型說明預設
target_change TargetChange? 無預設

Selector_BindGroupTarget_Response

定義於 fuchsia.media.target/target_discovery.fidl

欄位類型說明預設
target_id Id 無預設

Selector_BindTarget_Response

定義於 fuchsia.media.target/target_discovery.fidl

<EMPTY>

SessionBinding

定義於 fuchsia.media.target/target_discovery.fidl

工作階段和目標之間的繫結，表示媒體工作階段會在目標上顯示。

欄位類型說明預設
session_id fuchsia.media.sessions2/SessionId 無預設
target_id Id 無預設

TargetChange

定義於 fuchsia.media.target/target_discovery.fidl

欄位類型說明預設
new_target_id Id 無預設

表情符號

錯誤 strict 錯誤

類型：uint32

定義於 fuchsia.media.target/target_discovery.fidl

名稱值說明
0
1
2
3
4
5
6

資料表

說明

定義於 fuchsia.media.target/target_discovery.fidl

目標的說明。

序數欄位類型說明
target_id Id

用於識別目標。
capability_flags CapabilityFlags

列出裝置支援的互通性功能。
display_name DisplayName
metadata fuchsia.media/Metadata

SessionBindingsWatchEvent

定義於 fuchsia.media.target/target_discovery.fidl

序數欄位類型說明
updated vector<SessionBinding>

在任何時間點在網路中新增或更新的執行中工作階段繫結清單。
removed vector<SessionBinding>

發出通知後，從網路中移除的工作階段繫結清單。

TargetsWatchEvent

定義於 fuchsia.media.target/target_discovery.fidl

序數欄位類型說明
updated vector<Description>

隨時於聯播網新增或更新的目標。
removed vector<uint64>

自上次通知後移除的目標。

聯合國

GroupEditor_AddTarget_Result 嚴格

定義於 fuchsia.media.target/target_discovery.fidl

序數Variant類型說明
response GroupEditor_AddTarget_Response
err Error

GroupEditor_RemoveTarget_Result strict

定義於 fuchsia.media.target/target_discovery.fidl

序數Variant類型說明
response GroupEditor_RemoveTarget_Response
err Error

Selector_BindGroupTarget_Result strict

定義於 fuchsia.media.target/target_discovery.fidl

序數Variant類型說明
response Selector_BindGroupTarget_Response
err Error

Selector_BindTarget_Result strict

定義於 fuchsia.media.target/target_discovery.fidl

序數Variant類型說明
response Selector_BindTarget_Response
err Error

節拍

功能旗標嚴格

類型：uint64

定義於 fuchsia.media.target/target_discovery.fidl

目標的功能。

名稱值說明
1

表示目標可接收來自其他目標的媒體工作階段傳輸。
2

表示目標可將媒體工作階段傳送到其他目標。
4

表示目標可與其他裝置一同算繪媒體。
8

表示目標可以轉譯影片。

別名

名稱值說明
DisplayName string[200]

向使用者顯示的目標名稱，會顯示在使用者介面或語音介面中讀取。
ID uint64

目標的專屬 ID。