Flutter增强现实实时通信插件ar_rtc_engine的使用

Flutter增强现实实时通信插件ar_rtc_engine的使用

ar_rtc_engine

此 Flutter 插件 是对 anyRTC 音视频 SDK 的封装。

您可以集成此 SDK 以便在您自己的应用程序中快速实现实时通信。

快速开始

参阅 example 目录，这是一个一对一视频聊天的示例。

设备权限

SDK 需要 摄像头 和 麦克风 权限来开始视频通话。

Android

打开 AndroidManifest.xml 文件并且添加必备的权限到此文件中.

<manifest>
    ...
    <uses-permission android:name="android.permission.READ_PHONE_STATE"/>
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.RECORD_AUDIO" />
    <uses-permission android:name="android.permission.CAMERA" />
    <uses-permission android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
    <uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />

    <!-- The SDK requires Bluetooth permissions in case users are using Bluetooth devices. -->
    <uses-permission android:name="android.permission.BLUETOOTH" />
    ...
</manifest>

完整示例代码

以下是一个简单的示例，展示如何使用 ar_rtc_engine 实现一对一视频通话。

示例代码

// example/lib/main.dart
import 'package:flutter/material.dart';
import 'package:ar_rtc_engine/ar_rtc_engine.dart'; // 引入 ar_rtc_engine 插件

void main() => runApp(MyApp());

class MyApp extends StatelessWidget {
  // 这是应用的根部件。
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: VideoCallPage(), // 主页面为视频通话页面
    );
  }
}

class VideoCallPage extends StatefulWidget {
  [@override](/user/override)
  _VideoCallPageState createState() => _VideoCallPageState();
}

class _VideoCallPageState extends State<VideoCallPage> {
  final _engine = RtcEngine(); // 创建 RTC 引擎实例
  String appId = "your_app_id"; // 替换为您的 AnyRTC App ID
  String channelId = "test_channel"; // 通话频道名称
  bool _joined = false; // 是否已加入频道
  bool _isSpeakerOn = true; // 是否开启扬声器

  [@override](/user/override)
  void initState() {
    super.initState();
    initRtcEngine(); // 初始化 RTC 引擎
  }

  Future<void> initRtcEngine() async {
    await _engine.initialize(RtcEngineContext(appId: appId)); // 初始化引擎并设置 App ID
    _engine.enableAudio(); // 启用音频
    _engine.enableVideo(); // 启用视频
    _engine.setChannelProfile(ChannelProfileType.channelProfileLiveBroadcasting); // 设置频道类型
    _engine.startPreview(); // 开始预览
    _engine.setClientRole(role: ClientRoleType.clientRoleBroadcaster); // 设置角色（主播模式）
    _engine.setAudioRoute(_isSpeakerOn ? AudioPlaybackRouteType.audioPlaybackRouteSpeakerphone : AudioPlaybackRouteType.audioPlaybackRouteEarpiece); // 设置默认音频路由
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text('Flutter 视频通话'),
      ),
      body: Stack(
        children: [
          Center(
            child: _joined
                ? RTCVideoView(
                    _engine, // 显示本地视频流
                    objectFit: VideoObjectFit.videoObjectFitCover,
                  )
                : Container(), // 如果未加入频道，不显示视频
          ),
          Positioned(
            bottom: 20,
            left: 20,
            child: ElevatedButton(
              onPressed: () async {
                if (_joined) {
                  await _engine.leaveChannel(); // 离开频道
                  setState(() {
                    _joined = false;
                  });
                } else {
                  await _engine.joinChannel(
                    token: null, // 使用空令牌（需要配置服务器端生成令牌）
                    channelId: channelId,
                    uid: 123, // 用户 ID
                  );
                  setState(() {
                    _joined = true;
                  });
                }
              },
              child: Text(_joined ? '离开频道' : '加入频道'),
            ),
          ),
          Positioned(
            bottom: 20,
            right: 20,
            child: ElevatedButton(
              onPressed: () {
                setState(() {
                  _isSpeakerOn = !_isSpeakerOn; // 切换扬声器状态
                  _engine.setAudioRoute(
                    _isSpeakerOn
                        ? AudioPlaybackRouteType.audioPlaybackRouteSpeakerphone
                        : AudioPlaybackRouteType.audioPlaybackRouteEarpiece,
                  );
                });
              },
              child: Text(_isSpeakerOn ? '扬声器关闭' : '扬声器开启'),
            ),
          ),
        ],
      ),
    );
  }

  [@override](/user/override)
  void dispose() {
    _engine.stopPreview(); // 停止预览
    _engine.leaveChannel(); // 离开频道
    _engine.release(); // 释放资源
    super.dispose();
  }
}