Flutter音频通信插件 dolbyio_comms_sdk_flutter 的使用

Dolby.io Communications SDK for Flutter 允许创建高质量的视频会议应用程序。通过Flutter，您可以编写单一代码库，并在多个平台上本地编译和使用这些代码来构建、测试和部署应用程序。当前，Flutter SDK支持为iOS和Android设备创建应用程序。

快速开始

您可以在GitHub上访问Flutter SDK的发布版本。为了快速入门，请遵循GitHub上的入门项目指南。这个入门项目解释了如何为移动设备创建一个基本的仅限音频的会议应用，并为您的解决方案（如事件、协作、教育或直播）提供了基础。

如果您需要Flutter开发的帮助，请参阅Flutter文档。

前提条件

确保您已准备好以下内容：

• 一个Dolby.io账户。如果没有账户，可以免费注册。
• iOS或Android设备或模拟器
• Flutter SDK 3.0.3或更高版本，配置为可在iOS和Android上工作
• Android Studio用于Android开发
• Xcode和CocoaPods用于iOS开发
• 从Dolby.io仪表板复制的客户端访问令牌

要检查是否需要安装任何额外的依赖项以完成设置，请使用flutter doctor命令（macOS，Windows）。

有关iOS SDK和Android SDK的要求，请参阅支持环境文档。

示例代码

下面是一个完整的示例demo，展示了如何使用dolbyio_comms_sdk_flutter插件实现音频会议功能。

import 'package:permission_handler/permission_handler.dart';
import 'package:dolbyio_comms_sdk_flutter/dolbyio_comms_sdk_flutter.dart';
import 'package:flutter/material.dart';
import 'package:collection/collection.dart';
import 'dart:async';
import 'dart:math';

void main() {
  runApp(const MaterialApp(home: FlutterScreen()));
}

class FlutterScreen extends StatefulWidget {
  const FlutterScreen({Key? key}) : super(key: key);

  [@override](/user/override)
  State<FlutterScreen> createState() => _FlutterScreenState();
}

class _FlutterScreenState extends State<FlutterScreen> {
  final dolbyioCommsSdk = DolbyioCommsSdk.instance;
  TextEditingController usernameController = TextEditingController();
  TextEditingController conferenceNameController = TextEditingController();
  String accessToken = ''; // 替换为您自己的Dolby.io访问令牌

  bool isLeaving = false;
  bool isJoining = false;
  bool isInitializedList = false;
  List<Participant> participants = [];

  StreamSubscription<Event<ConferenceServiceEventNames, Participant>>?
      onParticipantsChangeSubscription;
  StreamSubscription<Event<ConferenceServiceEventNames, StreamsChangeData>>?
      onStreamsChangeSubscription;

  [@override](/user/override)
  void initState() {
    super.initState();
    [
      Permission.bluetoothConnect,
      Permission.microphone,
      Permission.camera,
    ].request();

    initializeSdk();
    openSession();

    onParticipantsChangeSubscription =
        dolbyioCommsSdk.conference.onParticipantsChange().listen((params) {
      updateParticipantsList();
    });

    onStreamsChangeSubscription =
        dolbyioCommsSdk.conference.onStreamsChange().listen((params) {
      updateParticipantsList();
    });
  }

  [@override](/user/override)
  void dispose() {
    onParticipantsChangeSubscription?.cancel();
    onStreamsChangeSubscription?.cancel();
    super.dispose();
  }

