截圖常見(jiàn)問(wèn)題
本文說(shuō)明了截圖中的常見(jiàn)問(wèn)題和對(duì)應(yīng)的解決方法。
截圖失敗常見(jiàn)報(bào)錯(cuò)
截圖任務(wù)錯(cuò)誤碼主要包含SnapshotTimeOut、InvalidParameter.ResourceNotFound、InvalidParameter.ResourceContentBad。錯(cuò)誤碼獲取方式提交截圖任務(wù)失敗可以通過(guò)查詢截圖任務(wù)接口來(lái)獲取失敗原因，詳情請(qǐng)參見(jiàn)查詢截圖作業(yè)。
SnapshotTimeOut
同步截圖任務(wù)超時(shí)。目前同步截圖作業(yè)會(huì)在5s內(nèi)返回，如果輸入文件過(guò)大可能會(huì)超時(shí)。當(dāng)超時(shí)頻繁，建議采用異步方式截圖。
InvalidParameter.ResourceNotFound
找不到輸入文件，導(dǎo)致提交不成功或截圖任務(wù)失敗。請(qǐng)根據(jù)以下原因進(jìn)行排查：
原因 | 解決方案 |
輸入文件在提交任務(wù)時(shí)還沒(méi)有完成上傳，或已經(jīng)被刪除。 | 請(qǐng)確保文件已經(jīng)上傳后再嘗試提交任務(wù)。 |
輸入文件的OSS路徑拼寫錯(cuò)誤。 | 請(qǐng)檢查拼寫。 |
輸入文件的OSS路徑未經(jīng)過(guò)URL Encoding正確轉(zhuǎn)換。 | 請(qǐng)參考URL Encoding說(shuō)明設(shè)置。 |
輸入文件的OSS Bucket與MPS服務(wù)不在同一地域。 | 請(qǐng)更換地域。 |
輸入文件的OSS存儲(chǔ)類型為冷歸檔存、深度冷歸檔存儲(chǔ)。 | 冷存數(shù)據(jù)需要先解凍取回后才可被訪問(wèn)處理。 |
輸入文件的OSS存儲(chǔ)類型為歸檔存儲(chǔ)，且未開(kāi)啟數(shù)據(jù)直讀或解凍取回。 | 歸檔存儲(chǔ)需要開(kāi)啟OSS數(shù)據(jù)直讀或先解凍取回才可被訪問(wèn)處理。 |
輸入文件的OSS Bucket開(kāi)啟了防盜鏈。 | 工作流自動(dòng)觸發(fā)需要在輸入媒體Bucket上配置referer，其他提交方式需要在input增加Referer參數(shù)。 |
InvalidParameter.ResourceContentBad
參數(shù)設(shè)置沖突或者輸入文件已損壞，導(dǎo)致提交不成功或截圖任務(wù)失敗。請(qǐng)根據(jù)以下步驟進(jìn)行排查：
請(qǐng)先確認(rèn)輸入文件是否正常。
請(qǐng)檢查截圖參數(shù)是否配置正確，特別注意截圖時(shí)間點(diǎn)Time，關(guān)鍵幀IFrameType、Output等信息。
如上述方法無(wú)法解決問(wèn)題，請(qǐng)您提供區(qū)域+RequestId聯(lián)系阿里云排查。
提交M3U8文件同步截圖失敗
M3U8文件同步截圖必須保證M3U8索引中的TS路徑與M3U8在相同的路徑下，異步無(wú)要求。
提交單張截圖失敗，指定時(shí)間超過(guò)視頻時(shí)長(zhǎng)
錯(cuò)誤碼：InvalidParameter.ResourceContentBad
錯(cuò)誤描述：The resource operated InputFile is bad
原因 | 解決方案 |
提交單張截圖任務(wù)，截取普通幀，設(shè)置time大于視頻時(shí)長(zhǎng)，因?yàn)橐曨l太短，所以截不到圖片，任務(wù)失敗。 | 修改time為小于視頻時(shí)長(zhǎng)的值。或者改為截取關(guān)鍵幀（FrameType=intra），當(dāng)time超過(guò)視頻時(shí)長(zhǎng)時(shí)，會(huì)返回時(shí)間點(diǎn)附近最近的關(guān)鍵幀圖片。 |
提交任務(wù)不成功，提示OutputFile Object參數(shù)問(wèn)題
錯(cuò)誤碼：InvalidParameter.ResourceContentBad
錯(cuò)誤描述：The format of parameter "SnapshotConfig:OutputFile:Object" is invalid
原因 | 解決方案 |
提交多張截圖任務(wù)（Num>1），但OutputFile的Object未添加{Count}占位符。參數(shù)設(shè)置錯(cuò)誤導(dǎo)致提交不成功。 | 需要將OutputFile的Object中添加{Count}，避免多張截圖路徑相同而被覆蓋。 |
提交WebVTT任務(wù)，將Format設(shè)置為vtt，但OutputFile的Object后綴沒(méi)有設(shè)置為.vtt。參數(shù)設(shè)置錯(cuò)誤導(dǎo)致提交不成功。 | 需要將OutputFile的Object后綴設(shè)置為.vtt，請(qǐng)檢查參數(shù)配置。 |
提交任務(wù)不成功，提示TileOutputFile Object參數(shù)問(wèn)題
錯(cuò)誤碼：InvalidParameter.ResourceContentBad
錯(cuò)誤描述：The format of parameter "SnapshotConfig:TileOutputFile:Object" is invalid
原因 | 解決方案 |
提交雪碧圖任務(wù)，但TileOutputFile的Object未添加{TileCount}占位符。參數(shù)設(shè)置錯(cuò)誤導(dǎo)致提交不成功。 | 需要將TileOutputFile的Object中添加{TileCount}，避免多張雪碧圖路徑相同而被覆蓋。 |
截圖設(shè)置疑問(wèn)
提交截圖任務(wù)如何區(qū)分同步異步
只要在SnapshotConfig中指定了Interval和Num的任何一個(gè)參數(shù)，則表示使用異步模式。跟是否設(shè)置了piplineId無(wú)關(guān)。
截圖設(shè)置時(shí)間點(diǎn)超過(guò)了視頻時(shí)長(zhǎng)會(huì)如何
單張截圖，設(shè)置time大于視頻時(shí)長(zhǎng)：
普通幀截圖：任務(wù)失敗。"InvalidParameter.ResourceContentBad"，The resource operated InputFile is bad
關(guān)鍵幀截圖：任務(wù)成功。返回時(shí)間點(diǎn)附近最近的關(guān)鍵幀圖片
多張截圖，設(shè)置Time＋I(xiàn)nterval＊Num>視頻時(shí)長(zhǎng)，任務(wù)成功。視頻時(shí)長(zhǎng)內(nèi)，正常截圖。截取點(diǎn)超過(guò)視頻時(shí)長(zhǎng)的，不截圖。截圖完成時(shí)返回實(shí)際截取的個(gè)數(shù)
截圖結(jié)果與預(yù)期不符
截圖數(shù)量與設(shè)置不一致
請(qǐng)根據(jù)以下原因進(jìn)行排查：
原因 | 解決方案 |
需要生成雪碧圖，但雪碧圖路徑與單張圖片的輸出路徑使用同一bucket的同名路徑，導(dǎo)致圖片路徑覆蓋。 | OutputFile和TileOutputFile請(qǐng)使用不同bucket或區(qū)分路徑命名。 |
使用了采樣截圖，指定了截圖數(shù)量和間隔時(shí)長(zhǎng)。但因?yàn)橐曨l較短，導(dǎo)致截取數(shù)量不夠。 | 結(jié)果正常，無(wú)需解決。 |
截取單張圖片時(shí)開(kāi)啟了首幀黑屏檢測(cè)。但因?yàn)槭讕呛谄帘贿^(guò)濾，導(dǎo)致沒(méi)截到圖片。 | 如果業(yè)務(wù)需要單張截圖不過(guò)濾黑幀，可以通過(guò)調(diào)整黑屏閾值（BlackLevel、PixelBlackThreshold）來(lái)實(shí)現(xiàn)。 |
設(shè)置了截取關(guān)鍵幀（即I幀，F(xiàn)rameType=intra）。但因?yàn)椋?/p>
| 如果要精確時(shí)間點(diǎn)截圖，請(qǐng)改為普通幀（FrameType=normal）。 |
截圖時(shí)間點(diǎn)與設(shè)置不一致
原因 | 解決方案 |
設(shè)置了截取關(guān)鍵幀（即I幀，F(xiàn)rameType=intra）。視頻中關(guān)鍵幀是間隔一段時(shí)間才會(huì)出現(xiàn)，所以截圖時(shí)間點(diǎn)不精確，會(huì)在設(shè)置的時(shí)間點(diǎn)附近尋找相應(yīng)的關(guān)鍵幀。 | 如果要精確時(shí)間點(diǎn)截圖，請(qǐng)改為普通幀（FrameType=normal）。 |
截圖模糊
原因 | 解決方案 |
設(shè)置了截取普通幀（即P幀，F(xiàn)rameType=normal）。普通幀的畫(huà)質(zhì)不如關(guān)鍵幀。 | 如果對(duì)畫(huà)質(zhì)有要求，請(qǐng)改為關(guān)鍵幀（FrameType=intra）。 |
截圖變形、比例與設(shè)置不一致
請(qǐng)根據(jù)以下原因進(jìn)行排查：
原因 | 解決方案 |
同時(shí)設(shè)置了截圖的寬Width、高Height，但與視頻比例不同，導(dǎo)致圖片變形。 | 建議只設(shè)置單邊，另一邊會(huì)按照視頻的分辨率保持比例不變，避免圖像變形。 |
需要生成雪碧圖，同時(shí)設(shè)置了Cellwidth、Cellheight但與圖片比例不同，導(dǎo)致雪碧圖中的小圖變形。 | 建議只設(shè)置單邊，另一邊會(huì)按照視頻的分辨率保持比例不變，避免圖像變形。 |
輸入視頻的dar/sar特性兼容問(wèn)題。 | 請(qǐng)您提供uid+區(qū)域+jobid聯(lián)系阿里云排查。 |
截圖旋轉(zhuǎn)，輸入豎屏視頻但截圖是橫屏
輸入的MP4豎屏視頻帶有旋轉(zhuǎn)標(biāo)識(shí)，所以輸出截圖是橫屏圖像。常見(jiàn)于移動(dòng)設(shè)備拍攝的視頻。
如何判斷視頻是否帶有旋轉(zhuǎn)標(biāo)識(shí)：
請(qǐng)調(diào)用SubmitMediaInfoJob - 提交媒體信息作業(yè)，查看VideoStream的Rotate信息，當(dāng)rotation取值為-90、90時(shí)，代表視頻會(huì)向左向右旋狀90度，從而導(dǎo)致橫豎方向改變。
同步截圖任務(wù)未生成雪碧圖或vtt文件
提交同步單張截圖任務(wù)時(shí)設(shè)置了雪碧圖、vtt參數(shù)。同步截圖僅能截一張圖片，不支持輸出雪碧圖或vtt。請(qǐng)使用異步任務(wù)。