Flutter WebRTC onaddremotestream异常：iOS端无法显示OpenVidu远程流

已确认的现状 #

• OpenVidu服务正常，Web浏览器可双向显示本地/远程流
• iOS设备/模拟器本地流显示正常，onAddRemoteStream事件已触发（打印输出flutter: onAddRemoteStream: default），但远程流渲染区域为黑/灰色
• 已升级Flutter WebRTC至空安全版本，替换旧API addStream 为 addTrack，本地流功能正常

针对性排查与修复方案 #

1. 替换onAddStream为onTrack事件监听

新版本WebRTC更推荐使用onTrack替代onAddStream（addTrack API对应onTrack事件，而非旧版的onAddStream），修改signalling.dart中的远程PeerConnection监听逻辑：

remotePeerConnection.onTrack = (RTCTrackEvent event) {
  print("Received remote track: ${event.track.kind}");
  if (event.streams.isNotEmpty) {
    final stream = event.streams[0];
    remoteParticipant.mediaStream = stream;
    this.onParticipantsStreamUpdate?.call(remoteParticipant);
    this.onAddRemoteStream?.call(stream);
  }
};

2. 强制刷新VideoRenderer状态

确保setState能正确触发渲染器更新，可尝试在设置srcObject时强制重置：

_signaling?.onAddRemoteStream = ((stream) {
  print('onAddRemoteStream: ${stream.id}');
  setState(() {
    // 先清空再赋值，强制触发渲染
    _remoteRenderer.srcObject = null;
    _remoteRenderer.srcObject = stream;
  });
});

3. 检查远程流Track状态

在onAddRemoteStream中打印Track的活跃状态，确认流是否正常传输：

_signaling?.onAddRemoteStream = ((stream) {
  print('onAddRemoteStream: ${stream.id}');
  for (var track in stream.getTracks()) {
    print('${track.kind} track state: ${track.state}');
  }
  setState(() {
    _remoteRenderer.srcObject = stream;
  });
});

若Track状态为ended，需排查OpenVidu的订阅/发布逻辑是否存在问题。

4. 确认iOS权限与渲染布局

• 检查Info.plist中是否添加相机/麦克风权限：

  <key>NSCameraUsageDescription</key>
  <string>需要访问相机进行视频通话</string>
  <key>NSMicrophoneUsageDescription</key>
  <string>需要访问麦克风进行语音通话</string>
  

• 确保RTCVideoView有足够的布局空间，例如用Expanded包裹：

  Expanded(
    child: RTCVideoView(
      _remoteRenderer,
      objectFit: RTCVideoViewObjectFit.RTCVideoViewObjectFitCover,
    ),
  )
  

5. 开启WebRTC日志排查

启用WebRTC调试日志，查看iOS端是否有隐藏错误：

import 'package:flutter_webrtc/flutter_webrtc.dart';

// 初始化时添加
WebRTC.logger.level = Level.debug;

内容的提问来源于stack exchange，提问作者Mus'ab Hajabi