====== 微信小程序介绍 ======
----

环信小程序 SDK 为小程序开发提供一套完整的技术解决方案，在微信小程序的开发环境下，集成 IM 相关的功能更加便捷、高效。扫描下方小程序二维码或者微信二维码可以快速体验环信小程序在线版本。
  
  
  
  
{{:im:applet:gh_3f73f345317e_430.jpg?nolink&220|}}{{:im:applet:gh_3f73f345317e_430_1_.jpg?nolink&220|}}
  
  
  
  
体验版微信小程序，仅包含部分 IM 的常用功能，添加注册后可以立即体验，如需查看具体功能开发请查看

  * [[im:applet:releasenote|微信小程序版本更新日志]]
  * [[https://github.com/easemob/webim-weixin-xcx/releases/tag/v1.0.5|微信小程序v1.0.5版本源码下载]]


===== 功能说明 =====

环信微信小程序 WebIM 在微信生态系统进行优化，功能与微信对接更为流畅：

  - 支持账户注册登录
  - 支持 IM 基本功能收发文本、图片、语音、视频、音频、文件、穿透、扩展消息等
  - 支持客户端与服务端的上下行消息
  - 支持部分群功能
  - 支持个人设置



===== 开发者集成 =====

==== 集成前准备 ====

[[im:000quickstart:10register|注册并创建应用]]

==== 安装 IDE 微信开发者工具 ====

进入微信公众平台的官网下载“开发者工具”，并安装。目前支持 windows 64、windows 32、mac 版本。
  * [[https://mp.weixin.qq.com/debug/wxadoc/dev/index.html|微信开发者文档]]
  * [[https://mp.weixin.qq.com/debug/wxadoc/dev/devtools/download.html?t=201715|“开发者工具”下载地址]]

==== 配置服务器地址 ====

登录微信小程序账户，进入“设置 > 开发设置”页面，配置以下服务器地址：

  * request合法域名   https:%%//%%a1.easemob.com
  * socket合法域名    wss:%%//%%im-api.easemob.com
  * uploadFile合法域名   https:%%//%%a1.easemob.com

==== 将微信小程序 SDK 添加到项目 ====

全新开发，将源码包中 src/sdk 目录下的内容导入进自己的项目包中即可集成使用。如果是基于环信小程序二次开发，可直接将源码导入使用，步骤如下：

  - 打开“微信开发者工具”，使用微信扫一扫授权登录。
  - 选择“本地小程序项目 -> 添加项目”。
  - 填写AppID、项目名称（可自定义）、项目目录（本地代码路径），并点击“添加项目”。

==== 集成调试 ====

可以通过使用服务端与客户端接口对客户端进行调试。

==== 发布小程序 ====

调试成功后，可通过微信后台直接发布自己的小程序应用。

===== 小程序 SDK API 文档 =====
当前小程序文档可参考 WebIM API DOC
  * [[https://webim.easemob.com/sdk/jsdoc/out/connection.html|Web SDK 接口列表]]