fuchsia.bluetooth.hfp

已新增：7

專家

撥打電話

定義於 fuchsia.bluetooth.hfp/hfp.fidl

控管透過耳機轉接的通話生命週期。

已要求有效

要求將呼叫設為 ONGOING_ACTIVE CallState。如果呼叫成功，這會將所有已轉送到這個對等點的呼叫全部改為 ONGOING_HELD 呼叫狀態。

要求

<空白>

要求保留

要求將通話設為 ONGOING_HELD CallState

要求

<空白>

要求終止

要求終止通話。

要求

<空白>

要求轉移音訊

要求將通話的音訊傳送到音訊閘道，並將呼叫狀態設為 TRANSFERRED_TO_AG。

要求

<空白>

傳送 DtmfCode

傳送代碼，讓呼叫管理員或遠端音訊閘道對等點應傳送至其網路連線。要求在程式碼傳送至網路後會傳回。

如果呼叫管理員或對等點無法將代碼傳送到網路，可能會傳回錯誤。

要求

名稱類型
code DtmfCode

回應

名稱類型
payload Call_SendDtmfCode_Result

手錶狀態

呼叫狀態的等待 get 方法。如要瞭解可能的狀態，請參閱 CallState 說明文件。

要求

<空白>

回應

名稱類型
state CallState

通話管理員

定義位置：fuchsia.bluetooth.hfp/hfp.fidl

對等連線

表示支援 HFP 免持聽筒角色的對等點已連線。

id 是與對等互連相關聯的專屬 ID。handle 是呼叫管理員用來管理對等點的管道。如果呼叫管理員不打算處理特定對等點，則必須使用 ZX_ERR_UNAVAILABLE 劇集關閉控制代碼。

用戶端可發出多個並行 PeerConnected 要求。 空白回應會用做流量控管機制，讓用戶端限制待處理的 PeerConnected 要求數量。

要求

名稱類型
id fuchsia.bluetooth/PeerId
handle server_end<PeerHandler>

回應

<空白>

免持模式

定義於 fuchsia.bluetooth.hfp/hfp.fidl

新增時間：12

WatchPeer 已連線

正在等待支援 HFP Audio Gateway 角色的對等互連連線。

id 是與對等互連相關聯的專屬 ID。

handle 是用戶端用來管理對等點的管道。如果呼叫管理員不打算處理特定對等點，則必須關閉控點，

要求

<空白>

回應

名稱類型
payload HandsFree_WatchPeerConnected_Result

耳機增益

定義於 fuchsia.bluetooth.hfp/hfp.fidl

控制耳機和麥克風的接收及接收目前值報告 (如 HFP v1.8 第 4.29 節所述)。這個通訊協定是由 Hfp 服務提供。

以 0 到 15 的量表表示增加的絕對值。0 是最低獲利，15 是最大獲利。這取決於耳機所控制的特定音量 (須視實作裝置而定)。

旁白：

如果這個管道已有一個有效的 HeadsetGain 管道，就會以 ZX_ERR_ALREADY_BOUND 步伐關閉這個版本。

如果 Hfp 服務未設定為支援遠端音量控制，或是對等耳機不支援遠端音量控制，此管道將會以 ZX_ERR_NOT_SUPPORTED 數字關閉。如果管道關閉而發生這個錯誤，用戶端就不應在同一個 PeerHandler 連線使用 PeerHandler::GainControl 要求嘗試重新開啟管道。

如果將無效引數傳遞至要求，系統會以 ZX_ERR_INVALID_ARGUMENT 的數字關閉這個管道。詳情請參閱特定要求的說明文件。

設定麥克風增益

向耳機請求將麥克風增益設為 requested。

requested 必須介於 [0 到 15] 之間 (含頭尾)。如果任何值超出這個範圍，系統將以 ZX_ERR_INVALID_ARGUMENT 劇集關閉通道。

要求

名稱類型
requested uint8

設定喇叭增益

向耳機提出要求，將喇叭亮度設為 requested。

requested 必須介於 [0 到 15] 之間 (含頭尾)。如果任何值超出這個範圍，系統將以 ZX_ERR_INVALID_ARGUMENT 劇集關閉通道。

要求

名稱類型
requested uint8

智慧手錶麥克風增益

然後稍待片刻，等待耳機麥克風增益。回應表示目前的獲利值。

傳回的 gain 值一律會在 [0 至 15] 的範圍內 (含頭尾)。

要求

<空白>

回應

名稱類型
gain uint8

智慧手錶喇叭增益

然後等待一段時間，查看耳機喇叭增益更新的相關資訊。回應表示目前的獲利值。

傳回的 gain 值一律會在 [0 至 15] 的範圍內 (含頭尾)。

要求

<空白>

回應

名稱類型
gain uint8

Hfp

定義位置：fuchsia.bluetooth.hfp/hfp.fidl

註冊

註冊為這部裝置的通話管理員。

一次只能註冊一位通話管理員。如果在呼叫 Register 時註冊了其中一種，系統就會關閉較新的 CallManager 管道。

