record_dev.md · 盛世六一/wawaji_doc

# 视频录制与剪辑

## 1 录制

### 1.1 开通点播服务

因为录制功能依托于 **点播服务系统**，所以想要录制需要先在腾讯云控制台上 [开通点播服务](https://console.cloud.tencent.com/video)。服务开通后，新录制的文件就可以在控制台的 [视频管理](https://console.cloud.tencent.com/video/videolist) 里找到。

### 1.2 录制方法

对房间直播视频流进行录制的方法有两种：**自动录制** 与 **手工录制**。

#### i. 自动录制（推荐）

自动录制的开启方法参考腾讯云直播服务的 [云端录制](https://cloud.tencent.com/document/product/267/7963) 指引文档。自动录制默认30分钟生成一个视频分片，可以通过 [剪辑](https://gitee.com/vqcloud/wawaji_doc/blob/master/record_dev.md#3-%E5%89%AA%E8%BE%91) 的方式将单局的游戏视频剪辑出来。

#### ii. 手工录制

如果您对录制有特殊需求，可以进行手工录制。手工录制可以直接控制录制的开始和结束时间，在录制结束后，**不需要再对视频文件进行剪辑操作**。

手工录制有两种方式：

- **在后台通过腾讯云提供的 `RESTful API` 发起（推荐）**

> 使用后台接口实现视频录制的大致步骤如下：
> 1. [开通点播服务](https://console.cloud.tencent.com/video)
> 2. 关闭自动录制（如果没有配置过的话默认是关闭的）, 自动录制的开启方法参考腾讯云直播服务的 [云端录制](https://cloud.tencent.com/document/product/267/7963) 指引文档
> 3. 设置 [录制回调](https://cloud.tencent.com/document/product/267/5957)
> 4. 开始推流之后，如果需要混流，可以调用腾讯云提供的 [混流接口](https://cloud.tencent.com/document/product/267/8832) 来进行混流
> 5. 开始游戏的时候，同时 [创建录制任务](https://cloud.tencent.com/document/product/267/9567)，推荐在接口中开启实时视频录制，并记录返回数据中的 `taskid`
> 6. 结束游戏的时候，同时 [结束录制任务](https://cloud.tencent.com/document/product/267/9568)，其中 `taskid` 是创建录制任务时返回的 `taskid`
> 7. 在录制回调的处理方法里记录录制文件地址

- **在客户端通过调用iLive SDK的 [手工旁路直播接口](https://cloud.tencent.com/document/product/268/8560) 进行旁路直播，并且在参数中指定开始录制(不推荐)**

## 2 混流

在存在多路视频流的时候，自动录制默认会对每个视频流都会单独录制成一个文件，如果希望录制的时候就对多个视频流进行混流成一个的话，需要在开始推流之后调用腾讯云提供的 [混流接口](https://cloud.tencent.com/document/product/267/8832)来实现。

这里指定的混流后的输出流ID需要记录下来，并与房间号做好映射，在后续进行视频剪辑的时候需要用到。

## 3 剪辑

由于自动录制的时候，录制的是整个直播过程中的视频流，如果需要把某个玩家游戏的过程进行回放的话，需要在收到录制回调后，根据需求对录制文件进行剪辑。

这里提供一种可行的剪辑步骤，当然您也可以在了解接口的情况下，根据自己的需求自行设计自己的实现方案。

为了能够顺利地对录制视频进行剪辑，您可以按照以下步骤进行：

- 开启自动录制功能，参考本文的`1.2 录制方法` 。

- 在控制台配置点播事件回调URL，参考 [任务管理与事件通知](https://cloud.tencent.com/document/product/266/7829)。

- 娃娃机控制端创建房间并开始推流，把 **房间信息（关键信息：房间号、推流用户ID）** 上报给业务服务器，业务服务器把房间信息记录到 **房间信息** 表中。

- 业务服务器调用 [混流接口](https://cloud.tencent.com/document/product/267/8832)将多路视频流混到一路新的视频流中，并把新的视频流ID记录到 **房间信息** 表中。

- 有用户进行游戏的时候，客户端把 **用户游戏信息（关键信息：用户ID、游戏房间号、游戏开始时间、游戏结束时间）** 上报到业务服务器，业务服务器把这些信息记录到 **游戏历史记录表** 中。

- 在确认录制文件生成成功（[录制回调](https://cloud.tencent.com/document/product/267/5957)中有录制视频的开始、结束时间）后，业务服务器根据之前记录的信息（视频流ID、开始时间、结束时间）调用 [任务流处理接口](https://cloud.tencent.com/document/product/266/11030) 来进行视频文件剪辑，并记录接口返回的 `vodTaskId`。不想看文档的话，可以参考示例代码中的 `clipVideoFileByProcedure` 接口。

- 业务服务器收到点播事件回调后，根据回调中的 `fileId` 调用 [获取视频文件信息接口](https://cloud.tencent.com/document/product/266/8586) 来获取剪辑好的视频文件信息，并记录到对应的条目中。不想看文档的话，可以参考示例代码中的 `getVideoBasicInfo` 接口。

**示例**

```php
<?php

require_once dirname(__FILE__) . '/../../Config.php';

class VodRestApi {
    private $appid;
    private $secretId;
    private $secretKey;

/**
    * 构造方法
    * @param string $appid 腾讯云视频服务APPID
    * @param string $secretId 腾讯云视频录制SecretID
    * @param string $secretKey 腾讯云视频录制SecretKey
    */
    public function __construct($appid, $secretId, $secretKey){
        $this->appid = $appid;
        $this->secretId = $secretId;
        $this->secretKey = $secretKey;
    }

public static function getDefaultInstance() {
        $instance = new self(VIDEO_DEFAULT_APP_ID, VIDEO_RECORD_SECRET_ID, VIDEO_RECORD_SECRET_KEY);
        return $instance;
    }

/**
    * 向Rest服务器发送请求
    * @param string $httpType http类型,比如https
    * @param string $method 请求方式，比如POST
    * @param string $url 请求的url
    * @return string $data 请求的数据
    */
    private function httpReq($httpType, $method, $url, $data)
    {
        $url = $httpType . '://' . $url;
        $ch = curl_init();
        if (strstr($httpType, 'https'))
        {
            curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
            curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, 0);
        }   
        if ($method == 'post')
        {
            curl_setopt($ch, CURLOPT_POST, 1);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
        } else
        {
            $url = $url . '?' . $data;
        }
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_HEADER, 0);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
        curl_setopt($ch, CURLOPT_TIMEOUT,5);//超时时间

Log::info(__METHOD__ . ':' . __LINE__ . ', request: '. $url);
        try
        {
            $ret=curl_exec($ch);
        }catch(Exception $e)
        {
            curl_close($ch);
            return json_encode(array('ret'=>0,'msg'=>'failure'));
        }
        curl_close($ch);

Log::info(__METHOD__ . ':' . __LINE__ . ', response: ' . json_encode($ret));

return json_decode($ret, true);
    }

/**
     * 将参数URL化
     * @param string $baseUrl 服务请求基本链接
     * @param array $serviceParam 服务请求专属参数
     * @param array $commonParam 点播服务公共参数
     * @param boolean $needSig 是否需要计算signature
     */
    private function concatUrlParam($baseUrl, $serviceParam, $commonParam, $needSig){
        $params = array_merge($serviceParam, $commonParam);
        ksort($params);

$isFirst = true;
        foreach($params as $key => $value){
            if($isFirst){
                $paramStr = $key . '=' . $value;
                $isFirst = false;
            }else{
                $paramStr = $paramStr . '&' . $key . '=' . $value;
            }
        }

if($needSig){
            $src = 'GET' . $baseUrl . '?' . $paramStr;
            $sign = base64_encode(hash_hmac('sha256', $src, $this->secretKey, true));
            $paramStr = $paramStr . '&Signature=' . urlencode($sign);
        }

return $paramStr;
    }

/**
     * 通过录制流信息进行视频剪辑(https://cloud.tencent.com/document/product/266/11030)
     * @param string $streamId 直播码
     * @param int $starttime 指定开始时间
     * @param int $endtime 指定结束时间
     */
    public function clipVideoFileByProcedure($streamId, $starttime, $endtime){
        // 以下示例的含义是：
        // 1.把streamId为12345的所有fileId按录制时间区间（15020876538，15020876638）剪辑
        // 2.然后再把剪辑的结果拼接成目标文件，格式是mp4
        // 3.最后对目标文件发起任务流。
        // note: procedure参数参考： https://cloud.tencent.com/document/product/266/11700#.E7.82.B9.E6.92.AD.E9.A2.84.E7.BD.AE.E4.BB.BB.E5.8A.A1.E6.B5.81.E6.A8.A1.E6.9D.BF
        //
        // req:
        // https://vod.api.qcloud.com/v2/index.php?Action=RunProcedure
        // &inputType=Stream
        // &stream.streamId=12345
        // &stream.startTimeStamp=15020876538
        // &stream.endTimeStamp=1502087638
        // &procedure=QCVB_SimpleProcessFile
        // &COMMON_PARAMS

// rsp:
        // {
        //     "code": 0,
        //     "message": "",
        //     "vodTaskId": "procedure-7a2229a8f1957bfce08ba733fbfd4a3c",
        // }

$baseUrl = 'vod.api.qcloud.com/v2/index.php';

//service param
        $serviceParam = [
            'Action' => 'RunProcedure',
            'inputType' => 'Stream',
            'procedure' => 'QCVB_SimpleProcessFile(0,0,0,0)',
            'stream.streamId' => $streamId,
            'stream.startTimeStamp' => $starttime,
            'stream.endTimeStamp' => $endtime,
        ];

//common param(构建请求公共参数（https://cloud.tencent.com/document/api/213/6976）
        // 示例：
        // &SecretId=xxxxxxx
        // &Region=ap-guangzhou
        // &Timestamp=1465055529
        // &Nonce=59485
        // &Signature=mysignature
        // &SignatureMethod=HmacSHA256
        $commonParam = [
            'SecretId' => $this->secretId,
            'Region' => 'ap-guangzhou',
            'Timestamp' => time(),
            'Nonce' => rand(),
            'SignatureMethod' => 'HmacSHA256',
        ];

$paramStr = $this->concatUrlParam($baseUrl, $serviceParam, $commonParam, true);

$ret = $this->httpReq('https', 'get', $baseUrl, $paramStr);

return $ret;
    }

/**
     * 根据文件ID获取视频基础信息（https://cloud.tencent.com/document/product/266/8586）
     * @param string $fileId 文件ID
     */
    public function getVideoBasicInfo($fileId) {
        // 示例
        // req:
        // https://vod.api.qcloud.com/v2/index.php?Action=GetVideoInfo
        // &fileId=12345
        // &infoFilter.0=basicInfo
        // &COMMON_PARAMS
        //
        // rsp:
        // {
        //     "code": 0,
        //     "message": "",
        //     "basicInfo": {
        //         "name": "test file",
        //         "size": 1000,
        //         "duration": 10,
        //         "description": "",
        //         "status": "",
        //         "createTime": 1485156352,
        //         "updateTime": 1485156352,
        //         "expireTime": 1485256352,
        //         "classificationId": 1,
        //         "classificationName": "",
        //         "playerId": 0,
        //         "coverUrl": "http://xxxx.vod2.myqcloud.com/xxxx/xxxx/shotup/f0.100_0.jpg",
        //         "type": "mp4",
        //         "sourceVideoUrl": "http://xxxx.vod2.myqcloud.com/xxxx/xxxx/f0.mp4"
        //     }
        // }

$baseUrl = 'vod.api.qcloud.com/v2/index.php';

//service param
        $serviceParam = [
            'Action' => 'GetVideoInfo',
            'fileId' => $fileId,
            'infoFilter.0' => 'basicInfo',
        ];

$paramStr = $this->concatUrlParam($baseUrl, $serviceParam, $commonParam, true);

$ret = $this->httpReq('https', 'get', $baseUrl, $paramStr);

return $ret;
    }

}
```

盛世六一/wawaji_doc

简介

发行版

贡献者

近期动态

盛世六一/wawaji_doc .gitee-modal { width: 500px !important; }

简介

发行版

贡献者

近期动态

搜索帮助

盛世六一/wawaji_doc