Flutter视频播放插件flutter_vlc_player_vconnex的使用

VLC Player Plugin

一个基于VLC的Flutter视频播放器插件，支持iOS和Android。

安装

iOS

如果无法加载来自外部源的媒体，您应该添加以下内容：

<key>NSAppTransportSecurity</key>
<dict>
  <key>NSAllowsArbitraryLoads</key>
  <true/>
</dict>

如需更多信息或更细粒度地控制您的App Transport Security（ATS）限制，请阅读 Apple官方文档。

确保以下行在 <项目根目录>/ios/Podfile 中已取消注释：

platform :ios, '9.0'

注意：虽然Flutter的 video_player 在iOS模拟器上不可用，但此插件 (flutter_vlc_player) 在iOS模拟器上完全可用。

若要启用vlc投射功能以支持外部显示（如Chromecast），还应添加以下内容：

<key>NSLocalNetworkUsageDescription</key>
<string>Used to search for chromecast devices</string>
<key>NSBonjourServices</key>
<array>
  <string>_googlecast._tcp</string>
</array>

Android

为了从互联网加载媒体/字幕，您的应用需要 INTERNET 权限。
这可以通过确保 <项目根目录>/android/app/src/main/AndroidManifest.xml 文件包含对 <uses-permission> 的声明来实现：

<uses-permission android:name="android.permission.INTERNET" />

由于Flutter默认包含此权限，因此该权限很可能已经声明在文件中。

如果您遇到“Cleartext HTTP traffic to * is not permitted”，则需要在 AndroidManifest.xml 文件中添加 android:usesClearTextTraffic="true" 标志，或者定义一个新的“网络安全配置”文件。有关更多信息，请参阅 https://developer.android.com/training/articles/security-config。

为了从内部设备存储加载媒体/字幕，您应添加以下权限：

<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE"/>
<uses-permission android:name="android.permission.READ_EXTERNAL_STORAGE"/>

在某些情况下，您还需要在 AndroidManifest.xml 文件的应用程序标签中添加 android:requestLegacyExternalStorage="true" 标志。

之后，您可以通过以下路径访问媒体/字幕文件：

"/storage/emulated/0/{FilePath}"
"/sdcard/{FilePath}"

Android构建配置

1. 在 <项目根目录>/android/app/build.gradle 中添加以下内容：

android {
    packagingOptions {
        // 解决重复库构建问题，当您的项目使用多个依赖C++库的插件时。
        pickFirst 'lib/**/libc++_shared.so'
    }

    buildTypes {
        release {
            minifyEnabled true
            useProguard true
            proguardFiles getDefaultProguardFile(
                    'proguard-android-optimize.txt'),
                    'proguard-rules.pro'
        }
    }
}

1. 创建 <项目根目录>/android/app/proguard-rules.pro，并添加以下内容：

-keep class org.videolan.libvlc.** { *; }

Android多窗口支持

要在Android应用程序中启用多窗口支持，您需要修改 <项目根目录>/android/app/src/main/AndroidManifest.xml，添加 android:resizeableActivity 键为主活动，并为应用程序添加 android.allow_multiple_resumed_activities 元数据：

<manifest ...>
  <application ...>
    <activity ...
      android:resizeableActivity="true">
      ...
    </activity>
    ...
    <meta-data
      android:name="android.allow_multiple_resumed_activities"
      android:value="true" />
  </application>
</manifest>

快速开始

要开始使用插件，请复制以下代码或参考示例项目 'flutter_vlc_player/example'：

import 'package:flutter/material.dart';
import 'package:flutter_vlc_player/vlc_player_flutter.dart';

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

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  MyHomePage({Key key}) : super(key: key);

  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  VlcPlayerController _videoPlayerController;

  Future<void> initializePlayer() async {}

  @override
  void initState() {
    super.initState();

    _videoPlayerController = VlcPlayerController.network(
      'https://media.w3.org/2010/05/sintel/trailer.mp4',
      hwAcc: HwAcc.FULL,
      autoPlay: false,
      options: VlcPlayerOptions(),
    );
  }

  @override
  void dispose() async {
    super.dispose();
    await _videoPlayerController.stopRendererScanning();
    await _videoPlayerController.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(),
      body: Center(
        child: VlcPlayer(
          controller: _videoPlayerController,
          aspectRatio: 16 / 9,
          placeholder: Center(child: CircularProgressIndicator()),
        ),
      ),
    );
  }
}

录制功能

要开始/停止视频录制，您需要分别调用 startRecording(String saveDirectory) 和 stopRecording() 方法。通过调用停止方法，可以从 vlcPlayerController.value.recordPath 获取录制文件的路径。

升级说明

版本5.0升级说明

要升级到版本5.0，首先需要将现有项目迁移到Swift。

1. 清理仓库：

   git clean -xdf
   

2. 删除现有的iOS文件夹。如果对iOS应用进行了自定义更改，请将其重命名或复制到项目外。

3. 重新创建iOS应用：

   flutter create -i swift .