如何通过Vimeo API PHP库请求指定4K/3K/2K画质的视频链接？

我之前在项目里也踩过Vimeo API返回的视频文件数组索引不固定的坑，核心解决思路就是彻底抛弃依赖数组索引的做法，转而通过每个视频文件对象自带的画质标识或分辨率属性来匹配咱们需要的目标画质。

步骤1：先搞懂Vimeo返回的视频文件结构 #

当你用Vimeo PHP库调用接口获取视频详情时，响应里的files数组包含了所有可用画质的资源信息，每个文件对象的核心字段大概是这样的：

[
    'quality' => '4k',
    'width' => 3840,
    'height' => 2160,
    'link' => 'https://player.vimeo.com/external/xxxx.mp4?s=xxxx&profile_id=xxxx',
    // 其他无关字段...
]

注意：Vimeo的quality字段会直接标记"4k"、"2k"这类明确画质，但3K没有对应的直接标识，需要通过分辨率宽度（3000-3839之间）来判断。

步骤2：编写针对性的筛选代码 #

下面是完整的PHP示例代码，直接解决你的需求：

use Vimeo\Vimeo;

// 初始化Vimeo客户端（替换成你的API密钥信息）
$client = new Vimeo('YOUR_CLIENT_ID', 'YOUR_CLIENT_SECRET', 'YOUR_ACCESS_TOKEN');

// 目标视频的Vimeo ID
$targetVideoId = '123456789';

// 调用API时只请求需要的字段，减少响应体积
$response = $client->get("/videos/{$targetVideoId}", [
    'fields' => 'files.quality,files.width,files.height,files.link'
]);

$videoData = $response->body;
$targetVideoUrls = [];

// 遍历所有可用视频文件，精准匹配目标画质
foreach ($videoData['files'] as $file) {
    // 匹配4K/2K这类有明确quality标识的资源
    if (in_array($file['quality'], ['4k', '2k'])) {
        $targetVideoUrls[$file['quality']] = $file['link'];
    }
    // 匹配3K资源（通过分辨率宽度范围判断）
    elseif ($file['width'] >= 3000 && $file['width'] < 3840) {
        $targetVideoUrls['3k'] = $file['link'];
    }
}

// 输出筛选结果
print_r($targetVideoUrls);

关键细节说明 #

• 彻底摆脱索引依赖：不管原数组里的画质顺序如何，遍历每个文件时直接检查属性，确保精准匹配。
• 3K画质的特殊处理：因为Vimeo没有直接标记"3k"的字段，所以用宽度区间（3000-3839）来识别——毕竟4K是3840宽度，2K是2560宽度，3K刚好卡在中间区间。
• 字段过滤优化：调用API时指定fields参数只获取必要字段，既加快响应速度，也让数据处理更简洁。
• 实际项目建议：记得给代码加上try-catch异常处理，应对视频不存在、API权限不足、请求超时等情况。

运行这段代码后，$targetVideoUrls数组里就会清晰地给出你需要的4K、3K、2K画质对应的视频链接，完全不用再担心索引随机的问题。

内容的提问来源于stack exchange，提问作者Matt Rowell