README

此包为 Laravel 6.0 及以上版本提供 FFmpeg 的集成。由 Laravel 的文件系统处理文件存储。

特性

围绕 PHP-FFMpeg 的超简单包装，包括对过滤器和其他高级特性的支持。
与 Laravel 的文件系统、配置系统和日志处理集成。
兼容 Laravel 6.0 及以上版本，支持包发现。
内置 HLS 支持。
内置支持加密 HLS (AES-128) 和密钥轮换（可选）。
内置支持拼接、多个输入/输出、图像序列（时间流逝）、复杂过滤器（和映射）、帧/缩略图导出。
内置支持水印（定位和处理）。
PHP 7.3 及以上。
大量集成测试，GitHub Actions 支持Ubuntu和Windows。

支持

我们自豪地通过开发 Laravel 包并免费提供来支持社区。跟踪问题和拉取请求需要时间，但我们乐于提供帮助！如果此包为您节省了时间或您在专业上依赖它，请考虑支持维护和开发。

安装

您可以通过 composer 安装此包

composer require pbmedia/laravel-ffmpeg

如果您不使用包发现，请将服务提供者和外观添加到您的 app.php 配置文件中

// config/app.php

'providers' => [
    ...
    ProtoneMedia\LaravelFFMpeg\Support\ServiceProvider::class,
    ...
];

'aliases' => [
    ...
    'FFMpeg' => ProtoneMedia\LaravelFFMpeg\Support\FFMpeg::class
    ...
];

使用 artisan CLI 工具发布配置文件

php artisan vendor:publish --provider="ProtoneMedia\LaravelFFMpeg\Support\ServiceProvider"

升级到 v7

命名空间已更改为 ProtoneMedia\LaravelFFMpeg，外观已重命名为 ProtoneMedia\LaravelFFMpeg\Support\FFMpeg，服务提供者已重命名为 ProtoneMedia\LaravelFFMpeg\Support\ServiceProvider。
链式导出仍然受支持，但您必须为每个导出重新应用过滤器。
HLS 播单现在包括比特率、帧率和分辨率数据。段也使用新的命名模式（了解更多）。请确认您的导出在您的播放器中仍然有效。
HLS 导出现在作为单个任务执行，而不是单独导出每个格式/流。这使用了 FFMpeg 的 map 和 filter_complex 功能。可能只需将所有对 addFilter 的调用替换为 addLegacyFilter，但对于某些过滤器应手动迁移。请阅读有关添加过滤器的 HLS 文档以获取更多信息。

用法

转换音频或视频文件

FFMpeg::fromDisk('songs')
    ->open('yesterday.mp3')
    ->export()
    ->toDisk('converted_songs')
    ->inFormat(new \FFMpeg\Format\Audio\Aac)
    ->save('yesterday.aac');

您还可以使用 fromFilesystem() 方法代替 fromDisk() 方法，其中 $filesystem 是 Illuminate\Contracts\Filesystem\Filesystem 的一个实例。

$media = FFMpeg::fromFilesystem($filesystem)->open('yesterday.mp3');

进度监控

您可以监控转码进度。使用 onProgress 方法提供一个回调，它给您完成百分比。在之前版本的此包中，您必须将回调传递给格式对象。

FFMpeg::open('steve_howe.mp4')
    ->export()
    ->onProgress(function ($percentage) {
        echo "{$percentage}% transcoded";
    });

从7.0版本开始，回调函数还公开了$remaining（以秒为单位）和$rate。

FFMpeg::open('steve_howe.mp4')
    ->export()
    ->onProgress(function ($percentage, $remaining, $rate) {
        echo "{$remaining} seconds left at rate: {$rate}";
    });

从网络上打开文件

您可以使用openUrl方法从网络上打开文件。您可以使用可选的第二个参数指定自定义HTTP头。

FFMpeg::openUrl('https://videocoursebuilder.com/lesson-1.mp4');

