# Music (/zh-CN/api-reference/rtc/cpp-all-platforms/class-music)

> For AI agents: see the complete documentation index at [llms.txt](/llms.txt).

<a id="class_music__prototype"></a>

```cpp
struct Music {
    int64_t songCode;
    const char* name;
    const char* singer;
    const char* poster;
    const char* releaseTime;
    int32_t durationS;
    int32_t type;
    int32_t pitchType;
    int32_t lyricCount;
    int32_t* lyricList;
    int32_t climaxSegmentCount;
    ClimaxSegment* climaxSegmentList;
    int32_t mvPropertyCount;
    MvProperty* mvPropertyList;
};
```

<a id="class_music__parameters"></a>

## 属性 [#属性]

<ParameterList>
<a id="songcode"></a>
<Parameter name="songCode">

音乐资源的 ID，用于标识一个音乐条目。

</Parameter>
<a id="name"></a>
<Parameter name="name">

音乐资源的名称。

</Parameter>
<a id="singer"></a>
<Parameter name="singer">

歌手名称。

</Parameter>
<a id="poster"></a>
<Parameter name="poster">

音乐海报的下载链接。

</Parameter>
<a id="releasetime"></a>
<Parameter name="releaseTime">

音乐资源的发布时间。

</Parameter>
<a id="durations"></a>
<Parameter name="durationS">

音乐资源的总时长（单位为秒）。

</Parameter>
<a id="type"></a>
<Parameter name="type">

音乐资源的类型：

- 1：单轨道，左声道为伴奏，右声道为原唱。
- 2：单轨道，仅包含伴奏。
- 3：单轨道，仅包含原唱。
- 4：多轨音频。

</Parameter>
<a id="pitchtype"></a>
<Parameter name="pitchType">

歌曲是否支持音高评分：

- 1：支持音高评分。
- 2：不支持音高评分。

</Parameter>
<a id="lyriccount"></a>
<Parameter name="lyricCount">

该歌曲可用的歌词数量。

</Parameter>
<a id="lyriclist"></a>
<Parameter name="lyricList">

支持的歌词格式：

- 0：XML 格式。
- 1：LRC 格式。

</Parameter>
<a id="climaxsegmentcount"></a>
<Parameter name="climaxSegmentCount">

高潮片段的数量。

</Parameter>
<a id="climaxsegmentlist"></a>
<Parameter name="climaxSegmentList">

高潮片段列表。详见 [ClimaxSegment](/zh-CN/api-reference/rtc/cpp-all-platforms/class-climaxsegment)。

</Parameter>
<a id="mvpropertycount"></a>
<Parameter name="mvPropertyCount">

MV 的数量。如果该值大于 0，表示当前音乐存在 MV 资源。

</Parameter>
<a id="mvpropertylist"></a>
<Parameter name="mvPropertyList">

MV 属性列表。

</Parameter>
</ParameterList>