---
name: "getDoorbellService"
mode: "api"
versionRequirements:
  - { name: "@ray-js/lock-sdk", version: "1.0.0" }
title: "getDoorbellService - 获取门铃通知服务信息。"
summary: "获取门铃通知服务信息。"
---

## getDoorbellService

> [VERSION] @ray-js/lock-sdk >= 1.0.0

### 描述

获取门铃通知服务信息

### 参数

无


### 返回值

类型: `Promise<LinkageRule>`

门铃联动规则摘要（存在规则时为 truthy；详情字段由云端返回）

##### LinkageRule

| 属性 | 类型 | 描述 |
| --- | --- | --- |
| `background` | `string` |  |
| `code` | `string` |  |
| `description` | `string` |  |
| `displayColor` | `string` |  |
| `icon` | `string` |  |
| `order` | `number` |  |
| `title` | `string` |  |
| `ruleId` | `string` |  |
| `ruleVO` | `Object` |  |

##### LinkageRule.ruleVO 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `actions` | `Object[]` | 是 | - |  |
| `auditStatus` | `number` | 是 | - |  |
| `boundForPanel` | `boolean` | 是 | - |  |
| `boundForWiFiPanel` | `boolean` | 是 | - |  |
| `code` | `string` | 是 | - |  |
| `commonField` | `string` | 是 | - |  |
| `conditions` | `Object[]` | 是 | - |  |
| `containDeviceDelete` | `boolean` | 是 | - |  |
| `coverIcon` | `string` | 是 | - |  |
| `description` | `string` | 是 | - |  |
| `disableTime` | `number` | 是 | - |  |
| `displayColor` | `string` | 是 | - |  |
| `enabled` | `boolean` | 是 | - |  |
| `forceCloudTrigger` | `boolean` | 是 | - |  |
| `gmtCreate` | `number` | 是 | - |  |
| `gmtModified` | `number` | 是 | - |  |
| `id` | `string` | 是 | - |  |
| `iotAutoAlarm` | `boolean` | 是 | - |  |
| `isAlarmIssue` | `boolean` | 是 | - |  |
| `isLogicRule` | `boolean` | 是 | - |  |
| `linkageType` | `number` | 是 | - |  |
| `localLinkage` | `boolean` | 是 | - |  |
| `matchType` | `number` | 是 | - |  |
| `name` | `string` | 是 | - |  |
| `needCleanGidSid` | `boolean` | 是 | - |  |
| `needValidOutOfWork` | `boolean` | 是 | - |  |
| `newLocalScene` | `false` | 是 | - |  |
| `offGwSync` | `boolean` | 是 | - |  |
| `offGwSyncSuccess` | `boolean` | 是 | - |  |
| `orderWeight` | `number` | 是 | - |  |
| `outOfWork` | `number` | 是 | - |  |
| `ownerId` | `string` | 是 | - |  |
| `panelType` | `number` | 是 | - |  |
| `permissionCode` | `string` | 是 | - |  |
| `ruleGenre` | `number` | 是 | - |  |
| `ruleSource` | `number` | 是 | - |  |
| `ruleType` | `number` | 是 | - |  |
| `scenarioRule` | `boolean` | 是 | - |  |
| `status` | `true` | 是 | - |  |
| `stickyOnTop` | `false` | 是 | - |  |
| `subMatchType` | `number` | 是 | - |  |


##### LinkageRule.ruleVO.actions[] 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `actionExecutor` | `string` | 是 | - |  |
| `actionStrategy` | `string` | 是 | - |  |
| `attribute` | `number` | 是 | - |  |
| `devDelMark` | `boolean` | 是 | - |  |
| `enabled` | `boolean` | 是 | - |  |
| `entityId` | `string` | 是 | - |  |
| `executorProperty` | `Object` | 是 | - |  |
| `extraProperty` | `Object` | 是 | - |  |
| `gmtModified` | `number` | 是 | - |  |
| `id` | `string` | 是 | - |  |
| `offGwSync` | `boolean` | 是 | - |  |
| `orderNum` | `number` | 是 | - |  |
| `ruleId` | `string` | 是 | - |  |
| `status` | `boolean` | 是 | - |  |


##### LinkageRule.ruleVO.actions[].executorProperty 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `topic` | `string` | 是 | - |  |
| `customParameters` | `Record<string, any>` | 是 | - |  |


##### LinkageRule.ruleVO.actions[].extraProperty 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `entityName` | `string` | 是 | - |  |
| `iconUrl` | `string` | 是 | - |  |
| `statusDescript` | `string` | 是 | - |  |
| `type` | `string` | 是 | - |  |


##### LinkageRule.ruleVO.conditions[] 的属性

| 属性 | 类型 | 必填 | 默认值 | 描述 |
| --- | --- | --- | --- | --- |
| `attribute` | `number` | 是 | - |  |
| `condType` | `number` | 是 | - |  |
| `devDelMark` | `boolean` | 是 | - |  |
| `enabled` | `boolean` | 是 | - |  |
| `entityId` | `string` | 是 | - |  |
| `entityName` | `string` | 是 | - |  |
| `entitySubIds` | `string` | 是 | - |  |
| `entityType` | `number` | 是 | - |  |
| `expr` | `any[]` | 是 | - |  |
| `exprDisplay` | `"远程开锁 : Unlock"` | 是 | - |  |
| `extraInfo` | `Record<string, any>` | 是 | - |  |
| `handleStrategy` | `string` | 是 | - |  |
| `iconUrl` | `string` | 是 | - |  |
| `id` | `string` | 是 | - |  |
| `orderNum` | `number` | 是 | - |  |
| `ruleId` | `string` | 是 | - |  |
| `serviceProvider` | `string` | 是 | - |  |
| `support` | `number` | 是 | - |  |


### 示例代码

#### 示例

```ts
import { getDoorbellService } from '@ray-js/lock-sdk';
const service = await getDoorbellService();
```