• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# native_audio_channel_layout.h
2
3## 概述
4
5在录制和播放时的扬声器布局。
6
7**引用文件：** <multimedia/native_audio_channel_layout.h>
8
9**库：** 无
10
11**系统能力：** SystemCapability.Multimedia.Media.Core
12
13**起始版本：** 11
14
15**相关模块：** [Core](capi-core.md)
16
17## 汇总
18
19### 枚举
20
21| 名称 | typedef关键字 | 描述 |
22| -- | -- | -- |
23| [OH_AudioChannelSet](#oh_audiochannelset) | OH_AudioChannelSet | 音频声道集合。<br>将每一个声道映射为int64的变量。 |
24| [OH_AmbAttributeSet](#oh_ambattributeset) | OH_AmbAttributeSet | 高保真立体声混响设置。<br>用int64整数来表示高保真立体声混响属性。 |
25| [OH_AudioChannelLayout](#oh_audiochannellayout) | OH_AudioChannelLayout | 音频声道布局。<br>用int64整数来表示在录制或播放时扬声器的外观和顺序。 |
26
27## 枚举类型说明
28
29### OH_AudioChannelSet
30
31```
32enum OH_AudioChannelSet
33```
34
35**描述**
36
37音频声道集合。<br>将每一个声道映射为int64的变量。
38
39**系统能力：** SystemCapability.Multimedia.Media.Core
40
41**起始版本：** 11
42
43| 枚举项 | 描述 |
44| -- | -- |
45| CH_SET_FRONT_LEFT = 1ULL << 0U | 左前声道 |
46| CH_SET_FRONT_RIGHT = 1ULL << 1U | 右前声道 |
47| CH_SET_FRONT_CENTER = 1ULL << 2U | 中前声道 |
48| CH_SET_LOW_FREQUENCY = 1ULL << 3U | 低频声道 |
49| CH_SET_BACK_LEFT = 1ULL << 4U | 左后声道 |
50| CH_SET_BACK_RIGHT = 1ULL << 5U | 右后声道 |
51| CH_SET_FRONT_LEFT_OF_CENTER = 1ULL << 6U | 左前中置声道 |
52| CH_SET_FRONT_RIGHT_OF_CENTER = 1ULL << 7U | 右前中置声道 |
53| CH_SET_BACK_CENTER = 1ULL << 8U | 后方中置声道 |
54| CH_SET_SIDE_LEFT = 1ULL << 9U | 左侧声道 |
55| CH_SET_SIDE_RIGHT = 1ULL << 10U | 右侧声道 |
56| CH_SET_TOP_CENTER = 1ULL << 11U | 上方中置声道 |
57| CH_SET_TOP_FRONT_LEFT = 1ULL << 12U | 上方左前声道 |
58| CH_SET_TOP_FRONT_CENTER = 1ULL << 13U | 上方中前声道 |
59| CH_SET_TOP_FRONT_RIGHT = 1ULL << 14U | 上方右前声道 |
60| CH_SET_TOP_BACK_LEFT = 1ULL << 15U | 上方左后声道 |
61| CH_SET_TOP_BACK_CENTER = 1ULL << 16U | 上方中后声道 |
62| CH_SET_TOP_BACK_RIGHT = 1ULL << 17U | 上方右后声道 |
63| CH_SET_STEREO_LEFT = 1ULL << 29U | 立体声左声道 |
64| CH_SET_STEREO_RIGHT = 1ULL << 30U | 立体声右声道 |
65| CH_SET_WIDE_LEFT = 1ULL << 31U | 宽左声道 |
66| CH_SET_WIDE_RIGHT = 1ULL << 32U | 宽右声道 |
67| CH_SET_SURROUND_DIRECT_LEFT = 1ULL << 33U | 左环绕声道 |
68| CH_SET_SURROUND_DIRECT_RIGHT = 1ULL << 34U | 右环绕声道 |
69| CH_SET_LOW_FREQUENCY_2 = 1ULL << 35U | 低频声道2 |
70| CH_SET_TOP_SIDE_LEFT = 1ULL << 36U | 上方左侧声道 |
71| CH_SET_TOP_SIDE_RIGHT = 1ULL << 37U | 上方右侧声道 |
72| CH_SET_BOTTOM_FRONT_CENTER = 1ULL << 38U | 下方中前声道 |
73| CH_SET_BOTTOM_FRONT_LEFT = 1ULL << 39U | 下方左前声道 |
74| CH_SET_BOTTOM_FRONT_RIGHT = 1ULL << 40U | 下方右前声道 |
75
76### OH_AmbAttributeSet
77
78```
79enum OH_AmbAttributeSet
80```
81
82**描述**
83
84高保真立体声混响设置。<br>用int64整数来表示高保真立体声混响属性。
85
86**系统能力：** SystemCapability.Multimedia.Media.Core
87
88**起始版本：** 11
89
90| 枚举项 | 描述 |
91| -- | -- |
92| AMB_ORD_1 = 1ULL << 0U | 一阶高保真立体声混响 |
93| AMB_ORD_2 = 2ULL << 0U | 二阶高保真立体声混响 |
94| AMB_ORD_3 = 3ULL << 0U | 三阶高保真立体声混响 |
95| AMB_COM_ACN = 0ULL << 8U | ACN通道排序的高保真立体声混响 |
96| AMB_COM_FUMA = 1ULL << 8U | FUMA通道排序的高保真立体声混响 |
97| AMB_NOR_N3D = 0ULL << 12U | N3D归一化的高保真立体声混响 |
98| AMB_NOR_SN3D = 1ULL << 12U | SN3D归一化的高保真立体声混响 |
99| AMB_MODE = 1ULL << 44U | 高保真立体声混响的声道布局 |
100
101### OH_AudioChannelLayout
102
103```
104enum OH_AudioChannelLayout
105```
106
107**描述**
108
109音频声道布局。<br>用int64整数来表示在录制或播放时扬声器的外观和顺序。
110
111**系统能力：** SystemCapability.Multimedia.Media.Core
112
113**起始版本：** 11
114
115| 枚举项 | 描述 |
116| -- | -- |
117| CH_LAYOUT_UNKNOWN = 0ULL | 未知声道布局 |
118| CH_LAYOUT_MONO = CH_SET_FRONT_CENTER | 单声道布局，共1个声道。 |
119| CH_LAYOUT_STEREO = CH_SET_FRONT_LEFT \| CH_SET_FRONT_RIGHT | 立体声布局，共2个声道。 |
120| CH_LAYOUT_STEREO_DOWNMIX = CH_SET_STEREO_LEFT \| CH_SET_STEREO_RIGHT | 立体声下混布局，共2个声道。 |
121| CH_LAYOUT_2POINT1 = CH_LAYOUT_STEREO \| CH_SET_LOW_FREQUENCY | 2.1布局，共3个声道。 |
122| CH_LAYOUT_3POINT0 = CH_LAYOUT_STEREO \| CH_SET_BACK_CENTER | 3.0布局，共3个声道。 |
123| CH_LAYOUT_SURROUND = CH_LAYOUT_STEREO \| CH_SET_FRONT_CENTER | 环绕布局，共3个声道。 |
124| CH_LAYOUT_3POINT1 = CH_LAYOUT_SURROUND \| CH_SET_LOW_FREQUENCY | 3.1布局，共4个声道。 |
125| CH_LAYOUT_4POINT0 = CH_LAYOUT_SURROUND \| CH_SET_BACK_CENTER | 4.0布局，共4个声道。 |
126| CH_LAYOUT_QUAD_SIDE = CH_LAYOUT_STEREO \| CH_SET_SIDE_LEFT \| CH_SET_SIDE_RIGHT | QUAD_SIDE布局，共4个声道。 |
127| CH_LAYOUT_QUAD = CH_LAYOUT_STEREO \| CH_SET_BACK_LEFT \| CH_SET_BACK_RIGHT | QUAD布局，共4个声道。 |
128| CH_LAYOUT_2POINT0POINT2 = CH_LAYOUT_STEREO \| CH_SET_TOP_SIDE_LEFT \| CH_SET_TOP_SIDE_RIGHT | 2.0.2布局，共4个声道。 |
129| CH_LAYOUT_AMB_ORDER1_ACN_N3D = AMB_MODE \| AMB_ORD_1 \| AMB_COM_ACN \| AMB_NOR_N3D | ACN_N3D（根据ITU标准）的一阶FOA布局，共4个声道。 |
130| CH_LAYOUT_AMB_ORDER1_ACN_SN3D = AMB_MODE \| AMB_ORD_1 \| AMB_COM_ACN \| AMB_NOR_SN3D | ACN_SN3D（根据ITU标准）的一阶FOA布局，共4个声道。 |
131| CH_LAYOUT_AMB_ORDER1_FUMA = AMB_MODE \| AMB_ORD_1 \| AMB_COM_FUMA | FUMA（根据ITU标准）的一阶FOA布局，共4个声道。 |
132| CH_LAYOUT_4POINT1 = CH_LAYOUT_4POINT0 \| CH_SET_LOW_FREQUENCY | 4.1布局，共5个声道。 |
133| CH_LAYOUT_5POINT0 = CH_LAYOUT_SURROUND \| CH_SET_SIDE_LEFT \| CH_SET_SIDE_RIGHT | 5.0布局，共5个声道。 |
134| CH_LAYOUT_5POINT0_BACK = CH_LAYOUT_SURROUND \| CH_SET_BACK_LEFT \| CH_SET_BACK_RIGHT | 5.0-后置布局，共5个声道。 |
135| CH_LAYOUT_2POINT1POINT2 = CH_LAYOUT_2POINT0POINT2 \| CH_SET_LOW_FREQUENCY | 2.1.2布局，共5个声道。 |
136| CH_LAYOUT_3POINT0POINT2 = CH_LAYOUT_2POINT0POINT2 \| CH_SET_FRONT_CENTER | 3.0.2布局，共5个声道。 |
137| CH_LAYOUT_5POINT1 = CH_LAYOUT_5POINT0 \| CH_SET_LOW_FREQUENCY | 5.1布局，共6个声道。 |
138| CH_LAYOUT_5POINT1_BACK = CH_LAYOUT_5POINT0_BACK \| CH_SET_LOW_FREQUENCY | 5.1-后置布局，共6个声道。 |
139| CH_LAYOUT_6POINT0 = CH_LAYOUT_5POINT0 \| CH_SET_BACK_CENTER | 6.0布局，共6个声道。 |
140| CH_LAYOUT_3POINT1POINT2 = CH_LAYOUT_3POINT1 \| CH_SET_TOP_FRONT_LEFT \| CH_SET_TOP_FRONT_RIGHT | 3.1.2布局，共6个声道。 |
141| CH_LAYOUT_6POINT0_FRONT = CH_LAYOUT_QUAD_SIDE \| CH_SET_FRONT_LEFT_OF_CENTER \| CH_SET_FRONT_RIGHT_OF_CENTER | 6.0-Front布局，共6个声道。 |
142| CH_LAYOUT_HEXAGONAL = CH_LAYOUT_5POINT0_BACK \| CH_SET_BACK_CENTER | HEXAGONAL布局，共6个声道。 |
143| CH_LAYOUT_6POINT1 = CH_LAYOUT_5POINT1 \| CH_SET_BACK_CENTER | 6.1布局，共7个声道。 |
144| CH_LAYOUT_6POINT1_BACK = CH_LAYOUT_5POINT1_BACK \| CH_SET_BACK_CENTER | 6.1-后置布局，共7个声道。 |
145| CH_LAYOUT_6POINT1_FRONT = CH_LAYOUT_6POINT0_FRONT \| CH_SET_LOW_FREQUENCY | 6.1-前置布局，共7个声道。 |
146| CH_LAYOUT_7POINT0 = CH_LAYOUT_5POINT0 \| CH_SET_BACK_LEFT \| CH_SET_BACK_RIGHT | 7.0布局，共7个声道。 |
147| CH_LAYOUT_7POINT0_FRONT = CH_LAYOUT_5POINT0 \| CH_SET_FRONT_LEFT_OF_CENTER \| CH_SET_FRONT_RIGHT_OF_CENTER | 7.0-前置布局，共7个声道。 |
148| CH_LAYOUT_7POINT1 = CH_LAYOUT_5POINT1 \| CH_SET_BACK_LEFT \| CH_SET_BACK_RIGHT | 7.1布局，共8个声道。 |
149| CH_LAYOUT_OCTAGONAL = CH_LAYOUT_5POINT0 \| CH_SET_BACK_LEFT \| CH_SET_BACK_CENTER \| CH_SET_BACK_RIGHT | OCTAGONAL布局，共8个声道。 |
150| CH_LAYOUT_5POINT1POINT2 = CH_LAYOUT_5POINT1 \| CH_SET_TOP_SIDE_LEFT \| CH_SET_TOP_SIDE_RIGHT | 5.1.2布局，共8个声道。 |
151| CH_LAYOUT_7POINT1_WIDE = CH_LAYOUT_5POINT1 \| CH_SET_FRONT_LEFT_OF_CENTER \| CH_SET_FRONT_RIGHT_OF_CENTER | 7.1-宽布局，共8个声道。 |
152| CH_LAYOUT_7POINT1_WIDE_BACK = CH_LAYOUT_5POINT1_BACK \| CH_SET_FRONT_LEFT_OF_CENTER \| CH_SET_FRONT_RIGHT_OF_CENTER | 7.1-后置宽布局，共8个声道。 |
153| CH_LAYOUT_AMB_ORDER2_ACN_N3D = AMB_MODE \| AMB_ORD_2 \| AMB_COM_ACN \| AMB_NOR_N3D | ACN_N3D（根据ITU标准）的二阶HOA布局，共9个声道。 |
154| CH_LAYOUT_AMB_ORDER2_ACN_SN3D = AMB_MODE \| AMB_ORD_2 \| AMB_COM_ACN \| AMB_NOR_SN3D | ACN_SN3D（根据ITU标准）的二阶HOA布局，共9个声道。 |
155| CH_LAYOUT_AMB_ORDER2_FUMA = AMB_MODE \| AMB_ORD_2 \| AMB_COM_FUMA | FUMA（根据ITU标准）的二阶HOA布局，共9个声道。 |
156| CH_LAYOUT_5POINT1POINT4 = CH_LAYOUT_5POINT1 \| CH_SET_TOP_FRONT_LEFT \| CH_SET_TOP_FRONT_RIGHT \| CH_SET_TOP_BACK_LEFT \| CH_SET_TOP_BACK_RIGHT | 5.1.4布局，共10个声道。 |
157| CH_LAYOUT_7POINT1POINT2 = CH_LAYOUT_7POINT1 \| CH_SET_TOP_SIDE_LEFT \| CH_SET_TOP_SIDE_RIGHT | 7.1.2布局，共10个声道。 |
158| CH_LAYOUT_7POINT1POINT4 = CH_LAYOUT_7POINT1 \| CH_SET_TOP_FRONT_LEFT \| CH_SET_TOP_FRONT_RIGHT \| CH_SET_TOP_BACK_LEFT \| CH_SET_TOP_BACK_RIGHT | 7.1.4布局，共12个声道。 |
159| CH_LAYOUT_10POINT2 = CH_SET_FRONT_LEFT \| CH_SET_FRONT_RIGHT \| CH_SET_FRONT_CENTER \| CH_SET_TOP_FRONT_LEFT \| CH_SET_TOP_FRONT_RIGHT \| CH_SET_BACK_LEFT \| CH_SET_BACK_RIGHT \| CH_SET_BACK_CENTER \| CH_SET_SIDE_LEFT \| CH_SET_SIDE_RIGHT \| CH_SET_WIDE_LEFT \| CH_SET_WIDE_RIGHT | 10.2布局，共12个声道。 |
160| CH_LAYOUT_9POINT1POINT4 = CH_LAYOUT_7POINT1POINT4 \| CH_SET_WIDE_LEFT \| CH_SET_WIDE_RIGHT | 9.1.4布局，共14个声道。 |
161| CH_LAYOUT_9POINT1POINT6 = CH_LAYOUT_9POINT1POINT4 \| CH_SET_TOP_SIDE_LEFT \| CH_SET_TOP_SIDE_RIGHT | 9.1.6布局，共16个声道。 |
162| CH_LAYOUT_HEXADECAGONAL = CH_LAYOUT_OCTAGONAL \| CH_SET_WIDE_LEFT \| CH_SET_WIDE_RIGHT \| CH_SET_TOP_BACK_LEFT \| CH_SET_TOP_BACK_RIGHT \| CH_SET_TOP_BACK_CENTER \| CH_SET_TOP_FRONT_CENTER \| CH_SET_TOP_FRONT_LEFT \| CH_SET_TOP_FRONT_RIGHT | HEXADECAGONAL布局，共16个声道。 |
163| CH_LAYOUT_AMB_ORDER3_ACN_N3D = AMB_MODE \| AMB_ORD_3 \| AMB_COM_ACN \| AMB_NOR_N3D | ACN_N3D（根据ITU标准）的三阶HOA布局，共16个声道。 |
164| CH_LAYOUT_AMB_ORDER3_ACN_SN3D = AMB_MODE \| AMB_ORD_3 \| AMB_COM_ACN \| AMB_NOR_SN3D | ACN_SN3D（根据ITU标准）的三阶HOA布局，共16个声道。 |
165| CH_LAYOUT_AMB_ORDER3_FUMA = AMB_MODE \| AMB_ORD_3 \| AMB_COM_FUMA | FUMA（根据ITU标准）的三阶HOA布局，共16个声道。 |
166| CH_LAYOUT_22POINT2 = CH_LAYOUT_7POINT1POINT4 \| CH_SET_FRONT_LEFT_OF_CENTER \| CH_SET_FRONT_RIGHT_OF_CENTER \| CH_SET_BACK_CENTER \| CH_SET_TOP_CENTER \| CH_SET_TOP_FRONT_CENTER \| CH_SET_TOP_BACK_CENTER \| CH_SET_TOP_SIDE_LEFT \| CH_SET_TOP_SIDE_RIGHT \| CH_SET_BOTTOM_FRONT_LEFT \| CH_SET_BOTTOM_FRONT_RIGHT \| CH_SET_BOTTOM_FRONT_CENTER \| CH_SET_LOW_FREQUENCY_2 | 22.2布局，共24个声道。 |
167
168
169