本文主要介绍如何快速地将 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. 开通摄像头和麦克风的权限,即可开启语音通话功能。
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 {// 权限已全部授予,可初始化 SDKinitLiveSDK();}} else {// Android 6.0 以下,Manifest 声明即生效initLiveSDK();}}@Overridepublic 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 LicenseUrlvar LICENSEURL = "";// 当前应用的License Keyvar LICENSEURLKEY = "";V2TXLivePremier.setLicense(LICENSEURL, LICENSEURLKEY);}
常见问题
如何获取可用的推流 URL?
iOS 无法显示视频(Android 正常)?
请确认在您的 Info.plist 中
io.flutter.embedded_views_preview 是为 YESAndroid 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 中