Flutter实时音视频通信插件agora_rtm的使用

发布于 1周前 作者 h691938207 来自 Flutter

Flutter实时音视频通信插件agora_rtm的使用

AgoraRtm

这个Flutter插件是Agora RTM SDK的封装。Agora.io提供了构建块，使您可以通过简单而强大的SDK在应用程序中添加实时消息传递功能。你可以集成Agora RTM SDK以快速启用应用程序中的实时消息传递。

Pub.dev likes Pub.dev points
latest version Platform License RTE Dev Slack Link

注意：main分支基于Agora RTM SDK 2.x进行了主要更新，引入了一些破坏性更改。之前的版本请参见以下分支（版本<2.x）：

使用方法

要使用此插件，请将agora_rtm作为依赖项添加到您的pubspec.yaml文件中。

快速开始

查看example目录，了解使用AgoraRtm的示例应用。

反馈

如果您对示例项目有任何问题或建议，可以随时提交issue或拉取请求。对于紧急问题，请向Agora Support提交工单以获得及时响应。

如何贡献

要帮助开发此SDK，请参考我们的贡献指南。

示例代码

以下是使用agora_rtm插件的一个完整示例demo：

import 'package:agora_rtm_example/src/rtm_api_demo.dart';
import 'package:flutter/material.dart';
import 'dart:async';

import 'src/log_sink.dart';

void main() {
  FlutterError.onError = (details) {
    FlutterError.presentError(details);
    logSink.log(details.toString());
  };

  // 错误处理
  runZonedGuarded(() {
    runApp(const MyApp());
  }, (error, stackTrace) {
    logSink.log(error.toString());
  });
}

class MyApp extends StatefulWidget {
  const MyApp({super.key});

  @override
  State<MyApp> createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  @override
  void initState() {
    super.initState();
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('RTM example app'),
          actions: const [LogActionWidget()],
        ),
        body: const RtmApiDemo(),
      ),
    );
  }
}

示例代码说明

  • 错误处理：通过runZonedGuarded捕获未被捕获的异常，并记录日志。
  • 主界面：MyApp类定义了应用程序的入口点，_MyAppState类实现了状态管理。
  • UI布局：包含一个AppBar和一个body，其中body显示RtmApiDemo组件，用于展示RTM API的功能。

希望以上内容能够帮助你更好地理解和使用agora_rtm插件。如果你有任何问题或需要进一步的帮助，请随时提问！


更多关于Flutter实时音视频通信插件agora_rtm的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html

Harmonyos Next教程
1 回复

更多关于Flutter实时音视频通信插件agora_rtm的使用的实战系列教程也可以访问 https://www.itying.com/category-92-b0.html


当然，下面是一个关于如何在Flutter中使用Agora RTM（实时消息）插件的简单示例。这个示例展示了如何初始化Agora RTM、加入频道、发送和接收消息。

首先，确保你已经安装了agora_rtm插件。在你的pubspec.yaml文件中添加以下依赖：

dependencies:
  flutter:
    sdk: flutter
  agora_rtm: ^x.y.z  # 请替换为最新版本号

然后，运行flutter pub get来安装依赖。

接下来，我们编写Flutter代码。

1. 初始化Agora RTM

在你的Flutter应用的入口文件（通常是main.dart）中，初始化Agora RTM客户端。

import 'package:flutter/material.dart';
import 'package:agora_rtm/agora_rtm.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatefulWidget {
  @override
  _MyAppState createState() => _MyAppState();
}

class _MyAppState extends State<MyApp> {
  late RtmClient _client;
  late RtmChannel _channel;
  String _channelName = "testChannel";
  String _appId = "your_agora_app_id";  // 替换为你的Agora App ID
  String _token = "";  // 如果需要Token认证，请替换为实际的Token

  @override
  void initState() {
    super.initState();
    initRtmClient();
  }

  void initRtmClient() async {
    _client = await RtmClient.create(_appId);
    _client.onError = (errorCode, errorMessage) {
      print("RtmClient Error: $errorCode, $errorMessage");
    };

    // 初始化完成后，可以加入频道
    joinChannel();
  }

  void joinChannel() async {
    _channel = await _client.joinChannel(_token, _channelName, null);
    _channel.onMessageReceived = (userId, message, messageInfo) {
      print("Received message from $userId: $message");
    };

    // 你可以在这里添加更多的频道事件监听，例如成员加入、离开等
  }

  void sendMessage(String message) {
    _channel.sendMessage(message);
  }

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: Text('Agora RTM Demo'),
        ),
        body: Center(
          child: Column(
            mainAxisAlignment: MainAxisAlignment.center,
            children: <Widget>[
              TextField(
                decoration: InputDecoration(labelText: 'Message'),
                onSubmitted: (message) {
                  sendMessage(message);
                },
              ),
            ],
          ),
        ),
      ),
    );
  }

  @override
  void dispose() {
    _channel?.leave();
    _client?.destroy();
    super.dispose();
  }
}

2. 发送消息

在上面的代码中，我们已经在TextField的onSubmitted回调中调用了sendMessage方法。当用户提交输入框中的内容时，消息将被发送到RTM频道。

3. 接收消息

我们在joinChannel方法中设置了_channel.onMessageReceived回调，用于接收来自其他用户的消息。每当收到消息时，都会在控制台中打印出消息内容。

注意事项

  1. Agora App ID：确保你替换了your_agora_app_id为你的实际Agora App ID。
  2. Token：如果你的应用需要Token认证，请确保你替换了_token变量。
  3. 权限：在Android和iOS项目中，确保你已经配置了必要的网络权限。

这是一个非常基础的示例，实际项目中你可能需要处理更多的错误处理、UI更新以及频道管理等。希望这个示例能帮助你快速上手Agora RTM在Flutter中的使用。

回到顶部