GSYVideoPlayer 比例適配5 種模式怎么選、怎么接【免費(fèi)下載鏈接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support項(xiàng)目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayerGSYVideoPlayer 的視頻比例適配只依賴一行靜態(tài)調(diào)用GSYVideoType.setShowType()即可在 5 種比例模式之間切換無(wú)需改布局、無(wú)需動(dòng)渲染層。場(chǎng)景類型推薦模式一句話理由典型 App 舉例短視頻信息流SCREEN_TYPE_DEFAULT豎屏源保比例上下留邊觀感自然抖音、快手影視詳情頁(yè)SCREEN_TYPE_16_9寬屏源與橫屏容器最貼合愛(ài)奇藝、騰訊視頻體育賽事 / 直播SCREEN_TYPE_FULL無(wú)黑邊裁掉兩側(cè)不影響觀感虎撲直播、央視頻老視頻 / 教學(xué)錄播SCREEN_TYPE_4_3傳統(tǒng)比例源不二次裁剪網(wǎng)課平臺(tái)、檔案館監(jiān)控墻 / 廣告位SCREEN_MATCH_FULL必須鋪滿固定坑位變形可接受安防 App、開(kāi)屏廣告比例適配之所以比設(shè)個(gè)參數(shù)復(fù)雜核心矛盾有兩個(gè)。第一setShowType()寫(xiě)入的是靜態(tài)全局變量RecyclerView 里 N 個(gè)播放器實(shí)例共享同一個(gè)值后綁定的 item 會(huì)直接改寫(xiě)前一個(gè)實(shí)例下次測(cè)量讀到的比例第二全屏是獨(dú)立創(chuàng)建的播放器實(shí)例窗口態(tài)的比例狀態(tài)不會(huì)自動(dòng)傳遞過(guò)去旋轉(zhuǎn)屏幕后比例會(huì)悄悄回退。一行代碼切換比例的調(diào)用機(jī)制setShowType(int type)的簽名極簡(jiǎn)但它不是實(shí)例方法而是寫(xiě)類級(jí)靜態(tài)字段TYPE/** * 設(shè)置顯示比例,注意這是全局生效的 */ public static void setShowType(int type) { TYPE type; }設(shè)置對(duì)當(dāng)前活躍播放器的生效時(shí)機(jī)是下一次測(cè)量渲染層的MeasureHelper.doMeasure()在onMeasure時(shí)讀取GSYVideoType.getShowType()據(jù)此計(jì)算 TextureView 的目標(biāo)寬高。所以改完比例后要讓正在播放的實(shí)例立即生效需要補(bǔ)一次changeTextureViewShowType()加requestLayout()Demo 的resolveTypeUI()就是這么做的。另外注意GSYVideoType沒(méi)有reset()方法所謂復(fù)位就是重新調(diào)用setShowType(GSYVideoType.SCREEN_TYPE_DEFAULT)。5 種模式在測(cè)量層的差異一次看全常量名視覺(jué)效果是否裁剪是否變形適用端SCREEN_TYPE_DEFAULT保持原始寬高比容器側(cè)留黑邊否否全端SCREEN_TYPE_16_9按 16:9 出畫(huà)面源不符時(shí)留邊否否寬屏源為主SCREEN_TYPE_4_3按 4:3 出畫(huà)面寬屏設(shè)備上兩側(cè)黑邊明顯否否老視頻源SCREEN_TYPE_FULL鋪滿容器超出部分裁掉是否橫屏全屏SCREEN_MATCH_FULL強(qiáng)制拉伸到容器寬高是是特殊坑位兩種最值得展開(kāi)理解的模式全屏裁減SCREEN_TYPE_FULL測(cè)量時(shí)按高度撐滿或?qū)挾葥螡M取較大方向計(jì)算超出容器的邊緣直接裁掉。源碼注釋明確建議surface_container用 FrameLayout 作父布局否則裁減后的畫(huà)面位置會(huì)偏移。適合對(duì)畫(huà)面邊緣不敏感的體育賽事、演唱會(huì)直播是沉浸式全屏的主力模式。mMoreScale.setText(全屏); GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_FULL);默認(rèn)比例SCREEN_TYPE_DEFAULTMeasureHelper直接按視頻真實(shí)寬高含 SAR 修正計(jì)算容器裝不下時(shí)上下或左右留黑邊不裁不拉。它是唯一在getTextureParams()里讓渲染層走M(jìn)ATCH_PARENT的模式也是多實(shí)例共存時(shí)最安全的基線。其余三種SCREEN_TYPE_16_9與SCREEN_TYPE_4_3邏輯相同只是目標(biāo)比例固定非等比源會(huì)在對(duì)應(yīng)方向留邊SCREEN_MATCH_FULL直接把測(cè)量結(jié)果寫(xiě)成容器全寬全高畫(huà)面必然變形只建議給監(jiān)控、廣告這類必須鋪滿的坑位。從布局到全屏同步的完整走讀下面按執(zhí)行順序走一遍完整鏈路。先放最小布局。比例裁減模式下surface_container的父容器建議是 FrameLayoutFrameLayout android:layout_widthmatch_parent android:layout_height200dp com.shuyu.gsyvideoplayer.video.StandardGSYVideoPlayer android:idid/detail_player android:layout_widthmatch_parent android:layout_heightmatch_parent / /FrameLayout初始化后先定初始比例。這里把當(dāng)前比例存進(jìn)實(shí)例字段mType后面全屏同步要復(fù)用它int mType 1; // 對(duì)應(yīng) SCREEN_TYPE_16_9 mMoreScale.setOnClickListener(v - { mType (mType 1) % 5; resolveTypeUI(); });resolveTypeUI()里做兩件事調(diào)靜態(tài)方法改全局值再通知當(dāng)前實(shí)例立即重測(cè)private void resolveTypeUI() { if (mType 1) { GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_16_9); } // ... 其余分支同 Demo changeTextureViewShowType(); if (mTextureView ! null) mTextureView.requestLayout(); }最后一步是關(guān)鍵覆寫(xiě)startWindowFullscreen()把比例狀態(tài)搬進(jìn)全屏播放器。全屏窗口是另一個(gè)實(shí)例它啟動(dòng)時(shí)會(huì)按全局值重新測(cè)量但按鈕文案和mType是自己的字段不同步就會(huì)出現(xiàn)畫(huà)面是對(duì)的、按鈕顯示默認(rèn)比例的狀態(tài)漂移Override public GSYBaseVideoPlayer startWindowFullscreen(Context context, boolean actionBar, boolean statusBar) { SampleVideo sampleVideo (SampleVideo) super.startWindowFullscreen(context, actionBar, statusBar); sampleVideo.mType mType; sampleVideo.resolveTypeUI(); return sampleVideo; }SampleVideo.java 的startWindowFullscreen()與resolveNormalVideoShow()就是這條鏈路的完整參考實(shí)現(xiàn)退出全屏?xí)r反向回寫(xiě)一次mType。如果不做這兩處同步用戶旋轉(zhuǎn)屏幕進(jìn)入全屏后比例會(huì)回退到默認(rèn)按鈕文案也會(huì)和實(shí)際畫(huà)面不一致。邊界問(wèn)題清單比例改動(dòng)波及所有實(shí)例 →setShowType()是靜態(tài)方法寫(xiě)的是類字段 → 每個(gè)實(shí)例開(kāi)播前顯式重設(shè)一次。列表滾動(dòng)時(shí)比例被后續(xù) item 覆蓋 → RecyclerView 復(fù)用導(dǎo)致后綁定實(shí)例改寫(xiě)全局值 →onBindViewHolder中按 position 重設(shè)。自定義播放器比例不生效或布局錯(cuò)位 → 默認(rèn)實(shí)現(xiàn)只改GSYRenderView容器 → 重寫(xiě)changeTextureViewShowType()落到自定義布局。全屏旋轉(zhuǎn)后比例回退 → 全屏實(shí)例字段獨(dú)立未繼承窗口態(tài)的mType→startWindowFullscreen中同步并resolveTypeUI()。全屏退出后窗口播放器狀態(tài)丟失 → 回寫(xiě)邏輯缺失 →resolveNormalVideoShow中反向同步。收束與延伸閱讀比例適配的本質(zhì)是兩件事選對(duì)模式管好作用域。模式?jīng)Q定了測(cè)量公式作用域決定了這個(gè)靜態(tài)值在窗口、全屏、列表復(fù)用之間如何流轉(zhuǎn)。setShowType()負(fù)責(zé)前者startWindowFullscreen里的狀態(tài)同步負(fù)責(zé)后者兩者缺一就會(huì)出現(xiàn)黑邊錯(cuò)位或比例回退。延伸閱讀USE.md 中切換比例章節(jié)覆蓋全部比例模式與常用組合GSYVIDEO_PLAYER_PROJECT_INFO.md 播放器整體架構(gòu)理解渲染層如何消費(fèi)比例值GSYVideoType.java 常量定義與setScreenScaleRatio自定義比例入口如果你的項(xiàng)目已經(jīng)在自定義播放控件上投入較多下一個(gè)值得看的問(wèn)題是如何在完全自繪的控件體系里讓比例按鈕和手勢(shì)旋轉(zhuǎn)共享同一份狀態(tài)機(jī)?！久赓M(fèi)下載鏈接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support項(xiàng)目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考 GSYVideoPlayer 比例適配：5 種模式怎么選、怎么接
GSYVideoPlayer 比例適配5 種模式怎么選、怎么接【免費(fèi)下載鏈接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support項(xiàng)目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayerGSYVideoPlayer 的視頻比例適配只依賴一行靜態(tài)調(diào)用GSYVideoType.setShowType()即可在 5 種比例模式之間切換無(wú)需改布局、無(wú)需動(dòng)渲染層。場(chǎng)景類型推薦模式一句話理由典型 App 舉例短視頻信息流SCREEN_TYPE_DEFAULT豎屏源保比例上下留邊觀感自然抖音、快手影視詳情頁(yè)SCREEN_TYPE_16_9寬屏源與橫屏容器最貼合愛(ài)奇藝、騰訊視頻體育賽事 / 直播SCREEN_TYPE_FULL無(wú)黑邊裁掉兩側(cè)不影響觀感虎撲直播、央視頻老視頻 / 教學(xué)錄播SCREEN_TYPE_4_3傳統(tǒng)比例源不二次裁剪網(wǎng)課平臺(tái)、檔案館監(jiān)控墻 / 廣告位SCREEN_MATCH_FULL必須鋪滿固定坑位變形可接受安防 App、開(kāi)屏廣告比例適配之所以比設(shè)個(gè)參數(shù)復(fù)雜核心矛盾有兩個(gè)。第一setShowType()寫(xiě)入的是靜態(tài)全局變量RecyclerView 里 N 個(gè)播放器實(shí)例共享同一個(gè)值后綁定的 item 會(huì)直接改寫(xiě)前一個(gè)實(shí)例下次測(cè)量讀到的比例第二全屏是獨(dú)立創(chuàng)建的播放器實(shí)例窗口態(tài)的比例狀態(tài)不會(huì)自動(dòng)傳遞過(guò)去旋轉(zhuǎn)屏幕后比例會(huì)悄悄回退。一行代碼切換比例的調(diào)用機(jī)制setShowType(int type)的簽名極簡(jiǎn)但它不是實(shí)例方法而是寫(xiě)類級(jí)靜態(tài)字段TYPE/** * 設(shè)置顯示比例,注意這是全局生效的 */ public static void setShowType(int type) { TYPE type; }設(shè)置對(duì)當(dāng)前活躍播放器的生效時(shí)機(jī)是下一次測(cè)量渲染層的MeasureHelper.doMeasure()在onMeasure時(shí)讀取GSYVideoType.getShowType()據(jù)此計(jì)算 TextureView 的目標(biāo)寬高。所以改完比例后要讓正在播放的實(shí)例立即生效需要補(bǔ)一次changeTextureViewShowType()加requestLayout()Demo 的resolveTypeUI()就是這么做的。另外注意GSYVideoType沒(méi)有reset()方法所謂復(fù)位就是重新調(diào)用setShowType(GSYVideoType.SCREEN_TYPE_DEFAULT)。5 種模式在測(cè)量層的差異一次看全常量名視覺(jué)效果是否裁剪是否變形適用端SCREEN_TYPE_DEFAULT保持原始寬高比容器側(cè)留黑邊否否全端SCREEN_TYPE_16_9按 16:9 出畫(huà)面源不符時(shí)留邊否否寬屏源為主SCREEN_TYPE_4_3按 4:3 出畫(huà)面寬屏設(shè)備上兩側(cè)黑邊明顯否否老視頻源SCREEN_TYPE_FULL鋪滿容器超出部分裁掉是否橫屏全屏SCREEN_MATCH_FULL強(qiáng)制拉伸到容器寬高是是特殊坑位兩種最值得展開(kāi)理解的模式全屏裁減SCREEN_TYPE_FULL測(cè)量時(shí)按高度撐滿或?qū)挾葥螡M取較大方向計(jì)算超出容器的邊緣直接裁掉。源碼注釋明確建議surface_container用 FrameLayout 作父布局否則裁減后的畫(huà)面位置會(huì)偏移。適合對(duì)畫(huà)面邊緣不敏感的體育賽事、演唱會(huì)直播是沉浸式全屏的主力模式。mMoreScale.setText(全屏); GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_FULL);默認(rèn)比例SCREEN_TYPE_DEFAULTMeasureHelper直接按視頻真實(shí)寬高含 SAR 修正計(jì)算容器裝不下時(shí)上下或左右留黑邊不裁不拉。它是唯一在getTextureParams()里讓渲染層走M(jìn)ATCH_PARENT的模式也是多實(shí)例共存時(shí)最安全的基線。其余三種SCREEN_TYPE_16_9與SCREEN_TYPE_4_3邏輯相同只是目標(biāo)比例固定非等比源會(huì)在對(duì)應(yīng)方向留邊SCREEN_MATCH_FULL直接把測(cè)量結(jié)果寫(xiě)成容器全寬全高畫(huà)面必然變形只建議給監(jiān)控、廣告這類必須鋪滿的坑位。從布局到全屏同步的完整走讀下面按執(zhí)行順序走一遍完整鏈路。先放最小布局。比例裁減模式下surface_container的父容器建議是 FrameLayoutFrameLayout android:layout_widthmatch_parent android:layout_height200dp com.shuyu.gsyvideoplayer.video.StandardGSYVideoPlayer android:idid/detail_player android:layout_widthmatch_parent android:layout_heightmatch_parent / /FrameLayout初始化后先定初始比例。這里把當(dāng)前比例存進(jìn)實(shí)例字段mType后面全屏同步要復(fù)用它int mType 1; // 對(duì)應(yīng) SCREEN_TYPE_16_9 mMoreScale.setOnClickListener(v - { mType (mType 1) % 5; resolveTypeUI(); });resolveTypeUI()里做兩件事調(diào)靜態(tài)方法改全局值再通知當(dāng)前實(shí)例立即重測(cè)private void resolveTypeUI() { if (mType 1) { GSYVideoType.setShowType(GSYVideoType.SCREEN_TYPE_16_9); } // ... 其余分支同 Demo changeTextureViewShowType(); if (mTextureView ! null) mTextureView.requestLayout(); }最后一步是關(guān)鍵覆寫(xiě)startWindowFullscreen()把比例狀態(tài)搬進(jìn)全屏播放器。全屏窗口是另一個(gè)實(shí)例它啟動(dòng)時(shí)會(huì)按全局值重新測(cè)量但按鈕文案和mType是自己的字段不同步就會(huì)出現(xiàn)畫(huà)面是對(duì)的、按鈕顯示默認(rèn)比例的狀態(tài)漂移Override public GSYBaseVideoPlayer startWindowFullscreen(Context context, boolean actionBar, boolean statusBar) { SampleVideo sampleVideo (SampleVideo) super.startWindowFullscreen(context, actionBar, statusBar); sampleVideo.mType mType; sampleVideo.resolveTypeUI(); return sampleVideo; }SampleVideo.java 的startWindowFullscreen()與resolveNormalVideoShow()就是這條鏈路的完整參考實(shí)現(xiàn)退出全屏?xí)r反向回寫(xiě)一次mType。如果不做這兩處同步用戶旋轉(zhuǎn)屏幕進(jìn)入全屏后比例會(huì)回退到默認(rèn)按鈕文案也會(huì)和實(shí)際畫(huà)面不一致。邊界問(wèn)題清單比例改動(dòng)波及所有實(shí)例 →setShowType()是靜態(tài)方法寫(xiě)的是類字段 → 每個(gè)實(shí)例開(kāi)播前顯式重設(shè)一次。列表滾動(dòng)時(shí)比例被后續(xù) item 覆蓋 → RecyclerView 復(fù)用導(dǎo)致后綁定實(shí)例改寫(xiě)全局值 →onBindViewHolder中按 position 重設(shè)。自定義播放器比例不生效或布局錯(cuò)位 → 默認(rèn)實(shí)現(xiàn)只改GSYRenderView容器 → 重寫(xiě)changeTextureViewShowType()落到自定義布局。全屏旋轉(zhuǎn)后比例回退 → 全屏實(shí)例字段獨(dú)立未繼承窗口態(tài)的mType→startWindowFullscreen中同步并resolveTypeUI()。全屏退出后窗口播放器狀態(tài)丟失 → 回寫(xiě)邏輯缺失 →resolveNormalVideoShow中反向同步。收束與延伸閱讀比例適配的本質(zhì)是兩件事選對(duì)模式管好作用域。模式?jīng)Q定了測(cè)量公式作用域決定了這個(gè)靜態(tài)值在窗口、全屏、列表復(fù)用之間如何流轉(zhuǎn)。setShowType()負(fù)責(zé)前者startWindowFullscreen里的狀態(tài)同步負(fù)責(zé)后者兩者缺一就會(huì)出現(xiàn)黑邊錯(cuò)位或比例回退。延伸閱讀USE.md 中切換比例章節(jié)覆蓋全部比例模式與常用組合GSYVIDEO_PLAYER_PROJECT_INFO.md 播放器整體架構(gòu)理解渲染層如何消費(fèi)比例值GSYVideoType.java 常量定義與setScreenScaleRatio自定義比例入口如果你的項(xiàng)目已經(jīng)在自定義播放控件上投入較多下一個(gè)值得看的問(wèn)題是如何在完全自繪的控件體系里讓比例按鈕和手勢(shì)旋轉(zhuǎn)共享同一份狀態(tài)機(jī)?！久赓M(fèi)下載鏈接】GSYVideoPlayerVideo players (IJKplayer, ExoPlayer, MediaPlayer), HTTPS, 16k page size, danmaku (bullet chat) support, external subtitles, support for filters, watermarks, and GIF screenshots, pre-roll and mid-roll ads, multiple simultaneous playback, basic seeking/dragging, volume and brightness adjustment, play-while-cache support項(xiàng)目地址: https://gitcode.com/GitHub_Trending/gs/GSYVideoPlayer創(chuàng)作聲明：本文部分內(nèi)容由AI輔助生成（AIGC），僅供參考