fuchsia.session

新增時間：7

通訊協定

啟動器

定義於 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

開始

啟動工作階段。

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

  • 錯誤 LifecycleError.NOT_FOUND。session_url 尚未提供且未設定預設工作階段網址。
  • 「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

<空白>

簡報

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

無法建立工作階段元件。

資料表

啟動設定

定義於 fuchsia.session/launcher.fidl

說明要啟動的工作階段。

序數欄位類型說明
session_url string[4096]

工作階段的元件網址。

LifecycleStartRequest

定義於 fuchsia.session/lifecycle.fidl

序數欄位類型說明
session_url string[4096]

工作階段的元件網址。

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

聯合國

Launcher_Launch_Result 嚴格

定義於 fuchsia.session/launcher.fidl

序數Variant類型說明
response Launcher_Launch_Response
err LaunchError

Lifecycle_Restart_Result 嚴格

定義於 fuchsia.session/lifecycle.fidl

序數Variant類型說明
response Lifecycle_Restart_Response
err LifecycleError
framework_err internal

Lifecycle_Start_Result 嚴格

定義於 fuchsia.session/lifecycle.fidl

序數Variant類型說明
response Lifecycle_Start_Response
err LifecycleError
framework_err internal

Lifecycle_Stop_Result 嚴格

定義於 fuchsia.session/lifecycle.fidl

序數Variant類型說明
response Lifecycle_Stop_Response
err LifecycleError
framework_err internal

Restarter_Restart_Result 嚴格

定義於 fuchsia.session/restarter.fidl

序數Variant類型說明
response Restarter_Restart_Response
err RestartError