nim_fluttify 0.1.5

A `网易云信` flutter plugin, Powered by `Fluttify` engine.

网易云信 Flutter插件

专业版为付费插件, 如有需要请联系qq 382146139

专业版为付费插件, 如有需要请联系qq 382146139

专业版为付费插件, 如有需要请联系qq 382146139

依赖

dependencies:
  flutter:
    sdk: flutter
  nim_fluttify: ^x.x.x

配置

Android

1. 在AndroidManifest.xml的application标签下配置app key:

<application>
    <meta-data
            android:name="com.netease.nim.appKey"
            android:value="6cxxxxxxxxxxxxxxxxxxxxxxxxxx9e" />
</application>

2. 由于SDK限制, 必须在Application中初始化, 所以需要重新指定Application的实现类, 需要用户继承FlutterApplication并重写onCreate方法, 然后在AndroidManifest.xml中配置自己实现的Application, 示例实现:

import com.netease.nimlib.sdk.NIMClient;
import com.netease.nimlib.sdk.SDKOptions;

public class NIMApplication extends FlutterApplication {
    @Override
    @CallSuper
    public void onCreate() {
        super.onCreate();
        SDKOptions options = new SDKOptions();
        NIMClient.config(this, null, options);
    }
}

最终的AndroidManifest.xml中, 至少需要包含如下信息:

<application android:name="NIMApplication">
    <meta-data
            android:name="com.netease.nim.appKey"
            android:value="6cxxxxxxxxxxxxxxxxxxxxxxxxxx9e" />
</application>

3. 云信最低支持minSdk为17, Flutter默认为16, 所以需要修改app/build.gradle下的minSdkVersion为17.

android {
    defaultConfig {
        minSdkVersion 17 // 原本为16, 改为17
    }
}

4. AndroidManifest.xml不需要用户再声明权限和官方提及的组件, 已经在插件中声明;
5. 不需要再配置混淆规则, 已在插件中配置混淆规则;

iOS

1. 选择图片时需要配置访问相册的权限, 在Info.plist中添加相册权限:

<key>NSPhotoLibraryUsageDescription</key>
<string>需要相册权限</string>

2. Flutter默认的最低支持版本是iOS 8.0, 云信的最低支持版本是iOS 9.0. 所以需要更改Podfile:

# Uncomment this line to define a global platform for your project
# platform :ios, '9.0'

改为(即去掉注释)

# Uncomment this line to define a global platform for your project
platform :ios, '9.0'

导入

import 'package:nim_fluttify/nim_fluttify.dart';

使用

插件的主要类为Nim类, Nim类为单例, 调用时使用Nim.instance.xxx来使用. 具体请参考wiki.

社区

QQ2群	QQ1群(已满)
加入QQ群讨论	加入QQ群讨论

社区版与专业版

登录登出	社区版	专业版
登录	✅	✅
登出	✅	✅
在线状态监听	✅	✅

消息收发	社区版	专业版
消息监听	✅	✅
发送文字消息	✅	✅
发送图片消息	✅	✅
发送音频消息	✅	✅
发送视频消息	✅	✅
发送文件消息	✅	✅
发送位置消息	✅	✅
发送自定义消息	✅	✅

用户关系托管	社区版	专业版
获取我的好友列表	✅	✅
获取免打扰列表	✅	✅
请求添加好友	✅	✅
删除好友	✅	✅
处理添加好友申请(同意/拒绝)	✅	✅
判断用户是好友	✅	✅
加入黑名单	✅	✅
移出黑名单	✅	✅
判断用户是否在黑名单	✅	✅
判断用户是免打扰	✅	✅
获取黑名单列表	✅	✅
是否接收用户[account]的消息	✅	✅

聊天室	社区版	专业版
进入聊天室	✅	✅
退出聊天室	✅	✅
获取聊天室信息	✅	✅
聊天室状态监听	✅	✅
聊天室踢出状态监听	✅	✅

最近会话	社区版	专业版
获取会话列表	✅	✅

历史记录	社区版	专业版
查询消息历史	✅	✅

用户资料托管	社区版	专业版
获取用户资料	☑️	✅

系统消息	社区版	专业版
系统消息监听	☑️	✅

群组	社区版	专业版
创建群组	☑️	✅
设置群聊消息提醒类型	☑️	✅
获取所有的群组	☑️	✅
查询群组资料	☑️	✅
踢人出群	☑️	✅
主动退群	☑️	✅
解散群	☑️	✅
获取群组成员列表	☑️	✅
查询被禁言群成员	☑️	✅
移除管理员	☑️	✅
提升管理员	☑️	✅
根据群 ID 和成员帐号获取群成员	☑️	✅
群成员禁言	☑️	✅
群整体禁言	☑️	✅
验证入群申请	☑️	✅
接受入群邀请	☑️	✅
拒绝入群邀请	☑️	✅
邀请加入群组	☑️	✅
转让群组	☑️	✅
用户申请加入群	☑️	✅

LICENSE

Copyright (C) 2020 yohom

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with this program. If not, see https://www.gnu.org/licenses/.