Zencoder API PHP 库使用指南

1. 安装指南

首先，您需要从 GitHub 下载 Zencoder API PHP 库。您可以通过访问 Zencoder API PHP 库 GitHub 仓库 来获取库的副本。

下载后，将库文件 Zencoder.php 放置在您的服务器上，确保您的脚本可以访问该文件。

git clone https://github.com/zencoder/zencoder-php.git

2. 项目使用说明

要开始使用 Zencoder API PHP 库，您需要创建 Services_Zencoder 类的新实例，并传递您的 API 密钥作为第一个参数。

$zencoder = new Services_Zencoder('您的API密钥');

一旦创建了对象，您就可以使用它来与 API 进行交互。以下是一些可以调用的函数的快速概览：

$zencoder->accounts->create($array);
$zencoder->jobs->create($array);
$zencoder->jobs->progress($job_id);
$zencoder->inputs->details($input_id);
$zencoder->outputs->details($output_id);
$zencer->notifications->parseIncoming();

任何错误都将抛出 Services_Zencoder_Exception。您可以在异常上调用 getErrors() 方法，它将返回从 Zencoder API 接收到的任何错误。

3. 项目API使用文档

Zencoder API PHP 库使用 cURL 来发送 JSON 格式的参数到 Zencoder 的编码 API。

创建编码任务

第一步

访问您的 Zencoder 账户中的 API 构建器，并执行一个成功的编码任务。

第二步

复制成功的 JSON 字符串（以第一个花括号 { 开头），并将其作为新 ZencoderJob 对象的参数。在您的服务器上执行此脚本来测试它是否正常工作。

try {
  $zencoder = new Services_Zencoder('您的API密钥');
  $encoding_job = $zencoder->jobs->create(
    array(
      "input" => "s3://bucket-name/file-name.avi",
      "outputs" => array(
        array(
          "label" => "web"
        )
      )
    )
  );
  echo "成功！\n";
  echo "任务 ID: " . $encoding_job->id . "\n";
  echo "输出 ID: " . $encoding_job->outputs['web']->id . "\n";
} catch (Services_Zencoder_Exception $e) {
  echo "失败 :(\n";
  foreach ($e->getErrors() as $error) {
    echo $error . "\n";
  }
}

第三步

修改上述脚本来满足您的需求。

通知处理

ZencoderOutputNotification 类用于捕获和解析当输出文件完成时从 Zencoder 发送到您的应用程序的 JSON 数据。

第一步

创建一个用于接收通知的脚本，并将其上传到服务器上的一个公共可访问位置。

try {
  $zencoder = new Services_Zencoder('您的API密钥');
  $notification = $zencoder->notifications->parseIncoming();
  // 根据通知状态进行处理
} catch (Services_Zencoder_Exception $e) {
  echo "失败 :(\n";
  foreach ($e->getErrors() as $error) {
    echo $error . "\n";
  }
}

第二步

在编码任务的参数中，为每个您想要接收到通知的输出添加脚本的 URL。

$encoding_job = $zencoder->jobs->create(
  array(
    "outputs" => array(
      array(
        "label" => "web",
        "notifications" => array("http://example.com/encoding/notification.php")
      )
    )
  )
);

第三步

修改上述脚本来满足您的需求。

4. 项目安装方式

请参考上述的安装指南来安装 Zencoder API PHP 库。确保您已经将库文件放置在服务器上，并且您的脚本可以访问到它。