react-native-tencent-im-ui

1.1.3 • Public • Published

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

    <activity android:name="com.yunchao.tencentim.activity.ChatActivity" />

  2. 在你自己的项目中的,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);
    
    ...
    
    }
    
  3. 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 <SafeAreaView style={{flex:1, paddingTop: (Platform.OS === 'ios' ?  10 : StatusBar.currentHeight)}}>

      <TIMConversationModel style={{ flex: 1 }}  {...this.props} />

}

}

参考鸣谢项目

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

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

Package Sidebar

Install

npm i react-native-tencent-im-ui

Weekly Downloads

0

Version

1.1.3

License

ISC

Unpacked Size

128 kB

Total Files

50

Last publish

Collaborators

  • mengyou