開始錄制 · anychat_sdk_web_doc

### **開始錄制** ~~~ instance.startRecord(recordOpt) ~~~ **接口說明** 開始錄制，錄像可以錄制單方視頻流，也可以錄制多方視頻流。 **返回值** 錄制操作返回的狀態碼（0代表錄制成功） **接口參數簡介** | 名稱 |類型 |說明 |是否必須 | | --- | --- | --- | --- | | recordOpt| object | 錄制配置類 | 是| **recordOpt錄制配置類簡介** | 名稱 |類型 |說明 |是否必須 | | --- | --- | --- | --- | | recordLayoutOpt | object | 錄制畫面布局配置 | 是 | | done | function | 錄制結果通知 | 是 | | OnRecordStatus | function | 錄像心跳通知 | 否 | | OnRecordStart | function | 錄像開始通知 | 否 | | userId | number | 需要錄制的用戶ID | 否（默認為調用者ID，即-1，若調用者自身無視頻流，或者只需要錄其他人視頻，則需要傳該字段） | | width | number | 錄制畫面高度（默認640） | 否 | | height | number | 錄制畫面高度（默認480） | 否 | | mode | number | 1: 本地錄制(默認) 2:服務器端錄制 3:服務器合成流錄制| 否 | | content | number | 錄制內容: 1--既錄音又錄像(默認), 2--只錄音, 3--只錄像 | 否 | | fileType | number | 錄制文件類型: 1--MP4(默認) 2--WMV 3--FLV 4--MP3 5--WMA| 否 | | clipMode | number | 視頻裁剪模式: 0--默認模式，畫面以最大比例進行裁剪后再拉伸，被裁剪畫面較大； 1--重疊模式，只取最大有效部分，對邊緣進行裁剪； 2--縮小模式，縮小到合適的比例，不進行裁剪； 3--平鋪模式，不進行裁剪，但可能導致畫面不成比例| 否 | | fileName | string | 錄制文件名 | 否 | | localFilePath | string | 本地錄制文件存放目錄 | 否 | | category | string | 錄像文件上傳至服務器上的分類子目錄 | 否 | | isStrict | number | 嚴格模式 | 否（ 嚴格模式 -- 1（默認） 非嚴格模式 -- 0） | | isDealException | number | 異常情況處理 | 否（ 錄像服務處理--0（默認） 業務層處理 -- 1） | | strJson | string | 錄像自定義參數 | 否 | | statusnotify | number | 獲取錄像心跳的時間間隔 | 否 | recordLayoutOpt 錄制畫面布局配置類簡介： | 返回值 | 名稱 |說明 |備注 | | --- | --- | --- | --- | | recordlayout| int | 視頻布局，視頻流數量，即多少個視頻畫面| 是| | layoutstyle| int | 三路流和四路流的視頻畫面布局風格：0-并列風格（默認），1-畫中畫風格，2-三畫面并列風格| 是 | streamlist | array| 錄制畫面各個區域對應的視頻流。視頻流對象包含三個屬性： 1、userid錄制對象ID; 2、streamindex：錄制對象的視頻流號； 3、recordindex:錄制畫面編號 | 是 | **回調說明** | 名稱 | 參數(類型):說明 | 接口說明 | 備注 | | --- | --- | --- | --- | | OnRecordStartDone | data（返回數據） | 錄像開始回調 |data.userid: 用戶id data.statuscode: 錄像狀態碼，1為prepare，2為start； data.status: 錄像狀態，值為prepare，start | | OnRecordStatusDone | result(執行結果) data（返回數據） | 錄像心跳回調 |result.code: 0表示成功 result.msg: 結果描述； data.guid: 發起錄制的guid | | OnRecordAbnormalDone | result(執行結果) data（返回數據） | 錄像異常回調 |result.code: 0表示成功 result.msg: 結果描述； data.guid: 發起錄制的guid | | onRecordDone | result(執行結果) data（返回數據） | 錄像結束回調 |result.code: 0表示成功，其他表示錯誤代號 result.msg: 結果描述； data.userid: 發起錄制的用戶ID data.filePath: 錄制文件的保存地址 data.elapse: 錄像時長，時間為秒； data.filelength: 錄像文件大小 data.filemd5: 錄像文件md5值(用于校驗錄像文件完整性等) | **示例代碼** ~~~ var recordLayoutOpt = {}； recordLayoutOpt.recordlayout = 2; recordLayoutOpt.layoutstyle= 0; //錄制畫面各個區域對應的視頻流 layoutStreams 的用法 recordLayoutOpt.streamlist= [ { userid: -1, //自己ID streamindex: 0, //用戶的視頻流編號，用戶可能存在多個攝像頭 recordindex: 1 //錄制畫面編號, 由數字從小到大向右排序， //若是錄制畫面是大小屏的，0是大屏，1是小屏 }, { userid: VideoCallUserId, //呼叫用戶ID streamindex: 0, //用戶的視頻流編號，用戶可能存在多個攝像頭 recordindex: 0 //錄制畫面編號，由數字從小到大向右排序， //若是錄制畫面是大小屏的，0是大屏，1是小屏 }， ... ]； var recordOpt = { userId: -1, //錄制的用戶ID,-1為自己 width: 640, //錄制畫面寬度 height: 480, //錄制畫面高度 mode: 1, //錄制模式 content: 1, //錄制內容 fileType: 1, //錄制文件類型 clipMode: 2, //視頻裁剪模式 fileName: '2018-08-06_15-25-06', //錄制文件名 localFilePath: 'd:\\anychat\\video', //本地錄制文件存放目錄 category: 'video', //錄像文件上傳至服務器上的分類子目錄 strJson: xxx, //錄像自定義參數 statusnotify: 15, //獲取錄像心跳的時間間隔 recordLayoutOpt:recordLayoutOpt,//錄制畫面布局配置 }; //調用錄制 instance.startRecord(recordOpt); ~~~