react-native-tencent-im-ui 腾讯云即时通信 IM 服务的react-native,使用原生ui版本得sdk

react-native-tencent-im-ui 腾讯云即时通信 IM 服务的react-native,使用原生ui版本得sdk

起因,项目中需要用到基础的im功能(聊天和聊天列表),晚上搜了一圈也没有找到,技术栈已经定好,也只能硬着头皮搞了。

直接给大家分享出来,目前功能简单,如果有简单需求的可以直接使用。

当前基于 TIMSDK UI版本 标准版 5.0.6 @2020.09.18

项目地址:https://github.com/mengyou658/react-native-tencent-im-ui

一、支持功能

  1. 聊天列表功能

  2. 聊天功能

二、待支持的功能

  1. 不支持自定义界面(可以yarn install 后,在node_models/react-native-tencent-im-ui/更改里面的代码或者直接clone项目复制先来粘贴过去改吧,虽然不方便,但是也能实现,一个个封装代码都不够项目成本的)

  2. 离线消息

  3. 用户信息编辑

  4. 加好友

  5. 等等。。。

三、支持版本

react-native 0.60 以上版本

四、如何安装

4.1.安装包

注意需要 --save 参数,react-native会自动link

$ npm install react-native-tencent-im-ui --save

$ yarn add react-native-tencent-im-ui

4.2. link

react-native 0.60以上 使用的autolink,注意需要 --save 参数,react-native会自动link

4.2.1 android 特别处理

  1. 需要在AndroidManifest.xml增加 activity

``

  1. 在你自己的项目中的,android/app/src/main/java/<你的包名>/MainApplication.java 中onCreate()方法中增加如下

@Override

public void onCreate() {

super.onCreate();

SoLoader.init(this, /* native exopackage */ false);

...

// 然后添加这一行,这里很重要,initSdk中使用到这个,初始化必须在主Application中初始化,否则会出现线程错误问题

IMApplication.setContext(this,  MainActivity.class);

...

}

  1. demo 中增加的有华为push的示例(使用的低版本的push,高版本的总是提示安装hms-core,有点烦),完整的请参考腾讯im-sdk内的demo

4.2.2 ios 特别处理

  1. 在你自己的项目中的,AppDelegate.m

...

// 引入头文件

#import "ConversationController.h"

...

// 方法 didFinishLaunchingWithOptions 中修改

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions

...

// 下面一行更改为

// self.window.rootViewController = rootViewController;

UINavigationController *nv = [[UINavigationController alloc] initWithRootViewController:rootViewController];

nv.navigationBar.hidden = YES;

nv.delegate = self;

self.window.rootViewController = nv;

ConversationController *c = [ConversationController getInstance];

[c initNc: nv];

...

五、示例 请参考 demo 文件夹

android demo 截图

ios demo 截图(同上,忘记截图了)

六、接口


/**

* 初始化

* @param sdkAppId

*/

export function TIMInitSdk(sdkAppId);

/**

* 登录

* @param userId 用户id

* @param userSig 用户sig

* @returns {*|PromiseLike<*>|Promise<*>}

*/

export function TIMLogin(userId, userSig);

/**

* 登出

* @returns {Promise<*>}

*/

export async function TIMLogout();

/**

* 从其他界面跳转到聊天界面

* @param userId im用户id

* @param conTitle 聊天标题

* @param type:

*  1 = 用户会话

*  2 = 分组会话

*/

export function TIMStartChat(userId, conTitle, type = 1);

七、使用示例

先初始化


import {TIMConversationModel, TIMInitSdk, TIMLogin, TIMLogout, TIMStartChat} from 'react-native-tencent-im-ui';

// 先初始化

TIMInitSdk(sdkAppId);

调用登录


import {TIMConversationModel, TIMInitSdk, TIMLogin, TIMLogout, TIMStartChat} from 'react-native-tencent-im-ui';

// 调用登录

TIMLogin(userId, userSig).then(res=>{

  console.log(res);

}).catch(e => {

});

从其他界面跳转打开会话


import {TIMConversationModel, TIMInitSdk, TIMLogin, TIMLogout, TIMStartChat} from 'react-native-tencent-im-ui';

// 从其他界面跳转打开会话

TIMStartChat(userId, "xxx聊天", 1);

展示聊天列表界面


// 展示聊天列表界面

import {TIMConversationModel, TIMInitSdk, TIMLogin, TIMLogout, TIMStartChat} from 'react-native-tencent-im-ui';

import React from "react";

import {

SafeAreaView,

StatusBar,

} from 'react-native';

export default class Conversation extends React.Component{

render() {

return

}

}

参考鸣谢项目

  1. https://github.com/yz1311/react-native-txim/

  2. https://github.com/kurisu994/react-native-txim

你可能感兴趣的:(react-native-tencent-im-ui 腾讯云即时通信 IM 服务的react-native,使用原生ui版本得sdk)