From 6f86a971aadcaa670b7b70bdf2d42c61a18cc02b Mon Sep 17 00:00:00 2001 From: jinyu Date: Thu, 9 May 2024 11:17:56 +0800 Subject: [PATCH] resolve comments --- dita/RTC-NG/API/api_irtcengine_disableaudio.dita | 4 ++-- dita/RTC-NG/API/api_irtcengine_enableaudio.dita | 6 +++--- .../API/api_irtcengine_enablelocalaudio.dita | 11 ++++++----- .../API/api_irtcengine_setaudioprofile.dita | 16 ++++++++-------- .../API/api_irtcengine_setaudioprofile2.dita | 2 +- .../API/api_irtcengine_setaudioscenario.dita | 12 ++++++------ 6 files changed, 26 insertions(+), 25 deletions(-) diff --git a/dita/RTC-NG/API/api_irtcengine_disableaudio.dita b/dita/RTC-NG/API/api_irtcengine_disableaudio.dita index ce62b621252..7427cf82967 100644 --- a/dita/RTC-NG/API/api_irtcengine_disableaudio.dita +++ b/dita/RTC-NG/API/api_irtcengine_disableaudio.dita @@ -25,11 +25,11 @@

-

调用该方法设置音频模块为禁用状态（默认开启）。

+

音频模块默认开启，你可以调用该方法关闭音频模块。

调用时机 -

在频道内和频道外均可调用。离开频道后仍然有效。

+

加入频道前后均可调用。离开频道后仍然有效。

调用限制 diff --git a/dita/RTC-NG/API/api_irtcengine_enableaudio.dita b/dita/RTC-NG/API/api_irtcengine_enableaudio.dita index 51759d3a9d2..0501b37e464 100644 --- a/dita/RTC-NG/API/api_irtcengine_enableaudio.dita +++ b/dita/RTC-NG/API/api_irtcengine_enableaudio.dita @@ -14,7 +14,7 @@

public abstract int enableAudio(); - - (int)enableAudio NS_SWIFT_NAME(enableAudio()); + - (int)enableAudio; virtual int enableAudio() = 0; UFUNCTION(BlueprintCallable, Category = "Agora|RtcEngineProxy") int EnableAudio(); @@ -25,11 +25,11 @@

-

音频模块默认为开启状态。

+

音频模块默认开启。如果你调用 关闭了音频模块，可调用该方法重新开启。

调用时机 -

在频道内和频道外均可调用。在离开频道后仍然有效。

+

加入频道前后均可调用。离开频道后仍然有效。

调用限制 diff --git a/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita b/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita index 0af5fb2aec5..c5acde2745d 100644 --- a/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita +++ b/dita/RTC-NG/API/api_irtcengine_enablelocalaudio.dita @@ -26,6 +26,11 @@

当用户加入频道时，音频功能默认是开启的。该方法可以关闭或重新开启本地音频功能，即停止或重新开始本地音频采集。

+

该方法与 的区别在于： +

    +
  • : 开启或关闭本地音频采集及处理。使用 关闭或开启本地采集后，本地听远端播放会有短暂中断。
    • +
  • : 停止或继续发送本地音频流，不影响音频的采集状态。
    • +

适用场景 @@ -37,11 +42,7 @@
调用限制 -

该方法与 的区别在于： -

    -
  • : 开启或关闭本地音频采集及处理。使用 关闭或开启本地采集后，本地听远端播放会有短暂中断。
    • -
  • : 停止或继续发送本地音频流，不影响音频的采集状态。
    • -

+

无。

适用场景 -

该方法适用于各种音频场景，你可以按需选择。例如，在音乐教学等高音质需求的场景中，建议将 profile 设置为 (4)，scenario 设置为 (3)。

+

该方法适用于各种音频场景，你可以按需选择。例如，在音乐教学等高音质需求的场景中，建议将 profile 设置为 (4)，scenario 设置为 (3)。

调用时机 @@ -50,7 +50,7 @@
调用限制 -