FFMpeg::openUrl('https://videocoursebuilder.com/lesson-2.mp4', [
    'Authorization' => 'Basic YWRtaW46MTIzNA==',
]);

异常处理

当编码失败时，将抛出ProtoneMedia\LaravelFFMpeg\Exporters\EncodingException异常，它扩展了底层的FFMpeg\Exception\RuntimeException类。这个类有两个方法可以帮助您识别问题。使用getCommand方法，您可以获取带有所有参数的执行命令。使用getErrorOutput方法，您可以获取完整的输出日志。

由于历史原因，异常消息始终为“编码失败”。您可以通过将set_command_and_error_output_on_exception配置键更新为true来替换此消息，以获得更详细的信息。

try {
    FFMpeg::open('yesterday.mp3')
        ->export()
        ->inFormat(new Aac)
        ->save('yesterday.aac');
} catch (EncodingException $exception) {
    $command = $exception->getCommand();
    $errorLog = $exception->getErrorOutput();
}

过滤器

您可以通过闭包或使用PHP-FFMpeg的Filter对象来添加过滤器。

use FFMpeg\Filters\Video\VideoFilters;

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->addFilter(function (VideoFilters $filters) {
        $filters->resize(new \FFMpeg\Coordinate\Dimension(640, 480));
    })
    ->export()
    ->toDisk('converted_videos')
    ->inFormat(new \FFMpeg\Format\Video\X264)
    ->save('small_steve.mkv');

// or

$start = \FFMpeg\Coordinate\TimeCode::fromSeconds(5)
$clipFilter = new \FFMpeg\Filters\Video\ClipFilter($start);

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->addFilter($clipFilter)
    ->export()
    ->toDisk('converted_videos')
    ->inFormat(new \FFMpeg\Format\Video\X264)
    ->save('short_steve.mkv');

从7.0版本开始，您还可以在export方法之后调用addFilter方法。

use FFMpeg\Filters\Video\VideoFilters;

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->export()
    ->toDisk('converted_videos')
    ->inFormat(new \FFMpeg\Format\Video\X264)
    ->addFilter(function (VideoFilters $filters) {
        $filters->resize(new \FFMpeg\Coordinate\Dimension(640, 480));
    })
    ->save('small_steve.mkv');

调整大小

由于调整大小是一个常见的操作，我们为它添加了一个专门的方法。

FFMpeg::open('steve_howe.mp4')
    ->export()
    ->resize(640, 480);

第一个参数是宽度，第二个参数是高度。可选的第三个参数是模式。您可以选择fit（默认）、inset、width或height。可选的第四个参数是一个布尔值，表示是否强制使用标准比例。您可以在FFMpeg\Filters\Video\ResizeFilter类中找到有关这些模式的更多信息。

自定义过滤器

有时您不想使用内置的过滤器。您可以通过提供一组选项来应用自己的过滤器。这可以是一个数组或多个字符串参数。

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->addFilter(['-itsoffset', 1]);

// or

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->addFilter('-itsoffset', 1);

水印过滤器

从7.3版本开始，您可以使用addWatermark方法轻松地添加水印。使用WatermarkFactory，您可以从指定的磁盘打开水印文件，就像打开音频或视频文件一样。如果您丢弃了fromDisk方法，它将使用在filesystems.php配置文件中指定的默认磁盘。

打开您的水印文件后，您可以使用top、right、bottom和left方法将其定位。这些方法的第一个参数是偏移量，它是可选的，可以是负值。

use ProtoneMedia\LaravelFFMpeg\Filters\WatermarkFactory;

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->addWatermark(function(WatermarkFactory $watermark) {
        $watermark->fromDisk('local')
            ->open('logo.png')
            ->right(25)
            ->bottom(25);
    });

除了使用位置方法外，您还可以使用horizontalAlignment和verticalAlignment方法。

