start
API_LEVEL
3.0
开始支持,API 兼容性请参考 API_LEVEL。
启动指定的设备应用服务,启动结果通过回调函数返回。
信息
权限代码: device:os.bg_service
类型
function start(option: Option): Result
参数
Option
属性 | 类型 | 必填 | 默认值 | 说明 | API_LEVEL |
---|---|---|---|---|---|
file | string | 是 | - | 设备应用服务 js 文件,必须是在 app.json module 中 app-service 字段配置的文件 | 3.0 |
param | string | 否 | - | 设备应用服务 js 文件加载时,传入的参数 | 3.0 |
complete_func | (callbackOption: CallbackOption) => void | 是 | - | 设备应用服务启动完成回调函数 | 3.0 |
CallbackOption
属性 | 类型 | 说明 | API_LEVEL |
---|---|---|---|
file | string | 设备应用服务 js 文件,与 start 传入参数相同 | 3.0 |
result | boolean | 设备应用服务启动结果,true 代表成功,false 代表失败 | 3.0 |
Result
类型 | 说明 |
---|---|
boolean | 如果返回 0 则表明设备应用服务启动成功,其余值的含义参考 ERROR_CODE |
ERROR_CODE
值 | 类型 | 说明 | API_LEVEL |
---|---|---|---|
0 | number | 成功 | 3.0 |
1 | number | 参数错误 | 3.0 |
2 | number | 服务状态错误 | 3.0 |
3 | number | 无权限 | 3.0 |
4 | number | 内存不足 | 3.0 |
5 | number | 不支持 | 3.0 |
6 | number | 服务被禁止 | 3.0 |
7 | number | 服务数量已达系统限制 | 3.0 |
255 | number | 未知错误 | 3.0 |
代码示例
import { start } from '@zos/app-service'