Exoplayer播放rtsp://ip:port格式RTSP地址无法显示预览如何解决

常见故障原因 #

• ExoPlayer版本兼容问题：低于2.16.0版本的ExoPlayer RTSP模块支持度极不完善，对TCP传输模式、H.265/G711等安防常见编码的适配存在大量缺陷，直接拉流大概率失败。
• 传输协议不匹配：RtspMediaSource默认使用UDP传输RTSP流，多数安防设备的RTSP服务、企业防火墙仅支持TCP传输，UDP丢包或被拦截后无法拉取到有效流数据。
• 编码格式不支持：ExoPlayer默认硬解码不支持部分非标H.265 profile、G726等监控设备常用编码格式，解码失败后不会渲染画面。
• 基础配置缺失：未申请网络权限、PlayerView未和ExoPlayer实例绑定、RTSP地址缺省流路径都会导致无画面输出。

对应解决方案 #

1. 升级ExoPlayer到稳定兼容版本
   将核心依赖和RTSP模块升级到2.18.0及以上版本，确保RTSP基础能力适配：

implementation "com.google.android.exoplayer:exoplayer-core:2.18.7"
implementation "com.google.android.exoplayer:exoplayer-rtsp:2.18.7"

2. 强制指定TCP传输模式
   创建RtspMediaSource时新增TCP强制配置，适配绝大多数RTSP流传输要求，同时补全RTSP地址的完整流路径：

MediaSource mediaSource =
        new RtspMediaSource.Factory()
                // 强制走TCP传输，避免UDP被拦截或丢包
                .setForceUseRtpTcp(true)
                // 补全完整流路径，示例：rtsp://ip:1935/stream/main
                .createMediaSource(MediaItem.fromUri("完整的RTSP流地址"));

3. 开启解码兼容配置
   创建ExoPlayer实例时开启软解 fallback，解决硬解码不支持的问题：

ExoPlayer player = new ExoPlayer.Builder(context)
        .setRenderersFactory(new DefaultRenderersFactory(context)
                // 开启扩展渲染器适配非标编码
                .setExtensionRendererMode(DefaultRenderersFactory.EXTENSION_RENDERER_MODE_ON))
        .build();

4. 检查基础配置

• 确认AndroidManifest.xml已申请网络权限：

<uses-permission android:name="android.permission.INTERNET" />

• 确认布局PlayerView已绑定播放器实例：playerView.setPlayer(player);
• 先通过VLC等本地播放器测试RTSP地址有效性，排除地址本身无法访问的问题。

5. 错误日志定位
   给播放器添加错误监听器，快速定位具体故障类型：

player.addListener(new Player.Listener() {
    @Override
    public void onPlayerError(PlaybackException error) {
        Log.e("RTSP播放错误", error.getMessage(), error);
    }
});

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