AppService

API_LEVEL 3.0 开始支持，API 兼容性请参考 API_LEVEL。

注册后台服务，指定当前服务的生命周期回调等。每个后台服务都必须调用 AppService() 构造函数且只能调用一次。

信息

权限代码： device:os.bg_service

类型

function AppService(option: Option): Result

参数

Option

属性	类型	必填	默认值	说明	API_LEVEL
state	object	否	-	appService 实例上挂载的数据对象，可用于存储当前服务的状态	3.0
onInit	(params?: string) => void	否	-	启动服务的时候触发该函数，如果启动服务携带 params 参数，则在 onInit 方法中可以获取到 params 字符串	3.0
onEvent	(params?: string) => void	否	-	onEvent 用来监听系统事件，事件相关参数会通过 params 传递	3.0
onDestroy	() => void	否	-	服务销毁时触发 onDestroy 生命周期函数	3.0

Result

类型	说明
unknown	AppService 实例

代码示例

appService.js

AppService({
  state: {
    text: 'Hello Zepp OS',
  },
  onInit() {
    console.log('onInit')
  },
  onEvent(event) {
    console.log(event)
  },
})