Merge branch 'master' into translation/4.x-api-ref

.gitignore

@@ -11,3 +11,4 @@ temp/
 *.xpr
 .vscode/settings.json
 .vscode/extensions.json
+*.py

dita/RTC-NG/API/api_agoravideoencoderconfiguration_initwithsize.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec">- (instancetype _Nonnull)initWithSize:(CGSize)size
                             frameRate:(AgoraVideoFrameRate)frameRate
                               bitrate:(NSInteger)bitrate
@@ -48,7 +49,7 @@
             <plentry>
                 <pt>mirrorMode</pt>
                 <pd>发送编码视频时是否开启镜像模式，只影响远端用户看到的视频画面。详见 <xref keyref="VIDEO_MIRROR_MODE_TYPE"/>。
-                    <p props="android">
+                    <p props="android hmos">
                         <ul conkeyref="setLocalRenderMode2/videomirrormodetype">
                         <li/>
                         </ul> </p>

dita/RTC-NG/API/api_agoravideoencoderconfiguration_initwithwidth.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec">- (instancetype _Nonnull)initWithWidth:(NSInteger)width
                                 height:(NSInteger)height
                              frameRate:(AgoraVideoFrameRate)frameRate
@@ -53,7 +54,7 @@
             <plentry>
                 <pt>mirrorMode</pt>
                 <pd>发送编码视频时是否开启镜像模式，只影响远端用户看到的视频画面。详见 <xref keyref="VIDEO_MIRROR_MODE_TYPE"/>。
-                    <p props="android">
+                    <p props="android hmos">
                         <ul conkeyref="setLocalRenderMode2/videomirrormodetype">
                         <li/>
                         </ul> </p>

dita/RTC-NG/API/api_channelmediarelayconfiguration_getdestchannelmediainfos.dita

@@ -15,6 +15,9 @@
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java">public Map&lt;String, ChannelMediaInfo> getDestChannelMediaInfos() {
   return destInfos;
+}</codeblock>
+            <codeblock props="hmos" outputclass="language-arkts">public getDestChannelMediaInfos(): Map&lt;String, ChannelMediaInfo> {
+  return this.destInfos;
 }</codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>

dita/RTC-NG/API/api_channelmediarelayconfiguration_getsrcchannelmediainfo.dita

@@ -15,6 +15,9 @@
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java">public ChannelMediaInfo getSrcChannelMediaInfo() {
   return srcInfo;
+}</codeblock>
+            <codeblock props="hmos" outputclass="language-arkts">public getSrcChannelMediaInfo(): ChannelMediaInfo {
+  return this.srcInfo;
 }</codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>

dita/RTC-NG/API/api_channelmediarelayconfiguration_removedestchannelinfo.dita

@@ -15,6 +15,9 @@
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java">public void removeDestChannelInfo(String channelName) {
   destInfos.remove(channelName);
+}</codeblock>
+            <codeblock props="hmos" outputclass="language-arkts">public removeDestChannelInfo(channelName: string) {
+  this.destInfos.delete(channelName);
 }</codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec">- (BOOL)removeDestinationInfoForChannelName:(NSString *_Nonnull)channelName;</codeblock>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>

dita/RTC-NG/API/api_channelmediarelayconfiguration_setdestchannelinfo.dita

@@ -16,6 +16,9 @@
             <codeblock props="android" outputclass="language-java">public void setDestChannelInfo(String channelName, ChannelMediaInfo destInfo) {
     destInfos.put(channelName, destInfo);
   }</codeblock>
+            <codeblock props="hmos" outputclass="language-arkts">public setDestChannelInfo(channelName: string, destInfo: ChannelMediaInfo) {
+  this.destInfos.set(channelName, destInfo);
+}</codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec">- (BOOL)setDestinationInfo:(AgoraChannelMediaRelayInfo *_Nonnull)destinationInfo forChannelName:(NSString *_Nonnull)channelName;
 </codeblock>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>