  [@override](/user/override)
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(title: const Text('Flutter SDK'), centerTitle: true),
      body: Padding(
        padding: const EdgeInsets.all(16),
        child: !isInitializedList
            ? Column(
                children: [
                  TextField(controller: usernameController, readOnly: true),
                  const SizedBox(height: 12),
                  TextField(decoration: const InputDecoration(hintText: 'Conference name'), controller: conferenceNameController),
                  const SizedBox(height: 12),
                  ElevatedButton(
                    onPressed: () async {
                      await joinConference();
                    },
                    child: isJoining ? const Text('Joining...') : const Text('Join the conference'),
                  ),
                  const Divider(thickness: 2),
                  const Text("Join the conference to see the list of participants.")
                ],
              )
            : Column(children: [
                Text('Conference name: ${conferenceNameController.text}', style: const TextStyle(fontWeight: FontWeight.w400, fontSize: 16)),
                const SizedBox(height: 16),
                Expanded(
                  child: Column(children: [
                    const Align(alignment: Alignment.centerLeft, child: Text('List of participants:', style: TextStyle(color: Colors.blue, fontWeight: FontWeight.w600))),
                    const SizedBox(height: 16),
                    Expanded(
                      child: ListView.separated(
                        separatorBuilder: (BuildContext context, int index) {
                          return const SizedBox(height: 5);
                        },
                        shrinkWrap: true,
                        itemCount: participants.length,
                        itemBuilder: (context, index) {
                          var participant = participants[index];
                          return Padding(
                            padding: const EdgeInsets.all(4),
                            child: Row(children: [
                              Expanded(
                                flex: 1,
                                child: SizedBox(
                                  height: 150,
                                  width: 150,
                                  child: VideoView.withMediaStream(
                                    participant: participant,
                                    mediaStream: participant.streams?.firstWhereOrNull((s) => s.type == MediaStreamType.camera),
                                    key: ValueKey('video_view_tile_${participant.id}'),
                                  ),
                                ),
                              ),
                              Expanded(
                                flex: 1,
                                child: Column(mainAxisAlignment: MainAxisAlignment.center, children: [
                                  Text("${participant.info?.name.toString()}"),
                                  Text("status: ${participant.status?.name}")
                                ]),
                              ),
                            ]),
                          );
                        },
                      ),
                    ),
                  ]),
                ),
                const SizedBox(height: 16),
                ElevatedButton(
                  style: ElevatedButton.styleFrom(primary: Colors.red),
                  onPressed: () async {
                    await leaveConference();
                  },
                  child: isJoining ? const Text('Leaving...') : const Text('Leave the conference'),
                )
              ]),
      ),
    );
  }

  Future<void> initializeSdk() async {
    await dolbyioCommsSdk.initializeToken(accessToken, () async {
      return accessToken;
    });
  }

  Future<void> openSession() async {
    int randomNumber = Random().nextInt(1000);
    usernameController.text = "user-$randomNumber";
    var participantInfo = ParticipantInfo(usernameController.text, null, null);
    await dolbyioCommsSdk.session.open(participantInfo);
  }

  Future<void> joinConference() async {
    setState(() => isJoining = true);

    var params = ConferenceCreateParameters();
    params.dolbyVoice = true;
    var createOptions = ConferenceCreateOption(conferenceNameController.text, params, 0);

    var joinOptions = ConferenceJoinOptions();
    joinOptions.constraints = ConferenceConstraints(true, true);

    var conference = await dolbyioCommsSdk.conference.create(createOptions);
    conference = await dolbyioCommsSdk.conference.join(conference, joinOptions);

    if (conference.status == ConferenceStatus.joined) {
      setState(() => isJoining = false);
      print('Joined to conference.');
    } else {
      print('Cannot join to conference.');
    }
  }

  Future<void> leaveConference() async {
    setState(() => isLeaving = true);
    await dolbyioCommsSdk.conference.leave(options: null);
    setState(() => isInitializedList = false);
    setState(() => isLeaving = false);
  }

  Future<void> updateParticipantsList() async {
    try {
      var conference = await dolbyioCommsSdk.conference.current();
      var participantsList = await dolbyioCommsSdk.conference.getParticipants(conference);
      final availableParticipants = participantsList.where((element) => element.status != ParticipantStatus.left);

      setState(() {
        participants = availableParticipants.toList();
        isInitializedList = true;
      });
    } catch (error) {
      print("Error during initializing participant list.");
    }
  }
}