README

PHP 字幕和字幕转换器

转换和编辑字幕和字幕。

支持的格式

安装

composer require mantas-done/subtitles

使用

将 .srt 文件转换为 .vtt

// add namespace
use \MindEdge\Subtitles\Subtitles;

Subtitles::convert('subtitles.srt', 'subtitles.vtt');

手动创建文件

$subtitles = new Subtitles();
$subtitles->add(0, 5, 'This text is shown in the beggining of video for 5 seconds');
$subtitles->save('subtitles.vtt');

从现有文件加载字幕

$subtitles = Subtitles::load('subtitles.srt');

从字符串加载字幕

$string = "
1
00:02:17,440 --> 00:02:20,375
Senator, we're making our final approach
";

$subtitles = Subtitles::load($string, 'srt');

保存字幕到文件

$subtitles->save('subtitler.vtt');

获取文件内容（不保存到文件）

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

添加字幕

$subtitles->add(0, 5, 'some text'); // from 0, till 5 seconds

// Add multiline text
$subtitles->add(0, 5, [
    'first line',
    'second line',
]);

删除字幕

$subtitles->remove(0, 5); // from 0, till 5 seconds

将所有字幕增加 1 秒

$subtitles->shiftTime(1);

减去 0.5 秒

$subtitles->shiftTime(-0.5);

从 1 分钟开始将字幕增加 5 秒到 2 分钟

$subtitles->shiftTime(5, 60, 120);

示例：在 1 小时视频上逐渐将时间移动 2 秒。视频开始时不要改变时间，中间移动 1 秒。视频结束时移动 2 秒。

$subtitles->shiftTimeGradually(2, 0, 3600);

如何添加新的字幕格式？

您需要实现 ConverterContract.php 接口。它有两个方法。

fileContentToInternalFormat($file_content)

internalFormatToFileContent($internal_format)

基本上，您的实现应该能够将字幕文件转换为“内部库的格式”，并将从内部库的格式转换回字幕文件。

“内部库的”格式用作中间格式，以便能够在不同格式之间转换。

最好的例子是查看 SrtConverter.php 的实现。以下是 .srt 文件的示例。

“内部格式”

“内部格式”只是一个 PHP 数组。它在库内部使用，以能够在不同格式之间转换。

Array
(
    [0] => Array
        (
            [start] => 137.44
            [end] => 140.375
            [lines] => Array
                (
                    [0] => Senator, we're making
                    [1] => our final approach into Coruscant.
                )
        )
    [1] => Array
        (
            [start] => 140.476
            [end] => 142.501
            [lines] => Array
                (
                    [0] => Very good, Lieutenant.
                )
        )
)

[start] - when to start showing text (float - seconds)
[end] - when to stop showing text (float -seconds)
[lines] - one or more text lines (array)

运行测试

最简单的方法是将 phpunit.phar 文件下载到项目的根目录。然后运行以下命令

php phpunit.phar

贡献

您可以通过任何方式贡献。如果您需要一些指导，请从下表中选择

目前库应仅支持基本功能（几行文本）。无需支持不同的文本样式或文本位置。

报告错误

如果某些文件与库不兼容，请创建一个问题并附加文件。

mindedge / subtitles

维护者

详细信息