TwitterOAuth 视频上传状态处理指南

在使用 TwitterOAuth 库进行视频上传时，开发者可能会遇到"媒体ID无效"的错误提示。本文将深入分析这一问题的成因，并提供完整的解决方案。

问题现象分析

当开发者尝试通过 TwitterOAuth 上传视频并立即使用返回的媒体ID发布推文时，系统会返回错误信息"Your media IDs are invalid"。从返回的响应对象中可以观察到关键信息：

{
  "processing_info": {
    "state": "pending",
    "check_after_secs": 1
  }
}

这表明视频文件虽然已成功上传，但Twitter后台仍在处理该视频文件，尚未达到可用状态。

根本原因

Twitter的视频处理是一个异步过程，不同于图片等静态媒体。当上传完成后，Twitter服务器需要时间进行转码和优化处理。在返回的响应中，state字段明确显示了当前处理状态为"pending"(处理中)，此时直接使用媒体ID是不被允许的。

完整解决方案

1. 检查处理状态

在尝试使用媒体ID前，必须先确认视频处理已完成。Twitter API提供了状态检查机制：

// 上传视频后获取media_id
$media = $connection->upload('media/upload', [
    'media' => '/path/to/video.mp4',
    'media_type' => 'video/mp4',
    'media_category' => 'tweet_video'
], ['chunkedUpload' => true]);

// 检查处理状态
$status = $connection->get('media/upload', [
    'command' => 'STATUS',
    'media_id' => $media->media_id_string
]);

while ($status->processing_info->state != 'succeeded') {
    sleep($status->processing_info->check_after_secs);
    $status = $connection->get('media/upload', [
        'command' => 'STATUS',
        'media_id' => $media->media_id_string
    ]);
}

2. 处理不同状态

视频处理可能经历多个状态：

• pending: 处理中，需要等待
• in_progress: 处理进行中，可以显示进度
• succeeded: 处理成功，可以使用
• failed: 处理失败，需要重新上传

3. 最佳实践建议

1. 超时处理：为状态检查设置合理的超时时间，避免无限等待
2. 错误处理：捕获并处理可能的网络错误或API限制
3. 进度反馈：对于长时间处理的视频，可以向用户显示处理进度
4. 重试机制：对于失败状态，实现自动重试逻辑

完整示例代码

<?php
require "vendor/autoload.php";
use Abraham\TwitterOAuth\TwitterOAuth;

// 初始化连接
$connection = new TwitterOAuth(CONSUMER_KEY, CONSUMER_SECRET, ACCESS_TOKEN, ACCESS_TOKEN_SECRET);
$connection->setApiVersion(1.1);
$connection->setTimeouts(30, 30); // 适当增加超时时间

// 上传视频
try {
    $media = $connection->upload('media/upload', [
        'media' => '/path/to/video.mp4',
        'media_type' => 'video/mp4',
        'media_category' => 'tweet_video'
    ], ['chunkedUpload' => true]);
    
    // 等待处理完成
    $maxAttempts = 30; // 最大尝试次数
    $attempts = 0;
    do {
        $status = $connection->get('media/upload', [
            'command' => 'STATUS',
            'media_id' => $media->media_id_string
        ]);
        
        if ($status->processing_info->state === 'failed') {
            throw new Exception('视频处理失败');
        }
        
        if (++$attempts >= $maxAttempts) {
            throw new Exception('视频处理超时');
        }
        
        sleep($status->processing_info->check_after_secs);
    } while ($status->processing_info->state !== 'succeeded');
    
    // 发布推文
    $connection->setApiVersion(2);
    $result = $connection->post('tweets', [
        'text' => '示例视频推文',
        'media' => ['media_ids' => [$media->media_id_string]]
    ]);
    
    print_r($result);
} catch (Exception $e) {
    echo '错误: ' . $e->getMessage();
}

性能优化建议

1. 并行处理：如果有多个视频需要上传，可以考虑并行处理
2. 预上传：在用户实际发布前提前上传视频
3. 缓存机制：对已处理的视频媒体ID进行缓存，避免重复上传
4. 断点续传：对于大文件，实现分块上传和断点续传功能

通过理解Twitter媒体处理的异步特性并实现正确的状态检查机制，开发者可以避免"媒体ID无效"的错误，确保视频内容能够顺利发布。