codebuglab / laravel-opensubtitles
简单集成OpenSubtitles API,用于搜索和下载字幕。
1.0.1
2024-06-19 01:07 UTC
Requires
- php: >=7.0
- illuminate/support: >=6.0.0
This package is auto-updated.
Last update: 2024-09-19 01:39:46 UTC
README
简单集成OpenSubtitles API,用于搜索和下载字幕。
目录
设置
安装
要通过composer安装此包,请在终端中运行以下命令
composer require codebuglab/laravel-opensubtitles
发布
您必须使用以下artisan命令发布配置文件
php artisan vendor:publish --provider="CodeBugLab\OpenSubtitles\OpenSubtitlesServiceProvider"
- 文件
opensubtitles.php
将在发布后位于config
文件夹中。 - 然后您必须将您的OpenSubtitles API密钥放入您的
env
文件中,如下所示OpenSubtitles_API_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
。
说明
- 您可以使用OpenSubtitles API获取所需信息,首先快速查看 官方API页面。
- 对于所有后续API请求,您必须使用OpenSubtitles外观
use CodeBugLab\OpenSubtitles\Facades\OpenSubtitles;
- 每个请求都有自己的参数和响应,我们将详细介绍
字幕
搜索字幕
$parameters = [ 'imdb_id' => "315642", 'languages' => 'en', 'type' => 'movie' ]; $opensubtitles = OpenSubtitles::subtitles()->searchForSubtitles($parameters)->toArray();
- 简单地,这将根据OpenSubtitles中的电影ID、IMDB ID或TMDB ID搜索字幕。
- 有关参数和响应的更多信息,请点击此处。
下载
详细信息
$parameters = [ 'file_id' => "2712566", 'sub_format' => 'srt' ]; $srtFile = OpenSubtitles::download()->details($parameters)->getSrt();
- 您可以通过从 搜索字幕 查询中获取的
file_id
获取srt文件。 - 您还可以以其他格式下载文件,请查看此 链接 了解您可以下载的所有其他格式。
- 不幸的是,根据您的OpenSubtitle账户,下载量有限,从每天10次到1000次不等。
- 有关参数和响应的更多信息,请点击此处。
通过旧版字幕ID获取ZIP文件
$legacySubtitleId = "7090487"; $zipFile = OpenSubtitles::download()->getZipFileByLegacySubtitleId($legacySubtitleId);
- 这是下载字幕的非官方方法,但仍受到OpenSubtitles网站的支持。
- 我们需要旧版字幕ID而不是文件ID,这两个都可以在 搜索字幕 响应中找到。
- 使用此方法下载没有特定限制。
许可证
此包是免费软件,根据MIT许可证的条款分发。