---
title: 视频主体突出方案 - 获取本地音乐列表
summary: 视频主体突出方案的本地音乐列表获取模块，涂鸦提供默认背景音乐资源。流程为通过 backgroundMusicList API 获取在线音乐地址，再使用 env.USER_DATA_PATH + backgroundMusicDownload API 下载至本地沙盒，建议进行本地缓存管理。
---

## 获取本地音乐列表

### 功能介绍

<div style="marginTop: 20px;">
<img alt="原始视频" src="https://images.tuyacn.com/rms-static/89112a80-0f96-11f0-9f57-5d628208d2a7-1743579966760.jpeg?tyName=bgMusic.jpeg" width="250">
</div>

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

1. **获取在线音乐地址**  
   开发者可通过 [backgroundMusicList](/cn/miniapp/develop/ray/api/ai/aiKit/backgroundMusicList) API 获取默认背景音乐的在线访问地址。

2. **下载至本地存储**  
   获取地址后，可组合使用系统环境变量[env](https://developer.tuya.com/cn/miniapp/develop/miniapp/api/base/env#tyenv)、[backgroundMusicDownload](/cn/miniapp/develop/ray/api/ai/aiKit/backgroundMusicDownload)API 将音乐文件下载至手机本地，供后续使用。

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

### 交互流程

```mermaid
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
```