使用腾讯云云通信IM的微信小程序入门指南（一）
IMSDK小程序demo运行
建议看这个https://gitee.com/cloudtencent/TIMSDK/tree/master/WXMini
本 IM 小程序 demo 是基于 MpVue 框架进行开发的。一分钟跑通 demo 小节只是用于引导您打开编译后的文件进行快速预览，如果您想要进行二次开发，请看开发运行小节。
一分钟跑通demo
-
克隆仓库到本地
# 命令行执行 git clone https://github.com/tencentyun/TIMSDK.git # 进入小程序 Demo 项目 cd TIMSDK/WXMini 安装微信小程序 开发者工具。
-
使用微信开发者工具导入项目，请注意目录为
/dist/wx，然后填入自己的小程序 AppID。[图片上传失败...(image-aadd6a-1584674697398)]
-
配置
SDKAPPID和SECRETKEY，获取方式参考：密钥获取方法打开
/debug/GeneraterUserSig.js文件按图示填写相应配置后，保存文件
[图片上传失败...(image-c47d46-1584674697398)]
-
本地配置如下图所示
- 勾选ES6转ES5选项
- 勾选不检验合法域名选项
- 基础库版本 > 2.1.1
[图片上传失败...(image-aa700e-1584674697398)]
-
点击编译即可运行
[图片上传失败...(image-3851a0-1584674697398)]
注意事项
合法域名
如果您要发布小程序，请将以下域名在【微信公众平台】>【开发】>【开发设置】>【服务器域名】中进行配置
进入微信公众平台，在小程序开发的服务器域名配置相关域名信息
添加到 request 合法域名：
域名 说明 是否必须 https://webim.tim.qq.comWeb IM 业务域名 必须 https://events.tim.qq.comWeb IM 业务域名 必须 https://yun.tim.qq.comWeb IM 业务域名 必须 https://grouptalk.c2c.qq.comWeb IM 业务域名 必须 https://pingtas.qq.comWeb IM 统计域名 必须 添加到 uploadFile 合法域名：
域名 说明 是否必须 https://cos.ap-shanghai.myqcloud.com文件上传域名 必须 添加到 downloadFile 合法域名：
域名 说明 是否必须 https://cos.ap-shanghai.myqcloud.com文件下载域名 必须 [图片上传失败...(image-69f38f-1584674697398)]
开发运行
项目目录
├───sdk/ - 存放tim-wx.js，demo 中未使用，仅供自行集成
├───build/
├───config/
├───dist/
│ └───wx/ - MpVue 项目编译后文件目录，使用小程序开发工具导入此文件夹
├───src/
│ ├───components/ - 组件
│ ├───pages/ - 页面
│ ├───store/ - Vuex 目录
│ ├───stylus/ - 全局主题色样式，可以修改全局颜色
│ ├───utils/ - 方法
│ ├───app.json
│ ├───App.vue
│ └───main.js
├───static/ - 静态依赖资源
│ ├───debug/ - 包含 userSig 验证登录方法
│ ├───images/ - 图片
│ └───iview/ - 使用的 iview 组件
├───_doc/
├───.babelrc
├───.editorconfig
├───.eslintignore
├───.eslintrc.js
├───.postcssrc.js
├───index.html
├───package-lock.json
├───package.json
├───project.config.json
└───README.md
准备工作
获取到您应用的
SDKAPPID和SECRETKEY，方式参考：密钥获取方法安装微信小程序 开发者工具
-
安装 nodejs 环境 ( Version > 8 ) ，选择合适您安装环境的安装包
- 安装后，在命令行输入
node --version，如果 > 8 即可
- 安装后，在命令行输入
启动流程
-
克隆仓库到本地
# 命令行执行 git clone https://github.com/tencentyun/TIMSDK.git # 进入 Demo 项目 cd TIMSDK/WXMini -
将
project.config.json文件中的appid修改为自己微信小程序的appid[图片上传失败...(image-3a09d2-1584674697398)]
-
配置
SDKAPPID和SECRETKEY，获取方式参考：密钥获取方法打开
/static/utils/GeneraterUserSig.js文件按图示填写相应配置后，保存文件
[图片上传失败...(image-62009b-1584674697398)]
-
安装依赖并启动
# 安装demo构建和运行所需依赖 npm install # 构建并生成最终可在小程序开发工具内使用的代码 npm run start使用
npm install命令，如果有些依赖包无法成功安装您可以试着切换源， 例如：
npm config set registry http://r.cnpmjs.org/然后再执行
npm install -
使用微信开发者工具导入项目，目录为
/dist/wx[图片上传失败...(image-173f46-1584674697398)]
-
本地配置如下图所示
- 勾选ES6转ES5选项
- 勾选不检验合法域名选项
- 基础库版本 > 2.1.1
[图片上传失败...(image-30d7b2-1584674697398)]
-
点击开发工具的编译即可预览该项目
[图片上传失败...(image-c13d1d-1584674697398)]
注意事项
合法域名
如果您要发布小程序，请将以下域名在【微信公众平台】>【开发】>【开发设置】>【服务器域名】中进行配置
进入微信公众平台，在小程序开发的服务器域名配置相关域名信息
添加到 request 合法域名：
域名 说明 是否必须 https://webim.tim.qq.comWeb IM 业务域名 必须 https://events.tim.qq.comWeb IM 业务域名 必须 https://yun.tim.qq.comWeb IM 业务域名 必须 https://grouptalk.c2c.qq.comWeb IM 业务域名 必须 https://pingtas.qq.comWeb IM 统计域名 必须 添加到 uploadFile 合法域名：
域名 说明 是否必须 https://cos.ap-shanghai.myqcloud.com文件上传域名 必须 添加到 downloadFile 合法域名：
域名 说明 是否必须 https://cos.ap-shanghai.myqcloud.com文件下载域名 必须 [图片上传失败...(image-50d735-1584674697398)]
项目截图
[图片上传失败...(image-e70b7c-1584674697398)]
备注
页面结构
目录 /src/pages
| 页面 | 简介 |
|---|---|
| login/ | 登录页 |
| index/ | 首页，对话列表 |
| chat/ | 聊天对话页 & 群信息/用户信息 |
| contact/ | 通讯录 |
| own/ | 个人信息 |
| create/ | 创建群聊 |
| members/ | 群成员 |
| profile/ | 修改个人信息 |
| groups/ | 群列表 |
| groupDetail/ | 群详细页 |
| system/ | 系统通知页 |
| blacklist/ | 黑名单页 |
| detail/ | 个人信息&群信息 |
| friend/ | 发起会话 |
| mention/ | @选择页 |
注意事项
1. 避免在前端进行签名计算
本 Demo 为了用户体验的便利，将 userSig 签发放到前端执行。若直接部署上线，会面临 SECRETKEY 泄露的风险。正确的 userSig 签发方式是将 userSig 的计算代码集成到您的服务端，并提供相应接口。在需要 userSig 时，发起请求获取动态 userSig。更多详情请参见 服务端生成 UserSig。
Change Log
2019/11/21
Feat Add
- 小程序支持发送视频消息
2019/10/17
Feat Add
- 增加视频消息的解析
- 增加语音消息的发送
2019/10/12
Bug Fixes
- 修复 React 框架下发图片消息失败的问题
2019/09/21
Bug Fixes
- 修复收到新群系统通知事件名不正确的问题
2019/09/06
Bug Fixes
- 修复 IE 下超长文本消息的显示超出会话框的问题
- 修复重发消息失败时无错误提示的问题
2019/09/05
Bug Fixes
- 修复预览图片时，图片显示不正确的问题
- 修复点击群组列表时，群成员列表不更新的问题
- 解决修改个人资料时，报错的问题