帮你快速理解、总结文档立即下载

Flutter

最近更新时间:2026-11-17 17:54:31
本文档已由 AI 辅助审校
我的收藏
本文主要介绍如何快速地将 live_flutter_plugin Flutter 插件 集成到您的项目中,按照如下步骤进行配置,就可以完成 live_flutter_plugin 的集成工作。示例工程请参见 live_flutter_plugin_example。

环境准备

Flutter 2.0 及以上版本。
Android 端开发:
Android Studio 3.5及以上版本。
App 要求 Android 4.1及以上版本设备。
iOS & macOS 端开发:
Xcode 11.0及以上版本。
macOS 系统版本要求 10.11 及以上版本
请确保您的项目已设置有效的开发者签名。

快速集成 SDK

Flutter SDK 已经发布到 pub 库,您可以通过配置 pubspec.yaml 自动下载更新。
1. 在项目的 pubspec.yaml 中写如下依赖:
dependencies:
live_flutter_plugin: latest version number
2. 开通摄像头和麦克风的权限,即可开启语音通话功能。
iOS
Android
1. 需要在 Info.plist 中加入对摄像头和麦克风的权限申请:
<key>NSCameraUsageDescription</key>
<string>授权摄像头权限才能正常视频通话</string>
<key>NSMicrophoneUsageDescription</key>
<string>授权麦克风权限才能正常语音通话</string>
2. 运行时允许打开权限,即可开启语音通话功能。
1. AndroidManifest.xml 权限声明。
<manifest xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:tools="http://schemas.android.com/tools">
<!-- 摄像头权限 -->
<uses-permission android:name="android.permission.CAMERA" />
<!-- 麦克风权限 -->
<uses-permission android:name="android.permission.RECORD_AUDIO" />
<!-- 网络权限(直播必需) -->
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- 可选:前后摄像头特性声明 -->
<uses-feature android:name="android.hardware.camera" android:required="false" />
<uses-feature android:name="android.hardware.camera.autofocus" android:required="false" />
<application
...
tools:replace="android:label">
...
</application>
</manifest>
2. 运行时动态权限申请(Android 6.0+ 必需)。
// MainActivity.java 或 MApplication.java 中
private static final int REQUEST_CODE_PERMISSIONS = 1001;
private static final String[] REQUIRED_PERMISSIONS = new String[] {
Manifest.permission.CAMERA,
Manifest.permission.RECORD_AUDIO
};

private void checkAndRequestPermissions() {
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.M) {
List<String> missingPermissions = new ArrayList<>();
for (String permission : REQUIRED_PERMISSIONS) {
if (ContextCompat.checkSelfPermission(this, permission)
!= PackageManager.PERMISSION_GRANTED) {
missingPermissions.add(permission);
}
}
if (!missingPermissions.isEmpty()) {
ActivityCompat.requestPermissions(
this,
missingPermissions.toArray(new String[0]),
REQUEST_CODE_PERMISSIONS
);
} else {
// 权限已全部授予,可初始化 SDK
initLiveSDK();
}
} else {
// Android 6.0 以下,Manifest 声明即生效
initLiveSDK();
}
}

@Override
public void onRequestPermissionsResult(int requestCode, @NonNull String[] permissions, @NonNull int[] grantResults) {
super.onRequestPermissionsResult(requestCode, permissions, grantResults);
if (requestCode == REQUEST_CODE_PERMISSIONS) {
for (int result : grantResults) {
if (result != PackageManager.PERMISSION_GRANTED) {
// 权限被拒绝,提示用户
Toast.makeText(this, "摄像头/麦克风权限被拒绝,无法使用直播功能", Toast.LENGTH_LONG).show();
return;
}
}
// 全部授权成功
initLiveSDK();
}
}

快速开始

1. 单击 License 申请 获取测试用 License,您会获得两个字符串:一个字符串是 licenseURL,另一个字符串是解密 key。
2. 在您的 App 调用 live_flutter_plugin 的相关功能之前进行如下设置:
import 'package:live_flutter_plugin/v2_tx_live_premier.dart';

/// 腾讯云License管理页面(https://console.cloud.tencent.com/live/license)
void setupLicense()
// 当前应用的License LicenseUrl
var LICENSEURL = "";
// 当前应用的License Key
var LICENSEURLKEY = "";
V2TXLivePremier.setLicense(LICENSEURL, LICENSEURLKEY);
}

常见问题

更多常见问题请参见 Flutter 相关问题。

如何获取可用的推流 URL?

开通直播服务后,可以使用 直播控制台 > 常用工具 > > 地址生成器 生成推流地址,详细信息请参见 推拉流 URL。

iOS 无法显示视频(Android 正常)?

请确认在您的 Info.plist 中 io.flutter.embedded_views_preview 是为 YES

Android Manifest merge failed 编译失败?

1. 请打开/example/android/app/src/main/AndroidManifest.xml 文件。
2. 将 xmlns:tools="http://schemas.android.com/tools"加入到 manifest 中。
3. 将 tools:replace="android:label"加入到 application 中