小程序开发定制声网（agora）云端录制（页面录制）实践总结

小程序开发定制近来使用声网的云端录小程序开发定制制功能中的页面录制，小程序开发定制来实现用户视角的课程小程序开发定制回放视频录制。小程序开发定制由于是声网刚新出的功能，文档不是很详细，所以踩了一些坑。在此记录一二。

注：声网页面录制文档地址： 

由于功能是新上的，所以文档不太完善，因此还需要参考：

目前还处于公测期。公测期期间，可以免费使用。

使用前，要确保开通了云端录制功能，且要将声网APPID、录制功能所需的key 、secret记下来。还要注意的是，声网录制开始时间和结束时间，都是由我们自己控制的

（当请求start接口时，就开始录制了，当请求stop接口时，就停止录制了。）

1.接口请求header信息需要增加：Authorization

或者直接在headers 中加入

2.请求acquire

3.请求start

4.请求stop

请求三个接口即可完成录制（以下代码只是简单示例---只提供大致代码，重点注解。）。

  1.     /** 简单示例（只提供大致代码，重点注解。并不完全）：开始录制
  2.      * @param $data
  3.      * @return bool
  4.      */
  5.     public function start($data)
  6.     {
  7.         
  8.        //请求声网接口开始录制
  9.         $data['prefix'] = empty($data['prefix']) ? 'test' : $data['prefix']; //文件名前缀
  10.         $data['hour'] = empty($data['hour']) ? 72 : $data['hour']; //设置云端录制 RESTful API 的调用时效
  11.         //录制视频设置
  12.         $data['fps'] = empty($data['fps']) ? 15 : $data['fps'];
  13.         $data['width'] = empty($data['width']) ? 960 : $data['width'];
  14.         $data['height'] = empty($data['height']) ? 720 : $data['height'];
  15.         //存储设置
  16.         $data['file_path'] = empty($data['file_path']) ? 'agoraRecordVideo' : $data['file_path']; //路径
  17.  
  18.         $baseStartUrl = $this->option['RestUrl'] . $this->option['AppID'] . '/cloud_recording/resourceid/';
  19.         $base64Credentials = base64_encode($this->option['Key'] . ':' . $this->option['Secret']);
  20.  
  21.         // 请求头
  22.         $header = [
  23.             'Authorization' => 'Basic ' . $base64Credentials,
  24.             'Content-type' => 'application/json;charset=utf-8'
  25.         ];
  26.  
  27.         $cname = $data['prefix'] . '-' . 'name';
  28.         $uid = (string) 1 //此处uid需要保持唯一性;
  29.  
  30.         $acquireData = [
  31.             'rest_url' => $this->option['RestUrl'],
  32.             'app_id' => $this->option['AppID'],
  33.             'base64_credentials' => $base64Credentials,
  34.             'hour' => $data['hour'],
  35.             'cname' => $cname,
  36.             'uid' => $uid
  37.         ];
  38.         $acquireRes = self::getAgoraResourceId($acquireData);
  39.  
  40.         if (!$acquireRes['resourceId']) {
  41.  
  42.             Log::error(['message' => '声网返回resourceId错误', 'agora' => $acquireRes], 'startAgoraRecordVideo');
  43.  
  44.             $this->addError('获取声网录resourceId错误，录制失败');
  45.             return false;
  46.         }
  47.  
  48.         $startUrl = $baseStartUrl . $acquireRes['resourceId'] . '/mode/web/start';
  49.         
  50.         $url = 'www.baidu.com' //你需要录制的页面地址;
  51.  
  52.         $startData = [
  53.             'cname' => $cname,
  54.             'uid' => $uid,
  55.             'clientRequest' => [
  56.                 'token' => '',
  57.                 'extensionServiceConfig' => [
  58.                     'errorHandlePolicy' => 'error_abort',
  59.                     'extensionServices' => [
  60.                         [
  61.                             'serviceName' => 'web_recorder_service',
  62.                             'errorHandlePolicy' => 'error_abort',
  63.                             'serviceParam' => [
  64.                                 'url' => $url,
  65.                                 'videoFps' => $data['fps'], //帧率
  66.                                 'audioProfile' => 1, //48 kHz 采样率，音乐编码，单声道，编码码率约 128 Kbps
  67.                                 'videoWidth' => $data['width'],
  68.                                 'videoHeight' => $data['height'],
  69.                                 'maxRecordingHour' => $data['hour'], //最大录制时长
  70.                             ]
  71.                         ]
  72.                     ]
  73.                 ],
  74.                 'recordingConfig' => [
  75.                     'maxIdleTime' => 86400  //不设置的话默认为30s:即推流中断30s，就会停止录制，建议设置此项
  76.                 ],
  77.                 'recordingFileConfig' => [
  78.                     'avFileType' => [
  79.                         'mp4', 'hls'
  80.                     ]
  81.                 ],
  82.                 'storageConfig' => [   //此处为第三方存储，可以设置其他存储
  83.                     'vendor' => 0, //七牛云
  84.                     'region' => 2, //华南
  85.                     'bucket' => '', //七牛云bucket
  86.                     'accessKey' => '',//七牛云accessKey
  87.                     'secretKey' => '',//七牛云secretKey
  88.                     'fileNamePrefix' => [
  89.                         $data['file_path']
  90.                     ]
  91.                 ]
  92.             ],
  93.         ];
  94.  
  95.         $startRes = HttpRequest::post($startUrl, $startData, $header);
  96.  
  97.         //成功，更新状态为开始录制  失败不更新
  98.         if ($startRes['sid']) {
  99.             $record= [
  100.                 'file_path' => $data['file_path'],
  101.                 'cname' => $cname,
  102.                 'uid' => $uid,
  103.                 'sid' => $startRes['sid'],
  104.                 'resource_id' => $startRes['resourceId']
  105.             ];
  106.  
  107.             /*****************以上数据应记录，以供后用******************/
  108.             记录代码省略....
  109.  
  110.         } else {
  111.             Log::error(['message' => '声网返回sid错误', 'agora' => $startRes], 'startAgoraRecordVideo');
  112.  
  113.             $this->addError('声网返回sid错误，录制失败');
  114.             return false;
  115.         }
  116.  
  117.         return true;
  118.     }
  119.  
  120.     /** 简单示例（只提供大致代码，重点注解。并不完全）停止录制
  121.      * @param $data
  122.      * @return bool
  123.      */
  124.     public function stop($data)
  125.     {
  126.         $record //record 为开始录制后记录下的数据
  127.  
  128.         $stopUrl = $this->option['RestUrl'] . $this->option['AppID'] . '/cloud_recording/resourceid/' . $record['resource_id'] . '/sid/' . $record['sid'] . '/mode/web/stop';
  129.         $base64Credentials = base64_encode($this->option['Key'] . ':' . $this->option['Secret']);
  130.  
  131.         // 请求头
  132.         $header = [
  133.             'Authorization' => 'Basic ' . $base64Credentials,
  134.             'Content-type' => 'application/json;charset=utf-8'
  135.         ];
  136.  
  137.         $stopData = [
  138.             'cname' => $record['cname'],
  139.             'uid' => $record['uid'],
  140.             'clientRequest' => (object)null  //此处需传空对象
  141.         ];
  142.  
  143.         $qiniuUrl = Yii::$app->params['qiniu']['host']; //文件存储地址host
  144.  
  145.         $stopRes = HttpRequest::post($stopUrl, $stopData, $header);
  146.  
  147.         if (!empty($stopRes['serverResponse']['extensionServiceState'])) {
  148.             $name = $stopRes['serverResponse']['extensionServiceState'][1]['payload']['fileList'][1]['filename'];
  149.  
  150.             $record = [
  151.                 'file_url' => $qiniuUrl . $record['file_path'] . '/' . $name,
  152.             ];
  153.             /***************得到录制文件地址****************/
  154.             
  155.         } else {
  156.             Log::error(['message' => '声网停止录制文件错误', 'agora' => $stopRes], 'stopAgoraRecordVideo');
  157.         }
  158.  
  159.         return true;
  160.     }
  161.  
  162.     /**
  163.      * 声网acquire接口获取resourceId
  164.      * @param $data
  165.      * @return bool|mixed|string
  166.      */
  167.     public static function getAgoraResourceId($data)
  168.     {
  169.         $acquireUrl = $data['rest_url'] . $data['app_id'] . '/cloud_recording/acquire';
  170.         // 请求头
  171.         $header = [
  172.             'Authorization' => 'Basic ' . $data['base64_credentials'],
  173.             'Content-type' => 'application/json;charset=utf-8'
  174.         ];
  175.         $acquireData = [
  176.             'cname' => $data['cname'],//区分录制进程
  177.             'uid' => $data['uid'],
  178.             'clientRequest' => [
  179.                 'resourceExpiredHour' => $data['hour'],
  180.                 'scene' => 1
  181.             ]
  182.         ];
  183.  
  184.         $acquireRes = HttpRequest::post($acquireUrl, $acquireData, $header);
  185.  
  186.         return $acquireRes;
  187.     }

 

 

网站建设定制开发 软件系统开发定制 定制软件开发 软件开发定制 定制app开发 app开发定制 app开发定制公司 电商商城定制开发 定制小程序开发 定制开发小程序 客户管理系统开发定制 定制网站 定制开发 crm开发定制 开发公司 小程序开发定制 定制软件 收款定制开发 企业网站定制开发 定制化开发 android系统定制开发 定制小程序开发费用 定制设计 专注app软件定制开发 软件开发定制定制 知名网站建设定制 软件定制开发供应商 应用系统定制开发 软件系统定制开发 企业管理系统定制开发 系统定制开发