如何解决视频字幕格式转换与编辑的难题，mantas-done/subtitles助你轻松搞定！

<code class="bash">composer require mantas-done/subtitles</code>

<pre class="brush:php;toolbar:false;"><?php

use Done\Subtitles\Subtitles;

// 将 subtitles.srt 转换为 subtitles.vtt
Subtitles::convert('subtitles.srt', 'subtitles.vtt');

// 如果不想指定输入格式，库会自动检测，并可指定输出格式
// 支持的格式有：ass, dfxp, sbv, srt, stl, sub, ttml, txt_quicktime, vtt
Subtitles::convert('input.file', 'output.file', ['output_format' => 'vtt']);

echo "字幕文件转换成功！\n";

<pre class="brush:php;toolbar:false;"><?php

use Done\Subtitles\Subtitles;

// 从文件加载
$subtitlesFromFile = Subtitles::loadFromFile('subtitles.srt');
echo "从文件加载成功。\n";

// 从字符串加载
$string = "
1
00:02:17,440 --> 00:02:20,375
Senator, we're making our final approach
";
$subtitlesFromString = Subtitles::loadFromString($string);
echo "从字符串加载成功。\n";

// 保存到文件
$subtitlesFromFile->save('new_subtitles.vtt');
echo "保存到 new_subtitles.vtt 成功。\n";

// 获取内容而不保存到文件
$vttContent = $subtitlesFromString->content('vtt');
echo "获取 VTT 内容：\n" . $vttContent . "\n";

<pre class="brush:php;toolbar:false;"><?php

use Done\Subtitles\Subtitles;

$subtitles = new Subtitles();

// 添加单行字幕
$subtitles->add(0, 5, 'This text is shown in the beginning of video for 5 seconds');

// 添加多行字幕
$subtitles->add(6, 10, [
    'First line of multi-line text',
    'Second line here.'
]);

// 添加带有 VTT 样式的字幕 (仅 VTT 支持)
$subtitles->add(11, 15, 'Styled text', ['vtt_cue_settings' => 'position:50% line:15% align:middle']);

// 移除特定时间范围内的字幕
$subtitles->remove(0, 5);

echo "字幕添加与移除操作完成。\n";
echo $subtitles->content('vtt');

<pre class="brush:php;toolbar:false;"><?php

use Done\Subtitles\Subtitles;

$subtitles = Subtitles::loadFromFile('subtitles.srt'); // 假设加载了一个字幕文件

// 将所有字幕时间向后平移 1 秒
$subtitles->shiftTime(1);
echo "所有字幕时间向后平移 1 秒。\n";

// 将所有字幕时间向前平移 0.5 秒
$subtitles->shiftTime(-0.5);
echo "所有字幕时间向前平移 0.5 秒。\n";

// 仅对视频 1 分钟到 2 分钟之间的字幕，时间向后平移 5 秒
$subtitles->shiftTime(5, 60, 120); // 从 60 秒到 120 秒
echo "特定时间段字幕平移 5 秒。\n";

// 渐进式时间调整：在 1 小时视频内，从开始时不调整，到结束时平移 2 秒
// 在视频中间时，平移 1 秒
$subtitles->shiftTimeGradually(2, 0, 3600); // 2秒是最大偏移量，3600秒是视频总长
echo "字幕时间渐进式调整完成。\n";

// 裁剪字幕，只保留 3 到 4 秒之间的内容
$subtitles->trim(3, 4);
echo "字幕裁剪至 3-4 秒。\n";

echo $subtitles->content('vtt');

<pre class="brush:php;toolbar:false;"><?php

use Done\Subtitles\Subtitles;
use Done\Subtitles\Code\UserException;

try {
    // 假设这里有一个过长的文本，不符合 SCC 格式要求
    (new Subtitles())->add(0, 1, 'very long text... aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa')->content('scc');
} catch (UserException $e) {
    echo "字幕文件错误： " . $e->getMessage() . "\n";
    // 输出：SCC file can't have more than 4 lines of text each 32 characters long. This text is too long: <text from user file that triggered this error>
}

// 允许非严格模式处理文件
Subtitles::convert($input, $output, ['strict' => false]);