Android平台基于SmartPlayer实现多实例RTSP|RTMP播放器

在 Android开发中，实现多实例的RTSP或RTMP直播播放器是一个常见的需求，本文将介绍如何利用大牛直播SDK的SmartPlayer模块接口，快速实现Android平台上的多实例播放器。通过合理的架构设计和 API 调用，我们可以轻松地管理多个播放实例，从而满足复杂场景下的播放需求。

1. 概述

SmartPlayer是一款功能强大的音视频播放 SDK，支持多种流媒体协议，如 RTSP、RTMP 等。它提供了丰富的接口和灵活的配置选项，支持多实例播放。通过调用SmartPlayer的接口，开发者可以实现多个播放器实例的同时运行，每个实例可以单独控制播放、录像、快照、实时音量控制等操作，为用户提供更加丰富和灵活的播放体验。

2. 多实例播放器的实现原理

多实例播放器的核心在于能够同时管理和控制多个播放器实例。每个播放器实例都是一个独立的播放对象，拥有自己的播放资源和状态。在 Android 中，通过SmartPlayer的接口，我们可以创建多个播放器实例，并为每个实例绑定独立的 SurfaceView 用于视频显示。每个播放器实例可以独立地进行播放、暂停、停止等操作，互不影响。

3. 实现步骤

3.1 初始化 SmartPlayer

在开始之前，需要先初始化 SmartPlayer。确保在项目中正确引入了 SmartPlayer 的相关库文件，并在应用中进行初始化。通常在应用的 onCreate 方法中完成初始化。

static {System.loadLibrary("SmartPlayer");
}SmartPlayerJniV2 libPlayer = new SmartPlayerJniV2();

3.2 创建多实例播放器

创建多个 LibPlayerWrapper 实例，每个实例代表一个播放器。在应用的 onCreate 方法中，初始化播放器实例并绑定回调接口。

private List<LibPlayerWrapper> playerInstances = new ArrayList<>();private void createPlayerInstances(int count) {for (int i = 0; i < count; i++) {playerInstances.add(new LibPlayerWrapper(libPlayer, context, this));}
}

3.3 初始化播放器实例

每个播放器实例在使用前需要进行初始化。通过调用 initialize 方法设置播放的 URL 和其他参数。

public boolean initialize(String playback_url, int play_buffer, int is_using_tcp) {if (check_native_handle())return true;if(!isValidRtspOrRtmpUrl(playback_url))return false;long handle = lib_player_.SmartPlayerOpen(application_context());if (0 == handle) {Log.e(TAG, "sdk open failed!");return false;}set(handle);configurePlayer(playback_url, play_buffer, is_using_tcp);return true;
}

3.4 设置 SurfaceView

每个播放器实例需要绑定一个独立的 SurfaceView 用于视频显示。在创建播放器实例后，通过调用 setSurfaceView 方法设置对应的 SurfaceView。

public void setSurfaceView(View surface_view) {this.surface_view_ = surface_view;
}

3.5 开始播放

通过调用 startPlayer 方法开始播放。每个播放器实例可以独立地进行播放。

public boolean startPlayer(boolean is_hardware_decoder, boolean is_enable_hardware_render_mode, boolean is_mute) {if (is_playing()) {Log.e(TAG, "already playing, native_handle:" + get());return false;}setPlayerParam(is_hardware_decoder, is_enable_hardware_render_mode, is_mute);int ret = lib_player_.SmartPlayerStartPlay(get());if (ret != OK) {Log.e(TAG, "call StartPlay failed, native_handle:" + get() + ", ret:" + ret);return false;}this.is_playing_ = true;return true;
}

3.6 停止播放

通过调用 stopPlayer 方法停止播放。同样，每个播放器实例可以独立地停止播放。

public boolean stopPlayer() {if (!check_native_handle())return false;if (!is_playing()) {Log.w(TAG, "it's not playing, native_handle:" + get());return false;}this.is_playing_ = false;lib_player_.SmartPlayerStopPlay(get());return true;
}

3.7 释放资源

在播放器实例不再使用时，需要释放相关的资源。通过调用 release 方法释放资源。

public void release() {if (empty())return;if(is_playing())stopPlayer();if (is_recording())stopRecorder();long handle;write_lock_.lock();try {handle = this.native_handle_;this.native_handle_ = 0;clear_all_playing_flags();} finally {write_lock_.unlock();}if (lib_player_ != null && handle != 0)lib_player_.SmartPlayerClose(handle);
}

4. 示例代码

以下是一个完整的多实例播放器的实现示例。

/* MultiSmartPlayerDemo.java* Created by daniusdk.com* WeChat: xinsheng120*/
public class MultiInstancePlayerActivity extends AppCompatActivity implements EventListener {private List<LibPlayerWrapper> playerInstances = new ArrayList<>();private List<SurfaceView> surfaceViews = new ArrayList<>();private List<Button> playButtons = new ArrayList<>();private List<Button> stopButtons = new ArrayList<>();private SmartPlayerJniV2 libPlayer = null;private Context context_;@Overrideprotected void onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_multi_instance_player);libPlayer = new SmartPlayerJniV2();context_ = this.getApplicationContext();initView();initPlayerInstances();setupButtonListeners();}private void initView() {// 获取 SurfaceView 和按钮surfaceViews.add(findViewById(R.id.surfaceView1));surfaceViews.add(findViewById(R.id.surfaceView2));surfaceViews.add(findViewById(R.id.surfaceView3));surfaceViews.add(findViewById(R.id.surfaceView4));playButtons.add(findViewById(R.id.btn_play1));playButtons.add(findViewById(R.id.btn_play2));playButtons.add(findViewById(R.id.btn_play3));playButtons.add(findViewById(R.id.btn_play4));stopButtons.add(findViewById(R.id.btn_stop1));stopButtons.add(findViewById(R.id.btn_stop2));stopButtons.add(findViewById(R.id.btn_stop3));stopButtons.add(findViewById(R.id.btn_stop4));}private void initPlayerInstances() {// 创建播放器实例for (int i = 0; i < 4; i++) {playerInstances.add(new LibPlayerWrapper(libPlayer, context_, this));}}private void setupButtonListeners() {// 设置播放按钮和停止按钮的点击监听for (int i = 0; i < playButtons.size(); i++) {final int index = i;playButtons.get(i).setOnClickListener(v -> startPlayback(index));stopButtons.get(i).setOnClickListener(v -> stopPlayback(index));}}private void startPlayback(int index) {LibPlayerWrapper player = playerInstances.get(index);SurfaceView surfaceView = surfaceViews.get(index);if (!player.is_playing()) {String playbackUrl = "rtsp://example.com/stream" + (index + 1);player.initialize(playbackUrl, 0, 0);player.setSurfaceView(surfaceView);player.startPlayer(false, false, false);}}private void stopPlayback(int index) {LibPlayerWrapper player = playerInstances.get(index);if (player.is_playing()) {player.stopPlayer();}}@Overridepublic void onPlayerEventCallback(long handle, int id, long param1, long param2, String param3, String param4, Object param5) {// 处理播放器事件回调Log.i("SmartPlayer", "PlayerEvent: handle=" + handle + ", id=" + id);}
}