Appearance
计费注册(reg)
宿主注入的全局函数。脚本启动后须先 reg(...) 完成机器注册;未注册时其余自动化 API 不可用。TypeScript 声明见 script-typings/billingModule.d.ts。VS Code 推送时可自动注入 developerKey。
reg - 注册当前机器并扣费
typescript
function reg(options?: {
developerKey?: string;
secretKey?: string;
machineName?: string;
} | string): Promise<{
registered: boolean;
charged: boolean;
dailyFee?: number;
balance?: number;
expireTime?: string;
message?: string;
}>;参数说明:
| 参数名 | 类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| options | object | string | 否* | - |
| options.developerKey | string | 是* | - | 开发者密钥;也可由宿主预置;缺省且无预置时 reject |
| options.secretKey | string | 否 | - | 与 developerKey 同义 |
| options.machineName | string | 否 | 设备型号 | 机器备注名 |
返回值:
| 类型 | 描述 |
|---|---|
Promise<RegResult> | 注册成功 resolve 为结果对象;密钥无效、余额不足或网络失败时 reject(字段见下表) |
返回字段:
| 字段名 | 类型 | 是否必填 | 默认值 | 描述 |
|---|---|---|---|---|
| registered | boolean | 是 | - | 是否已完成注册;成功调用后一般为 true,宿主据此放行自动化 API |
| charged | boolean | 是 | - | 本次调用是否发生扣费;同一计费周期内再次 reg 常为 false |
| dailyFee | number | 否 | - | 日费金额(元);服务端未返回时可能缺省 |
| balance | number | 否 | - | 开发者账户当前余额;服务端未返回时可能缺省 |
| expireTime | string | 否 | - | 当前计费周期到期时间(服务端字符串,常见为日期时间文本) |
| message | string | 否 | - | 服务端提示信息(成功或补充说明);失败时错误信息在 reject 的 Error.message 中 |
说明:
每台机器每天首次 reg 起算 24 小时计费周期。成功后宿主将标记已注册,后续自动化 API 可正常调用。
示例:
javascript
let r = reg({ developerKey: 'YOUR_DEV_KEY', machineName: '测试机' });
// 或:reg('YOUR_DEV_KEY');
logger.info('注册结果', r.registered, r.charged, r.expireTime);
auto.click(100, 200);