Skip to content

计费注册(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;
}>;

参数说明:

参数名类型是否必填默认值描述
optionsobjectstring否*-
options.developerKeystring是*-开发者密钥;也可由宿主预置;缺省且无预置时 reject
options.secretKeystring-developerKey 同义
options.machineNamestring设备型号机器备注名

返回值:

类型描述
Promise<RegResult>注册成功 resolve 为结果对象;密钥无效、余额不足或网络失败时 reject(字段见下表)

返回字段:

字段名类型是否必填默认值描述
registeredboolean-是否已完成注册;成功调用后一般为 true,宿主据此放行自动化 API
chargedboolean-本次调用是否发生扣费;同一计费周期内再次 reg 常为 false
dailyFeenumber-日费金额(元);服务端未返回时可能缺省
balancenumber-开发者账户当前余额;服务端未返回时可能缺省
expireTimestring-当前计费周期到期时间(服务端字符串,常见为日期时间文本)
messagestring-服务端提示信息(成功或补充说明);失败时错误信息在 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);