fuchsia.session

新增：7

PROTOCOLS

發射器

在 fuchsia.session/launcher.fidl 中定義的

用於啟動工作階段的通訊協定。

啟用

啟動 configuration 中詳述的工作階段。

如果工作階段正在執行，與執行中相關聯的元件 就會刪除這個工作階段

  • configuration 描述要啟動的工作階段。
  • 如未設定 configuration.session_url，則傳回錯誤 LaunchError.INVALID_ARGS。
  • 如果 configuration.session_url 則傳回「LaunchError.NOT_FOUND」 無法解決。
  • 如果現有的工作階段元件，則傳回錯誤 LaunchError.DESTROY_COMPONENT_FAILED 無法刪除 。現有的工作階段會繼續執行。
  • 如果工作階段元件，則傳回錯誤 LaunchError.CREATE_COMPONENT_FAILED 無法啟動。此時不會執行任何工作階段。

要求

名稱類型
configuration LaunchConfiguration

回應

名稱類型
payload Launcher_Launch_Result

生命週期

定義於 fuchsia.session/lifecycle.fidl

用於控制工作階段生命週期的通訊協定。

新增：13

重新啟動

重新啟動工作階段。

這會停止現有的工作階段，並啟動新的工作階段 設為上一個工作階段網址

建立並啟動新的工作階段元件後，系統會傳回 。

  • 如果目前沒有工作階段，則傳回 LifecycleError.NOT_FOUND。
  • 如果工作階段網址，則傳回 LifecycleError.RESOLVE_COMPONENT_FAILED 錯誤 無法解析為元件
  • 如果工作階段元件，則傳回錯誤 LifecycleError.DESTROY_COMPONENT_FAILED 無法刪除 。前一個工作階段會繼續存在 元件可能會開始執行
  • 如果工作階段元件，則傳回錯誤 LifecycleError.CREATE_COMPONENT_FAILED 無法啟動。此時不會執行任何工作階段。

要求

<空白>

回應

名稱類型
payload Lifecycle_Restart_Result

開始

啟動工作階段。

建立並啟動工作階段元件後，系統會傳回。

  • 如未提供 session_url，則傳回錯誤 LifecycleError.NOT_FOUND 而且未設定預設工作階段網址
  • 如果工作階段已啟動，則會傳回 LifecycleError.ALREADY_STARTED 錯誤。
  • 如果session_url無法，則傳回「LifecycleError.RESOLVE_COMPONENT_FAILED」 並套用至元件
  • 如果現有的工作階段元件，則傳回錯誤 LifecycleError.DESTROY_COMPONENT_FAILED 無法刪除 。現有的工作階段會繼續執行。
  • 如果工作階段元件，則傳回錯誤 LifecycleError.CREATE_COMPONENT_FAILED 無法啟動。此時不會執行任何工作階段。

要求

名稱類型
payload LifecycleStartRequest

回應

名稱類型
payload Lifecycle_Start_Result

停止

停止工作階段。

刪除工作階段元件後，會傳回此內容。

  • 如果工作階段尚未啟動，則會傳回 LifecycleError.NOT_FOUND 錯誤。
  • 如果工作階段元件，則傳回錯誤 LifecycleError.DESTROY_COMPONENT_FAILED 無法刪除 。前一個工作階段會繼續存在 元件可能會開始執行

要求

<空白>

回應

名稱類型
payload Lifecycle_Stop_Result

重新啟動器

定義於 fuchsia.session/restarter.fidl

用於重新啟動目前執行工作階段的通訊協定。

重新啟動

重新啟動工作階段。

  • 如果沒有，則傳回「RestartError.NOT_RUNNING」 以便重新啟動。
  • 如果現有的工作階段元件，則傳回錯誤 RestartError.DESTROY_COMPONENT_FAILED 無法刪除 。現有的工作階段會繼續執行。
  • 如果工作階段元件，則傳回錯誤 RestartError.CREATE_COMPONENT_FAILED 無法啟動。此時不會執行任何工作階段。

要求

<空白>

回應

名稱類型
payload Restarter_Restart_Result

結構

Launcher_Launch_Response

在 fuchsia.session/launcher.fidl 中定義的

<空白>

Lifecycle_Restart_Response

定義於 fuchsia.session/lifecycle.fidl

<空白>

Lifecycle_Start_Response

定義於 fuchsia.session/lifecycle.fidl

<空白>

Lifecycle_Stop_Response

定義於 fuchsia.session/lifecycle.fidl

<空白>

Restarter_Restart_Response

定義於 fuchsia.session/restarter.fidl

<空白>

ENUMS

LaunchError 彈性

類型：uint32

在 fuchsia.session/launcher.fidl 中定義的

啟動工作階段時發生錯誤。

名稱值說明
1

工作階段的 LaunchConfiguration 格式錯誤。
2

解析工作階段的元件網址時發生錯誤。
3

無法刪除工作階段元件。
4

無法建立工作階段元件。

LifecycleError 彈性

類型：uint32

定義於 fuchsia.session/lifecycle.fidl

更新工作階段生命週期時發生錯誤。

新增：13

名稱值說明
1

工作階段尚未啟動，或未設定預設工作階段網址。
2

工作階段已開始。
3

無法解析工作階段元件。
4

無法建立工作階段元件。
5

無法刪除工作階段元件。

RestartError 彈性

類型：uint32

定義於 fuchsia.session/restarter.fidl

重新啟動工作階段時發生錯誤。

名稱值說明
1

目前沒有執行中的工作階段可重新啟動。
2

解析工作階段的元件網址時發生錯誤。
3

無法刪除工作階段元件。
4

無法建立工作階段元件。

資料表

LaunchConfiguration

在 fuchsia.session/launcher.fidl 中定義的

描述要啟動的工作階段。

Ordinal欄位類型說明
session_url string[4096]

工作階段的元件網址。
config_capabilities vector<fuchsia.component.decl/Configuration>

要提供給工作階段的設定功能。

在預期用途中，工作階段元件會使用特定的 具有 transitional 可用性。發生這種 轉換能力不適用於工作階段，其中設定值 。使用以下憑證時： config_capabilities，則此處指定的設定值將會是 因此，這可以覆寫工作階段元件的設定值 並未依據這種模式設定

新增時間：HEAD

LifecycleStartRequest

定義於 fuchsia.session/lifecycle.fidl

Ordinal欄位類型說明
session_url string[4096]

工作階段的元件網址。

選用。如果省略，則會使用預設設定的工作階段網址 (如果有的話)。

聯合國

Launcher_Launch_Result 嚴格

在 fuchsia.session/launcher.fidl 中定義的

OrdinalVariant類型說明
response Launcher_Launch_Response
err LaunchError

Lifecycle_Restart_Result 嚴格

定義於 fuchsia.session/lifecycle.fidl

OrdinalVariant類型說明
response Lifecycle_Restart_Response
err LifecycleError
framework_err internal

Lifecycle_Start_Result 嚴格

定義於 fuchsia.session/lifecycle.fidl

OrdinalVariant類型說明
response Lifecycle_Start_Response
err LifecycleError
framework_err internal

Lifecycle_Stop_Result 嚴格

定義於 fuchsia.session/lifecycle.fidl

OrdinalVariant類型說明
response Lifecycle_Stop_Response
err LifecycleError
framework_err internal

Restarter_Restart_Result 嚴格

定義於 fuchsia.session/restarter.fidl

OrdinalVariant類型說明
response Restarter_Restart_Response
err RestartError