阅读本文，您可以获取 PHP SDK 画质测评的接口调用示例，实现快速开发。

调用说明

• 本文提供的接口调用示例均通过 AK 和 SK 初始化实例。
• 接口的参数说明和错误码等信息可通过接口文档或打开 API Explorer 的文档说明页签查看。

前提条件

调用接口前，请先完成 PHP SDK 的安装及初始化操作。

调用示例

本节为您介绍画质测评相关接口的功能和调用示例。

创建画质评测任务

您可以调用 CreateLiveVideoQualityAnalysisTask 接口创建画质评测任务。详细的参数说明可参见 CreateLiveVideoQualityAnalysisTask 接口文档。

接口调用示例如下所示。

<?php
include_once "./vendor/autoload.php";

use Volc\Service\Live\V20230101\Live;

// 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。
// 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY
$client = Live::getInstance();

$client->setAccessKey(getenv("VOLC_ACCESSKEY"));

$client->setSecretKey(getenv("VOLC_SECRETKEY"));

$body = [
    // 任务名称，默认为空，进行中任务名称不可重复，长度需小于 16 个字符。
    "Name" => "test",
    // 待测评流的播放地址，支持 FLV、HLS、RTMP 拉流地址。
    "SrcURL" => "https://pull.example.com/live/example.flv",
    // 画质测评的打点间隔，单位为秒，默认为 10，取值范围为 [3，10]。
    "Interval" => 5,
    // 测评任务持续时长，单位为秒，默认为 180，取值范围为 [60,300]。
    "Duration" => 300,
];

$response = $client->createLiveVideoQualityAnalysisTask($body);
print_r($response);

查询画质评测任务列表

您可以调用 ListLiveVideoQualityAnalysisTasks 接口查询画质评测任务列表。详细的参数说明可参见 ListLiveVideoQualityAnalysisTasks 接口文档。

接口调用示例如下所示。

<?php
include_once "./vendor/autoload.php";

use Volc\Service\Live\V20230101\Live;

// 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。
// 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY
$client = Live::getInstance();

$client->setAccessKey(getenv("VOLC_ACCESSKEY"));

$client->setSecretKey(getenv("VOLC_SECRETKEY"));

$body = [
    // 查询的任务名称列表，默认为空，表示查询结果不对任务名称进行筛选。
    // note：
    // Name 和 ID 不可同时传入。
    "Names" => ["test"],
    // 查询数据的页码，取值范围为正整数。
    "PageNum" => 1,
    // 每页显示的数据条数，最大是为 1000。
    "PageSize" => 10,
    // 查询的任务 ID 列表，默认为空，表示查询结果不对任务 ID 进行筛选。
    // note：
    // Name 和 ID 不可同时传入。
    "IDs" => ["23123***55t523"],
];

$response = $client->listLiveVideoQualityAnalysisTasks($body);
print_r($response);

查询单个画质测评任务详情

您可以调用 GetLiveVideoQualityAnalysisTaskDetail 接口查询单个画质测评任务详情。详细的参数说明可参见 GetLiveVideoQualityAnalysisTaskDetail 接口文档。

接口调用示例如下所示。

<?php
include_once "./vendor/autoload.php";

use Volc\Service\Live\V20230101\Live;

// 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。
// 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY
$client = Live::getInstance();

$client->setAccessKey(getenv("VOLC_ACCESSKEY"));

$client->setSecretKey(getenv("VOLC_SECRETKEY"));

$body = [
    // 查询的任务名称。
    // note：
    // Name 和 ID 二选一必填。
    "Name" => "test",
    // 查询的任务 ID。
    // note：
    // Name 和 ID 二选一必填。
    "ID" => "cbxmc",
];

$response = $client->getLiveVideoQualityAnalysisTaskDetail($body);
print_r($response);

删除画质测评任务

您可以调用 DeleteLiveVideoQualityAnalysisTask 接口删除画质测评任务。详细的参数说明可参见 DeleteLiveVideoQualityAnalysisTask 接口文档。

接口调用示例如下所示。

<?php
include_once "./vendor/autoload.php";

use Volc\Service\Live\V20230101\Live;

// 强烈建议不要把 VOLC_ACCESSKEY 和 VOLC_SECRETKEY 保存到工程代码里，否则可能导致 AccessKey 泄露，威胁您账号下所有资源的安全。
// 本示例通过从环境变量中读取 VOLC_ACCESSKEY 和 VOLC_SECRETKEY，来实现 API 访问的身份验证。运行代码示例前，请配置环境变量 VOLC_ACCESSKEY 和 VOLC_SECRETKEY
$client = Live::getInstance();

$client->setAccessKey(getenv("VOLC_ACCESSKEY"));

$client->setSecretKey(getenv("VOLC_SECRETKEY"));

$body = [
    // 待删除任务的任务名称。
    // note：
    // Name 和 ID 二选一必填。
    "Name" => "test",
    // 待删除任务的任务 ID。
    // note：
    // Name 和 ID 二选一必填。
    "ID" => "cbxmc",
];

$response = $client->deleteLiveVideoQualityAnalysisTask($body);
print_r($response);