由于 iOS 系统限制，部分音频路由在通话音量模式下无法识别。因此，如需使用外接声卡，建议将音频应用场景设置为高音质场景 (3)。在这种场景下，SDK 会切换到媒体音量规避该问题。

+

由于 iOS 系统限制，部分音频路由在通话音量模式下无法识别。因此，如需使用外接声卡，建议将音频应用场景设置为高音质场景 (3)。在这种场景下，SDK 会切换到媒体音量规避该问题。

无。

@@ -61,15 +61,15 @@

音频编码属性，包含采样率、码率、编码模式和声道数。详见 。

    -
  • (0)：默认值。 +
  • (0)：默认值。
    • -
  • (1)：指定 32 kHz 采样率，语音编码，单声道，编码码率最大值为 18 Kbps。
    • -
  • (2)：指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 64 Kbps。
    • -
  • (3)：指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 80 Kbps。
    • -
  • (4)：指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 96 Kbps。
    • -
  • (5)：指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 128 Kbps。
    • +
  • (1)：指定 32 kHz 采样率，语音编码，单声道，编码码率最大值为 18 Kbps。
    • +
  • (2)：指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 64 Kbps。
    • +
  • (3)：指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 80 Kbps。
    • +
  • (4)：指定 48 kHz 采样率，音乐编码，单声道，编码码率最大值为 96 Kbps。
    • +
  • (5)：指定 48 kHz 采样率，音乐编码，双声道，编码码率最大值为 128 Kbps。

 diff --git a/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita b/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita index 46920667309..7ce477cd034 100644 --- a/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita +++ b/dita/RTC-NG/API/api_irtcengine_setaudioprofile2.dita @@ -26,7 +26,7 @@
适用场景 -

该方法适用于各种音频场景，你可以按需选择。例如，在音乐教学等高音质需求的场景中，建议将 profile 设置为 (4)。

+

该方法适用于各种音频场景，你可以按需选择。例如，在音乐教学等高音质需求的场景中，建议将 profile 设置为 (4)。

调用时机 diff --git a/dita/RTC-NG/API/api_irtcengine_setaudioscenario.dita b/dita/RTC-NG/API/api_irtcengine_setaudioscenario.dita index 7129968c3d7..1117a0d6a77 100644 --- a/dita/RTC-NG/API/api_irtcengine_setaudioscenario.dita +++ b/dita/RTC-NG/API/api_irtcengine_setaudioscenario.dita @@ -29,7 +29,7 @@
适用场景 -

该方法适用于各种音频场景，你可以按需选择。例如，在音乐教学等高音质需求的场景中，建议将 scenario 设置为 (3)。

+

该方法适用于各种音频场景，你可以按需选择。例如，在音乐教学等高音质需求的场景中，建议将 scenario 设置为 (3)。

调用时机 @@ -44,12 +44,12 @@ 音频场景。不同的音频场景下，设备的音量类型是不同的。 详见 。
    -
  • (0):（默认）自动场景，根据用户角色和音频路由自动匹配合适的音质。
    • -
  • (3): 高音质场景，适用于音乐为主的场景。
    • -
  • (5): 聊天室场景，适用于用户需要频繁上下麦的场景。该场景下，观众会收到申请麦克风权限的弹窗提示。
    • -
  • (7): 合唱场景。适用于网络条件良好，要求极低延时的实时合唱场景。 +
  • (0):（默认）自动场景，根据用户角色和音频路由自动匹配合适的音质。
    • +
  • (3): 高音质场景，适用于音乐为主的场景。
    • +
  • (5): 聊天室场景，适用于用户需要频繁上下麦的场景。该场景下，观众会收到申请麦克风权限的弹窗提示。
    • +
  • (7): 合唱场景。适用于网络条件良好，要求极低延时的实时合唱场景。
    • -
  • (8): 会议场景，适用于人声为主的多人会议。
    • +
  • (8): 会议场景，适用于人声为主的多人会议。