# 开通并配置声网灵隼物联网服务 (/zh-CN/solutions/iot-apaas/build/setup-and-access/enable-service)
> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).
你需要在控制台中开通并配置灵隼物联网服务。
## 介绍视频 [#介绍视频]
声网推荐你通过视频了解灵隼物联网服务的开通和使用流程：
详细设置见下文。
## 开通与配置步骤 [#开通与配置步骤]
参考以下步骤开通并配置灵隼物联网服务。
### 1. 创建声网项目 [#1-创建声网项目]
参考以下步骤创建一个声网项目并进入项目详情页面。你也可以使用已创建的声网项目，但鉴权模式必须是 **安全模式：APP ID + Token**。
1. 进入声网控制台的[项目管理](https://console.shengwang.cn/)页面。
2. 在**项目管理**页面，点击**创建项目**按钮。
3. 在弹出的对话框内输入项目名称，选择使用的产品/场景，然后选择鉴权模式为**安全模式：APP ID + Token（推荐）**。
4. 点击**创建项目**按钮。新建的项目会显示在**项目管理**页面中。你可以在**项目管理**页面查看项目基本信息，包括 App ID、项目阶段、项目名称、创建日期。
6. 点击**配置**，可以进入项目详情页面，查看和修改 App 证书、项目状态、扩展能力的启用情况等。
### 2. 开通灵隼物联网服务 [#2-开通灵隼物联网服务]
在**项目配置**页面，参考以下步骤开通灵隼物联网服务：
1. 选择**服务配置**栏，找到**灵隼物联网**，点击**启用**开通灵隼服务。
2. 根据产品发行地区选择合适的服务节点，点击**启用**。
:::info
考虑到不同国家区域的政策法规要求，你的所有数据将会存储在选定的服务节点。服务开启后服务节点不可再更改。
:::
### 3. 创建灵隼物联网产品 [#3-创建灵隼物联网产品]
开通灵隼服务后，控制台会自动跳转到**灵隼物联网 - 产品列表**页面。参考以下步骤创建灵隼物联网产品：
1. 点击**产品开发**菜单下的**产品列表**，在右侧找到**创建新产品**按钮并点击。
2. 点击**创建新产品**，输入产品名称、型号、品类、联网方式等信息。点击**提交**创建产品。
3. 在产品列表中会出现你创建的产品。每个产品有一个独有的产品 ID，即 Product Key。
### 4. 选择开发方案 [#4-选择开发方案]
在产品列表中，点击**继续开发**进入方案选型页面。
页面包括以下方案：
- **官方适配智能化方案**：一站式解决方案。你可以基于声网灵隼提供的示例项目，专属设备端 SDK 和客户端 SDK 快速实现所需场景。目前声网灵隼支持针对乐鑫 ESP32-S3 模组和 SigmaStar SSC333E 模组的智能门铃解决方案。详见[智能门铃](/zh-CN/solutions/smart-doorbell)。
- **自定义开发**：自定义开发模式。你可以使用声网提供的通用 SDK 自行实现所需场景，并按需接入声网灵隼云平台的相关服务。你可以根据自己的业务需求选择不同版本的 SDK。自定义开发分为以下方案：
- 全功能方案：使用全功能版本设备端 SDK 和客户端 SDK。
- 全功能版本设备端 SDK：包含呼叫、实时音视频、设备管理、连接认证、上下行消息收发等服务。如果你没有自研的设备管理等模块，声网建议你使用全功能版本 SDK。
- 全功能版本客户端示例项目：用户注册/登录、绑定/解绑设备、Wi-Fi 二维码配网、呼叫、实时音视频等功能。如果你没有自研的设备管理等模块，声网建议你使用全功能版本示例项目。
- 纯呼叫方案：使用纯呼叫版本设备端 SDK 和客户端 SDK。
- 纯呼叫版本设备端 SDK：包含呼叫、实时音视频等服务。你需要自行实现账号管理和设备管理相关逻辑。如果你已有自研的设备管理等模块，声网建议你使用纯呼叫版本 SDK。
- 纯呼叫版本客户端示例项目：呼叫、实时音视频等功能。你需要自行实现账号管理和设备管理相关逻辑。如果你已有自研的设备管理等模块，声网建议你使用纯呼叫版本示例项目。
### 5. 配置开发方案 [#5-配置开发方案]
对于**官方适配智能化方案**，你可以点击具体的硬件型号，并根据界面提示，购买开发板、获取方案详情并查看示例项目。
对于**自定义开发**，你可以选择 **x86 平台方案**或**其他平台方案**：
- 对于 x86 平台方案，你可以在控制台获取 SDK 的下载链接和参考文档链接。
- 对于其他平台方案，你可以按照控制台的说明联系我们获取相关 SDK 包。
### 6. 定义属性 [#6-定义属性]
:::info[信息]
纯呼叫方案不支持属性。如果你使用**纯呼叫方案**进行开发，可以直接跳过该步骤。
:::
1. 点击下一步进入**属性定义**页面。
2. 点击**新增属性**，填入以下字段：
- 属性名称
- 标识符
- 读写权限
- 数据类型
3. 完成后，点击**提交**新增一个属性点。你需要根据产品设计增加相应的属性列表，并在设备端和客户端分别同步实现相应属性值的上报和解析操作。具体可以分别参考设备端和客户端的示例项目。
4. 点击下一步进入**应用配置**页面。
### 7. 获取客户端 Demo [#7-获取客户端-demo]
在**应用配置**页面中选择**应用开发**选项卡，扫码获取客户端 Demo。该 Demo 仅用于灵隼物联网平台能力展示，可以与**步骤 5** 中下载的 SDK 中的设备端示例项目配套测试。
:::warning[注意]
二维码展示的是全功能版本的 Demo，不包括纯呼叫版本。
:::
该 Demo 使用了声网测试专用项目 App ID，目前只支持固定的低功耗门铃设备，你需要在自助开发中选择对应端侧的实现文档，并根据文档指引完成自定义客户端应用开发工作。
### 8. 配置开发参数 [#8-配置开发参数]
在**应用配置**页面中选择**开发者选项**，该页面提供了双向呼叫、云录云存、离线消息推送等服务。选择你需要的灵隼服务并配置相关参数。
#### 配置呼叫服务字段 [#配置呼叫服务字段]
参考以下步骤配置呼叫服务字段。
1. 在 **App Certificate** 字段填入你的 App 证书。获取方法如下：
创建好项目后，你可以参考如下步骤获取项目的 App 证书。
在声网控制台**总览**页面的**项目信息**栏，点击**主要证书**/**次要证书**下面的复制图标，即可获取项目的主次 App 证书。
2. 在 **RESTful API Customer ID** 和 **RESTful API Customer Secret** 字段填入你的客户 ID 和客户密钥。
3. 点击**保存**。
#### 配置消息推送字段 [#配置消息推送字段]
根据你需要覆盖的移动端平台，参考以下步骤配置消息推送字段。
Google
Apple
华为
小米
OPPO
vivo
1. 启用 [FCM 推送服务](https://firebase.google.com/docs/cloud-messaging) 。
2. 配置以下字段：
- FCM SenderID：FCM 推送服务的 sender ID。详见 [About FCM messages](https://firebase.google.com/docs/cloud-messaging/concept-options#senderid)。
- FCM Server Key：FCM 推送服务的 Server Key。详见 [About FCM messages](https://firebase.google.com/docs/cloud-messaging/concept-options#credentials)。
1. 生成 [APNs 客户端 TLS 证书](https://help.apple.com/developer-account/?lang=zh-cn#/dev82a71386a?sub=dev3255f4fb6)。
2. [导出客户端 TLS 身份证书](https://help.apple.com/developer-account/?lang=zh-cn#/dev82a71386a?sub=deveece40199)，获得 `.p12` 身份证书文件。你也可以[创建用于访问服务的私钥
](https://help.apple.com/developer-account/?lang=zh-cn#/devcdfbb56a3) 获得 `.p8` 秘钥文件。 两者择一即可。
3. 对于 `.p12` 证书文件，配置以下字段：
- **Certificate Name**：证书名称。
- **Certificate Secret**：证书秘钥。
- **上传证书**：`.p12` 证书文件。
- **Certificate Type**：证书类型。
- **Bundle ID**：Apple 应用的 bundle ID。
4. 对于`.p8` 秘钥文件，配置以下字段：
- **Certificate Name**：秘钥名称。
- **上传证书**：`.p8` 密钥文件。
- **Key ID**：密钥标识符。
- **Team ID**: Apple 应用的 team ID。
- **Certificate Type**：密钥类型。
- **Bundle ID**：Apple 应用的 bundle ID。
5. 点击**保存**。
1. 启用[华为推送服务](https://developer.huawei.com/consumer/cn/doc/development/HMSCore-Guides/android-config-agc-0000001050170137#section9471122085218)。
2. 配置以下字段：
- **App ID**：在华为应用市场创建应用对应的 APP ID。
- **App Secret**：在华为应用市场创建应用对应的 APP Secret。
- **App Package Name**：Android 应用的包名。
1. 启用[小米消息推送服务](https://dev.mi.com/console/doc/detail?pId=68)。
2. 配置以下字段：
- **App ID**：在小米开放平台创建应用对应的 APP ID。
- **App Secret**：在小米开放平台创建应用对应的 APP Secret。
- **App Package Name**：Android 应用的包名。
1. 启用 [OPPO 推送服务](https://open.oppomobile.com/new/developmentDoc/info?id=10195)。
2. 配置以下字段：
- **App Key**：在 OPPO 开放平台创建应用的 AppKey。
- **Master Secret**：在 OPPO 开放平台创建应用的 MasterSecret。
- **App Package Name**：Android 应用的包名。
1. 启用 [vivo 推送服务](https://dev.vivo.com.cn/documentCenter/doc/281)。
2. 配置以下字段：
- **App Key**：在 vivo 开放平台创建应用的 App Key。详见 [vivo 推送使用指南](https://dev.vivo.com.cn/documentCenter/doc/151)。
- **App Secret**：在 vivo 开放平台创建应用对应的 APP Secret。详见 [vivo 推送使用指南](https://dev.vivo.com.cn/documentCenter/doc/151)。
- **App Package Name**：Android 应用的包名。
控制台配置完成后，你就可以根据选择的开发方案开发你的设备端与客户端 App。
## 发布产品 [#发布产品]
如果你已经完成了设备端和客户端的开发和测试工作，就可以在**产品发布**页面点击**发布产品**将产品发布到生产环境。
:::warning[注意]
产品发布后将被冻结，无法再修改相关参数，但不影响功能使用。因此，请在点击发布按钮前，确认产品已经达到发布状态。如需继续开发和调试，请保持未发布状态。
:::
### 获取产品信息二维码 [#获取产品信息二维码]
:::info[信息]
如果你使用纯呼叫方案进行开发，则无需获取产品信息二维码。
:::
产品信息二维码用于印刷在产品说明书或者产品设备机身上。产品用户通过扫描二维码添加设备。
点击**下载二维码按钮**可以下载高清版本二维码图案，以便复制或者印刷。
### 申请许可证 [#申请许可证]
设备端 SDK 通过 License 对设备鉴权。License 与设备绑定，一个 License 在同一时间只能绑定一个设备。
为方便你测试和体验，灵隼示例项目中默认携带了一个有效期 3 个月的测试 License，且该 License 仅在声网测试 App ID 下有效。License 失效后示例项目将无法使用。如需延长试用时间或使用你自己的 App ID 开发设备端 App，你需要联系 sales@shengwang.cn 申请新的 License。详见[申请和使用 License](/zh-CN/solutions/iot-apaas/build/setup-and-access/license)。