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

获取开始

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" />

    <!-- Meta SDK 需要蓝牙权限以支持蓝牙设备 -->
    <uses-permission android:name="android.permission.BLUETOOTH"  android:maxSdkVersion="30"/>

    <!-- 如果项目的目标版本大于30（即Android 12及以上），则需要动态适配蓝牙权限 -->
    <uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
    ...
</manifest>

如果项目的 targetVersion 大于30（即Android 12及以上），则需要在 manifest 中注册权限并动态申请：

private val PERMISSION_REQ_CODE = 10000
private val PERMISSIONS = arrayOf(
    Manifest.permission.BLUETOOTH_SCAN,
    Manifest.permission.BLUETOOTH_CONNECT,
    Manifest.permission.BLUETOOTH_ADVERTISE
)

private fun requestPermissions() {
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.S) {
        ActivityCompat.requestPermissions(this@MainActivity, PERMISSIONS, PERMISSION_REQ_CODE)
    }
}

ProGuard

-keep class co.meta.** {*;}
-keep class org.webrtc.** {*;}

iOS & macOS

打开 Info.plist 文件并添加以下内容：

• Privacy - Microphone Usage Description
• Privacy - Camera Usage Description

在对应的 Value 列中添加描述信息。

Flutter2支持

Null Safety

从 2.0.3 版本开始支持空安全。此版本不向后兼容，您的项目需要迁移到空安全。有关更多信息，请参阅迁移至空安全。

示例代码

以下是使用 meta_rtc_engine 插件的完整示例代码：

import 'dart:async';

import 'package:meta_rtc_engine/rtc_engine.dart';
import 'package:meta_rtc_engine/rtc_local_view.dart' as RtcLocalView;
import 'package:meta_rtc_engine/rtc_remote_view.dart' as RtcRemoteView;
import 'package:flutter/material.dart';
import 'package:permission_handler/permission_handler.dart';

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

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

class _MyAppState extends State<MyApp> {
  bool _joined = false;
  int _remoteUid = null;
  bool _switch = false;

  [@override](/user/override)
  void initState() {
    super.initState();
    initPlatformState();
  }

  // 平台消息是异步的，所以我们初始化在一个异步方法中。
  Future<void> initPlatformState() async {
    // 请求相机、麦克风和存储权限
    await [Permission.camera, Permission.microphone, Permission.storage].request();

    // 创建RtcEngine实例
    var engine = await RtcEngine.create('123');

    // 设置事件处理器
    engine.setEventHandler(RtcEngineEventHandler(
      joinChannelSuccess: (String channel, int uid, int elapsed) {
        print('joinChannelSuccess ${channel} ${uid}');
        setState(() {
          _joined = true;
        });
      },
      userJoined: (int uid, int elapsed) {
        print('userJoined ${uid}');
        setState(() {
          _remoteUid = uid;
        });
      },
      userOffline: (int uid, UserOfflineReason reason) {
        print('userOffline ${uid}');
        setState(() {
          _remoteUid = null;
        });
      },
      error: (ErrorCode errorCode) {
        print('error ${errorCode}');
      },
    ));

    // 启用视频功能
    await engine.enableVideo();
    // 加入频道
    await engine.joinChannel(null, 'meta_test', null, 0);
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
        appBar: AppBar(
          title: const Text('Plugin example app'),
        ),
        body: Stack(
          children: [
            Center(
              child: _switch ? _renderRemoteVideo() : _renderLocalPreview(),
            ),
            Align(
              alignment: Alignment.topLeft,
              child: Container(
                width: 100,
                height: 100,
                color: Colors.blue,
                child: GestureDetector(
                  onTap: () {
                    setState(() {
                      _switch = !_switch;
                    });
                  },
                  child: Center(
                    child: _switch ? _renderLocalPreview() : _renderRemoteVideo(),
                  ),
                ),
              ),
            ),
          ],
        ),
      ),
    );
  }

  Widget _renderLocalPreview() {
    if (_joined) {
      return RtcLocalView.SurfaceView();
    } else {
      return Text(
        '请先加入频道',
        textAlign: TextAlign.center,
      );
    }
  }

  Widget _renderRemoteVideo() {
    if (_remoteUid != null) {
      return RtcRemoteView.SurfaceView(uid: _remoteUid);
    } else {
      return Text(
        '等待远程用户加入',
        textAlign: TextAlign.center,
      );
    }
  }
}