# BLEPeripheralServer.addService(Object object)

> 基础库 2.10.3 开始支持，低版本需做[兼容处理](1003706)。

> __以 [Promise 风格](/miniprogram/dev/framework/app-service/api.md#异步-API-返回-Promise) 调用__：不支持
> 
> __小程序插件__：不支持
> 
> __微信 鸿蒙 OS 版__：支持

> 相关文档: [蓝牙介绍](/minigame/dev/guide/device/bluetooth.md)

## 功能描述

添加服务。

## 参数

### Object object


```json
[
  {
    "属性": "service",
    "类型": "Object",
    "默认值": "",
    "必填": "是",
    "说明": "描述service的Object",
    "子项": [
      {
        "结构属性": "uuid",
        "类型": "String",
        "默认值": "",
        "必填": "是",
        "说明": "蓝牙服务的 UUID"
      },
      {
        "结构属性": "characteristics",
        "类型": "Array.<Object>",
        "默认值": "",
        "必填": "是",
        "说明": "characteristics列表",
        "子项": [
          {
            "结构属性": "uuid",
            "类型": "String",
            "默认值": "",
            "必填": "是",
            "说明": "characteristic 的 UUID"
          },
          {
            "结构属性": "properties",
            "类型": "Object",
            "默认值": "",
            "必填": "否",
            "说明": "特征支持的操作",
            "子项": [
              {
                "结构属性": "write",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "写"
              },
              {
                "结构属性": "writeNoResponse",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "无回复写"
              },
              {
                "结构属性": "read",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "读"
              },
              {
                "结构属性": "notify",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "订阅"
              },
              {
                "结构属性": "indicate",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "回包"
              }
            ]
          },
          {
            "结构属性": "permission",
            "类型": "Object",
            "默认值": "",
            "必填": "否",
            "说明": "特征权限",
            "子项": [
              {
                "结构属性": "readable",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "可读"
              },
              {
                "结构属性": "writeable",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "可写"
              },
              {
                "结构属性": "readEncryptionRequired",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "加密读请求"
              },
              {
                "结构属性": "writeEncryptionRequired",
                "类型": "Boolean",
                "默认值": "false",
                "必填": "否",
                "说明": "加密写请求"
              }
            ]
          },
          {
            "结构属性": "value",
            "类型": "ArrayBuffer",
            "默认值": "",
            "必填": "否",
            "说明": "特征对应的二进制值"
          },
          {
            "结构属性": "descriptors",
            "类型": "Array.<Object>",
            "默认值": "",
            "必填": "否",
            "说明": "描述符数据",
            "子项": [
              {
                "结构属性": "uuid",
                "类型": "String",
                "默认值": "",
                "必填": "是",
                "说明": "Descriptor 的 UUID"
              },
              {
                "结构属性": "permission",
                "类型": "Object",
                "默认值": "",
                "必填": "否",
                "说明": "描述符的权限",
                "子项": [
                  {
                    "结构属性": "write",
                    "类型": "Boolean",
                    "默认值": "false",
                    "必填": "否",
                    "说明": "写"
                  },
                  {
                    "结构属性": "read",
                    "类型": "Boolean",
                    "默认值": "false",
                    "必填": "否",
                    "说明": "读"
                  }
                ]
              },
              {
                "结构属性": "value",
                "类型": "ArrayBuffer",
                "默认值": "",
                "必填": "否",
                "说明": "描述符数据"
              }
            ]
          }
        ]
      }
    ]
  },
  {
    "属性": "success",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用成功的回调函数"
  },
  {
    "属性": "fail",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用失败的回调函数"
  },
  {
    "属性": "complete",
    "类型": "function",
    "默认值": "",
    "必填": "否",
    "说明": "接口调用结束的回调函数（调用成功、失败都会执行）"
  }
]
```