---
name: "SmartTapToRunAbility.trigger"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.11.0" }
title: "trigger - 手动触发一键执行，由云端执行"
summary: "手动触发一键执行规则，由云端执行绑定的联动动作。"
---

## SmartTapToRunAbility.trigger

> [VERSION] @ray-js/panel-sdk >= 1.11.0

> 💡 仅支持单设备，不支持群组环境。
> 注意，返回示例仅供参考，其包含字段大于返回参数定义范围，请勿使用除本文返回参数定义以外的返回数据，否则可能会导致程序异常。

### 描述

忽略自动化条件，直接触发一键执行

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `options` | `TriggerTapToRunParams` | 是 | 触发参数，包含 ruleId |

### 返回值

类型: `Promise<boolean>`

执行是否成功

### 引用对象

##### `type` TriggerTapToRunParams

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `ruleId` | `string` | 规则 ID，可通过已绑定的一键执行列表中的 triggerRuleId 获取 |


### 示例代码

#### 示例

```typescript
await sdm.tapToRun.trigger({ ruleId: 'rule_abc123' });
console.log('一键执行已触发');
```