KtvSDK-2.0升级到3.0版本迁移指南

对于已集成KtvSDK2.0的客户，升级KtvSDK3.0时，可参见此文档做版本迁移。

SDK依赖

之前：

implementation "com.google.android.exoplayer:exoplayer-core:2.14.0"

更新为：

//exoplayer核心
implementation("com.google.android.exoplayer:exoplayer-core:2.18.5") {
    exclude group: 'androidx.core'
    exclude group: 'androidx.annotation'
    exclude group: 'androidx.fragment'
}

登录适配

需对接sdk的新增登录接口，提供用户态登录token给sdk，不然会播放歌曲失败：
https://karaoketv.coding.net/p/ktvsdk3/wiki/4

需适配的API变更

功能/API | KtvSDK2.0 | KtvSDK3.0 | 变更说明 |
:-----------: | :-----------: | :-----------
播放下一首 | KaraokPlayer.playNext() | PlayerManager.playNext() | playNext逻辑：实际就是调用了stopPlayer() -> PlayerManger.preload() -> KaraokePlayer.play() |
播放回调 | KaraokePlayer.KaraokePlayerCallback | KaraokePlayerListener | 提供更丰富的回调功能，回调线程：大多非UI线程 |
播放前设置K歌模式 | KaraokePlayer.setPlayMode(PlayMode.KTV) | SongInfoObject.setSongType(SongType.SONG_TYPE_K_SONG) | |
播放前设置听歌模式 | KaraokePlayer.setPlayMode(PlayMode.NORMAL) | SongInfoObject.setSongType(SongType.SONG_TYPE_KSONG_LISTEN) | |
创建KaraokePlayer | new KaraokePlayerIml(KtvVideoLayout) | new KtvPlayerImpl().setKtvVideoLayout(KtvVideoLayout) | 将播放器创建与UI分离 |

修改于 2025-09-01 07:13:30

KtvSDK-3.0版本新功能

KtvSDK-多屏渲染