Android 网易云信集成(一)
原创
©著作权归作者所有:来自51CTO博客作者是丹凤呀的原创作品,请联系作者获取转载授权,否则将追究法律责任
网易云信流程与账号管理
关于网易云信的注册还有应用管理就不说了,先说下网易云信的通信流程,只有清楚流程,你才能知道自己要做什么。
先是你的服务器端拿着accid还有其他参数发给网易云信,生成一个token,移动端用户登录后,后端返回给用户token,移动端拿着accid跟token进行登录网易云信,与网易云信做后面其他一系列操作。
通过上面的流程你会不会感觉,你作为移动端想自己登录网易云只能先让后天生成token+用户名呢?并不是这样,几乎所有的做即时通讯的第三方平台(嗯其实我接触过的就环信,网易云、还有容联云,反正这几个都是这样)都会给你提供可直接管理并专门用于测试账号,如下图的账号管理。你设置的密码相当于后台给你的token。
登录
有了账号,先来试试你的登录是否顺利?
manifest
manifest里面提醒下这里注意是修改的 哪个属性的包名,之前看错了直接不回调登录方法了。
<!-- 云信进程间通信provider -->
<!-- android:authorities="{包名}.ipc.provider", 请将com.netease.nim.demo替换为自己的包名 -->
<!--这里看清楚是修改authorities属性,之前看错了结果登录直接不回调了-->
<provider
android:name="com.netease.nimlib.ipc.NIMContentProvider"
android:authorities="com.flyfish.yunxintest.ipc.provider"
android:exported="false"
android:process=":core" />
BaseApplication
就看最基本的登录操作
public class BaseApplication extends Application {
@Override
public void onCreate() {
super.onCreate();
NIMClient.init(this, loginInfo(), options());
// ... your codes
if (NIMUtil.isMainProcess(this)) {
// 注意:以下操作必须在主进程中进行
// 1、UI相关初始化操作
// 2、相关Service调用
}
}
// 如果已经存在用户登录信息,返回LoginInfo,否则返回null即可
private LoginInfo loginInfo() {
return null;
}
// 如果返回值为 null,则全部使用默认参数。
private SDKOptions options() {
SDKOptions options = new SDKOptions();
// 如果将新消息通知提醒托管给 SDK 完成,需要添加以下配置。否则无需设置。
StatusBarNotificationConfig config = new StatusBarNotificationConfig();
config.notificationEntrance = MessageActivity.class; // 点击通知栏跳转到该Activity
config.notificationSmallIconId = R.drawable.ic_launcher_foreground;
// 呼吸灯配置
config.ledARGB = Color.GREEN;
config.ledOnMs = 1000;
config.ledOffMs = 1500;
// 通知铃声的uri字符串
config.notificationSound = "android.resource://com.netease.nim.demo/raw/msg";
options.statusBarNotificationConfig = config;
// 配置保存图片,文件,log 等数据的目录
// 如果 options 中没有设置这个值,SDK 会使用下面代码示例中的位置作为 SDK 的数据目录。
// 该目录目前包含 log, file, image, audio, video, thumb 这6个目录。
// 如果第三方 APP 需要缓存清理功能, 清理这个目录下面个子目录的内容即可。
String sdkPath = Environment.getExternalStorageDirectory() + "/" + getPackageName() + "/nim";
options.sdkStorageRootPath = sdkPath;
// 配置是否需要预下载附件缩略图,默认为 true
options.preloadAttach = true;
// 配置附件缩略图的尺寸大小。表示向服务器请求缩略图文件的大小
// 该值一般应根据屏幕尺寸来确定, 默认值为 Screen.width / 2
options.thumbnailSize = 50;
// 用户资料提供者, 目前主要用于提供用户资料,用于新消息通知栏中显示消息来源的头像和昵称
options.userInfoProvider=new UserInfoProvider() {
@Override
public UserInfo getUserInfo(String account) {
return null;
}
@Override
public String getDisplayNameForMessageNotifier(String account, String sessionId, SessionTypeEnum sessionType) {
return null;
}
@Override
public Bitmap getAvatarForMessageNotifier(SessionTypeEnum sessionType, String sessionId) {
return null;
}
};
return options;
}
}
LoginActivity
public void login(View view) {
account = mUserName.getText().toString();
password = mPassword.getText().toString();
final LoginInfo info = new LoginInfo(account, password); // config...
RequestCallback<LoginInfo> callback =
new RequestCallback<LoginInfo>() {
@Override
public void onSuccess(LoginInfo param) {
// 可以在此保存LoginInfo到本地,下次启动APP做自动登录用
Toast.makeText(getApplicationContext(), "登录成功", Toast.LENGTH_SHORT).show();
}
@Override
public void onFailed(int code) {
Toast.makeText(getApplicationContext(), "登录失败"+code, Toast.LENGTH_SHORT).show();
}
@Override
public void onException(Throwable exception) {
}
};
NIMClient.getService(AuthService.class).login(info)
.setCallback(callback);
}
登录成功,你就可以进一步操作了,不管你是要接入即时通讯还是要接入音视频,第一步总算是很顺利了。如果登录失败,检查下你的appkey是否替换成自己应用的appkey。