应用开发指南

快速入门

最近更新时间:2021-05-11 09:06:46

腾讯云物联网开发平台为开发者提供一个 Demo 小程序参考,开发者可以按本文档的指引流程部署并体验一个属于自己的 Demo 小程序。Demo 小程序以开源的方式向开发者开放,便于开发者在开发自主品牌小程序时进行参考。在开始之前需完成以下操作:

步骤1:创建项目、产品及设备

本步骤指导您通过物联网开发平台的快速入门功能,创建一个智能灯产品及设备,并运行平台生成的模拟设备 Demo。如需自行创建项目、产品和设备,请参见 产品开发

  1. 登录腾讯云 物联网开发平台控制台,单击【公共实例】或您创建的【标准企业示例】进入项目管理页面。
  2. 单击页面左上角的【快速入门】,进入快速连接设备页面。
  3. 单击【开始使用】进入设备新建界面,按照实际情况填写以下信息:
    快速入门 - 创建项目、产品及设备
    • 项目名称:支持中文、英文、数字、下划线的组合,最多不超过20个字符。
    • 产品名称:支持中文、英文、数字、下划线的组合,最多不超过20个字符。
    • 设备名称:支持英文、数字、下划线的组合,最多不超过48个字符。
  4. 根据您的电脑的操作系统,单击页面下方 Windows、Linux 或 OSX 操作系统的【设备 Demo 下载】。
    快速入门 - 设备 Demo 下载
  5. 然后单击【确定下载】,下载设备 Demo 程序到本地。
  6. 单击【下一步】,根据页面指引运行设备 Demo 程序。运行设备 Demo 程序后,页面显示设备已激活,并显示设备上报的数据。单击【完成】。
  7. 页面提示已成功将设备接入腾讯云物联网开发平台,单击【完成】。

步骤2:获取小程序 AppKey 与 AppSecret

  1. 登录腾讯云 物联网开发平台控制台,选择 步骤1 中创建的项目,进入项目管理页面。
  2. 在左侧菜单中选择【应用开发】,单击【新建应用】,进入新建应用页面。
  3. 填写应用信息。
    应用开发 - 新建应用
    • 应用名称:必填,根据实际业务填写便于识别的应用名称。
    • 备注:非必填,填写应用的备注信息(选填)。
  4. 单击【保存】,页面提示保存成功,回到应用开发页面。
  5. 单击应用列表中应用的名称,进入应用详情页面。
  6. 记录小程序应用下显示的【APP Key】和【APP Secret】。
  7. 在页面下方的关联产品列表中,单击【关联】列的开关,使小程序与 步骤1 中创建的产品关联(开关为开启状态)。
    注意:

    小程序只能对已关联产品下的设备进行绑定、控制等操作。

步骤3:注册、配置小程序

  1. 前往 微信公众平台 注册小程序。
  2. 登录微信公众平台的小程序后台,选择【开发管理】>【开发设置】。
  3. 记录开发者 ID 中显示的【AppID(小程序 ID)】。
  4. 在服务器域名中单击【开始配置】(若曾经配置过则单击【修改】),根据页面指引完成身份确认。
  5. 填写服务器信息。
    微信公众平台小程序后台 - 配置服务器信息
    • request 合法域名https://iot.cloud.tencent.com
    • socket 合法域名wss://iot.cloud.tencent.com
  6. 单击【保存并提交】。
注意:

请务必进行配置!小程序只能与服务器域名列表中指定的域名进行网络通信。若未配置小程序的服务器域名,则小程序不能正常连接到物联网开发平台。在真机预览时若遇到接口出错,请确认此步骤域名是否配置正确。

步骤4:下载、配置 Demo小程序

  1. 前往 qcloud-iotexplorer-appdev-miniprogram-sdk-demo,选择【Code】>【Download ZIP】,下载 Demo小程序代码到本地并解压。
  2. demo/miniprogram/app.js 文件中填写 步骤2 获得的 AppKey。
    const APP_KEY = 'YOUR_APP_KEY_HERE'; // 填写 AppKey
  3. demo/cloudfunctions/login/index.js 文件中填写 步骤2 获得的 AppKey 与 AppSecret。
    const APP_KEY = 'YOUR_APP_KEY_HERE'; // 填写 AppKey
    const APP_SECRET = 'YOUR_APP_SECRET_HERE'; // 填写 AppSecret
  4. 打开命令行,切换到 Demo 代码中的 demo/miniprogram 目录。
  5. 执行以下命令安装依赖。
    npm install
  6. 运行微信开发者工具,在项目列表中单击【+】,进入创建小程序页面,填写项目信息。
    • 项目名称:可自行填写。
    • 目录:选择 Demo 代码中的 demo 目录。
    • AppID:填写 步骤3 获取的 AppID。
  7. 单击界面右下角的【新建】,项目创建完成后,进入微信开发者工具的主界面。选择菜单栏的【工具】>【构建 npm】,构建成功后界面提示完成构建。
    微信开发者工具 - 构建 npm
  8. 选择菜单栏的【项目】>【重新打开此项目】,以加载上一步构建的 npm 依赖。

