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