来自私人视频的Vimeo缩略图

Question

我已经阅读了API文档,但我迷失了.

我想做的就是从私人视频中获取缩略图.

我没有构建应用程序,但要获得我需要的密钥,我必须包含应用程序的网站,徽标和应用程序的返回URL.

我再次需要一个缩略图.

我不是API的新手,但我真的需要一些示例PHP代码来帮助我开始,以及如何设置应用程序来获取我需要的密钥.

根据我的理解,我应该使用oembed,这看起来很简单,但我需要帮助进行身份验证.

Answer 1

创建一个应用程序

首先,您需要在您帐户下的Vimeo开发者网站上创建一个应用程序.不要过多担心应用程序的网站,徽标和应用程序的返回URL.

您只需输入localhost网站网址和返回网址,就可以为徽标上传自己的图片(请注意图片不是必需的).

但我建议填写"说明"以最适合您要做的事情.

这三个要求仅适用于特定身份验证,而您不想要这样做.

请确保您对以下问题回答" 否 ":

您会向用户收取使用您的应用的费用吗？您的集成是否会得到广告支持？

并回答"Web服务器"的问题:

哪个平台将运行此应用程序？

可能有一点他们会询问您的应用是否需要UPLOAD访问权限.请确保您回答" 否",因为请求上传访问的应用程序会通过审核.

创建令牌

转到您应用的" 身份验证 "标签下.

基本上,我们将跳过使用回调URL的身份验证,并直接创建具有以下范围的令牌:

公共,私人 不要打扰复制我的令牌,我已经删除了它.

创建令牌后,请确保将其复制并将其存储在某处.刷新页面后,您将无法再次获取令牌.请注意,您只使用PUBLIC和PRIVATE范围.由于您只是要求信息,这就足够了.

此外,您需要在App的身份验证选项卡下提供的客户端标识符和客户端密钥.

使用官方Vimeo PHP库

使用客户端ID,客户端机密和令牌进行基本身份验证.

//Where $client_id and $client_secrets are variables with your vimeo client id 
//and secrets that you copied from the app you created on Vimeo.
$vimeoLib = new \Vimeo\Vimeo($client_id, $client_secrets);

//Where $token is the variable containing the token you generated earlier
$vimeoLib->setToken($token);

获取所有缩略图

Vimeo将生成多个缩略图(不同大小).如果您不知道视频的缩略图ID是什么,那么我们必须先浏览所有视频数据.

我们首先会看到如何从单个视频返回的所有数据中获取缩略图.

为此,我们将使用此API:

GET https://api.vimeo.com/videos/{video_id}

返回以下内容:

+------------------+--------------------------------------------------+
| Http Status Code | Explanation                                      |
+------------------+--------------------------------------------------+
| 200 Ok           |                                                  |
+------------------+--------------------------------------------------+
| 404 not found    | If the video cannot be found.                    |
+------------------+--------------------------------------------------+

只要确保你知道你的vimeo id是什么.

//Where $vimeo_id is a variable containing your video's vimeo Id
$response = $vimeoLib->request("/me/videos/".$vimeo_id);

缩略图的响应看起来像这样:

{
    //I've replaced information regarding my videos with {SOME_DESCRIPTIVE_TEXT}
    //More info here
    "pictures": {
            "uri": "/videos/{VIMEO_ID_HERE}/pictures/{THUMBNAIL_ID_HERE}",
            "active": true,
            "type": "custom",
            "sizes": [
                {
                    "width": 100,
                    "height": 75,
                    "link": "https://i.vimeocdn.com/video/{THUMBNAIL_ID_HERE}_100x75.jpg?r=pad",
                    "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F{THUMBNAIL_ID_HERE}_100x75.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png"
                },
                {
                    "width": 200,
                    "height": 150,
                    "link": "https://i.vimeocdn.com/video/{THUMBNAIL_ID_HERE}_200x150.jpg?r=pad",
                    "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F{THUMBNAIL_ID_HERE}_200x150.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png"
                },
                {
                    "width": 295,
                    "height": 166,
                    "link": "https://i.vimeocdn.com/video/{THUMBNAIL_ID_HERE}_295x166.jpg?r=pad",
                    "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F{THUMBNAIL_ID_HERE}_295x166.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png"
                },
                {
                    "width": 640,
                    "height": 360,
                    "link": "https://i.vimeocdn.com/video/{THUMBNAIL_ID_HERE}_640x360.jpg?r=pad",
                    "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F{THUMBNAIL_ID_HERE}_640x360.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png"
                },
                {
                    "width": 960,
                    "height": 540,
                    "link": "https://i.vimeocdn.com/video/{THUMBNAIL_ID_HERE}_960x540.jpg?r=pad",
                    "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F{THUMBNAIL_ID_HERE}_960x540.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png"
                },
                {
                    "width": 1920,
                    "height": 1080,
                    "link": "https://i.vimeocdn.com/video/{THUMBNAIL_ID_HERE}_1920x1080.jpg?r=pad",
                    "link_with_play_button": "https://i.vimeocdn.com/filter/overlay?src0=https%3A%2F%2Fi.vimeocdn.com%2Fvideo%2F{THUMBNAIL_ID_HERE}_1920x1080.jpg&src1=http%3A%2F%2Ff.vimeocdn.com%2Fp%2Fimages%2Fcrawler_play.png"
                }
            ],
            "resource_key": "{RESOURCE_KEY}"
        }
        //More info here
  }

要检索您正在寻找的信息,您需要执行以下操作:

//Check to see if the request didn't fail
if($response["status"] === 200){

  //Get the pictures object
  $thumbnailsObject = $response["body"]["data"]["pictures"];

  //Get the URI, so next time you can directly request the thumbnails instead of going through the whole video data
  $thumbnailUri = $thumbnailsObject["uri"];

  //Array of thumbnail links that'll be populated after loop.
  $thumbnails = [];
  //thumbnail without S
  foreach($thumbnailsObject["sizes"] as $thumbnailObject){
    $thumbnails[] = $thumbnailObject["link"];
  }

  //Done, do something with $thumbnails
}

仅请求缩略图:

获得URI后,您可以在将来的请求中调用缩略图,如下所示:

GET https://api.vimeo.com/videos/{video_id}/pictures/{picture_id}

$response = $vimeoLib->request("/me/videos/".$vimeo_id."/pictures/".$picture_id);

或者使用$thumbnailUri之前的变量.

$response = $vimeoLib->request("/me".$thumbnailUri);