只要將通話管理員關閉，即可取消註冊。

要求

名稱類型
manager CallManager

PeerHandler

定義於 fuchsia.bluetooth.hfp/hfp.fidl

呼叫管理員或免持伺服器元件將會為每個選擇用於管理通話的已連線耳機提供呼叫處理通訊協定。

如果對等處理常式是由管道端點關閉，則與這個對等處理常式相關聯的所有通訊協定都會關閉。包括任何呼叫和頭戴式裝置通訊協定。在這種情況下，由伺服器端關閉的通道會包含劇集 ZX_ERR_HANDLE_CLOSED。

增益控制

拆除耳機增益的通訊協定。

任何時間，PeerHandler 通訊協定只能啟用一個 HeadsetGet 通訊協定。系統會優先使用舊版 HeadsetGet 通訊協定。如果在發出新的 YieldControl 要求時啟用 HeadsetGet 通訊協定，系統會立即關閉新的 HeadsetGet 通訊協定。

要求

名稱類型
control HeadsetGain

查詢運算子

要求呼叫管理員或音訊閘道對等點的網路業者名稱。如果沒有可用的運算子名稱，系統會傳回空值。

要求

<空白>

回應

名稱類型
operator string[16]?

回報頭戴式電池級別

耳機電池電量介於 0 至 100 之間 詳情請參閱 https://www.bluetooth.com/specifications/assigned-numbers/hands-free-profile/

要求

名稱類型
level uint8

要求撥出電話

用於要求通話管理員或音訊閘道對等點發起撥出電話。啟動呼叫後，系統透過 WatchNextCall 結果傳回對應的 Call 通訊協定後，RequestOutgoingCall 才會完成。

如果呼叫無法按照要求送出，系統會傳回錯誤。

  • 如果系統不支援要求的動作，則可以使用 ZX_ERR_NOT_SUPPORTED。

  • 如果已有進行中的呼叫，且系統不支援其他呼叫，則可以使用 ZX_ERR_ALREADY_EXISTS。

要求

名稱類型
action CallAction

回應

名稱類型
payload PeerHandler_RequestOutgoingCall_Result

SetNrecMode

HF 要求根據 enabled 布林值，啟用或停用 AG 的降噪/Echo 取消功能。如果裝置不支援 Noice Reduction/Echo 取消作業，系統會傳回 ZX_ERR_NOT_SUPPORTED 錯誤。

要求

名稱類型
enabled bool

回應

名稱類型
payload PeerHandler_SetNrecMode_Result

SubscriptionNumberInformation

向通話管理員或音訊閘道對等點要求訂閱者號碼。 可能傳回零或更多數字。目前不支援傳送超過 128 組號碼。

要求

<空白>

回應

名稱類型
numbers vector<string>[128]

WatchNetworkInformation

懸掛在 NetworkInformation 上為 Hfp 服務提供 update。凡是 update 中不存在的欄位，都將視為未經修改。

呼叫管理員或音訊閘道對等點應在首次呼叫時提供完整填入的 update。

系統會在對等點連線初始化程序中使用最新的 NetworkInformation，且如果支援 AG 指標，更新就會套用至對等點。

要求

<空白>

回應

名稱類型
update NetworkInformation

WatchNextCall

當呼叫管理員或音訊閘道對等點發起新呼叫，或進行中的呼叫轉接至耳機時，掛鉤就會回傳。可在 WatchNextCall 之前或之後呼叫 RequestOutgoingCall。

要求

<空白>

回應

名稱類型
call NextCall

結構

Call_SendDtmfCode_Response

定義位置：fuchsia.bluetooth.hfp/hfp.fidl

<空白>

HandsFree_WatchPeerConnected_Response 資源

定義位置：fuchsia.bluetooth.hfp/hfp.fidl

欄位類型說明預設
id fuchsia.bluetooth/PeerId 無預設
handle PeerHandler 無預設

PeerHandler_RequestOutgoingCall_Response

定義位置：fuchsia.bluetooth.hfp/hfp.fidl

<空白>

PeerHandler_SetNrecMode_回應

定義位置：fuchsia.bluetooth.hfp/hfp.fidl

<空白>

重新撥號

定義於 fuchsia.bluetooth.hfp/hfp.fidl

代表重撥最後一個撥號號碼的動作。

<空白>

傳輸中

定義於 fuchsia.bluetooth.hfp/hfp.fidl

代表將有效通話轉接至耳機的動作。

<空白>

表情符號

CallDirection 嚴格

類型：uint32

定義於 fuchsia.bluetooth.hfp/hfp.fidl

通話啟動的方向。

名稱值說明
1

來自這部裝置的通話。也稱為「撥出通話」。
2

這部裝置的通話已終止。也稱為來電。

CallState 彈性

類型：uint32

定義於 fuchsia.bluetooth.hfp/hfp.fidl

代表呼叫的有效狀態。

名稱值說明
1