对于水平对齐，您可以使用WatermarkFactory::LEFT、WatermarkFactory::CENTER和WatermarkFactory::RIGHT常量。对于垂直对齐，您可以使用WatermarkFactory::TOP、WatermarkFactory::CENTER和WatermarkFactory::BOTTOM常量。这两种方法都接受一个可选的第二个参数，即偏移量。

FFMpeg::open('steve_howe.mp4')
    ->addWatermark(function(WatermarkFactory $watermark) {
        $watermark->open('logo.png')
            ->horizontalAlignment(WatermarkFactory::LEFT, 25)
            ->verticalAlignment(WatermarkFactory::TOP, 25);
    });

WatermarkFactory还支持使用openUrl方法从网络上打开文件。它也支持自定义HTTP头。

FFMpeg::open('steve_howe.mp4')
    ->addWatermark(function(WatermarkFactory $watermark) {
        $watermark->openUrl('https://videocoursebuilder.com/logo.png');

        // or

        $watermark->openUrl('https://videocoursebuilder.com/logo.png', [
            'Authorization' => 'Basic YWRtaW46MTIzNA==',
        ]);
    });

如果您想对GET请求有更多的控制，您可以传递一个可选的第三个参数，这将为您提供Curl资源。

$watermark->openUrl('https://videocoursebuilder.com/logo.png', [
    'Authorization' => 'Basic YWRtaW46MTIzNA==',
], function($curl) {
    curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, 0);
    curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, 0);
});

水印操作

此软件包可以通过使用Spatie的Image软件包来操作水印。要开始使用，请使用Composer安装此软件包。

composer require spatie/image

现在您可以在WatermarkFactory实例上链式调用一个操作方法。

FFMpeg::open('steve_howe.mp4')
    ->addWatermark(function(WatermarkFactory $watermark) {
        $watermark->open('logo.png')
            ->right(25)
            ->bottom(25)
            ->width(100)
            ->height(100)
            ->greyscale();
    });

查看文档以获取所有可用方法。

不进行转码的导出

此软件包包含一个ProtoneMedia\LaravelFFMpeg\FFMpeg\CopyFormat类，允许您在不转码流的情况下导出文件。您可能想使用此功能来使用其他容器。

use ProtoneMedia\LaravelFFMpeg\FFMpeg\CopyFormat;

FFMpeg::open('video.mp4')
    ->export()
    ->inFormat(new CopyFormat)
    ->save('video.mkv');

链式多个转换

// The 'fromDisk()' method is not required, the file will now
// be opened from the default 'disk', as specified in
// the config file.

FFMpeg::open('my_movie.mov')

    // export to FTP, converted in WMV
    ->export()
    ->toDisk('ftp')
    ->inFormat(new \FFMpeg\Format\Video\WMV)
    ->save('my_movie.wmv')

    // export to Amazon S3, converted in X264
    ->export()
    ->toDisk('s3')
    ->inFormat(new \FFMpeg\Format\Video\X264)
    ->save('my_movie.mkv');

    // you could even discard the 'toDisk()' method,
    // now the converted file will be saved to
    // the same disk as the source!
    ->export()
    ->inFormat(new FFMpeg\Format\Video\WebM)
    ->save('my_movie.webm')

    // optionally you could set the visibility
    // of the exported file
    ->export()
    ->inFormat(new FFMpeg\Format\Video\WebM)
    ->withVisibility('public')
    ->save('my_movie.webm')

从视频中创建帧

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->getFrameFromSeconds(10)
    ->export()
    ->toDisk('thumnails')
    ->save('FrameAt10sec.png');

// Instead of the 'getFrameFromSeconds()' method, you could
// also use the 'getFrameFromString()' or the
// 'getFrameFromTimecode()' methods:

$media = FFMpeg::open('steve_howe.mp4');
$frame = $media->getFrameFromString('00:00:13.37');

// or

