update zh-cn/device-dev/reference/hdi-apis/_audio_attribute.md.

Signed-off-by: Nli-yan339 <liyan339@h-partners.com>
Signed-off-by: Nliyan <liyan339@h-partners.com>

zh-cn/device-dev/reference/hdi-apis/_audio_attribute.md

@@ -5,7 +5,7 @@
 
 AudioAttribute音频属性接口。
 
-提供音频播放（render）或录音（capture）需要的公共属性驱动能力，包括获取帧（frame）信息、设置采样属性等。
+提供音频播放（Render）或录音（Capture）需要的公共属性驱动能力，包括获取帧（frame）信息、设置采样属性等。
 
 **Since:**
 
@@ -34,8 +34,8 @@ AudioAttribute音频属性接口。
 | ([GetCurrentChannelId](#getcurrentchannelid))(AudioHandle handle, uint32_t \*channelId) | 获取音频的数据通道ID | 
 | ([SetExtraParams](#setextraparams))(AudioHandle handle, const char \*keyValueList) | 设置音频拓展参数 | 
 | ([GetExtraParams](#getextraparams))(AudioHandle handle, char \*keyValueList) | 获取音频拓展参数 | 
-| ([ReqMmapBuffer](#reqmmapbuffer))(AudioHandle handle, int32_t reqSize, struct AudioMmapBufferDescripter \*desc) | 请求mmap缓冲区 | 
-| ([GetMmapPosition](#getmmapposition))(AudioHandle handle, uint64_t \*frames, struct AudioTimeStamp \*time) | 获取当前mmap的读/写位置 | 
+| ([ReqMmapBuffer](#reqmmapbuffer))(AudioHandle handle, int32_t reqSize, struct AudioMmapBufferDescripter \*desc) | 请求Mmap缓冲区 | 
+| ([GetMmapPosition](#getmmapposition))(AudioHandle handle, uint64_t \*frames, struct AudioTimeStamp \*time) | 获取当前Mmap的读/写位置 | 
 | ([AddAudioEffect](#addaudioeffect))(AudioHandle handle, uint64_t effectid) | 添加音频效果算法实例 | 
 | ([RemoveAudioEffect](#removeaudioeffect))(AudioHandle handle, uint64_t effectid) | 移除音频效果算法实例 | 
 | ([GetFrameBufferSize](#getframebuffersize))(AudioHandle handle, uint64_t \*bufferSize) | 获取播放或录音的缓冲区大小 | 
@@ -53,7 +53,7 @@ int32_t (*AudioAttribute::AddAudioEffect)(AudioHandle handle, uint64_t effectid)
 
 **描述：**
 
-添加音频效果算法实例
+添加音频效果算法实例。
 
 **参数:**
 
@@ -64,7 +64,7 @@ int32_t (*AudioAttribute::AddAudioEffect)(AudioHandle handle, uint64_t effectid)
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### GetCurrentChannelId
@@ -76,18 +76,18 @@ int32_t(* AudioAttribute::GetCurrentChannelId) (AudioHandle handle, uint32_t *ch
 
 **描述：**
 
-获取音频的数据通道ID
+获取音频的数据通道ID。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| channelId | 获取的通道ID保存到channelId中 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| channelId | 输出参数，获取的通道ID保存到channelId中。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### GetExtraParams
@@ -99,18 +99,18 @@ int32_t(* AudioAttribute::GetExtraParams) (AudioHandle handle, char *keyValueLis
 
 **描述：**
 
-获取音频拓展参数
+获取音频拓展参数。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| keyValueList | 拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| keyValueList | 输出参数，拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### GetFrameBufferSize
@@ -122,7 +122,7 @@ int32_t (*AudioAttribute::GetFrameBufferSize)(AudioHandle handle, uint64_t *buff
 
 **描述：**
 
-获取播放或录音的缓冲区大小
+获取播放或录音的缓冲区大小。
 
 **参数:**
 
@@ -145,18 +145,18 @@ int32_t(* AudioAttribute::GetFrameCount) (AudioHandle handle, uint64_t *count)
 
 **描述：**
 
-获取音频buffer中的音频帧数
+获取音频buffer中的音频帧数。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| count | 一个音频buffer中包含的音频帧数，获取后保存到count中 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| count | 输出参数，一个音频buffer中包含的音频帧数，获取后保存到count中。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### GetFrameSize
@@ -168,20 +168,19 @@ int32_t(* AudioAttribute::GetFrameSize) (AudioHandle handle, uint64_t *size)
 
 **描述：**
 
-获取音频帧（frame）的大小
+获取音频帧（frame）的大小，即一帧音频数据的长度（字节数）。
 
-获取一帧音频数据的长度（字节数）
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| size | 获取的音频帧大小（字节数）保存到size中 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| size | 输出参数，获取的音频帧大小（字节数）保存到size中。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### GetMmapPosition
@@ -193,19 +192,19 @@ int32_t(* AudioAttribute::GetMmapPosition) (AudioHandle handle, uint64_t *frames
 
 **描述：**
 
-获取当前mmap的读/写位置
+获取当前Mmap的读/写位置。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| frames | 获取的音频帧计数保存到frames中 | 
-| time | 获取的关联时间戳保存到time中 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| frames | 输出参数，获取的音频帧计数保存到frames中。 | 
+| time | 输出参数，获取的关联时间戳保存到time中。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### GetSampleAttributes
@@ -217,14 +216,14 @@ int32_t(* AudioAttribute::GetSampleAttributes) (AudioHandle handle, struct Audio
 
 **描述：**
 
-获取音频采样的属性参数
+获取音频采样的属性参数。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| attrs | 获取的音频采样属性（例如采样频率、采样精度、通道）保存到attrs中 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| attrs | 输出参数，获取的音频采样属性（例如采样频率、采样精度、通道）保存到attrs中。 | 
 
 **返回:**
 
@@ -244,7 +243,7 @@ int32_t (*AudioAttribute::RemoveAudioEffect)(AudioHandle handle, uint64_t effect
 
 **描述：**
 
-移除音频效果算法实例
+移除音频效果算法实例。
 
 **参数:**
 
@@ -267,19 +266,19 @@ int32_t(* AudioAttribute::ReqMmapBuffer) (AudioHandle handle, int32_t reqSize, s
 
 **描述：**
 
-请求mmap缓冲区
+请求Mmap缓冲区。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| reqSize | 请求缓冲区的大小 | 
-| desc | 缓冲区描述符 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| reqSize | 输入参数，请求缓冲区的大小。 | 
+| desc | 输出参数，缓冲区描述符。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### SetExtraParams
@@ -291,18 +290,18 @@ int32_t(* AudioAttribute::SetExtraParams) (AudioHandle handle, const char *keyVa
 
 **描述：**
 
-设置音频拓展参数
+设置音频拓展参数。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| keyValueList | 拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| keyValueList | 输入参数，拓展参数键值对字符串列表，格式为key=value，多个键值对通过分号分割。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 
 ### SetSampleAttributes
@@ -314,18 +313,18 @@ int32_t(* AudioAttribute::SetSampleAttributes) (AudioHandle handle, const struct
 
 **描述：**
 
-设置音频采样的属性参数
+设置音频采样的属性参数。
 
 **参数:**
 
   | 名称 | 描述 | 
 | -------- | -------- |
-| handle | 待操作的音频句柄 | 
-| attrs | 待设置的音频采样属性，例如采样频率、采样精度、通道 | 
+| handle | 输入参数，待操作的音频句柄。 | 
+| attrs | 输入参数，待设置的音频采样属性，例如采样频率、采样精度、通道。 | 
 
 **返回:**
 
-成功返回值0，失败返回负值
+成功返回值0，失败返回负值。
 
 **参见:**