---
name: "SmartTapToRunAbility.unbind"
mode: "api"
versionRequirements:
  - { name: "@ray-js/panel-sdk", version: "1.11.0" }
title: "unbind - 解绑一键执行规则"
summary: "根据绑定 ID 解绑一键执行规则。"
---

## SmartTapToRunAbility.unbind

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

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

### 描述

解绑一键执行规则

### 参数

`Params`

| 参数 | 类型 | 必填 | 描述 |
| --- | --- | --- | --- |
| `params` | `UnbindTapToRunParams` | 是 | 解绑参数 |

### 返回值

类型: `Promise<UnbindTapToRunResult>`

解绑后剩余的场景列表

### 引用对象

##### `type` UnbindTapToRunParams

一键执行解绑参数

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `bindId` | `string` | 可通过已绑定的一键执行列表中的 bindId 获取 |
| `gid` | `string` | 家庭 ID，不传则使用当前 App 家庭 |

##### `type` UnbindTapToRunResult

一键执行解绑结果

```typescript
export type UnbindTapToRunResult = boolean;
```


### 示例代码

#### 示例

```typescript
const remaining = await sdm.tapToRun.unbind({ bindId: 'bind_001' });
console.log('解绑成功，剩余场景:', remaining);
```