$timecode = new FFMpeg\Coordinate\TimeCode(...);
$frame = $media->getFrameFromTimecode($timecode);

您也可以获取帧的原始内容，而不是将其保存到文件系统中

$contents = FFMpeg::open('video.mp4')
    ->getFrameFromSeconds(2)
    ->export()
    ->getFrameContents();

使用循环进行多次导出

链式调用多个转换是可行的，因为 MediaExporter 的 save 方法返回一个新的 MediaOpener 实例。您可以使用这个实例来遍历项目，例如从视频中导出多个帧

$mediaOpener = FFMpeg::open('video.mp4');

foreach ([5, 15, 25] as $key => $seconds) {
    $mediaOpener = $mediaOpener->getFrameFromSeconds($seconds)
        ->export()
        ->save("thumb_{$key}.png");
}

MediaOpener 还包含一个 each 方法。上面的示例可以重构如下

FFMpeg::open('video.mp4')->each([5, 15, 25], function ($ffmpeg, $seconds, $key) {
    $ffmpeg->getFrameFromSeconds($seconds)->export()->save("thumb_{$key}.png");
});

创建时间流逝视频

您可以使用导出器上的 asTimelapseWithFramerate 方法从一系列图像创建时间流逝视频

FFMpeg::open('feature_%04d.png')
    ->export()
    ->asTimelapseWithFramerate(1)
    ->inFormat(new X264)
    ->save('timelapse.mp4');

多个输入

自 7.0 版本起，您可以打开多个输入，甚至来自不同的磁盘。这使用了 FFMpeg 的 map 和 filter_complex 功能。您可以通过链式调用 open 方法或使用数组来打开多个文件。您可以混合来自不同磁盘的输入。

FFMpeg::open('video1.mp4')->open('video2.mp4');

FFMpeg::open(['video1.mp4', 'video2.mp4']);

FFMpeg::fromDisk('uploads')
    ->open('video1.mp4')
    ->fromDisk('archive')
    ->open('video2.mp4');

当您打开多个输入时，您必须添加映射，这样 FFMpeg 才知道如何路由它们。此包提供了一个 addFormatOutputMapping 方法，它接受三个参数：格式、输出和 -filter_complex 部分的输出标签。

输出（第二个参数）应该是 ProtoneMedia\LaravelFFMpeg\Filesystem\Media 的一个实例。您可以使用 make 方法实例化，使用磁盘名称和路径调用它（请参阅示例）。

查看此示例，它将单独的视频和音频输入映射到单个输出。

FFMpeg::fromDisk('local')
    ->open(['video.mp4', 'audio.m4a'])
    ->export()
    ->addFormatOutputMapping(new X264, Media::make('local', 'new_video.mp4'), ['0:v', '1:a'])
    ->save();

这是一个来自底层库的示例。

// This code takes 2 input videos, stacks they horizontally in 1 output video and
// adds to this new video the audio from the first video. (It is impossible
// with a simple filter graph that has only 1 input and only 1 output).

FFMpeg::fromDisk('local')
    ->open(['video.mp4', 'video2.mp4'])
    ->export()
    ->addFilter('[0:v][1:v]', 'hstack', '[v]')  // $in, $parameters, $out
    ->addFormatOutputMapping(new X264, Media::make('local', 'stacked_video.mp4'), ['0:a', '[v]'])
    ->save();

就像单个输入一样，您也可以将回调传递给 addFilter 方法。这将为您提供 \FFMpeg\Filters\AdvancedMedia\ComplexFilters 的一个实例。

use FFMpeg\Filters\AdvancedMedia\ComplexFilters;

FFMpeg::open(['video.mp4', 'video2.mp4'])
    ->export()
    ->addFilter(function(ComplexFilters $filters) {
        // $filters->watermark(...);
    });

从网络上打开文件的工作方式类似。您可以将 URL 数组传递给 openUrl 方法，可选地带有自定义 HTTP 头部。

