fuchsia.component.sandbox

通訊協定

字典

在 fuchsia.component.sandbox/sandbox.fidl 中定義

複製

建立與相同基礎字典的新連線。

使用 Copy 前往新的字典，其中包含所有結束項目的複本。

要求

<EMPTY>

回應

名稱	類型
payload	Dictionary_Clone_Result

複製

建立新的字典，其中包含這個字典中所有項目的本機副本。

例如，如果這個字典包含巢狀字典，則新建立的字典會包含這些巢狀字典的參照，因為這些項目是複製而來，而非複製項目。

要求

<EMPTY>

回應

名稱	類型
payload	Dictionary_Copy_Result

排液閥

移除這個字典中的所有項目。

如未提供 contents，系統會捨棄所有項目，而不會列舉項目。

要求

名稱	類型
contents	server_end<DictionaryIterator>?

列舉

計算這個字典中的項目。

在列舉期間建立每個項目的複本。

要求

名稱	類型
contents	server_end<DictionaryIterator>

取得

從這個字典取得能力副本。

• 如果字典不包含索引鍵，則傳回 DictionaryError.NOT_FOUND 錯誤。

要求

名稱	類型
key	DictionaryKey

回應

名稱	類型
payload	Dictionary_Get_Result

插入

將鍵/值組合插入字典。

• 錯誤：DictionaryError.ALREADY_EXISTS。

要求

名稱	類型
key	DictionaryKey
value	Capability

回應

名稱	類型
payload	Dictionary_Insert_Result

已讀

傳回這個字典中的所有項目，並以自然順序排序。

這項作業會建立淺層值副本。

要求

<EMPTY>

回應

名稱	類型
payload	Dictionary_Read_Result

移除

從字典中移除索引鍵，並傳回 Capability 值。

• 如果字典不包含索引鍵，則傳回 DictionaryError.NOT_FOUND 錯誤。

要求

名稱	類型
key	DictionaryKey

回應

名稱	類型
payload	Dictionary_Remove_Result

DictionaryIterator

在 fuchsia.component.sandbox/sandbox.fidl 中定義

GetNext

要求

<EMPTY>

回應

名稱	類型
payload	DictionaryIterator_GetNext_Result

工廠

在 fuchsia.component.sandbox/sandbox.fidl 中定義

Factory 通訊協定會處理以下項目：

• 沙箱類型例項化。
• 控制指定權杖的沙箱物件。

ConnectToSender

操作提供的寄件者能力。

使用參照按鈕物件的權杖，並在 server_end 上提供對應的 FIDL 表示法。server_end 的對等點是另一個平面物件的參照。捨棄控制管道會減少物件的一項參照。

要求

名稱	類型
capability	SenderCapability
server_end	server_end<Sender>

CreateDictionary

建立新的空白字典。

要求

<EMPTY>

回應

名稱	類型
payload	Factory_CreateDictionary_Result

CreateSender

從提供 Receiver 的用戶端建立 Sender。

要求

名稱	類型
receiver	Receiver

回應

名稱	類型
payload	Factory_CreateSender_Result

HandleCapability

在 fuchsia.component.sandbox/sandbox.fidl 中定義

Clone2

要求

名稱	類型
request	server_end<fuchsia.unknown/Cloneable>

GetHandle

要求

<EMPTY>

回應

名稱	類型
payload	HandleCapability_GetHandle_Result

接收器

在 fuchsia.component.sandbox/sandbox.fidl 中定義

接收器由用戶端提供，並允許其接收架構中的管道。

接收

將管道傳送給這個接收器。

要求

名稱	類型
channel	handle<channel>

路由器

在 fuchsia.component.sandbox/sandbox.fidl 中定義

路由器可讓用戶端要求某項能力。

路徑

要求

名稱	類型
payload	RouteRequest

回應

名稱	類型
payload	Router_Route_Result

寄件者

在 fuchsia.component.sandbox/sandbox.fidl 中定義

傳送者允許用戶端將管道傳送至架構，以便連結。

傳送

透過這位傳送者傳送管道。

要求

名稱	類型
channel	handle<channel>

結構化

ComponentToken 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

這代表架構中的一個元件。目前沒有方法做為權杖使用，

廣闊	類型	說明	預設
token	handle<eventpair>		無預設

DictionaryItem 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

字典中的鍵/值組合。

廣闊	類型	說明	預設
key	DictionaryKey		無預設
value	Capability		無預設

DictionaryIterator_GetNext_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
items	vector<DictionaryItem>[128]		無預設

Dictionary_Clone_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
dictionary	Dictionary		無預設

Dictionary_Copy_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
dictionary	Dictionary		無預設

Dictionary_Get_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
capability	Capability		無預設

Dictionary_Insert_Response

定義於 fuchsia.component.sandbox/sandbox.fidl

<EMPTY>

Dictionary_Read_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
items	vector<DictionaryItem>		無預設

Dictionary_Remove_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
capability	Capability		無預設

Factory_CreateDictionary_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
dictionary	Dictionary		無預設

Factory_CreateSender_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
capability	SenderCapability		無預設

HandleCapability_GetHandle_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
handle	handle<handle>		無預設

ProtocolPayload 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

包含通訊協定開啟的要求。

