通訊協定功能

library fuchsia.examples;

const MAX_STRING_LENGTH uint64 = 32;

@discoverable
protocol Echo {
    EchoString(struct {
        value string:MAX_STRING_LENGTH;
    }) -> (struct {
        response string:MAX_STRING_LENGTH;
    });
    SendString(struct {
        value string:MAX_STRING_LENGTH;
    });
    -> OnString(struct {
        response string:MAX_STRING_LENGTH;
    });
};

提供通訊協定功能

如要提供通訊協定能力，元件必須宣告能力，並從 self 轉送該功能。

若要定義能力，請為該功能新增 capabilities 宣告：

{
    capabilities: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
        },
    ],
}

這會定義由此元件託管的能力，其傳出目錄路徑為 /svc/fuchsia.example.ExampleProtocol。您也可以自訂路徑：

{
    capabilities: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            path: "/my_svc/fuchsia.example.MyExampleProtocol",
        },
    ],
}

轉送通訊協定功能

元件路徑通訊協定功能會將其「公開」exposing給父項，並提供給子項。

如要進一步瞭解架構路徑元件功能，請參閱「功能轉送」。

公開

公開通訊協定能力可讓元件的父項存取該能力：

{
    expose: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            from: "self",
        },
    ],
}

from: "self" 指令代表通訊協定能力是由此元件「提供」。

提供

提供通訊協定能力可讓子項元件存取該能力：

{
    offer: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            from: "self",
            to: [ "#child-a", "#child_b" ],
        },
    ],
}

使用通訊協定功能

如要要求能力，請為該功能新增 use 宣告：

{
    use: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
        },
    ],
}

這會在已知路徑 /svc/fuchsia.example.ExampleProtocol 的元件命名空間中填入通訊協定。您也可以自訂路徑：

{
    use: [
        {
            protocol: "fuchsia.example.ExampleProtocol",
            path: "/my_svc/fuchsia.example.MyExampleProtocol",
        },
    ],
}

如要進一步瞭解開放式要求，請參閱通訊協定開放的生命週期。

使用選用的通訊協定功能

請參閱「連結元件：使用選用功能」。

架構通訊協定

「架構通訊協定」是元件架構提供的通訊協定。任何元件都可以將 framework 設為來源，且不附加其父項的 offer，藉此 use 這些功能。Fuchsia 支援下列架構通訊協定：

{
    use: [
        {
            protocol: "fuchsia.component.Realm",
            from: "framework",
        },
    ],
}