Skip to content

Commit

Permalink
Merge pull request #3578 from AgoraIO/translation/4.x-api-ref
Browse files Browse the repository at this point in the history
New YiCAT updates
  • Loading branch information
Cilla-luodan authored Apr 16, 2024
2 parents b7c5d97 + 3f758b4 commit f117b4c
Show file tree
Hide file tree
Showing 409 changed files with 1,781 additions and 537 deletions.
Original file line number Diff line number Diff line change
Expand Up @@ -31,18 +31,16 @@
<parml>
<plentry props="mac">
<pt>type</pt>
<pd>
<p>The device type. See <xref keyref="MEDIA_DEVICE_TYPE"/>.</p>
</pd>
<pd>Output parameter; the device type, see <xref keyref="MEDIA_DEVICE_TYPE"/>.</pd>
</plentry>

<plentry props="cpp unreal bp">
<plentry props="cpp unreal bp" id="name">
<pt>deviceName</pt>
<pd>Output parameter, the name of the system default audio device. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE"/>.</pd>
<pd>Output parameter; the name of the system's default audio device. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE"/>.</pd>
</plentry>
<plentry props="cpp unreal bp">
<plentry props="cpp unreal bp" id="id">
<pt>deviceId</pt>
<pd>Output parameter, the device ID of the the system default audio device. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE"/>.</pd>
<pd>Output parameter; the device ID of the system default audio device. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE"/>.</pd>
</plentry>
</parml> </section>
<section id="return_values">
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="api_iaudiodevicecollection_getdefaultdevice2">
<title><ph keyref="getDefaultDevice2_IAudioDeviceCollection"/></title>
<shortdesc id="short"><ph id="shortdesc">Get the system‘s default audio device and its type.</ph></shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm keyref="getDefaultDevice2_IAudioDeviceCollection"/>
</keywords>
</metadata>
</prolog>
<refbody>
<section id="prototype">
<p outputclass="codeblock">
<codeblock props="android" outputclass="language-java"/>
<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"/>
<codeblock props="electron" outputclass="language-typescript"/>
<codeblock props="unity cs" outputclass="language-csharp"/>
<codeblock props="rn" outputclass="language-typescript"/>
<codeblock props="flutter" outputclass="language-dart"/> </p>
</section>
<section id="detailed_desc">
<title>Details</title>
<dl outputclass="since">
<dlentry props="native">
<dt>Since</dt>
<dd>v4.3.1</dd>
</dlentry>
</dl>
<ul><li>This method applies to macOS only.</li>
<li>You need to call <xref keyref="enumeratePlaybackDevices" /> or <xref keyref="enumerateRecordingDevices" /> to get the device list before calling this method.</li></ul>
</section>
<section id="parameters">
<title>Parameters</title>
<parml>
<plentry conkeyref="getDefaultDevice_IAudioDeviceCollection/name">
<pt/>
<pd/>
</plentry>
<plentry conkeyref="getDevice2_IAudioDeviceCollection/typename">
<pt/>
<pd/>
</plentry>
<plentry conkeyref="getDefaultDevice_IAudioDeviceCollection/id">
<pt></pt>
<pd></pd>
</plentry>
</parml> </section>
<section id="return_values" conkeyref="getDefaultDevice_IAudioDeviceCollection/return_values"> </section>
</refbody>
</reference>
15 changes: 9 additions & 6 deletions en-US/dita/RTC-NG/API/api_iaudiodevicecollection_getdevice.dita
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="api_iaudiodevicecollection_getdevice">
<title><ph keyref="getDevice_IAudioDeviceCollection" /></title>
<shortdesc id="short"><ph id="shortdesc">Gets the information of a specified audio device.</ph></shortdesc>
<shortdesc id="short"><ph id="shortdesc">Gets the information of a specified audio device by index.</ph></shortdesc>
<prolog>
<metadata>
<keywords>
Expand All @@ -24,18 +24,21 @@
<codeblock props="flutter" outputclass="language-dart">Future&lt;String&gt; getDevice();</codeblock>
<codeblock props="reserve" outputclass="language-cpp"></codeblock></p>
</section>
<section id="detailed_desc">
<p id="note">This method is for Windows and macOS only.</p>
</section>
<section id="parameters" props="cpp unreal bp">
<title>Parameters</title>
<parml>
<plentry>
<plentry id="index">
<pt>index</pt>
<pd>An input parameter. The index of the device.</pd>
</plentry>
<plentry>
<plentry id="device">
<pt>deviceName</pt>
<pd>An output parameter. The device name. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</pd>
</plentry>
<plentry>
<plentry id="id">
<pt>deviceId</pt>
<pd>An output parameter. The device ID. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</pd>
</plentry>
Expand All @@ -46,7 +49,7 @@
<li>0: Success.</li>
<li>&lt; 0: Failure. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></li>
</ul>
<p props="unity flutter electron rn cs">Retrieves the volume of the audio recording device.</p>
<p props="unity flutter electron rn cs">Retrieves the information of the audio recording device.</p>
</section>
</refbody>
</reference>
</reference>
59 changes: 59 additions & 0 deletions en-US/dita/RTC-NG/API/api_iaudiodevicecollection_getdevice2.dita
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="api_iaudiodevicecollection_getdevice2">
<title><ph keyref="getDevice2_IAudioDeviceCollection"/></title>
<shortdesc id="short"><ph id="shortdesc">Get the audio device information and device type by index.</ph></shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm keyref="getDevice2_IAudioDeviceCollection"/>
</keywords>
</metadata>
</prolog>
<refbody>
<section id="prototype">
<p outputclass="codeblock">
<codeblock props="android" outputclass="language-java"/>
<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>
<codeblock props="bp" outputclass="language-cpp"/>
<codeblock props="electron" outputclass="language-typescript"/>
<codeblock props="unity cs" outputclass="language-csharp"/>
<codeblock props="rn" outputclass="language-typescript"/>
<codeblock props="flutter" outputclass="language-dart"/> </p>
</section>
<section id="detailed_desc">
<title>Details</title>
<dl outputclass="since">
<dlentry props="native">
<dt>Since</dt>
<dd>v4.3.1</dd>
</dlentry>
</dl>
<p>You can call this method to get the name, type and ID of a specified audio device.</p>
<note type="attention">This method is for macOS only.</note>
</section>
<section id="parameters">
<title>Parameters</title>
<parml>
<plentry conkeyref="getDevice_IAudioDeviceCollection/index">
<pt></pt>
<pd></pd>
</plentry>
<plentry conkeyref="getDevice_IAudioDeviceCollection/id">
<pt/>
<pd/>
</plentry>
<plentry conkeyref="getDevice_IAudioDeviceCollection/device">
<pt></pt>
<pd></pd>
</plentry>
<plentry id="typename">
<pt>deviceTypeName</pt>
<pd>Output parameter; indicates the type of audio devices, such as built-in, USB and HDMI. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</pd>
</plentry>
</parml> </section>
<section id="return_values" conkeyref="getDevice_IAudioDeviceCollection/return_values"> </section>
</refbody>
</reference>
Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@
</parml> </section>
<section id="return_values">
<title><ph keyref="return-section-title"/></title>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown; and you need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown. You need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<ul props="native unreal bp electron unity rn cs">
<li>0: Success.</li>
<li>&lt; 0: Failure. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></li>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -45,7 +45,7 @@
</parml> </section>
<section id="return_values">
<title><ph keyref="return-section-title"/></title>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown; and you need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown. You need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<ul props="native unreal bp unity electron cs">
<li>0: Success.</li>
<li>&lt; 0: Failure. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></li>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@
</parml> </section>
<section id="return_values">
<title><ph keyref="return-section-title"/></title>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown; and you need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown. You need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<ul props="native unreal bp unity electron rn cs">
<li>0: Success.</li>
<li>&lt; 0: Failure. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></li>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -40,7 +40,7 @@
</parml></section>
<section id="return_values">
<title><ph keyref="return-section-title"/></title>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown; and you need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown. You need to catch the exception and handle it accordingly. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></p>
<ul props="mac cpp unreal bp unity electron rn cs">
<li>0: Success.</li>
<li>&lt; 0: Failure. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></li>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="api_iaudiodevicemanager_getplaybackdeviceinfo">
<title><ph keyref="getPlaybackDeviceInfo" /></title>
<shortdesc id="short"><ph id="shortdesc"><ph props="cpp unreal bp">Retrieves the audio playback device information associated with the device ID and device name. </ph><ph props="unity electron flutter cs">Retrieves the audio playback device associated with the device ID.</ph></ph></shortdesc>
<shortdesc id="short"><ph id="shortdesc"><ph>Retrieves the information of the audio playback device.</ph></ph></shortdesc>
<prolog>
<metadata>
<keywords>
Expand Down Expand Up @@ -31,13 +31,13 @@
<section id="parameters" props="cpp unreal bp unity cs">
<title>Parameters</title>
<parml>
<plentry>
<plentry id="id">
<pt>deviceId</pt>
<pd><ph>The device ID of the playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
<pd><ph>Th ID of the audio playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
</plentry>
<plentry>
<plentry id="name">
<pt>deviceName</pt>
<pd><ph>The device name of the playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
<pd><ph>Output parameter; the name of the playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
</plentry>
</parml> </section>
<section id="return_values">
Expand Down
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="api_iaudiodevicemanager_getplaybackdeviceinfo2">
<title><ph keyref="getPlaybackDeviceInfo2"/></title>
<shortdesc id="short"><ph id="shortdesc">Get the information and type of the audio playback device.</ph></shortdesc>
<prolog>
<metadata>
<keywords>
<indexterm keyref="getPlaybackDeviceInfo2"/>
</keywords>
</metadata>
</prolog>
<refbody>
<section id="prototype">
<p outputclass="codeblock">
<codeblock props="android" outputclass="language-java"/>
<codeblock props="ios mac" outputclass="language-objectivec"/>
<codeblock props="cpp unreal" outputclass="language-cpp">virtual int getPlaybackDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH], char deviceTypeName[MAX_DEVICE_ID_LENGTH]) = 0;</codeblock>
<codeblock props="bp" outputclass="language-cpp"/>
<codeblock props="electron" outputclass="language-typescript"/>
<codeblock props="unity cs" outputclass="language-csharp"/>
<codeblock props="rn" outputclass="language-typescript"/>
<codeblock props="flutter" outputclass="language-dart"/> </p>
</section>
<section id="detailed_desc">
<title>Details</title>
<dl outputclass="since">
<dlentry props="native">
<dt>Since</dt>
<dd>v4.3.1</dd>
</dlentry>
</dl>
<p>This method applies to macOS only.</p>
</section>
<section id="parameters">
<title>Parameters</title>
<parml>
<plentry conkeyref="getPlaybackDeviceInfo/id">
<pt/>
<pd/>
</plentry>
<plentry conkeyref="getPlaybackDeviceInfo/name">
<pt></pt>
<pd></pd>
</plentry>
<plentry>
<pt>deviceTypeName</pt>
<pd>Output parameter; indicates the type of audio playback devices, such as built-in, USB and HDMI. The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</pd>
</plentry>
</parml> </section>
<section id="return_values">
<title><ph keyref="return-section-title"/></title>
<p props="flutter">When the method call succeeds, there is no return value; when fails, the <xref keyref="AgoraRtcException"/> exception is thrown. You need to catch the exception and handle it accordingly.</p>
<ul props="native electron unity rn unreal bp">
<li>0: Success.</li>
<li>&lt; 0: Failure. <ph props="cn">See <xref keyref="error-code-link"/> for details and resolution suggestions.</ph></li>
</ul> </section>
</refbody>
</reference>
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<!DOCTYPE reference PUBLIC "-//OASIS//DTD DITA Reference//EN" "reference.dtd">
<reference id="api_iaudiodevicemanager_getrecordingdeviceinfo">
<title><ph keyref="getRecordingDeviceInfo" /></title>
<shortdesc id="short"><ph id="shortdesc"><ph props="cpp unreal bp">Retrieves the information of the audio recording device. </ph><ph props="unity electron flutter cs">Retrieves the volume of the audio recording device.</ph></ph></shortdesc>
<shortdesc id="short"><ph id="shortdesc"><ph>Retrieves the information of the audio recording device.</ph></ph></shortdesc>
<prolog>
<metadata>
<keywords>
Expand Down Expand Up @@ -31,13 +31,13 @@
<section id="parameters" props="cpp unreal bp unity cs">
<title>Parameters</title>
<parml>
<plentry>
<plentry id="id">
<pt>deviceId</pt>
<pd><ph>The device ID of the playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
<pd><ph>Th ID of the audio playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
</plentry>
<plentry>
<plentry id="name">
<pt>deviceName</pt>
<pd><ph>The device name of the playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
<pd><ph>Output parameter; the name of the playback device. </ph><ph props="cpp unreal bp">The maximum length is <xref keyref="MAX_DEVICE_ID_LENGTH_TYPE" />.</ph></pd>
</plentry>
</parml> </section>
<section id="return_values">
Expand Down
Loading

0 comments on commit f117b4c

Please sign in to comment.