FFMpeg::openUrl([
    'https://videocoursebuilder.com/lesson-3.mp4',
    'https://videocoursebuilder.com/lesson-4.mp4',
]);

FFMpeg::openUrl([
    'https://videocoursebuilder.com/lesson-3.mp4',
    'https://videocoursebuilder.com/lesson-4.mp4',
], [
    'Authorization' => 'Basic YWRtaW46MTIzNA==',
]);

如果您想为每个 URL 使用另一组 HTTP 头部，您可以链式调用 openUrl 方法。

FFMpeg::openUrl('https://videocoursebuilder.com/lesson-5.mp4', [
    'Authorization' => 'Basic YWRtaW46MTIzNA==',
])->openUrl('https://videocoursebuilder.com/lesson-6.mp4', [
    'Authorization' => 'Basic bmltZGE6NDMyMQ==',
]);

不进行转码拼接文件

FFMpeg::fromDisk('local')
    ->open(['video.mp4', 'video2.mp4'])
    ->export()
    ->concatWithoutTranscoding()
    ->save('concat.mp4');

进行转码拼接文件

FFMpeg::fromDisk('local')
    ->open(['video.mp4', 'video2.mp4'])
    ->export()
    ->inFormat(new X264)
    ->concatWithTranscoding($hasVideo = true, $hasAudio = true)
    ->save('concat.mp4');

确定持续时间

使用 Media 类，您可以确定文件的持续时间

$media = FFMpeg::open('wwdc_2006.mp4');

$durationInSeconds = $media->getDurationInSeconds(); // returns an int
$durationInMiliseconds = $media->getDurationInMiliseconds(); // returns a float

处理远程磁盘

当从或向远程磁盘打开或保存文件时，您的服务器将创建临时文件。完成导出或处理这些文件后，您可以调用 cleanupTemporaryFiles() 方法来清理它们。

FFMpeg::cleanupTemporaryFiles();

默认情况下，临时目录的根由 PHP 的 sys_get_temp_dir() 方法评估，但您可以通过将 temporary_files_root 配置键设置为自定义路径来修改它。

HLS

您可以使用 M3U8 播放列表来创建 HLS。

$lowBitrate = (new X264)->setKiloBitrate(250);
$midBitrate = (new X264)->setKiloBitrate(500);
$highBitrate = (new X264)->setKiloBitrate(1000);

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->exportForHLS()
    ->setSegmentLength(10) // optional
    ->setKeyFrameInterval(48) // optional
    ->addFormat($lowBitrate)
    ->addFormat($midBitrate)
    ->addFormat($highBitrate)
    ->save('adaptive_steve.m3u8');

HLS 导出器的 addFormat 方法接受一个可选的第二个参数，它可以是回调方法。这允许您为每个格式添加不同的过滤器。首先，查看 多个输入 部分，了解如何处理复杂过滤器。

您可以使用 addFilter 方法添加一个复杂过滤器（请参阅 $lowBitrate 示例）。由于使用了大量的 scale 过滤器，因此有一个辅助方法（请参阅 $midBitrate 示例）。您还可以使用可调用对象来访问 ComplexFilters 实例。该包提供了 $in 和 $out 参数，因此您无需担心它（请参阅 $highBitrate 示例）。

自 7.0 版本起，HLS 导出是使用 FFMpeg 的 map 和 filter_complex 功能构建的。这与之前版本相比是一个重大变化，因为之前版本为每个格式执行单个导出。如果您正在升级，请将 addFilter 调用替换为 addLegacyFilter 调用，并验证结果（请参阅 $superBitrate 示例）。并非所有过滤器都以这种方式工作，并且某些过滤器需要手动升级。

$lowBitrate = (new X264)->setKiloBitrate(250);
$midBitrate = (new X264)->setKiloBitrate(500);
$highBitrate = (new X264)->setKiloBitrate(1000);
$superBitrate = (new X264)->setKiloBitrate(1500);

