pecee/subscene-php-sdk

简单、轻量级的PHP-SDK,用于搜索和下载Subscene.com上的字幕

1.0.0.1 2017-12-26 14:54 UTC

This package is auto-updated.

Last update: 2024-08-25 13:07:01 UTC


README

简单、轻量级的PHP-SDK,用于搜索和下载Subscene.com上的字幕。

警告:请谨慎使用!

遗憾的是,Subscene.com尚未提供官方API,尽管他们在2013年通过推特宣布了API。

这意味着,SDK可能会发生变化,并且当网站应用新更新时可能不会按预期工作。

在使用此SDK进行生产之前,请务必注意这一点。

致谢

感谢Subscene.com提供这项出色的服务!

我们还在等待你承诺的API :)

安装

您可以通过在终端/命令行中运行以下composer命令轻松地将此库添加到项目中:

composer require pecee/subscene-php-sdk

要求

  • PHP 5.6或更高版本
  • 启用curl扩展

使用方法

搜索字幕

$client = \Pecee\Service\Subscene();
$subtitles = $movie->search('The Walk');

参数

响应

[
   {
      "id":"the-walk",
      "title":"The Walk",
      "year":"2015",
      "count":"114",
   }
]

通过电影ID获取字幕

$client = \Pecee\Service\Subscene();
$subtitles = $movie->getSubtitles('the-walk', ['dan', 'eng']);

参数

响应

[
   {
      "id":"the-walk",
      "title":"The Walk",
      "year":"2015",
      "count":"114",
      "subtitles":[
         {
            "language":"Danish",
            "language_id":"dan",
            "filename":"The-Walk-2015-720p-BluRay-x264-YIFY-[YTS.AG]",
            "author":"Firewalker.dk",
            "comment":"Retail Rippet og tilpasset af TeamSky uploadet af Firewalker.dk",
            "download_url":"https:\/\/subscene.com\/subtitle\/download?mac=Hd63BOWXFRbtZJKQmd1nmRLJ9cJAYJeYQYidqyixTQ5ORYDQ72_lUCwgSWx9Vdd28ODVS7GlWY0gMzo58gDZsKDEkQf5UgrlJKf8PL_LJHxYCc6rFPaePaE7UfGlSgJL0"
         },
         {
            "language":"English",
            "language_id":"eng",
            "filename":"Yify \/ Superchillin",
            "author":"japangoodtime",
            "comment":"French speaking parts and some hard to hear English part",
            "download_url":"https:\/\/subscene.com\/subtitle\/download?mac=YYhV9nVUcbV1K_BhkVM8E6BrGB8qmFEFX3ykn6Iz0JEwNzh2YsugBFp-18ue_eYJw3RE_fVmlHV8nQh_FLsy7r5kZIJ_Z3OTBDIfWhsj2BhhcKnFrY8jXQycuHUOuiSS0"
         }
      ]
   }
]

全文搜索

此方法将为每个结果查找字幕。根据结果数量,可能非常慢。

$client = \Pecee\Service\Subscene();
$subtitles = $movie->searchFull('the-walk', ['dan', 'eng']);

参数

响应

[
   {
      "id":"the-walk",
      "title":"The Walk",
      "year":"2015",
      "count":"114",
      "subtitles":[
         {
            "language":"Danish",
            "language_id":"dan",
            "filename":"The-Walk-2015-720p-BluRay-x264-YIFY-[YTS.AG]",
            "author":"Firewalker.dk",
            "comment":"Retail Rippet og tilpasset af TeamSky uploadet af Firewalker.dk",
            "download_url":"https:\/\/subscene.com\/subtitle\/download?mac=Hd63BOWXFRbtZJKQmd1nmRLJ9cJAYJeYQYidqyixTQ5ORYDQ72_lUCwgSWx9Vdd28ODVS7GlWY0gMzo58gDZsKDEkQf5UgrlJKf8PL_LJHxYCc6rFPaePaE7UfGlSgJL0"
         },
         {
            "language":"English",
            "language_id":"eng",
            "filename":"Yify \/ Superchillin",
            "author":"japangoodtime",
            "comment":"French speaking parts and some hard to hear English part",
            "download_url":"https:\/\/subscene.com\/subtitle\/download?mac=YYhV9nVUcbV1K_BhkVM8E6BrGB8qmFEFX3ykn6Iz0JEwNzh2YsugBFp-18ue_eYJw3RE_fVmlHV8nQh_FLsy7r5kZIJ_Z3OTBDIfWhsj2BhhcKnFrY8jXQycuHUOuiSS0"
         }
      ]
   }
]

下载字幕

从Subscene下载字幕。

$client = \Pecee\Service\Subscene();
$subtitles = $movie->download('https://subscene.com/subtitle/download?mac=YYhV9nVUcbV1K_BhkVM8E6BrGB8qmFEFX3ykn6Iz0JEwNzh2YsugBFp-18ue_eYJw3RE_fVmlHV8nQh_FLsy7r5kZIJ_Z3OTBDIfWhsj2BhhcKnFrY8jXQycuHUOuiSS0');

参数

响应

您将收到文件的二进制输出。

许可证

MIT许可证 (MIT)

版权所有 (c) 2017 Simon Sessingø / subscene-php-sdk

在此条件下,任何获得此软件及其相关文档副本(“软件”)的人均有权免费使用、复制、修改、合并、发布、分发、再许可和/或出售软件的副本,并允许向软件提供方提供软件的人这样做,但须遵守以下条件:

上述版权声明和本许可声明应包含在软件的任何副本或主要部分中。

本软件按“现状”提供,不提供任何明示或暗示的保证,包括但不限于适销性、特定用途的适用性和非侵权性保证。在任何情况下,作者或版权所有者均不对任何索赔、损害或其他责任(无论因合同、侵权或其他原因而产生)承担责任,无论是因使用软件或软件的使用或其他交易而产生。