Flutter视频通话插件call_video的使用

Flutter视频通话插件call_video的使用

开始使用

可以从以下示例文件夹获取一些基本和高级示例：

• 示例文件夹

隐私权限

Call Video SDK 需要 Camera 和 Microphone 权限才能开始视频通话。

Android

查看 AndroidManifest.xml 文件中的所需设备权限：

<manifest>
  ...
  <uses-permission android:name="android.permission.READ_PHONE_STATE" />
  <uses-permission android:name="android.permission.NFC" />
  <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" />
  <uses-permission android:name="android.permission.BLUETOOTH" />
  <uses-permission android:name="android.permission.ACCESS_WIFI_STATE" />
  <uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE" />
  <uses-permission android:name="android.permission.WAKE_LOCK" />
  <uses-permission android:name="android.permission.READ_PRIVILEGED_PHONE_STATE"
    tools:ignore="ProtectedPermissions" />
  ...
</manifest>

在您的 android/app/build.gradle 文件中将最低 Android SDK 版本更改为 26 或更高版本：

minSdkVersion 26

iOS

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

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

并在相应的 Value 列中添加描述。例如：

<key>Privacy - Microphone Usage Description</key>
<string>我们需要访问您的麦克风来完成视频通话。</string>

<key>Privacy - Camera Usage Description</key>
<string>我们需要访问您的摄像头来完成视频通话。</string>

<key>Privacy - NFCReaderUsageDescription</key>
<string>我们需要访问您的NFC读取器。</string>

<key>com.apple.developer.nfc.readersession.iso7816.select-identifiers</key>
<array>
  <string>A0000002471001</string>
  <string>A0000002472001</string>
  <string>00000000000000</string>
</array>

如何贡献

要帮助开发此 SDK，请参阅 CONTRIBUTING.md。

许可证

该项目受 MIT 许可证保护。

示例代码

以下是完整的示例代码：

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

void main() => runApp(const MyHomePage());

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

  [@override](/user/override)
  State<MyHomePage> createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  late CallVideoController callVideoController;
  bool _localUserJoined = false;
  bool _remoteUserJoined = false;

  /// TODO 填写电话号码
  String phoneNumber = "*****";

  // 构建UI
  [@override](/user/override)
  Widget build(BuildContext context) {
    return MaterialApp(
      home: Scaffold(
          appBar: AppBar(
            title: const Text('开始视频通话'),
          ),
          body: ListView(
            padding: const EdgeInsets.symmetric(horizontal: 16, vertical: 4),
            children: [
              // 本地视频容器
              if (_localUserJoined)
                Container(
                  height: 240,
                  decoration: BoxDecoration(border: Border.all()),
                  child: const Center(child: LocalVideoView()),
                ),
              const SizedBox(height: 10),
              // 远程视频容器
              if (_remoteUserJoined)
                Container(
                  height: 240,
                  decoration: BoxDecoration(border: Border.all()),
                  child: const Center(child: RemoteVideoView()),
                ),
              // 按钮行
              Row(
                children: <Widget>[
                  Expanded(
                    child: ElevatedButton(
                      onPressed: () {
                        _localUserJoined
                            ? null
                            : callVideoController.initialize(phoneNumber: phoneNumber);
                      },
                      child: const Text("加入"),
                    ),
                  ),
                  const SizedBox(width: 10),
                  Expanded(
                    child: ElevatedButton(
                      onPressed: _localUserJoined
                          ? callVideoController.leaveSession
                          : null,
                      child: const Text("离开"),
                    ),
                  ),
                ],
              ),
              // 按钮行结束
            ],
          )),
    );
  }

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

  Future<void> initVideoCall() async {
    callVideoController = createVideoCall();

    await callVideoController.initialize(phoneNumber: phoneNumber);

    callVideoController.join(
        onJoinCallSuccess: (bool isJoinCall) {
          setState(() {
            _localUserJoined = isJoinCall;
          });
        },
        onUserJoined: (bool isUserJoined) {
          setState(() {
            _remoteUserJoined = isUserJoined;
          });
        },
        onUserOffline: (int uid) {
          setState(() {
            _remoteUserJoined = false;
          });
        },
        onConnectionStateChanged: (ConnectionType type) {
          if (type == ConnectionType.failed || type == ConnectionType.disconnected) {
            setState(() {
              _remoteUserJoined = false;
              _localUserJoined = false;
            });
          }
        }
    );
  }

  [@override](/user/override)
  void dispose() {
    callVideoController.dispose();
    super.dispose();
  }
}