FFMpeg::open('steve_howe.mp4')
    ->exportForHLS()
    ->addFormat($lowBitrate, function($media) {
        $media->addFilter('scale=640:480');
    })
    ->addFormat($midBitrate, function($media) {
        $media->scale(960, 720);
    })
    ->addFormat($highBitrate, function ($media) {
        $media->addFilter(function ($filters, $in, $out) {
            $filters->custom($in, 'scale=1920:1200', $out); // $in, $parameters, $out
        });
    })
    ->addFormat($superBitrate, function($media) {
        $media->addLegacyFilter(function ($filters) {
            $filters->resize(new \FFMpeg\Coordinate\Dimension(2560, 1920));
        });
    })
    ->save('adaptive_steve.m3u8');

使用自定义段落模式

您可以使用自定义模式来命名片段和播放列表。函数useSegmentFilenameGenerator提供了5个参数。前三个参数提供了关于导出基本名、当前迭代格式和当前迭代键的信息。第四个参数是一个回调函数，您应该使用您的片段模式调用它。第五个参数是一个回调函数，您应该使用您的播放列表模式调用它。请注意，这不仅仅是主播放列表的名称，而是每个格式的播放列表名称。

FFMpeg::fromDisk('videos')
    ->open('steve_howe.mp4')
    ->exportForHLS()
    ->useSegmentFilenameGenerator(function ($name, $format, $key, callable $segments, callable $playlist) {
        $segments("{$name}-{$format}-{$key}-%03d.ts");
        $playlist("{$name}-{$format}-{$key}.m3u8");
    });

加密HLS

从版本7.5开始，您可以使用AES-128加密加密每个HLS片段。为此，请在带有密钥的HLS导出器上调用withEncryptionKey方法。我们在HLSExporter类上提供了一个辅助方法generateEncryptionKey来生成密钥。请确保妥善存储密钥，因为没有密钥，导出的结果毫无价值。默认情况下，密钥的文件名为secret.key，但您可以使用withEncryptionKey方法的可选第二个参数来更改它。

use ProtoneMedia\LaravelFFMpeg\Exporters\HLSExporter;

$encryptionKey = HLSExporter::generateEncryptionKey();

FFMpeg::open('steve_howe.mp4')
    ->exportForHLS()
    ->withEncryptionKey($encryptionKey)
    ->addFormat($lowBitrate)
    ->addFormat($midBitrate)
    ->addFormat($highBitrate)
    ->save('adaptive_steve.m3u8');

为了进一步保护您的HLS导出，您可以在每个导出的片段上旋转密钥。通过这样做，它将生成多个您需要存储的密钥。使用withRotatingEncryptionKey方法启用此功能，并提供一个实现密钥存储的回调函数。

FFMpeg::open('steve_howe.mp4')
    ->exportForHLS()
    ->withRotatingEncryptionKey(function ($filename, $contents) {
        $videoId = 1;

        // use this callback to store the encryption keys

        Storage::disk('secrets')->put($videoId . '/' . $filename, $contents);

        // or...

        DB::table('hls_secrets')->insert([
            'video_id' => $videoId,
            'filename' => $filename,
            'contents' => $contents,
        ]);
    })
    ->addFormat($lowBitrate)
    ->addFormat($midBitrate)
    ->addFormat($highBitrate)
    ->save('adaptive_steve.m3u8');

withRotatingEncryptionKey方法有一个可选的第二个参数来设置使用相同密钥的片段数。默认为1。

FFMpeg::open('steve_howe.mp4')
    ->exportForHLS()
    ->withRotatingEncryptionKey($callable, 10);

保护您的HLS加密密钥

为了使使用加密HLS的工作更好，我们添加了一个DynamicHLSPlaylist类，该类可以实时修改播放列表，并专门针对您的应用程序。这样，您可以添加您的身份验证和授权逻辑。由于我们使用了一个简单的Laravel控制器，您可以使用诸如Gates和Middleware之类的功能。

