English | Chinese

Update time: 2022-08-11

react-native-chat-sdk

Instant messaging connects people wherever they are and allows them to communicate with others in real time. The Agora Chat SDK enables you to embed real-time messaging in any app, on any device, anywhere.

Directory description

├── CHANGELOG.md // Release notes document
├── CONTRIBUTING.md // Contributor documentation
├── LICENSE // License file
├── README.md // Project help documentation
├── README.zh.md // Project help documentation (Chinese version)
├── android // react native SDK android platform folder
├── docs // docs folder
├── example // project built-in demo
├── examples // Independent demo outside the project
├── ios // react native SDK ios platform folder
├── lib // react native SDK generates product folder
├── native_src // react native SDK native source code folder
├── node_modules // react native depends folder, generated by yarn or npm command
├── package.json // react native project management file
├── scripts // react native script folder
├── src // react native source code folder
├── tsconfig.build.json // typescript language build configuration file
├── tsconfig.json // typescript language configuration file
└── yarn.lock // yarn project dependency version configuration file

Project development environment requirements

The requirements are as follows:

• React Native 0.63.4 or above
• NodeJs 16 or above
• Xcode 12.4 or above for iOS application
• Android Studio 4.2 or above for Android application

For details, please refer to the Quick Start demo. Portal

Add SDK to existing application

Open the terminal and go to the existing project folder to add SDK dependencies:

yarn add react-native-chat-sdk

or

npm i --save react-native-chat-sdk

General Usage

Initialization SDK

ChatClient.getInstance()
  .init(
    new ChatOptions({
      appKey: '<your app key>',
    })
  )
  .then(() => {
    console.log('init success');
  })
  .catch((reason) => {
    console.log('init fail:', reason);
  });

Login

ChatClient.getInstance()
  .loginWithAgoraToken('<your account ID>', '<your token>')
  .then((value: any) => {
    console.log(`login success`, value);
  })
  .catch((reason: any) => {
    console.log(`login fail:`, reason);
  });

Others

Please refer to the corresponding example or method description.

quick start

See the Quick Start documentation for details. Portal

For more examples, see here.Portal

Contributors

See Contributor Guide for details. Portal.

Release Notes

See the changelog for details. Portal.

Release type description

See version type description for details. Portal.

Developer Instructions

See developer instructions for details. Portal.

User Instructions

See the User Instructions Portal for details.

License

MIT

Q & A

If you encounter problems, please refer to here. Portal.

References

Official website document address