Android端Quickblox视频通话：onRemoteVideoTrackReceive后本地视图被遮挡

我之前也碰到过Quickblox视频通话里本地小窗口被对方全屏视图覆盖的问题，结合你的代码和常见的WebRTC视图渲染坑，给你几个靠谱的解决方向：

1. 优先设置本地视图的层级优先级 #

WebRTC的SurfaceViewRenderer基于SurfaceView实现，默认会按照添加顺序或者布局层级来显示，后渲染的视图容易覆盖前面的。你可以通过这两种方式确保本地视图在顶层：

方式一：布局文件中明确层级 #

在XML布局里把本地视图写在对方视图的后面（XML中后声明的视图层级更高），同时给本地视图设置更高的elevation：

<FrameLayout
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 对方全屏视图，放在底层 -->
    <org.webrtc.SurfaceViewRenderer
        android:id="@+id/opponentView"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:elevation="0dp"/>

    <!-- 本地小窗口，放在顶层 -->
    <org.webrtc.SurfaceViewRenderer
        android:id="@+id/localView"
        android:layout_width="150dp"
        android:layout_height="200dp"
        android:layout_gravity="bottom|end"
        android:layout_margin="16dp"
        android:elevation="5dp"/>
</FrameLayout>

方式二：代码中强制提升本地视图层级 #

在接收到远程视频轨道并完成对方视图渲染后，主动把本地视图带到顶层：

@Override
public void onRemoteVideoTrackReceive(BaseSession baseSession, QBRTCVideoTrack qbrtcVideoTrack, Integer userId) {
    opponentVideoTrack = qbrtcVideoTrack;
    qbrtcVideoTrack.addRenderer(new VideoRenderer(opponentView));
    
    // 确保本地视图始终在最上层
    localView.bringToFront();
    // 如果是AndroidX环境，也可以用ViewCompat.bringToFront(localView)兼容低版本
}

2. 给本地视图启用媒体Overlay模式 #

SurfaceViewRenderer有个专门的方法setZOrderMediaOverlay(true)，开启后这个视图会作为媒体叠加层显示在其他SurfaceView之上，非常适合本地小窗口的场景。建议在初始化本地视图时就设置：

// 初始化本地视图
localView.init(mediaStreamManager.getPeerConnectionFactory().getEglBaseContext(), null);
localView.setMirror(true); // 本地视图通常需要镜像显示
localView.setZOrderMediaOverlay(true); // 关键：设置为媒体叠加层，避免被覆盖

3. 检查渲染器的绑定是否正确 #

虽然你的onLocalVideoTrackReceive代码看起来是把本地轨道绑定到localView，但还是要确认onRemoteVideoTrackReceive里没有错误地把远程轨道绑定到本地视图，或者反过来。比如要确保：

// 本地轨道绑定本地视图（你的现有代码没问题）
localVideoTrack.addRenderer(new VideoRenderer(localView));
// 远程轨道绑定对方视图（别写错视图ID）
opponentVideoTrack.addRenderer(new VideoRenderer(opponentView));

4. 排查视图大小与位置 #

如果对方视图设置为match_parent，而本地视图的位置刚好被对方视图覆盖（比如本地视图没有设置layout_gravity），也会导致看不到本地画面。这种情况下调整本地视图的布局位置即可。

按上面的步骤调整后，本地视图应该就能稳定显示在对方视图之上了，不会再被覆盖。

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