撥出電話有正在進行的通話設定程序。呼叫通訊協定用戶端不應設定此狀態。這是未接聽來電的初始狀態。
2

撥出通話有正在進行的通話設定程序，且遠端方已經收到通話設定的快訊。此狀態是來自 OUTGOING_DIALING 的選用轉換。
3

有正在進行的來電通話設定程序。
4

有正在進行的來電通話設定程序。
5

通話已在進行中，但目前仍在進行其他通話。
6

通話進行中。
7

通話已終止。
8

呼叫已轉移到 AG，超過 HF 就會停止追蹤其狀態。

DtmfCode strict

類型：uint8

定義於 fuchsia.bluetooth.hfp/hfp.fidl

雙色調多頻訊號代碼。

名稱值說明
49

在 AT 指令中，以 ASCII「1」表示。
50

在 AT 指令中，以 ASCII「2」表示。
51

在 AT 指令中以 ASCII「3」表示。
52

在 AT 指令中，以 ASCII「4」表示。
53

在 AT 指令中以 ASCII「5」表示。
54

在 AT 指令中，以 ASCII「6」表示。
55

在 AT 指令中，以 ASCII「7」表示。
56

在 AT 指令中，以 ASCII「8」表示。
57

在 AT 指令中以 ASCII「9」表示。
35

在 AT 指令中，以 ASCII「#」表示。
48

在 AT 指令中，以 ASCII「0」表示。
42

在 AT 指令中以 ASCII「*」表示。
65

在 AT 指令中，以 ASCII「A」表示。
66

在 AT 指令中，以 ASCII「B」表示。
67

在 AT 指令中以 ASCII「C」表示。
68

在 AT 指令中以 ASCII「D」表示。

訊號強度嚴格

類型：int8

定義於 fuchsia.bluetooth.hfp/hfp.fidl

代表音訊閘道和網路之間的連線訊號強度。

名稱值說明
1
2
3
4
5
6

資料表

網路資訊

定義於 fuchsia.bluetooth.hfp/hfp.fidl

Audio Gateway 的網路資訊。通常這代表電話通訊網路的連線狀態資訊。

序數欄位類型說明
service_available bool

向聯播網回報註冊狀態。請參閱 HFP v1.8 第 4.4 節
signal_strength SignalStrength

回報網路連線的訊號強度。請參閱 HFP v1.8 的第 4.5 節。
roaming bool

回報網路連線的漫遊狀態。請參閱 HFP v1.8 的第 4.6 節

NextCall 資源

定義於 fuchsia.bluetooth.hfp/hfp.fidl

Peer Handler 回報的下一個呼叫資訊。

序數欄位類型說明
call Call

這次通話的管道。 這是必填欄位。
remote Number

通話中遠端派對的號碼。 這是必填欄位。
state CallState

對等處理常式回報的呼叫狀態。這是必填欄位。
direction CallDirection

通話啟動的方向。詳情請參閱 CallDirection 說明文件。這是必填欄位。

聯合國

CallAction 嚴格

定義於 fuchsia.bluetooth.hfp/hfp.fidl

HF 的指令，其中的值代表要撥打的號碼。

序數Variant類型說明
dial_from_number Number

由呼叫處理常式服務撥打的完整號碼。請參閱 HFP v1.8 第 4.18 節
dial_from_location Memory

應查詢用於撥打號碼的電話簿記憶體位置。請參閱 HFP v1.8 第 4.19 節。
redial_last RedialLast

呼叫處理常式服務應撥打最近一次使用的號碼。請參閱 HFP 1.8 版 第 4.20 節
transfer_active TransferActive

要求將進行中的通話轉接至耳機，而不是發起新的撥出電話。音訊閘道上必須有進行中的通話，才能傳輸到免持裝置的音訊。請參閱 HFP v1.8 第 4.16 節。

Call_SendDtmfCode_Result 嚴格

定義於 fuchsia.bluetooth.hfp/hfp.fidl

序數Variant類型說明
response Call_SendDtmfCode_Response
err zx/Status

HandsFree_WatchPeerConnected_Result 嚴格 資源

定義於 fuchsia.bluetooth.hfp/hfp.fidl

序數Variant類型說明
response HandsFree_WatchPeerConnected_Response
err zx/Status

PeerHandler_RequestOutgoingCall_Result strict

定義於 fuchsia.bluetooth.hfp/hfp.fidl

序數Variant類型說明
response PeerHandler_RequestOutgoingCall_Response
err zx/Status

PeerHandler_SetNrecMode_Result strict

定義於 fuchsia.bluetooth.hfp/hfp.fidl

序數Variant類型說明
response PeerHandler_SetNrecMode_Response
err zx/Status

場景

名稱值類型說明
MAX_PICONET_SIZE 8 uint64

別名

名稱值說明
記憶體 string[256]敬上

代表特定電話簿記憶體位置。
編號 string[256]敬上

代表 V.250 撥號數字的文字字串。如需詳細資訊，請參閱 TS 127.007v06.08.00 第 6.2 節。