====== React Demo(WebIM)介绍 ======
更新时间:2022-07-15
----
环信即时通讯 WEB 端提供示例应用可供体验。为方便体验,建议使用你自己的 Demo 应用,具体步骤如下:
- 在 [[https://console.easemob.com/user/login|环信即时通讯云 IM 管理后台]] 通过邮箱注册,可以看到默认的 Demo 应用(默认应用是全功能开通的应用);
- 在上图页面 Demo 应用右侧点击 **查看**,选择 **开放注册**;
[[https://docs-im.easemob.com/_detail/ccim/android/quickstart/3.png?id=ccim%3Aandroid%3Aquickstart%3Ademo|{{https://docs-im.easemob.com/_media/ccim/android/quickstart/3.png?w=600&tok=83515c|img}}]]
打开 Demo,点击 **服务器配置**;
将 Demo 的 App Key 填入,点击 **保存配置**;
然后点击 **注册用户** 进行体验。
**注意**
注册模式分两种,开放注册和授权注册。只有开放注册时,才可以客户端注册。
* 开放注册是为了测试使用,正式环境中不推荐使用该方式注册环信账号;
* 授权注册的流程应该是你的应用服务器通过环信提供的 REST API 注册,之后将 token 保存到你的应用服务器或返回给客户端。
===== 代码下载 =====
* 下载源代码:[[https://github.com/easemob/webim|github 源码地址]]
欢迎大家提交 PR 改进和修复 WebIM 中的问题。
===== 运行 WebIM 工程 =====
从 [[https://www.easemob.com/download/im|IM SDK 及 Demo 下载]] 下载 WEB SDK 压缩包,然后解压。解压后在 ''%%demo%%'' 文件夹下,即为 WebIM 的工程目录。
- 初始化安装
* 在 ''%%/demo%%'' 下执行 ''%%npm install%%''
- 运行 Demo
* ''%%cd demo && npm start%%'' http:%%//%%localhost:3001
* ''%%cd demo && HTTPS=true npm start%%'' (webrtc supports HTTPS only) https:%%//%%localhost:3001
===== 主要模块介绍 =====
Demo 中有几大模块
* components —— 项目中定义的组件
* config —— SDK 初始化配置
* containers —— 容器组件,包含 contact, chat, login/regester
* layout —— chat 部分的布局
* selectors —— 缓存数据,优化性能
* utils —— 数据库和工具方法
===== 部分 UI 展示 =====
{{ :ccim:web:quickstart:react_demo.png?1200 |}}