步骤5:开通云开发并部署云函数

本步骤指导您使用小程序云开发部署登录接口,以支持小程序登录物联网开发平台。关于小程序登录物联网开发平台的更多信息,详情请参见 接入微信登录

说明:

小程序登录物联网开发平台,需要在小程序中获取用户基本信息,并由开发者的后台服务器调用应用端 API 获取 AccessToken。关于应用端 API,请参见 应用端 API 简介微信号注册登录。关于通过小程序 SDK 登录物联网开发平台,请参见小程序 SDK > SDK 初始化

  1. 单击微信开发者工具主界面上方的【云开发】,进入开通小程序云开发页面。
  2. 单击【开通】,进入创建环境页面。
  3. 填写云开发环境名称及环境 ID,单击【确定】。
    微信开发者工具 - 创建云开发环境
  4. 云开发环境创建完成后,自动进入云开发控制台页面。关闭云开发控制台窗口,回到微信开发者工具的主界面。
  5. 单击微信开发者工具主界面上方的【编辑器】,打开文件编辑器。
  6. 右键单击文件列表中的【cloudfunctions】,选择【当前环境】,然后选择上述步骤中创建的云开发环境。
    微信开发者工具 - 选择云开发环境
  7. 展开文件列表中的【cloudfunctions】>【login】,右键单击【login】,选择【创建并部署:云端安装依赖(不上传 node_modules)】,上传完成后界面右上角提示上传云函数 login 成功。
    微信开发者工具 - 创建并部署 login 云函数到云开发

步骤6:编译、运行小程序

  1. 在微信开发者工具的主界面,单击界面上方的【编译】,编译完成后小程序在模拟器中运行(或单击界面上方的【预览】,编译完成后小程序在真机中运行)。
  2. 小程序启动后,进入登录页面。单击【授权登录】>【允许】,登录完成后进入设备列表页面。

步骤7:通过小程序绑定设备

Wi-Fi 配网绑定设备

Wi-Fi 配网绑定设备需要配合真实设备(如 ESP8266 模组)进行操作。关于配网协议与配网流程,详情请参见 配网开发概述。在 Demo 小程序中进行 Wi-Fi 配网的步骤如下:

  1. 在小程序的设备列表页面,选择【添加设备】>【SmartConfig 配网】或【SoftAP 配网】。
  2. 根据页面指引进行设备配网。
    小程序 - Wi-Fi 配网

扫描二维码绑定设备

说明:

物联网开发平台提供的设备二维码可以用于快速绑定真实设备,帮助开发者降低开发难度。量产后为了安全性,将会关闭二维码入口。

  1. 登录腾讯云 物联网开发平台控制台,选择 步骤1 中创建的项目,进入项目管理页面。
  2. 单击【产品开发】,选择 步骤1 中创建的产品,进入产品详情页面。
  3. 单击页面上方的【设备调试】,进入设备调试页面。根据设备类型,按照以下步骤获取设备二维码。
    • 真实设备:在设备列表中单击【二维码】,页面展示设备二维码。
      设备调试 - 获取真实设备二维码
    • 虚拟设备:单击【虚拟设备调试】,进入虚拟设备调试页面,页面展示虚拟设备调试二维码。
      设备调试 - 获取虚拟设备二维码
  4. 在小程序的设备列表页面,选择【添加设备】>【扫码绑定设备】,进入扫码页面。
  5. 扫描控制台页面展示的二维码。扫码成功后小程序提示绑定设备成功。单击【确定】回到设备列表页面,设备列表中显示已绑定的设备。

步骤8:通过小程序控制设备

  1. 小程序进入设备列表页面,单击要控制的设备,进入设备操控页面。

  2. 单击设备属性列表中列出的属性,可以修改对应的设备属性。

说明:

物联网开发平台提供了真实设备在线调试及虚拟设备调试功能,可通过控制台查询设备上报的当前数据、历史通信日志、事件及上下线记录等。具体操作请参见 设备调试

目录