廣闊	類型	說明	預設
channel	handle<channel>		無預設

Router_Route_Response 資源

定義於 fuchsia.component.sandbox/sandbox.fidl

廣闊	類型	說明	預設
capability	Capability		無預設

SenderCapability 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

廣闊	類型	說明	預設
token	handle<eventpair>		無預設

UnitCapability

定義於 fuchsia.component.sandbox/sandbox.fidl

<EMPTY>

ENUMS

開放使用嚴格

類型：uint32

定義於 fuchsia.component.sandbox/availability.fidl

說明能力的預期可用性。

某些功能可能不適用於部分系統設定。在這些情況下，系統會在公開/優惠/用途鏈中將供應情形宣告為 OPTIONAL，而如果系統設定無法轉送或提供特定能力 (例如無頭系統上的圖形功能)，則會從系統設定中的 void 轉送。

名稱	物超所值	說明
是否必要	1	功能必須可用。無法轉送能力會發生錯誤。
選用	2	在用途宣告中：如果元件無法取得該能力，也可以正常運作。 在優惠/公開聲明中：部分系統設定可能無法提供該項能力。做為共同項目，目標元件不得對能力缺少必要的依附元件。
SAME_AS_TARGET	3	如果對應優惠或公開聲明的目標需要能力，則行為相當於必要行為。如果目標對能力有選用依附元件，則行為即為選用功能。這對想要根據內部元件變更轉送可用性的容器元件而言非常實用。 用途宣告中不允許使用這個值。
轉換	4	來源可能會完全省略路線，甚至不需要從 void 轉送。 暫時轉換用於導入新功能的軟性轉換。

DictionaryError 彈性

類型：uint32

在 fuchsia.component.sandbox/sandbox.fidl 中定義

Dictionary 中的方法傳回的錯誤。

名稱	物超所值	說明
NOT_FOUND	1	字典中沒有具有指定鍵的項目。
ALREADY_EXISTS	2	字典中已有具備指定鍵的項目。
BAD_CAPABILITY	3	功能無效。 功能必須由沙箱透過 fuchsia.component.sandbox.Factory 建立，或從其他元件架構 API 傳回。
INVALID_KEY	4	金鑰無效。如需有效金鑰的限制，請參閱 https://fuchsia.dev/reference/cml#names。

HandleCapabilityError strict

類型：uint32

定義於 fuchsia.component.sandbox/sandbox.fidl

名稱	物超所值	說明
無法使用	1

RouterError 彈性

類型：uint32

在 fuchsia.component.sandbox/sandbox.fidl 中定義

名稱	物超所值	說明
NOT_FOUND	1	路由器找不到任何能力。
INVALID_ARGS	2	提供給函式的引數無效。

資料表

RouteRequest 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

路線要求。

序數	廣闊	類型	說明
1	availability	Availability	要求這項能力的可用性。
2	requesting	ComponentToken	要求能力的元件。

聯合國

功能彈性 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	unit	UnitCapability
2	handle	HandleCapability
3	data	DataCapability
4	dictionary	Dictionary
5	sender	SenderCapability
6	directory	fuchsia.io/Directory
7	router	Router

Data 功能彈性

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	bytes	vector<uint8>[8192]
2	string	string[8192]
3	int64	int64
4	uint64	uint64

DictionaryIterator_GetNext_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	DictionaryIterator_GetNext_Response
3	framework_err	internal

Dictionary_Clone_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Dictionary_Clone_Response
3	framework_err	internal

Dictionary_Copy_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Dictionary_Copy_Response
3	framework_err	internal

Dictionary_Get_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Dictionary_Get_Response
2	err	DictionaryError
3	framework_err	internal

Dictionary_Insert_Result 嚴格

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Dictionary_Insert_Response
2	err	DictionaryError
3	framework_err	internal

Dictionary_Read_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Dictionary_Read_Response
3	framework_err	internal

Dictionary_Remove_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Dictionary_Remove_Response
2	err	DictionaryError
3	framework_err	internal

Factory_CreateDictionary_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Factory_CreateDictionary_Response
3	framework_err	internal

Factory_CreateSender_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Factory_CreateSender_Response
3	framework_err	internal

HandleCapability_GetHandle_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	HandleCapability_GetHandle_Response
2	err	HandleCapabilityError

Router_Route_Result 嚴格 資源

在 fuchsia.component.sandbox/sandbox.fidl 中定義

序數	Variant	類型	說明
1	response	Router_Route_Response
2	err	RouterError
3	framework_err	internal

業者

名稱	物超所值	類型	說明
MAX_DATA_LENGTH	8192	uint32	[DataCapability] 中的位元組數上限。
MAX_DICTIONARY_ITEMS_CHUNK	128	uint32	[DictionaryIterator] 傳回的項目數量上限。
MAX_NAME_LENGTH	fuchsia.io/MAX_NAME_LENGTH	uint64	字典鍵的長度上限。這個項目應與 fuchsia.component.MAX_NAME_LENGTH 相同。 已新增：HEAD

別名

名稱	物超所值	說明
DictionaryKey	string[MAX_NAME_LENGTH]	DictionaryItem 的鍵。如需有效金鑰的限制，請參閱 https://fuchsia.dev/reference/cml#names。 已新增：HEAD