getBindTapToRunRules - 查询当前已经绑定的一键执行列表。

SmartTapToRunAbility.getBindTapToRunRules(params?: TapToRunQueryParams)

版本要求:

@ray-js/panel-sdk≥1.11.0

描述

查询已绑定一键执行的联动列表

参数

参数	类型	必填	说明
		否	查询参数

返回值

类型：Promise<BindTapToRunRules>

已绑定的一键执行规则列表

引用对象

typeBindTapToRunRules已绑定的一键执行联动规则列表

export type BindTapToRunRules = BindTapToRunRule[];

typeBindTapToRunRule已绑定的一键执行项

属性	类型	描述
`associativeEntityId`	string	关联实体 ID，格式为 dpId#dpValue
		关联实体的值列表
`bindId`	number	绑定 ID
`bizDomain`	string	业务域，一键执行固定为 wirelessSwitchBindScene
`enable`	boolean	是否启用
`sourceEntityId`	string	源设备 ID

typeBindTapToRunLinkedRule已绑定的一键执行目标规则

属性	类型	描述
`ruleType`	number	规则类型
`triggerRuleEnable`	boolean	规则是否启用
`triggerRuleId`	string	执行规则 ID，一般用来进行触发

typeTapToRunRule可绑定的一键执行规则

属性	类型	描述
		执行动作列表
`background`	string	背景图地址
`boundForPanel`	boolean	面板绑定
`boundForWiFiPanel`	boolean	WiFi 面板绑定
`coverIcon`	string	图标
`displayColor`	string	背景颜色
`enabled`	boolean	规则是否启用
`id`	string	执行规则 ID
`name`	string	联动名称或备注

typeTapToRunAction一键执行动作项

属性	类型	描述
`actionDisplay`	string	执行动作的显示名称
`actionExecutor`	string	执行动作的执行者
`actionStrategy`	string	执行动作的执行策略
`entityId`	string	动作所属实体 ID
`gmtModified`	number	修改时间戳
`id`	string	动作唯一 ID
`orderNum`	number	动作顺序号
`ruleId`	string	规则 ID
`status`	boolean	动作状态

示例代码

示例

const bindRules = await sdm.tapToRun.getBindTapToRunRules();
bindRules.forEach(item => {
  console.log('绑定 ID:', item.bindId);
  item.associativeEntityValueList.forEach(rule => {
    console.log('已绑定规则:', rule.id, rule.name);
  });
});