在这个例子中，我们将HLS导出保存在public磁盘上，并将加密密钥存储在secrets磁盘上，该磁盘不公开。由于浏览器无法访问加密密钥，因此不会播放视频。每个播放列表都有指向加密密钥的路径，我们需要修改这些路径，使其指向可访问的端点。

此实现由两个路由组成。一个响应加密密钥的路由，另一个响应修改后的播放列表。第一个路由（video.key）相对简单，这是您应该添加额外逻辑的地方。

第二个路由（video.playlist）使用DynamicHLSPlaylist类。在FFMpeg外观上调用dynamicHLSPlaylist方法，类似于打开媒体文件，您可以使用fromDisk和open方法打开播放列表。然后您必须提供三个回调。每个回调都为您提供相对路径，并期望返回完整路径。由于DynamicHLSPlaylist类实现了Illuminate\Contracts\Support\Responsable接口，因此您可以返回实例。

第一个回调（KeyUrlResolver）为您提供加密键的相对路径。第二个回调（MediaUrlResolver）为您提供媒体片段（.ts文件）的相对路径。第三个回调（PlaylistUrlResolver）为您提供播放列表的相对路径。

现在，您可以使用route('video.playlist', ['playlist' => 'adaptive_steve.m3u8'])而不是使用Storage::disk('public')->url('adaptive_steve.m3u8')来获取主播放列表的完整URL。DynamicHLSPlaylist类负责所有路径和URL。

Route::get('/video/secret/{key}', function ($key) {
    return Storage::disk('secrets')->download($key);
})->name('video.key');

Route::get('/video/{playlist}', function ($playlist) {
    return FFMpeg::dynamicHLSPlaylist()
        ->fromDisk('public')
        ->open($playlist)
        ->setKeyUrlResolver(function ($key) {
            return route('video.key', ['key' => $key]);
        })
        ->setMediaUrlResolver(function ($mediaFilename) {
            return Storage::disk('public')->url($mediaFilename);
        })
        ->setPlaylistUrlResolver(function ($playlistFilename) {
            return route('video.playlist', ['playlist' => $playlistFilename]);
        });
})->name('video.playlist');

现场编码会议

您在这里可以找到一个关于HLS加密的现场编码会议

https://www.youtube.com/watch?v=WlbzWoAcez4

进程输出

您可以通过调用 getProcessOutput 方法获取原始处理输出。尽管使用场景有限，您可以使用它来分析文件（例如，使用 volumedetect 过滤器）。它返回一个 ProtoneMedia\LaravelFFMpeg\Support\ProcessOutput 类，该类具有三个方法：all、errors 和 output。每个方法返回一个包含对应行的数组。

$processOutput = FFMpeg::open('video.mp4')
    ->export()
    ->addFilter(['-filter:a', 'volumedetect', '-f', 'null'])
    ->getProcessOutput();

$processOutput->all();
$processOutput->errors();
$processOutput->out();

高级

当您“打开”文件时获取的媒体对象，实际上持有属于底层驱动器的媒体对象。它处理动态方法调用，如您在此处所见。这样，底层驱动器的所有方法仍然对您可用。

// This gives you an instance of ProtoneMedia\LaravelFFMpeg\MediaOpener
$media = FFMpeg::fromDisk('videos')->open('video.mp4');

// The 'getStreams' method will be called on the underlying Media object since
// it doesn't exists on this object.
$codec = $media->getStreams()->first()->get('codec_name');

如果您想直接访问底层对象，请将对象作为函数（调用）。

// This gives you an instance of ProtoneMedia\LaravelFFMpeg\MediaOpener
$media = FFMpeg::fromDisk('videos')->open('video.mp4');

// This gives you an instance of FFMpeg\Media\MediaTypeInterface
$baseMedia = $media();