@@ -33,7 +36,7 @@
                 <pd>目标频道的频道名。</pd>
             </plentry>
             <plentry>
-                <pt props="android">destInfo</pt>
+                <pt props="android hmos">destInfo</pt>
                 <pt props="ios mac">destinationInfo</pt>
                 <pd>
                     <p>目标频道信息 <apiname keyref="ChannelMediaInfo"/>，包含如下成员：                    

dita/RTC-NG/API/api_channelmediarelayconfiguration_setsrcchannelinfo.dita

@@ -15,6 +15,9 @@
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java">public void setSrcChannelInfo(ChannelMediaInfo srcInfo) {
   this.srcInfo = srcInfo;
+}</codeblock>
+            <codeblock props="hmos" outputclass="language-arkts">public setSrcChannelInfo(srcInfo: ChannelMediaInfo) {
+  this.srcInfo = srcInfo;
 }</codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>

dita/RTC-NG/API/api_createagorartcengine.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">AGORA_API agora::rtc::IRtcEngine *AGORA_CALL createAgoraRtcEngine ()</codeblock>
             <codeblock props="electron" outputclass="language-typescript">export function createAgoraRtcEngine(): IRtcEngineEx {

dita/RTC-NG/API/api_createagorartcengineex.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>
             <codeblock props="electron" outputclass="language-typescript"/>

dita/RTC-NG/API/api_getmediaplayercachemanager.dita

@@ -16,6 +16,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java">public abstract IMediaPlayerCacheManager getMediaPlayerCacheManager();</codeblock>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec">- (id&lt;AgoraRtcMediaPlayerCacheManagerProtocol&gt; _Nullable)createMediaPlayerCacheManager;</codeblock>
             <codeblock props="cpp unreal" outputclass="language-cpp">AGORA_API agora::rtc::IMediaPlayerCacheManager* AGORA_CALL getMediaPlayerCacheManager();</codeblock>
             <codeblock props="electron" outputclass="language-typescript">export function getMediaPlayerCacheManager(): IMediaPlayerCacheManager {
@@ -28,12 +29,17 @@
             <codeblock props="flutter" outputclass="language-dart">MediaPlayerCacheManager getMediaPlayerCacheManager()</codeblock>
             <codeblock props="reserve" outputclass="language-cpp"></codeblock></p>
         </section>
-        <section id="detailed_desc">
-            <title>详情</title>
-            <p>当你调用该方法后，SDK 会返回一个媒体播放器缓存管理器的实例。由于媒体播放器缓存管理器对象是单例模式，因此多次调用该方法将返回同一个实例。</p>
-            <note type="attention">
-            <p>请在初始化 <xref keyref="IRtcEngine" /> 后调用该方法。</p>
-            </note> </section>
+            <section id="detailed_desc" deliveryTarget="details" otherprops="no-title">
+                <p>在调用 <xref keyref="IMediaPlayerCacheManager"/> 类下的其他 API 前，你需要先调用该方法获取一个媒体播放器缓存管理器的实例。</p>
+            </section>
+            <section id="timing" deliveryTarget="details">
+                <title>调用时机</title>
+                <p>请在初始化 <xref keyref="IRtcEngine" /> 后调用该方法。</p>
+            </section>
+            <section id="restriction" deliveryTarget="details">
+                <title>调用限制</title>
+                <p>由于媒体播放器缓存管理器对象是单例模式，因此多次调用该方法将返回同一个实例。</p>
+            </section>
         <section id="return_values">
             <title>返回值</title>
             <p><xref keyref="IMediaPlayerCacheManager" /> 实例。</p>

dita/RTC-NG/API/api_iagoraparameter_setparameters.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int setParameters(const char* parameters) = 0;</codeblock>
             <codeblock props="electron" outputclass="language-typescript"/>

dita/RTC-NG/API/api_iaudiodevicecollection_getapplicationvolume.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getApplicationVolume(int&amp; volume) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_getcount.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getCount() = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_getdefaultdevice.dita

@@ -13,6 +13,7 @@
     <refbody>
         <section id="prototype">
             <p outputclass="codeblock">
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="mac" outputclass="language-objectivec">- (AgoraRtcDeviceInfo* _Nullable)getDefaultAudioDevice:(AgoraMediaDeviceType)type;
 </codeblock>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getDefaultDevice(char deviceName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;</codeblock>

dita/RTC-NG/API/api_iaudiodevicecollection_getdefaultdevice2.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getDefaultDevice(char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; </codeblock>
             <codeblock props="bp" outputclass="language-cpp"/>

dita/RTC-NG/API/api_iaudiodevicecollection_getdevice.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java" />
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec" />
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getDevice(int index, char deviceName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_getdevice2.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getDevice(int index, char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH],
                         char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; </codeblock>

dita/RTC-NG/API/api_iaudiodevicecollection_isapplicationmute.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int isApplicationMute(bool &amp;mute) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_release.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual void release() = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_setapplicationmute.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int setApplicationMute(bool mute) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_setapplicationvolume.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int setApplicationVolume(int volume) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicecollection_setdevice.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java" />
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec" />
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int setDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceCollection&quot;)

dita/RTC-NG/API/api_iaudiodevicemanager_enumerateplaybackdevices.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java" />
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec" />
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual IAudioDeviceCollection* enumeratePlaybackDevices() = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceManager&quot;)

dita/RTC-NG/API/api_iaudiodevicemanager_enumeraterecordingdevices.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java" />
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec" />
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual IAudioDeviceCollection* enumerateRecordingDevices() = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceManager&quot;)

dita/RTC-NG/API/api_iaudiodevicemanager_followsystemloopbackdevice.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int followSystemLoopbackDevice(bool enable) = 0;</codeblock>
             <codeblock props="electron" outputclass="language-typescript">abstract followSystemLoopbackDevice(enable: boolean): number;</codeblock>

dita/RTC-NG/API/api_iaudiodevicemanager_followsystemplaybackdevice.dita

@@ -13,6 +13,7 @@
     <refbody>
         <section id="prototype">
             <p outputclass="codeblock">
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="mac" outputclass="language-objectivec">(int) followSystemPlaybackDevice:(BOOL)enable;</codeblock>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int followSystemPlaybackDevice(bool enable) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceManager&quot;)

dita/RTC-NG/API/api_iaudiodevicemanager_followsystemrecordingdevice.dita

@@ -13,6 +13,7 @@
     <refbody>
         <section id="prototype">
             <p outputclass="codeblock">
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="mac" outputclass="language-objectivec">(int) followSystemRecordingDevice:(BOOL)enable;</codeblock>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int followSystemRecordingDevice(bool enable) = 0;</codeblock>
          <codeblock props="bp" outputclass="language-cpp">UFUNCTION(BlueprintCallable, Category = &quot;Agora|IAudioDeviceManager&quot;)

dita/RTC-NG/API/api_iaudiodevicemanager_getloopbackdevice.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp">virtual int getLoopbackDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0;</codeblock>
             <codeblock props="electron" outputclass="language-typescript">abstract getLoopbackDevice(): string;</codeblock>

dita/RTC-NG/API/api_iaudiodevicemanager_getplaybackdefaultdevice.dita

@@ -14,6 +14,7 @@
         <section id="prototype">
             <p outputclass="codeblock">
             <codeblock props="android" outputclass="language-java"/>
+            <codeblock props="hmos" outputclass="language-arkts"></codeblock>
             <codeblock props="ios mac" outputclass="language-objectivec"/>
             <codeblock props="cpp unreal" outputclass="language-cpp"/>
             <codeblock props="electron" outputclass="language-typescript">abstract getPlaybackDefaultDevice(): AudioDeviceInfo;</codeblock>