1# AutoStartupCallback (系统接口)
2
3应用设置为开机自启动时的回调函数。
4
5> **说明：**
6>
7> 本模块首批接口从API version 11开始支持。后续版本的新增接口，采用上角标单独标记接口的起始版本。
8> 本模块接口仅可在Stage模型下使用。
9> 本模块接口为系统接口。
10
11## AutoStartupCallback.onAutoStartupOn
12
13onAutoStartupOn(info: AutoStartupInfo): void;
14
15应用设置为开机自启动时调用。
16
17**系统接口**：此接口为系统接口。
18
19**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
20
21**参数：**
22
23| 参数名 | 类型 | 必填 | 说明 |
24| -------- | -------- | -------- | -------- |
25| info | [AutoStartupInfo](js-apis-inner-application-autoStartupInfo-sys.md)   | 是 | 设置为开机自启动的应用组件信息。 |
26
27**示例：**
28
29```ts
30import { autoStartupManager, common } from '@kit.AbilityKit';
31import { BusinessError } from '@kit.BasicServicesKit';
32
33let autoStartupCallback: common.AutoStartupCallback = {
34  onAutoStartupOn(data: common.AutoStartupInfo) {
35    console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
36  },
37  onAutoStartupOff(data: common.AutoStartupInfo) {
38    console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
39  }
40}
41
42try {
43  autoStartupManager.on('systemAutoStartup', autoStartupCallback)
44} catch (err) {
45  console.info('===> autostartupmanager on callback err: ' + JSON.stringify(err as BusinessError));
46}
47```
48
49## AutoStartupCallback.onAutoStartupOff
50
51onAutoStartupOff(info: AutoStartupInfo): void;
52
53取消应用开机自启动时调用。
54
55**系统接口**：此接口为系统接口。
56
57**系统能力**：SystemCapability.Ability.AbilityRuntime.Core
58
59**参数：**
60
61| 参数名 | 类型            | 必填 | 说明                 |
62| ------ | --------------- | ---- | -------------------- |
63| info   | [AutoStartupInfo](js-apis-inner-application-autoStartupInfo-sys.md)   | 是   | 取消开机自启动的应用组件信息。 |
64
65**示例：**
66
67```ts
68import { autoStartupManager, common } from '@kit.AbilityKit';
69import { BusinessError } from '@kit.BasicServicesKit';
70
71let autoStartupCallback: common.AutoStartupCallback = {
72  onAutoStartupOn(data: common.AutoStartupInfo) {
73    console.info('===> autostartupmanager onAutoStartupOn data: ' + JSON.stringify(data));
74  },
75  onAutoStartupOff(data: common.AutoStartupInfo) {
76    console.info('===> autostartupmanager onAutoStartupOff data: ' + JSON.stringify(data));
77  }
78}
79
80try {
81  autoStartupManager.on('systemAutoStartup', autoStartupCallback)
82} catch (err) {
83  console.info('===> autostartupmanager on callback err: ' + JSON.stringify(err as BusinessError));
84}
85```
86