Flutter插件omnitalk_sdk_test的介绍与使用

概述

Omnitalk 是一个基于 webRTC 技术实现的实时通信 SDK，可以轻松地在应用程序中实现语音、视频通话以及聊天等功能。本文将详细介绍如何在 Flutter 中使用 omnitalk_sdk_test 插件来实现这些功能。

特性概览

以下表格展示了 Omnitalk 提供的主要功能及其在不同平台上的支持情况：

使用前准备

1. 获取服务 ID 和服务密钥

• 登录 OmniTalk 官网 并注册账号。
• 在控制台中创建应用并获取服务 ID 和服务密钥。
• 或者，您可以从 这里 获取免费试用的测试 ID 和密钥（有效期一小时）。

2. 系统最低要求

• Flutter >= 3.1.0
• Dart >= 2.19
• Android API >= 21
• iOS >= 11

快速入门

1. 添加依赖

在 pubspec.yaml 文件中添加 omnitalk_sdk_test 插件：

dependencies:
  omnitalk_sdk_test: ^版本号

然后运行以下命令安装依赖：

flutter pub get

2. 初始化 OmniTalk 对象

// 导入 omnitalk_sdk_test 包
import 'package:omnitalk_sdk_test/omnitalk_sdk.dart';

void main() async {
  // 初始化 OmniTalk SDK
  Omnitalk.sdkInit(serviceId: '您的服务ID', serviceKey: '您的服务密钥');

  // 创建 OmniTalk 实例
  Omnitalk omnitalk = Omnitalk.getInstance();
}

3. 创建会话

// 创建用户会话
await omnitalk.createSession(userId: '您的用户ID');

4. 创建房间

// 创建指定类型的房间
await omnitalk.createRoom(roomType: RoomType.videoroom);

5. 加入房间

// 加入房间
await omnitalk.joinRoom(roomId: '房间ID');

// 加入房间后会自动开始音频广播，并允许发送和接收聊天消息

6. 开始视频广播

// 准备本地视频渲染器
final localVideo = VideoRenderer(); 

// 开始视频广播
await omnitalk.publish(localRenderer: localVideo);

7. 接收事件消息

// 监听事件消息
omnitalk.on('event', (event) {
  print('接收到事件: $event');
});

8. 订阅广播

// 订阅其他用户的广播
await omnitalk.subscribe(
  publisherSession: '发布者的会话ID',
  remoteRenderer: VideoRenderer(),
);

9. 实现一对一语音通话

// 发起语音呼叫
await omnitalk.offerCall(
  callType: CallType.audiocall,
  callee: '被叫方的用户ID',
);

// 接听语音呼叫
await omnitalk.answerCall();

10. 实现一对一视频通话

// 发起视频呼叫
await omnitalk.offerCall(
  callType: CallType.videocall,
  callee: '被叫方的用户ID',
  record: false, // 是否录制
  localRenderer: VideoRenderer(), // 本地视频渲染器
  remoteRenderer: VideoRenderer(), // 远程视频渲染器
);

// 接听视频呼叫
await omnitalk.answerCall(
  callType: CallType.videocall,
  caller: '主叫方的用户ID',
  localRenderer: VideoRenderer(),
  remoteRenderer: VideoRenderer(),
);

11. 发送聊天消息

// 发送聊天消息
await omnitalk.sendMessage(
  action: MessageAction.send,
  message: 'Hello!',
);

12. 结束广播

// 离开房间或结束广播
await omnitalk.leave();