本页目录
获取本地音乐列表功能介绍交互流程

获取本地音乐列表

功能介绍

原始视频

当前涂鸦为开发者提供了部分默认背景音乐资源，可直接获取并使用。我们将持续扩充音乐库内容，以满足更多场景需求。 默认背景音乐的获取与使用主要分为以下两个步骤：

  1. 获取在线音乐地址
    开发者可通过 backgroundMusicList API 获取默认背景音乐的在线访问地址。

  2. 下载至本地存储
    获取地址后，可组合使用系统环境变量env、backgroundMusicDownloadAPI 将音乐文件下载至手机本地，供后续使用。

提示：我们建议开发者在下载完成后对音乐文件进行本地缓存管理，以优化用户体验。

交互流程

sequenceDiagram
rect rgb(191, 223, 255)
    面板->>App: 1.请求背景音乐列表(backgroundMusicList)
    App-->>面板: 返回默认音乐列表
    面板->>App: 2.批量申请沙盒地址(env.USER_DATA_PATH)
    App-->>面板: 返回沙盒地址列表
    面板->>App: 3.发起批量下载(backgroundMusicDownload)
    App->>云端: 请求音乐文件
    云端-->>App: 返回音乐文件
    App->>App: 存储至预分配沙盒地址
    App-->>面板: 通知下载完成
end

rect rgb(200, 150, 255)
    Note right of 面板: 用户交互层
    Note left of 云端: 云端存储服务
end