Android

package io.trtc.tuikit.atomicx.karaoke.store

import android.content.Context
import androidx.core.content.ContextCompat
import com.tencent.qcloud.tuikit.debug.GenerateTestUserSig
import io.trtc.tuikit.atomicx.karaoke.store.utils.MusicInfo
import java.io.File

/**
 * 本地音乐数据源实现类
 * 负责加载本地存储的演示歌曲，并处理基础鉴权逻辑
 */
class KaraokeLocalSource(private val context: Context) : MusicSourceService() {

    /**
     * 步骤 1：获取本地歌曲列表
     * 将本地文件路径封装为 MusicInfo 对象并返回
     */
    override fun getSongList(callback: GetSongListCallBack) {
        // 1. 获取本地存储的绝对路径。
        // 确保在调用此方法前，相关 mp3/vtt 文件已通过 copyAssetToFile 拷贝至该路径。
        val localPath = ContextCompat.getExternalFilesDirs(context, null)[0].absolutePath + File.separator

        // 2. 配置 MusicInfo 核心字段。
        // musicId: 歌曲唯一标识；musicName: 歌曲名称；artist: 歌手名列表。
        val demoMusic = MusicInfo().apply {
            musicId = " local_demo_01"        // LiveKit中，本地音乐的musicId前缀是local_demo.
            musicName = "后来"
            artist = "刘若英"
            lyricUrl = "lyricUrl.vtt"         // 对应歌词文件的 URL
            originalUrl = "originalUrl.mp3"   // 对应原唱文件的 URL
            accompanyUrl = "accompanyUrl.mp3" // 对应伴奏文件的 URL
        }

        // 4. 构建列表并通过回调返回。
        val musicList = arrayListOf(demoMusic)
        callback.onSuccess(musicList)
    }

    /**
     * 步骤 2：生成用户签名
     * 为当前用户生成合法的业务签名，用于初始化组件和鉴权
     */
    override fun generateUserSig(userId: String, callback: ActionCallback) {
        // 调用测试环境工具生成 UserSig
        val userSig = GenerateTestUserSig.genTestUserSig(userId)
        if (userSig.isNotEmpty()) {
            callback.onSuccess(userSig)
        } else {
            callback.onError(-1, "Generate UserSig failed")
        }
    }
}


package io.trtc.tuikit.atomicx.karaoke.store

import io.trtc.tuikit.atomicx.karaoke.store.utils.MusicInfo

/**
 * 在线曲库数据源实现类
 * 职责：1. 检索云端歌曲；2. 提供机器人进房鉴权；3. 获取版权播放凭证
 */
class KaraokeOnlineSource : MusicSourceService() {

    /**
     * 职责一：获取云端歌曲列表
     * 此处通常调用您的业务后端接口，将返回的 JSON 解析为 MusicInfo 列表
     */
    override fun getSongList(callback: GetSongListCallBack) {
        // 示例：此处模拟网络请求成功后构建的在线歌曲对象
        val onlineMusic = MusicInfo().apply {
            musicId = "online_id_1001" // 云端歌曲唯一 ID
            musicName = "在线歌曲示例"
            artist = mutableListOf("歌手名")
            coverUrl = "https://example.com/cover.jpg" // 在线封面 URL
        }
        
        callback.onSuccess(arrayListOf(onlineMusic))
    }

    /**
     * 职责二：鉴权播放
     * 建议由您的业务后端生成 UserSig，确保合唱机器人安全入会
     */
    override fun generateUserSig(userId: String, callback: ActionCallback) {
        // 示例：此处应发起网络请求从您的服务器获取 UserSig
        val userSig = "YOUR_SERVER_GENERATED_USERSIG"
        callback.onSuccess(userSig)
    }

    /**
     * 职责三：获取播放凭证 (在线模式核心)
     * 根据 musicId 获取播放 Token、License 等版权信息
     */
    override fun queryPlayToken(musicId: String, userId: String, callback: QueryPlayTokenCallBack) {
        // 示例：此处应向服务器请求该音乐的播放许可
        val playToken = "YOUR_PLAY_TOKEN"
        val licenseKey = "YOUR_LICENSE_KEY"
        val licenseUrl = "YOUR_LICENSE_URL"
        
        // 验证成功后返回凭证
        callback.onSuccess(musicId, playToken, licenseKey, licenseUrl)
    }
}