实验性

进度监听器揭示了转码的百分比，但底层包还有一个内部 AbstractProgressListener，它揭示了当前遍历和当前时间。尽管使用场景有限，您可能想获取此监听器实例。您可以通过使用 ProgressListenerDecorator 装饰格式来实现这一点。此功能高度实验性，因此在生产中使用之前务必彻底测试。

use FFMpeg\Format\ProgressListener\AbstractProgressListener;
use ProtoneMedia\LaravelFFMpeg\FFMpeg\ProgressListenerDecorator;

$format = new \FFMpeg\Format\Video\X264;
$decoratedFormat = ProgressListenerDecorator::decorate($format);

FFMpeg::open('video.mp4')
    ->export()
    ->inFormat($decoratedFormat)
    ->onProgress(function () use ($decoratedFormat) {
        $listeners = $decoratedFormat->getListeners();  // array of listeners

        $listener = $listeners[0];  // instance of AbstractProgressListener

        $listener->getCurrentPass();
        $listener->getTotalPass();
        $listener->getCurrentTime();
    })
    ->save('new_video.mp4');

由于我们无法删除一些底层选项，您可以通过将回调添加到导出器来与最终的 FFmpeg 命令交互。您可以通过使用 beforeSaving 方法添加一个或多个回调。

FFMpeg::open('video.mp4')
    ->export()
    ->inFormat(new X264)
    ->beforeSaving(function ($commands) {
        $commands[] = '-hello';

        return $commands;
    })
    ->save('concat.mp4');

注意：此方法不适用于拼接和帧导出。

示例应用

这是一篇博客文章，它将帮助您开始使用此包。

https://protone.media/en/blog/how-to-use-ffmpeg-in-your-laravel-projects

使用 Video.js 在任何浏览器中播放 HLS

这是一篇20分钟的概览，介绍了如何开始使用 Video.js。它涵盖了从CDN中包含 Video.js、使用 Laravel Mix（Webpack）将其导入为ES6模块以及构建可重用的 Vue.js 组件。

https://www.youtube.com/watch?v=nA1Jy8BPjys

Wiki

变更日志

请参阅 CHANGELOG 了解最近更改的更多信息。

测试

$ composer test

贡献

请参阅 CONTRIBUTING 了解详细信息。

其他 Laravel 包

Laravel Analytics Event Tracking：用于轻松将事件发送到 Google Analytics 的 Laravel 包。
Laravel Blade On Demand：用于在内存中编译 Blade 模板的 Laravel 包。
Laravel Cross Eloquent Search：用于在多个 Eloquent 模型中搜索的 Laravel 包。
Laravel Eloquent Scope as Select：停止在 PHP 中重复您的 Eloquent 查询范围和约束。此包允许您通过将它们添加为子查询来重用您的查询范围和约束。
Laravel Eloquent Where Not：此 Laravel 包允许您翻转/反转 Eloquent 范围或任何查询约束。
Laravel Form Components：用于使用 Tailwind CSS Custom Forms 和 Bootstrap 4 快速构建表单的 Blade 组件。支持验证、模型绑定、默认值、翻译，包括默认供应商样式和完全可定制！
Laravel Mixins ：Laravel好工具的集合。
Laravel Paddle ：支持webhooks/events的Paddle.com API集成。
Laravel Verify New Email ：此包增加了验证新电子邮件地址的支持：当用户更新其电子邮件地址时，新地址将在验证通过之前不会替换旧地址。
Laravel WebDAV ：Laravel文件系统的WebDAV驱动。

安全性

如果您发现任何安全问题，请通过电子邮件发送到 code@protone.media，而不是使用问题跟踪器。请不要发送任何问题，如果有问题，请提交一个问题。

鸣谢

许可证

MIT许可证（MIT）。有关更多信息，请参阅许可证文件。

kimdongwan121 / laravel-ffmpeg

维护者

详细信息