Android中如何去除VLCVideoLayout的上下黑边

出现上下黑边的核心原因是视频原始宽高比与容器宽高比不匹配，VLC默认会保持视频比例避免拉伸，因此产生黑边。要实现无黑边全屏，需从缩放模式设置、布局优化、系统全屏配置三个维度调整：

1. 设置VLC媒体播放器的缩放模式 #

在播放器启动后，将缩放模式改为填充容器的类型，根据需求选择两种模式：

• SURFACE_FIT_SCREEN：填充整个容器，超出部分会被裁剪（保持视频比例）
• SURFACE_FILL：强制拉伸视频填满容器（会改变视频比例）

修改你的Activity代码：

@Override
protected void onStart() {
    super.onStart();
    mediaPlayer.attachViews(videoLayout, null, false, false);

    // 注意去掉URL前后的空格，避免播放失败
    Media media = new Media(libVlc, Uri.parse(url.trim()));
    media.setHWDecoderEnabled(true, false);
    media.addOption(":network-caching=600");

    mediaPlayer.setMedia(media);
    media.release();
    mediaPlayer.play();
    
    // 设置缩放模式为填充容器
    mediaPlayer.setScale(MediaPlayer.ScaleType.SURFACE_FIT_SCREEN);
}

2. 优化布局结构 #

原布局嵌套层级过多，且误用了RelativeLayout的属性（layout_above/layout_below在LinearLayout中无效），简化布局确保VLCVideoLayout占满分配空间：

<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:orientation="vertical">

    <!-- 视频播放区域，占一半高度 -->
    <org.videolan.libvlc.util.VLCVideoLayout
        android:id="@+id/videoLayout"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:fitsSystemWindows="false" />

    <!-- 下方橙色区域，占另一半高度 -->
    <LinearLayout
        android:id="@+id/thirdLayout"
        android:layout_width="match_parent"
        android:layout_height="0dp"
        android:layout_weight="1"
        android:background="@android:color/holo_orange_light"
        android:orientation="vertical" />

</LinearLayout>

3. 实现系统级全屏（可选） #

如果需要让视频占满整个屏幕（包括系统状态栏区域），在Activity的onCreate中添加全屏配置：

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 隐藏状态栏
    getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
            WindowManager.LayoutParams.FLAG_FULLSCREEN);
    // 隐藏导航栏并保持沉浸式（可选）
    getWindow().getDecorView().setSystemUiVisibility(View.SYSTEM_UI_FLAG_HIDE_NAVIGATION
            | View.SYSTEM_UI_FLAG_IMMERSIVE_STICKY);
    
    setContentView(R.layout.activity_video);
    if (getSupportActionBar() != null) {
        getSupportActionBar().hide();
    }

    libVlc = new LibVLC(this);
    mediaPlayer = new MediaPlayer(libVlc);
    videoLayout = findViewById(R.id.videoLayout);
}

4. 补充生命周期资源释放 #

避免内存泄漏，在Activity销毁时释放VLC相关资源：

@Override
protected void onStop() {
    super.onStop();
    mediaPlayer.stop();
    mediaPlayer.detachViews();
}

@Override
protected void onDestroy() {
    super.onDestroy();
    mediaPlayer.release();
    libVlc.release();
}

总结 #

• 通过setScale设置填充模式是解决黑边的核心；
• 简化布局层级确保容器空间分配准确；
• 可选配置系统全屏实现真正的无黑边体验；
• 务必正确处理VLC资源的生命周期。

内容的提问来源于stack exchange，提问作者MARSH