野火IM是专业级即时通讯和实时音视频整体解决方案，由北京野火无限网络科技有限公司维护和支持。
主要特性有：私有部署安全可靠，性能强大，功能齐全，全平台支持，开源率高，部署运维简单，二次开发友好，方便与第三方系统对接或者嵌入现有系统中。详细情况请参考在线文档。
主要包括一下项目：
| GitHub仓库地址(主站) | 码云仓库地址(镜像) | 说明 | 备注 |
|---|---|---|---|
| android-chat | android-chat | 野火IM Android SDK源码和App源码 | 可以很方便地进行二次开发，或集成到现有应用当中 |
| ios-chat | ios-chat | 野火IM iOS SDK源码和App源码 | 可以很方便地进行二次开发，或集成到现有应用当中 |
| pc-chat | pc-chat | 基于Electron开发的PC平台应用 | |
| web-chat | web-chat | Web平台的Demo, 体验地址 | |
| wx-chat | wx-chat | 微信小程序平台的Demo | |
| server | server | IM server | |
| app server | app server | 应用服务端 | |
| robot_server | robot_server | 机器人服务端 | |
| push_server | push_server | 推送服务器 | |
| docs | docs | 野火IM相关文档，包含设计、概念、开发、使用说明，在线查看 |
- 如果大家发现bug，请在GitHub或码云提issue；如果有需求也请给我们提issue。
- 其他问题，请到野火IM论坛进行交流学习
- 关注我们的公众号。我们有新版本发布或者有重大更新会通过公众号通知大家，另外我们也会不定期的发布一些关于野火IM的技术介绍。
我们有核心研发工程师轮流值班处理issue和论坛，会及时处理的，疑难Bug的修改和新需求的开发我们也会尽快解决。
野火Flutter插件，包含即时通讯插件和实时音视频插件，包含Flutter Demo。
进入到项目工程目录下，依次执行下述命令：
cd example && flutter packages get && cd ..cd example/ios/ && pod install && cd ..(仅iOS平台需要)cd example && flutter run
-
在项目的
pubspec.yaml文件依赖配置中，添加如下内容。其中${path_to_imclient}和${path_to_imclient}为 本项目的imclient和rtckit目录。dependencies: flutter: sdk: flutter imclient: path: ${path_to_imclient} rtckit: path: ${path_to_rtckit} -
在项目
android/app/build.gradle文件依赖配置中，添加依赖dependencies { // 将path_to_android_xxx_aars 替换成实际路径，可以使用相对路径，但一定要保证路径是正确的；路径不对的话，会报 ClassNotFoundException // moment 对应的是朋友圈SDK，ptt对应的是对接SDK。仅当购买或者试用这两个功能的用户打开这两个包的引入。 // wfc dep start implementation fileTree(dir: "${path_to_android_client_aars}", include: ["*.aar"]) implementation fileTree(dir: "${path_to_android_avclient_aars}", include: ["*.aar"]) //implementation fileTree(dir: "${path_to_android_moment_aars}", include: ["*.aar"]) //implementation fileTree(dir: "${path_android_ptt_aars}", include: ["*.aar"]) // wfc dep end } -
项目目录下执行
flutter packages get命令。 -
如果有iOS平台，执行
cd example/ios/ && pod install命令。 -
分别运行iOS平台和Android平台。
-
Android 平台，集成音视频的时候，需要在
AndroidManifest.xml入口activity的配置里面添加如下intent-filter<!-- 音视频通话，需要加入下面的 intent-filter--> <intent-filter> <action android:name="${applicationId}.main" /> <category android:name="android.intent.category.DEFAULT" /> </intent-filter>
- 升级插件时，一定要记得同步升级
android_client_aars和android_avclient_aars等aars目录
必须对野火IM有一定认识后才可以顺利使用，建议做到以下几点：
- 仔细阅读野火基础知识，建议最好把文档都看一遍，仔细阅读一遍绝对会物超所值的。
- 仔细查看插件的接口文件
Imclient.dart文件，大概130+个接口，根据接口名称和简单的注释还有参数，了解到具体的功能，这样后面使用时也比较好找。 - 查看插件带的demo应用。demo应用十分不完善，但也基本能反应出使用的方法，如果您有时间可以给我们提PR来完善这个demo。
- 如果您有原生客户端开发经验，可以查看对于客户端的demo，原生客户端demo比较完善。
初始化在应用启动时唯一调用一次即可，参数是各种事件的回调。
Imclient.init(...);
连接需要IM Token，必须在应用服务进行获取token，获取token时必须使用从SDK内获取到的clientId，否则会连接不上。
var clientId = await Imclient.clientId;
// 调用应用服务去IM服务获取token，需要使用从SDK内获取的clientId。得到token后调用connect函数。
Imclient.connect(IM_Host, userId, token);
展示用户的所有会话的列表使用。
Imclient.getConversationInfos([ConversationType.Single, ConversationType.Group, ConversationType.Channel], [0]);
从指定会话获取消息，可以指定消息其实id和获取条目数，实际使用时可以滚动加载。
Imclient.getMessages(conversation, 0, 10);
构造消息内容，把消息发送到指定会话去。
Imclient.sendMessage(conversation, txtMsgContent);
refresh参数表明是否强制从服务器刷新用户信息，函数会返回本地数据库存储用户信息，如果不存在将返回null。refresh为true或者用户信息不存在时会从服务器更新用户信息，如果信息有变化，会通过用户信息变更回调通知。注意仅当单聊会话和用户详情时强制刷新，避免反复refresh调用出现死循环。
Imclient.getUserInfo(userId, refresh:false);
获取群组信息，具有可选参数refresh，refresh的使用方法请参考获取用户信息。
Imclient.getGroupInfo(groupId, refresh:false);
SingleVideoCallView callView = SingleVideoCallView(userId:userId, audioOnly:false);
Navigator.push(context, MaterialPageRoute(builder: (context) => callView));
GroupVideoCallView callView = GroupVideoCallView(groupId: groupId, participants: members);
Navigator.push(context, MaterialPageRoute(builder: (context) => callView),);
实现推送需要客户端和服务端研发配合实现，首先需要掌握野火推送的流程才可以，关于野火推送的知识，在野火推送服务的项目说明上有详细描述，请客户端研发和服务端研发详细阅读。
目前有多种推送方案可选，可以选取手机厂商的推送，也可以选取第三方推送。需要根据您的需求来选取适合您的方案。
客户端集成选取的推送平台的flutter插件，每个推送插件注册成功后，都会返回一个注册ID（或者是其他名称，能够唯一代表当前推送设备的ID），然后调用imclient的下面接口
Imclient.setDeviceToken(pushType, deviceToken);
下载野火推送服务，在此基础上进行二次开发。推送服务会收到IM服务的推送请求，推送请求中有这个pushType和deviceToken及要推送的内容，推送服务根据这些信息找到对应厂商进行推送。
实际上可以选用任意一个或者多个推送服务商，这里给出一个使用个推的介绍。 对接个推
野火在flutter项目上的音视频的实现有2个方案：
- 方案1：使用原生UI，就是把android平台和ios平台的音视频SDK和UI代码全都集成到flutter项目中。这种方案的问题是引入的无关代码太多，且原生UI无法修改，跟flutter互通也很不方便，不利于二次开发。
- 方案2：是使用原生的音视频SDK，但UI层使用dart语言编写，UI和SDK使用flutter插件的方式沟通。这种方案引入的SDK比较小，且修改方便，有利于大家做自定义。
我们在2023.11.29日起，正式采用方案2，同时方案1保留在native-rtc-ui分支。已经使用方案1的用户可以继续使用native-rtc-ui的分支，如果有需求可以切换到master分支去，以后我们的开发重点将会放到master分支上去。
在国外是可以使用callkit的，需要使用callkit时，推送服务需要配置启用callkit。另外客户端这边也需要做一些处理来支持callkit，首先代码中搜索
Rtckit.enableCallkit()把这句话的注释打开。另外打开iOS工程，在应用的依赖库中添加CallKit.framework和PushKit.framework，另外在项目的Signing & Capabilities中添加Background Modes中添加Audio, AirPlay, and Picture in Picture, Voice over IP和Remote Notification（如果找不到请百度一下）。
会话列表
消息界面
联系人列表
发现界面
设置界面
单人视频通话
多人视频通话
- 获取token的过程一定是先从客户端获取clientId，然后应用服务使用clientId和userId参数获取token，返回给当前客户端使用。即token是和客户端绑定的，该token仅能在当前客户端使用。
- 获取用户/群组/频道信息时，都是直接返回本地数据，如果本地没有会返回null且去服务器更新，更新成功后会有eventbus通知。编写UI代码时需要考虑到获取信息为空的可能，并做好监听，以便信息更新能更新UI。
- 展示消息是分批获取的，先获取最新的一部分，然后列表滚动式再加载下一批，以此类推。
- 免费版本音视频需要用到turn服务，上线前请部署自己的turn服务，野火提供开发的带宽比较小无法支持商用。
- IM服务init时可以传入各种事件的回调，另外基本上每个事件都会同时触发EventBus事件通知，当需要某个通知时也可以用EventBus事件，所有事件定义在
imclient.dart文件中，比如ConnectionStatusChangedEvent是连接状态变化事件。其他事件可以在这附近找到。
