getInternalSongCode

创建音乐资源的副歌片段编号。

Future<int> getInternalSongCode(
      {required int songCode, required String jsonOption});

详情

适用场景

当你需要播放某一音乐资源的副歌片段前，你需要调用此方法，通过 jsonOption 参数和该音乐资源的 songCode 来为该音乐资源的副歌片段创建一个编号，作为该资源的唯一标识。当你获取到该片段的编号后，在你调用相应方法打开、预加载、移除该资源时，将该内部歌曲编号传入 songCode 参数。

参数

songCode
音乐资源编号，用于标识音乐资源。你可以通过调用 或 方法来获取音乐资源，并通过由此触发的 回调获取音乐资源的编号（songCode）。
jsonOption
扩展 JSON 字段，默认为 NULL。目前支持传入下列值：
Key 值 Value 值 示例
sceneType 场景类型：
  • 1：直播场景：K 歌及背景音乐播放。
  • 2：直播场景：背景音乐播放。
  • 3：（默认）语聊场景：K 歌。
  • 4：语聊场景：背景音乐播放。
  • 5：VR 场景：K 歌及背景音乐播放。
Note: 声网会根据你在 sceneType 传入的应用场景进行收费。不同的应用场景对应不同的费率，你可以参考 查看详细的计费。如果需要切换到不同场景，需要重新调用此方法并传入 sceneType 的值。
 {"sceneType":1}
highPart 副歌片段的索引。你可以从 回调中获取副歌片段的索引然后传值。索引序号从 0 开始。 {"format": {"highpart": 0}}

Exceptions

  • 方法调用成功，返回创建的音乐资源内部编号。
  • < 0: 方法调用失败。