Fuchsia.session

添加数量：7

协议

启动器

在 fuchsia.session/launcher.fidl 中定义

用于启动会话的协议。

Launch

启动 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 中定义

描述要启动的会话。

序数字段类型说明
session_url string[4096]

会话的组件网址。

LifecycleStartRequest

在 fuchsia.session/lifecycle.fidl 中定义

序数字段类型说明
session_url string[4096]

会话的组件网址。

可选。如果省略，则使用已配置的默认会话网址（如有）。

联合

Launcher_Launch_Result Strict

在 fuchsia.session/launcher.fidl 中定义

序数变体类型说明
response Launcher_Launch_Response
err LaunchError

Lifecycle_Restart_Result Strict

在 fuchsia.session/lifecycle.fidl 中定义

序数变体类型说明
response Lifecycle_Restart_Response
err LifecycleError
framework_err internal

Lifecycle_Start_Result Strict

在 fuchsia.session/lifecycle.fidl 中定义

序数变体类型说明
response Lifecycle_Start_Response
err LifecycleError
framework_err internal

Lifecycle_Stop_Result Strict

在 fuchsia.session/lifecycle.fidl 中定义

序数变体类型说明
response Lifecycle_Stop_Response
err LifecycleError
framework_err internal

Restarter_Restart_Result 严格

在 fuchsia.session/restarter.fidl 中定义

序数变体类型说明
response Restarter_Restart_Response
err RestartError