播放器SDK功能詳情
阿里云播放器SDK（ApsaraVideo Player SDK，后續(xù)統(tǒng)稱“播放器SDK”）是MediaBox音視頻SDK的子產(chǎn)品之一，提供直播和點(diǎn)播場(chǎng)景中視頻播放功能，支持Web、Android、iOS、Flutter、Windows、macOS等多種平臺(tái)。通過(guò)閱讀本文，您可以了解播放器SDK支持的功能。
標(biāo)準(zhǔn)功能
本文以Web、Android和iOS端為例，為您介紹了播放器SDK的標(biāo)準(zhǔn)功能。其中，??和?分別表示支持和不支持該功能。
播放協(xié)議與格式
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
點(diǎn)播播放 | 支持常見(jiàn)的FLV、HLS、MP4、MP3等點(diǎn)播場(chǎng)景的音視頻格式。 | ?? | ?? | ?? |
直播播放 | 支持常見(jiàn)的RTMP、FLV、HLS等直播場(chǎng)景的音視頻格式。 | ??，不支持RTMP協(xié)議 | ?? | ?? |
直播時(shí)移 | 支持直播時(shí)移視頻流播放，可設(shè)置開(kāi)始、結(jié)束和當(dāng)前支持時(shí)間，支持拖動(dòng)。 | ?? | ?? | ?? |
H.264編碼協(xié)議 | 支持播放H.264編碼協(xié)議的視頻流，支持軟硬解切換。 | ?? | ?? | ?? |
H.265編碼協(xié)議 | 支持播放H.265編碼協(xié)議的視頻流，支持軟硬解切換。 | ??，需申請(qǐng)后方可使用，詳見(jiàn)增值功能。 | ?? | ?? |
H.266編碼協(xié)議 | 支持播放H.266編碼協(xié)議的視頻流。 | ??，需申請(qǐng)后方可使用，詳見(jiàn)增值功能。 | ??，需申請(qǐng)后方可使用，詳見(jiàn)增值功能。 | ??，需申請(qǐng)后方可使用，詳見(jiàn)增值功能。 |
超低延時(shí)直播RTS | 支持高并發(fā)、低卡頓、毫秒級(jí)延遲的阿里云超低延時(shí)直播RTS。 | ?? | ?? | ?? |
低延時(shí)直播 | 支持LL-HLS、DASH協(xié)議的低延時(shí)流播放。 | ??，僅支持LL-HLS協(xié)議 | ?? | ?? |
DASH協(xié)議 | 支持標(biāo)準(zhǔn)協(xié)議的DASH視頻流播放，例如：SegmentBase 、SegmentTemplate。 | ?? | ?? | ?? |
HDR視頻播放 | 支持HDR10/HLG等多種HDR格式。 | ? | ?? | ?? |
URL播放 | 支持在線視頻、本地視頻以URL的方式播放。 | ?? | ?? | ?? |
VID播放 | 支持VID方式播放，同時(shí)對(duì)視頻下發(fā)多個(gè)清晰度的播放地址（若有），例如：VidAuth播放、VidSts播放。 | ?? | ?? | ?? |
SEI消息 | 接受讀取SEI消息。 | ?? | ?? | ?? |
網(wǎng)絡(luò)協(xié)議
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
自定義Header | 請(qǐng)求音視頻資源時(shí)，自定義HTTP Headers內(nèi)容。 | ?? | ?? | ?? |
HTTPDNS | 支持標(biāo)準(zhǔn)HTTPDNS，降低DNS劫持風(fēng)險(xiǎn)。 | ? | ?? | ?? |
HTTP/2 | 支持HTTP/2，通過(guò)二進(jìn)制分幀、多路復(fù)用、首部壓縮等最新的特性，能夠大幅度提高Web性能，降低數(shù)據(jù)交互延遲。 | 取決于瀏覽器是否支持，詳情請(qǐng)參見(jiàn)Can I use http2? | ?? | ?? |
HTTP/3 | 支持HTTP/3，支持基于QUIC協(xié)議進(jìn)行加速，加速效果更快更優(yōu)。 | 取決于瀏覽器是否支持，詳情請(qǐng)參見(jiàn)Can I use http3? | ?? | ?? |
播放控制
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
基礎(chǔ)控制 | 支持開(kāi)始、結(jié)束、暫停、seek、自動(dòng)播放等播放控制功能。 | ?? | ?? | ?? |
seek | 支持拖動(dòng)到指定位置（UI支持手勢(shì)）；支持已經(jīng)緩沖的視頻內(nèi)容在拖動(dòng)時(shí)不清除緩沖內(nèi)容并快速拖動(dòng)。 | ?? | ?? | ?? |
精確seek | 支持精確到幀級(jí)別拖動(dòng)到指定位置。 | 支持毫秒級(jí)別的精確seek | ?? | ?? |
緩存內(nèi)seek | 支持已經(jīng)緩存的視頻內(nèi)容在seek時(shí)不清除緩存內(nèi)容并快速seek。 | ? | ?? | ?? |
續(xù)播 | 支持設(shè)置續(xù)播起播時(shí)間點(diǎn)。 | ?? | ?? | ?? |
循環(huán)播放 | 支持音視頻播放結(jié)束后自動(dòng)重播。 | ?? | ?? | ?? |
列表播放 | 支持短視頻列表播放功能，提升加載速度。 | ?? | ?? | ?? |
倍速播放 | 支持變速播放，支持音頻變速不變調(diào)。 | ??，0.5~2倍速 | ??，0.5~5倍速 | ??，0.5~5倍速 |
清晰度（手動(dòng)）切換 | 支持視頻點(diǎn)播的多路清晰度流切換。 | ?? | ?? | ?? |
無(wú)縫切換 | 針對(duì)阿里云直播流地址，在播放過(guò)程中支持無(wú)縫切換多個(gè)分辨率的直播流（switchStream），提升用戶的播放體驗(yàn)。 | ? | ?? | ?? |
切換音軌 | 支持視頻點(diǎn)播的多路音軌流切換。 | ?? | ?? | ?? |
截圖 | 支持截取當(dāng)前播放畫(huà)面幀并保存為靜態(tài)圖片。 | 部分支持，受平臺(tái)、播放模式的影響略有差異，詳情請(qǐng)參見(jiàn)開(kāi)啟截圖功能。 | ?? | ?? |
鎖定屏幕 | 支持鎖屏功能，包含鎖定旋轉(zhuǎn)和隱藏界面元素。 | ? | ?? | ?? |
視頻效果
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
填充 | 支持畫(huà)面填充和畫(huà)面裁剪兩種填充模式。 | ?? | ?? | ?? |
旋轉(zhuǎn) | 支持0°、90°、180°和270°四個(gè)視頻畫(huà)面渲染角度設(shè)置。 | ?? | ?? | ?? |
鏡像 | 支持無(wú)鏡像、水平鏡像和垂直鏡像三種鏡像模式設(shè)置。 | ?? | ?? | ?? |
亮度調(diào)節(jié) | 支持系統(tǒng)的亮度調(diào)節(jié)（UI支持手勢(shì)）。 | ? | ?? | ?? |
自定義播放器尺寸 | 支持自定義設(shè)置播放器的寬高。 | ?? | ?? | ?? |
畫(huà)中畫(huà)（小窗）播放 | 支持切換到畫(huà)中畫(huà)以小窗形式播放。 | ?? | ?? | ??，iOS14及其以下版本不支持在App外播放 |
音頻效果
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
音量調(diào)節(jié) | 支持調(diào)用系統(tǒng)接口調(diào)節(jié)觀看視頻的音量。 | ?? | ?? | ?? |
靜音 | 支持開(kāi)啟和關(guān)閉靜音功能。 | ?? | ?? | ?? |
純音頻播放 | 支持只播放視頻文件中的音頻和常見(jiàn)的音頻文件，例如：MP3、AAC。 | ?? | ?? | ?? |
后臺(tái)播放 | 支持界面切到后臺(tái)后繼續(xù)播放音頻。 | ?? | ?? | ?? |
播放性能
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
播放失敗重試 | 播放失敗時(shí)自動(dòng)重試。 | ?? | ?? | ?? |
自動(dòng)重連 | 支持直播的自動(dòng)重連功能。 | ?? | ?? | ?? |
本地緩存 | 支持視頻播放的同時(shí)緩存下載后面的內(nèi)容到本地，滿足短視頻場(chǎng)景下的循環(huán)播放，節(jié)約用戶流量。 | ? | ?? | ?? |
預(yù)加載 | 對(duì)本地緩存功能的升級(jí)，提升視頻的起播速度。 | ?? | ?? | ?? |
多實(shí)例 | 支持在一個(gè)界面添加多個(gè)播放器同時(shí)播放。 | ?? | ?? | ?? |
網(wǎng)絡(luò)自適應(yīng)播放多碼率視頻流 | 支持多碼率HLS、DASH的無(wú)縫切換。 | ?? | ?? | ?? |
動(dòng)態(tài)追幀 | 支持直播的動(dòng)態(tài)追幀，降低延時(shí)。 | ?? | ?? | ?? |
互動(dòng)功能
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
字幕 | 支持導(dǎo)入自定義的字幕文件。 | ??，支持VTT字幕 | ??，支持SRT、SSA、ASS、VTT字幕 | ??，支持SRT、SSA、ASS、VTT字幕 |
視頻安全
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
referer黑白名單 | 支持通過(guò)播放請(qǐng)求中攜帶的referer字段識(shí)別請(qǐng)求來(lái)源，以黑名單或白名單方式對(duì)請(qǐng)求來(lái)源進(jìn)行控制。 | ?? | ?? | ?? |
HLS標(biāo)準(zhǔn)加密 | 支持標(biāo)準(zhǔn)AES-128加密方案。 | ?? | ?? | ?? |
阿里云加密（私有加密） | 支持阿里云加密（私有加密）方案，防止視頻泄露和盜鏈問(wèn)題。 | ??，部分瀏覽器支持，詳情請(qǐng)參見(jiàn)H5功能適配說(shuō)明 | ?? | ?? |
安全下載 | 支持通過(guò)唯一應(yīng)用下載視頻并進(jìn)行加密。 | ? | ?? | ?? |
DRM加密 | 支持Widevine、Fairplay的DRM加密方案。 | ?? | ?? | ?? |
質(zhì)量服務(wù)
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
日志上報(bào) | 支持上報(bào)播放器SDK日志，統(tǒng)計(jì)音視頻點(diǎn)播、直播相關(guān)播放埋點(diǎn)信息。 | ?? | ?? | ?? |
播放異常追溯 | 支持按照指定用戶、播放會(huì)話對(duì)播放歷史進(jìn)行追溯，定位播放異常原因。 | ??，免費(fèi)版支持查詢最近3天數(shù)據(jù) | ??，免費(fèi)版支持查詢最近3天數(shù)據(jù) | ??，免費(fèi)版支持查詢最近3天數(shù)據(jù) |
播放數(shù)據(jù)大盤(pán) | 支持觀測(cè)播放量、播放用戶數(shù)等宏觀數(shù)據(jù)。 | ??，免費(fèi)版支持查詢最近3天數(shù)據(jù) | ??，免費(fèi)版支持查詢最近3天數(shù)據(jù) | ??，免費(fèi)版支持查詢最近3天數(shù)據(jù) |
開(kāi)發(fā)支持
功能 | 說(shuō)明 | Web端 | Android端 | iOS端 |
渲染數(shù)據(jù)輸出 | 支持邊渲染邊輸出PCM和YUV數(shù)據(jù)。 | ? | ?? | ?? |
事件回調(diào) | 支持對(duì)播放狀態(tài)回調(diào)、首幀回調(diào)、播放完成或失敗回調(diào)。 | ?? | ?? | ?? |
解碼策略黑名單 | 支持設(shè)置硬解碼黑名單。 | ?? | ?? | ?? |
網(wǎng)速顯示 | 支持播放器實(shí)例的實(shí)時(shí)網(wǎng)速上報(bào)。 | 僅支持超低延時(shí)直播RTS | ?? | ?? |
UI組件 | 包含完整UI，您可以根據(jù)自身需求選用。 | ?? | ?? | ?? |
增值功能
本文以Web、Android和iOS端為例，為您介紹了播放器SDK的增值功能。如需使用，請(qǐng)先為您的應(yīng)用申請(qǐng)?jiān)囉没蛸?gòu)買(mǎi)增值服務(wù)，Android和iOS端可登錄視頻點(diǎn)播控制臺(tái)申請(qǐng)?jiān)囉没蛸?gòu)買(mǎi)增值服務(wù)；Web端請(qǐng)提交工單進(jìn)行申請(qǐng)。，申請(qǐng)開(kāi)通增值服務(wù)。其中，??和?分別表示支持和不支持該功能。
功能 | 功能概述 | Web端 | Android端 | iOS端 |
播放H.265視頻 | 支持播放H.265的視頻流，相對(duì)于H.264視頻流有效降低帶寬消耗，改善播放性能。 說(shuō)明 Web播放器SDK如需播放H.265視頻，請(qǐng)先提交工單或聯(lián)系阿里云商務(wù)經(jīng)理申請(qǐng)開(kāi)通。 | ?? | ?? | ?? |
播放H.266視頻 | 支持播放H.266的視頻流，相對(duì)于H.264/H.265視頻流有效降低帶寬消耗，改善播放性能。 說(shuō)明 如需播放H.266視頻，請(qǐng)先提交工單或聯(lián)系阿里云商務(wù)經(jīng)理申請(qǐng)開(kāi)通。 | ?? | ?? | ?? |
高級(jí)ABR策略 | 相對(duì)于普通ABR策略更好地適應(yīng)多碼率HLS或DASH視頻流，明顯降低卡頓，提升平均播放碼率。 | ? | ?? | ?? |
VR播放 | 播放全景視頻，支持手勢(shì)操作、響應(yīng)陀螺儀、重力感應(yīng)器。 | ? | ?? | ?? |
端側(cè)超分 | 將低分辨率視頻轉(zhuǎn)換為高分辨率視頻，以提高視頻播放的清晰度，改善播放體驗(yàn)。 在確保視頻主觀體驗(yàn)的前提下，適應(yīng)更低碼率的視頻源，降低視頻傳輸費(fèi)用。 | ? | ?? | ?? |
端側(cè)銳化 | 突出圖像的輪廓和銳化模糊的細(xì)節(jié)，從而提供更清晰、更銳利的觀看效果。 | ? | ?? | ?? |
端側(cè)插幀 | 消除低幀率視頻的卡頓感，從而提供絲滑流暢的播放體驗(yàn)。 | ? | ?? | ?? |
音頻增強(qiáng) | 全景聲空間音頻技術(shù)，提供更加沉浸、真實(shí)的體驗(yàn)。 | ? | ?? | ?? |
增強(qiáng)型HTTPDNS | 支持阿里云CDN網(wǎng)絡(luò)精準(zhǔn)調(diào)度、實(shí)時(shí)解析生效，有效提高網(wǎng)絡(luò)性能。 說(shuō)明 播放器SDK從6.7.0版本開(kāi)始支持增強(qiáng)型HTTPDNS。6.7.0~6.11.0版本播放器SDK，請(qǐng)先提交工單或聯(lián)系阿里云商務(wù)經(jīng)理申請(qǐng)開(kāi)通；6.12.0及以后版本無(wú)需申請(qǐng)，默認(rèn)開(kāi)啟。 | ? | ?? | ?? |