From 4b16250781d3e78648dd8ba2a3d8715c09e23ff0 Mon Sep 17 00:00:00 2001 From: TongJiangyong <1246376353@qq.com> Date: Mon, 28 Dec 2020 12:05:27 +0800 Subject: [PATCH 1/7] fit 1.2.1 --- .../RtcChannelPublishHelper/.gitignore | 70 + .../RtcChannelPublishHelper/CMakeLists.txt | 44 + .../RtcChannelPublishHelper/build.gradle | 64 + .../gradle/wrapper/gradle-wrapper.jar | Bin 0 -> 53637 bytes .../gradle/wrapper/gradle-wrapper.properties | 6 + .../RtcChannelPublishHelper/libs/PLACEHOLDER | 2 + .../proguard-rules.txt | 20 + .../src/main/AndroidManifest.xml | 62 + .../src/main/cpp/agora_plugin_rtc.cpp | 395 + .../src/main/cpp/include/AgoraBase.h | 786 ++ .../src/main/cpp/include/AgoraRefPtr.h | 119 + .../cpp/include/AgoraRtcCryptoCppLoader.h | 18 + .../main/cpp/include/AudioCircularBuffer.h | 174 + .../src/main/cpp/include/IAgoraMediaEngine.h | 227 + .../src/main/cpp/include/IAgoraParameter.h | 208 + .../src/main/cpp/include/IAgoraRtcChannel.h | 1203 +++ .../src/main/cpp/include/IAgoraRtcEngine.h | 7155 +++++++++++++++++ .../src/main/cpp/include/IAgoraService.h | 76 + .../src/main/cpp/include/constructor_magic.h | 50 + .../src/main/cpp/include/scoped_ptr.h | 719 ++ .../src/main/cpp/include/template_util.h | 114 + .../src/main/cpp/include/typedefs.h | 151 + .../main/java/io/agora/MediaVideoSource.java | 58 + .../io/agora/RtcChannelPublishHelper.java | 307 + .../src/main/java/io/agora/utils/LogUtil.java | 110 + .../main/res/drawable-hdpi/ic_launcher.png | Bin 0 -> 9397 bytes .../src/main/res/values/dimens.xml | 7 + .../src/main/res/values/strings.xml | 7 + .../src/main/res/values/styles.xml | 20 + .../AgoraPlayer_Quickstart/app/build.gradle | 8 +- .../io/agora/mediaplayer/PlayerFragment.java | 10 + .../app/src/main/res/values/strings.xml | 2 +- .../AgoraPlayer_Quickstart/settings.gradle | 3 +- 33 files changed, 12190 insertions(+), 5 deletions(-) create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/.gitignore create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/CMakeLists.txt create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/gradle/wrapper/gradle-wrapper.jar create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/gradle/wrapper/gradle-wrapper.properties create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/libs/PLACEHOLDER create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/proguard-rules.txt create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/AndroidManifest.xml create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRefPtr.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRtcCryptoCppLoader.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AudioCircularBuffer.h create mode 100755 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraParameter.h create mode 100755 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h create mode 100755 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/constructor_magic.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/scoped_ptr.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/template_util.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/typedefs.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/utils/LogUtil.java create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/drawable-hdpi/ic_launcher.png create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/dimens.xml create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/strings.xml create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/styles.xml diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/.gitignore b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/.gitignore new file mode 100644 index 0000000..9a2a2f0 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/.gitignore @@ -0,0 +1,70 @@ +# built application files +*.apk +*.ap_ + +# files for the dex VM +*.dex + +# Java class files +*.class + +# Mobile Tools for Java (J2ME) +.mtj.tmp/ + + +# generated files +bin/ +obj +obj/local +gen/ +bin/dexedLibs +bin/res +bin/*.xml +bin/classes +bin/res +bin/jarlist.cache +*.cache + +# Local configuration file (sdk path, etc) +local.properties + +# Eclipse project files +.classpath +.project + +# Proguard folder generated by Eclipse +proguard/ + +# Intellij project files +*.iml +*.ipr +*.iws + +# Gradle +.gradle/ +.gradle +build/ +build +.externalNativeBuild/ +.externalNativeBuild +# gedit +*~ + +.idea/*.xml +!.idea/codeStyleSettings.xml +!.idea/copyright/*.xml +!.idea/fileColors.xml +!.idea/encodings.xml +!.idea/gradle.xml +!.idea/runConfigurations/*.xml + +!.idea/inspectionProfiles/*.xml +.idea/inspectionProfiles/profiles_settings.xml + +!.idea/scopes/*.xml +.idea/scopes/scope_settings.xml + +!.idea/templateLanguages.xml +!.idea/vcs.xml +profiles_settings.xml +.idea/libraries diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/CMakeLists.txt b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/CMakeLists.txt new file mode 100644 index 0000000..d6c76ba --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/CMakeLists.txt @@ -0,0 +1,44 @@ +# For more information about using CMake with Android Studio, read the +# documentation: https://d.android.com/studio/projects/add-native-code.html + +# Sets the minimum version of CMake required to build the native library. + +cmake_minimum_required(VERSION 3.4.1) + +# Creates and names a library, sets it as either STATIC +# or SHARED, and provides the relative paths to its source code. +# You can define multiple libraries, and CMake builds them for you. +# Gradle automatically packages shared libraries with your APK. + +include_directories(src/main/cpp/include) +add_library( # Sets the name of the library. + + apm-plugin-agora-rtc-player + # Sets the library as a shared library. + SHARED + src/main/cpp/agora_plugin_rtc.cpp + ) + +# Searches for a specified prebuilt library and stores the path as a +# variable. Because CMake includes system libraries in the search path by +# default, you only need to specify the name of the public NDK library +# you want to add. CMake verifies that the library exists before +# completing its build. + +find_library( # Sets the name of the path variable. + log-lib + + # Specifies the name of the NDK library that + # you want CMake to locate. + log ) + +# Specifies libraries CMake should link to your target library. You +# can link multiple libraries, such as libraries you define in this +# build script, prebuilt third-party libraries, or system libraries. + +target_link_libraries( # Specifies the target library. + apm-plugin-agora-rtc-player + android + # Links the target library to the log library + # included in the NDK. + ${log-lib} ) \ No newline at end of file diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle new file mode 100644 index 0000000..59864e6 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle @@ -0,0 +1,64 @@ +apply plugin: 'com.android.library' + +android { + compileSdkVersion 26 + flavorDimensions "default" + + defaultConfig { + minSdkVersion 18 + targetSdkVersion 26 + versionCode 5 + versionName "1.0" + externalNativeBuild { + cmake { + cppFlags "-std=c++11 " + } + } + + ndk { + //abiFilters "armeabi-v7a","arm64-v8a","x86"// DO NOT MODIFY THIS LINE, IT'S UPDATED BY BUILD MACHINE AUTOMATICALLY. + abiFilters "armeabi-v7a" + } + } + + + buildTypes { + release { + minifyEnabled false + proguardFiles getDefaultProguardFile('proguard-android.txt'), 'proguard-rules.txt' + } + } + + externalNativeBuild { + cmake { + path "CMakeLists.txt" + } + } + + android.libraryVariants.all { variant -> + variant.outputs.all { + outputFileName = "RtcChannelPublishHelper"+'.aar' + } + } + + compileOptions { + sourceCompatibility JavaVersion.VERSION_1_7 + targetCompatibility JavaVersion.VERSION_1_7 + } +} + +dependencies { + provided files('../app/lib/AgoraMediaPlayer.jar') + // implementation 'io.agora:agoraplayer:1.2.1' + //api fileTree(include: ['*.jar'], dir: 'libs') + //api project(':proj.android') + //dependencies { compile fileTree(dir:'../../../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} + //provided files('../../../../build/android/arm/android/lib/agora-rtc-sdk/agora-rtc-sdk.jar') + compile 'com.android.support:support-v4:23.2.0' + implementation 'io.agora.rtc:full-sdk:3.0.0' + //dependencies { compile fileTree(dir:'../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} + //implementation 'net.butterflytv.utils:rtmp-client:0.2.6' + //implementation 'net.butterflytv.utils:rtmp-client:3.1.0' + //implementation project(':rtmp_module') + //implementation files('libs/agora-rtc-sdk.jar') +} diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/gradle/wrapper/gradle-wrapper.jar b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/gradle/wrapper/gradle-wrapper.jar new file mode 100644 index 0000000000000000000000000000000000000000..05ef575b0cd0173fc735f2857ce4bd594ce4f6bd GIT binary patch literal 53637 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 t9m@SZ!E*7&jsr?!t7TL-WYI4eM@gAug8 zmYdImd_$moc|Wl+D8f)Ox9p>-vTa~|_%Q2qvp&29w$cF()B3LM?Pv3^!oHR}TtG&o zlDfH&A>Hrv!B+ag{dZsZo@@&OnX}MMFiHk?89N78gbcsa7aL?|msUy{d_N{Ox!Re1 zKKoG>8>U7KK+}Q|CGiSY zBiLkThmxruWxvQ{suzTd3|nw8GJ9ZoBT}&LCY)3IMut4gSTls>>5(;F)E$*=m|5LW z9hA=x`sj{ieY{t(w-(l3#W26Ra}DNucjF9^RN8zF3{0t{K?4oLLukz2gBi}^A-CJ+ zO+;EE@_fEFi4dhp6PLYM-k;rs&h?<1DX-T61zfk=00LrkTyxQfh`_8yAq0&sIH}F} za~%n`$^MWPI}#nMx>^Xav8i-1EV*d1d9uo4SWl=U=*Ceu6P1AimL2p`;pre)TSuA6 z*JQn}3n}ct{t9*^ID2$9(GF`SjDYO4BLj?uV6c?Xl!dhl13wj*Q_4z(Dt(bHavklA5pHE6LQy9-M8P1-t6t+zNWix z-izoiiQtEaytHn%$}IlG`9V>Y*JYH})3G5Y%+ohLkx56L6n+7%5^(P5>A5+maMQpS3iQ_c;ME3ZbVpQg z*qu=77cF|QikGY}GJPAzaFuvP65=>fS8i|(u9O;DL^t{u^yGpCRh#&i$sO#HvQ*Ic z$2AF582U^eo28jk$A*vA7Z+7#rd5ctLnV~hsm(bDGf_KKEGD<)HJ$@& z;y7pIsm1#6;)yRUN#ZEt&lz;fUBG-OTR@fXLt;J)D7I2>*7T=@i9&~D6Y3BL-=-ee zWQ`B?C}k}e8gU5W&Tp4_4y`!eV3kgsIG-I|Iut)2)6`(=~RnoW0iNLI)Qt&-%E z1j~+p`TVP0EKwqCQoI3osA_hd6=A&oDDz?mtZbt`kk+BjDpxd-+J>h&uCJH&j%Ny2AShK8|D zBUN7KwtGD1Fe$0W`QSk)Mc~NAtg)hFGBgLd8s!ry zE|e!24Wlf{14}K;>lmj%8v-u;U^Lp3{BJC zf3O)Gh@9xd!@5uiDN)|5qY78F2vK~&EfA^m0C8J+RJQuqd5+QGS8zaZ{^>ckBkva5 zg*?CfT-E0Odx1PH&i4r-GgtC*@~U30#!`aL_~G4Cy+@8$W9)f?Zm(TD@+?QMv1I*M zCIk)f*2%x7cR+G8pCW8sP2`ZNayG0%tc0$u<8dA!gahP}p087KGuQMSTwRVbBOE^a zXeaz??`o6oIIF6tg;gJs!T_RVd*?Z<5B@(&8MoRVXW+>o!!FI<}`8~a5I z4(U<78*wHBDa$f|KPz;HssLwWm6+9`TxLnmo;QQ3&C`22abTkIaOK%#}$OCR8st88PA$X{6?t>3x|i;{Q(coN#bAl;%FEh_L$tYwgwcd}$UC24(})!{3>9?E4W zsjx+EDJ-7|?DK?O{v_@^faffTc`AKdYmPWW_4#@77xnw<>VoEk5m2{jV5J0>XP^fz zd(8nMD6N-cHi_98BY}G_K3FSLm`(z9B3-gmw)pWkv!+1%4?~s9i3NqVQS@)>(5nUy zO`E-Fcvu8UupgJ?tA0W7`pCm8@7i4kV?y-et%DyKyp$})OZR=bwzBdy_7WeI59MmJ ztrE^5SK8xHGjH3EK3yER+XYMR8WIs~W*WtDhdO9Mg5@re?2%SaguL{To$56GdF}O(gN$moKGQ$q`- zESPgF*T*p}r+qTNwfKB_LMKvSNj@@k$U{-61c9bGvDGOEXk=q-k>q26WQq7C_!1d{ z^9Rspm$rUmcMu6Hgnm2%qi#~sjyD>&cr#;H4dKgcn&&T8BzQNK zcYD8b-uub=NFpu6W$Un0z7?JUN+i{@CA?#Bfo^6IYfEbtv?PAHl5Y&uM9y%><#%~C z88S6`LD8`!$)YD12VMya>VYNu+SnRqbQY}sk*6iJf@SqX56OpEWA9~v{2j!NhDVZz z5U&W*^^NK+B(v3+Su6PbvWUguA?R&^1e16&hmkqAXZ-lt4v?byG#$OcnG^U5gBDlu8`Di%jjGDx$l5$~GG=bM#7QSIyu3xAk+0hq&o~a% za&~|#ze1$ffVJno9#=Z|CL^*X$w3<}dxrN2m+6epca}i``Uw4Q!P1DsJ+rw2WFF*| z#Xa>s_T{!H@3UKWD$j8H9G8>MT440SUEX$L@J0VmX?vMvyPm$&0k`l#m7;rfkWuD= z`g$|u0|(E^HWy;f z7OHk4UyIR9j0vuFLMDr`4tuZx-Sv2=Et2FK(%Dagqg>}~T;+r)P&K{NI_5)qwhRq} zLpQ|?yuv$Xbjw6=FPJRr>21!FJ-BO0LG&QwO7BP;W&_Q{J;Kf~EBtBWgSfz*Q5=To z6hn$H41&=oe$O%=2lPX?TptHEI6p+H(j|7-{M^iYA*gv-lFWOwYh@cE@|8fTn-hRe zj6Xo*7R`Y-UC~fEKP?pR7GFE4`%$vZQRQ&p#dsR}<3~B0kH$#Rr2mXG1I+|b=U{HVAvEvpP+sCpyRT#gBax8Ao_)n?Sh*b98GbjN?9C*Pl>NJ z-3WsvvV-y4;q_nE6}_*F_F<5A`NVOxxWcisY`c)r)_M>0swV^tbpoq0agSVFnW2a< z+!>Y(O(9N^hH-P>qpF{~Xx)jm)2SOBwu-QRYu;eVeu!M7+RW5`#n7M7cJMTHm9=xz zuJTUm9bwD9ItZOu=dDAPL1=#Sc8q@g`b>lRR!6jpo)oycOemq}j{e)wUQ6KKtDMGd z=UNqe=OX=B6TC2-P)ssHvh@SX1D)8mvN`N$===+P^o*L$-77W|TUwoq5PlmhN(QW$ zuQizUY&2tGp0}b4eyH!DpNwCSGiJ=hVs(vj?UHzr9ZGw(68YuR&2r<(eF52(GMJ<5 zR6GtHo_Mz+7=1DBT4HSfRyk^18t4rblN63Vq;Kt-WoYAldvpoI{1y{k=n!#WvzzAN zd;H`O(ts_YTc(qmowhTV)a6-idBz@lRJJcFJ<{dWmb!P}UxPfn6CxPv0{@&9=9ot+$Tv`W!)NW*nJrUNpaIfGwrMcw%6#HX$smzH#9=O`er{lr; z4K>^k(duxHDbohK3l_FX+U=%+wL39YI!zAs1N7>L+%qYZ<_shzT7vX?GiJ)gCv^^f zkMSq$0uEpH7w6VnX*Vd6ARLdp_*Y)Ra_LjJZ8dh3alC{8IZ`uCU#U*!v1IQkIX zQ=>g*)eB`?g!g;H9!~x&DG%b!EdRn<#*B05Z5W#5y z;e-#fqA?mK6#7R7m{S)`5dN&jYQE2Er!o6?P|}tzcOII})mx*zu2e&kK@r**oHiKI z+tCp;FgjWVMos`_C~6qwrQD2@1sTC>&h)p6y|7XYKsS6dKdBx!eGQrUI zfnxA&>X#ch802~|3fWrif!J`J%?WcMbDj?vDhzGJ(UN%DtI&BK0t-AM5&^z(hSfNP z_o%UttN|ltZd_~31f~_*-GV2R;ZF27DB0;~B{p=%c>E_|kr}|`TyF(KhDBFlV?;Z$ zlC~OjyWkpElYLUsh{>5o>2ZhoI>VB^&n>dN>Z3c%7x%P9)*F+I4HKn{#uJeOisPTC5M`VoSXwcG77#2;V>|~+1O-Ry=CbdctWt3Awn_a1l z$}AL+G}7WO*?1O|Tgi>D%aRNAIii4DX3vdmyX*oBm`Q~yVDZ9cVS4rv!?AIF70eBj z@Ka-VM;!1|JNHl58m3EvpKT+rU1X%U|fD{8)Mk z+c(z`y`l{5K(vk~H?W`JY@5sV{%C96Q?o-$na;V;3g@y)WSHiIBTIURkte#l_d*On z+Xh2KcK+Szi#+|Iw`yIwm?wgW(Ft;Vay>L}=D}?&_G)Z7^DRDky#FM6qZ0iJSxDm=xV$_pzJf zb0kEMC3nrqD2)vFlJxav_GW?_i;P}|P|T!1GH7;+Lc4k(cfOL(2(@X0g<&PY)eh3WA4k*+$S4=^WrCqw zYoL^Z@LmHGL38I{`GgTVW_J#ut7XR9O)}if|K_%sh@McN$Xc&6gC(Mb z+yPtqpAKK-qKLaCrE%P)ow%)VFtt6pJwAJjNKL8t>Xn=np^pIkEqzAzRzOIKI89EJ zS9%XE4VksN$H|9!>b9%R%AEDq5O63Y*C8`&W&XU%!OO(uFMb8eeh0MFy9H34I$DEk zPzH@22|iW*G=gO=5#?c9jJYHd9Y|WL{LF7=6%f>G4&oM-5z#!yOw4R|P#0J!V@hUO z3@jK$`)o17oVk4BHmPfMcLO^2$!1LRM&B^@Ze1ugjlEUUd~MFmt*x%`!r01E9_tl- zB3){N5S|QzP%5{#U2-ZndULy4^3(x!#F&ZIpgesXZ)8kFY%y&AgQToYU_+LU$rv_h zLE(~($=8M`T#TmneILDXdOvN@=lLeeIDto!{aClrQ&zZDP-HSir72`=iK-Wgy)(u@JyUQVqRi(h&z{#F>;SFJA2tds&(i# zzFd-Fi8~eQl&3VheC%-!(ARZMnE4QxFcJ}P97Meg+M=HSE`VCJVwvNX;GLbQ@moz_ zsK@@+q7F?{<`#FU@s$2i-)!&x7vqjzGKerlGOi{ZB?*+TMdBRz@|+-Yox=L23A5iI z-W|R#8>Lzyq#zdIAg%@|O_%CS?%;RUL=|D$(4w{xdU!4ClGIl26UOj{zCqv;fX8&l z50EEc+eI8l{OWUAplO}R>|;`(@IK?Zw?F_78FwmSeyW!e@3iQ^F6MDP<|2+}4LqMK zW<%R%GzzDii~&{6Nd(bYIhN#1bT@p}-jRAcij0G}^%Xw$m;NPY12;@NL&2Wc6x7(~ zt1&*$KUBc$ebr6qxq%CxtNqA<|L*b0^j+ItZkq^r3JL+IS^pK^#b1vBzoWK|{$Bww zKk;3ZC<4~1atPdYfUs+a3e+r*Rd5}|MieNPzI-So1`^ohN#>89bw_IGbxqsH(~+X5 zkY6|8rG>&tc)Z~CQ`O_u#*>BDGe$;+l5F!Fw~rsbUfhFwITw>hb-}`NR(>%Sc%PAi zMaGaz2rk%N4TcKXJz*iC&)3lsjwV#KO_4sHl#JJ93`@`$qhJOpTQJBnQ1|cEa58W| zgEx3bxXoMFe5iqMhhC~lLEZ_@1U_0MBrRJcXz+r!Ns$j zr{tiXZD67L#fg!7SG6FM*uOfWN@bKGh>6oeSD`yQf|RC6Wvn8ECBXmHR=8m+Wi8Fx z&6X027!%ADv}6qz3={dr%a{0AiOWY4aPu|Y@*`1%k939w>v+#G$U2p|xK^~5>bG!V z9cavEFu|N#9#+HYoctGP&*%mf_Hy^-@{`WghR>T1J8(1?gON3a8*=C#2H$b-&6!<& zNJ}?;iIX2ThW$F<(GaB5rrX<2?FF}R_A8^v0HeyCK59fF308Bd6JN|jY9bL2{4rU6 z+7IzxXyC(#3Azm!1S(**J_H;JXWo;r5Oq02zJGQGb%TV;l-I_0GrAVaU#eIUNb;U{! zA_jvAh}tv!=8X7#;QuMY>q(GaxSX_PCm(`4AO?G~tdRT@5i^uXnKY%C911WL7D%iBdVHF5)k%x?_RiG-c02b7t{rYFQYwi&bSZ4s3Ut2N z$FFgeYi$^%bL?CEkgmA0&N{$lP>7t7gMOY^Nd*nQOg`A+S&98D$X)b68tT(|Q6?gcp=ib%I|T z?Y6s;pMzPqnY=7cdmXpMxhBh4bBj*eFy;cOu~MqyH+VFXQs#H;3EeU5u~Ws_*XP`0{RA)Hu@sQHnw*1_B!9||F5^-ZY6VhWM#l9`ARG6DkCx2ceS%(zI<8` z{6%~S(1=k;!RB$Svvtxc6H|IKb7qB}S-e?~9V6Ag@dcOahPSzo?|HK)Y#ntW$jU!j z=e;=|YycdZZ}^n%diij1Vo3*-WBsN_bto;{KuZL}76%g(2~D47RSih8e&jSbk;b+d zVip#YQHf(3tbD{;z6Xrw9Yc_GL~0m9E&CUoI?UUnlM5HS0BssWwRZ~LuN{lj3N@zW zRjZWb!woh=m3WZ=opG+T{_>0vTrZ3Y8aTL@DC(6VRd3^&zek1B-@M9 zD)u7{B!(^HvKSF2>p4K4fcfbAbtnPPNIzwR3zSNNNGEBna3`8Il6}phx*tjEVaE$94$ir@_&3|3bvffg+)Roa9a7j8~A z!Gwd?@K??Q;Zx-oCj0TXVkn;k!Kn05hYjjyWhRE>lwB93!C|&ReNVM84y~fny#@Cl zW~JZNy>gj1wJS>odt)eon)6KaAh4AeKfd7=+K8;ujKMY!TT zpY4j5x@!=;4;xmg7*@eTGRw(m=DQrq5%{2=pc2{|04arJ&XAlP4gc(rAOHl{J#JH6 z2kSKgiE5*B{mT-uNn24`hfJk5t4_2udIt1ys7?mSeI`S@{xQk07aO`et{T>E8r^}D zWl;`>dmL`*G;;gBq^BBMe5qR9l>3M{UQRCz3Gq6i>xJv-FEYe=+@$Z>V!q=4I)=mo zaV33=to{lZqd9&bqvf4#?exw6jZYyhW>BJ&4<+E!Y>|0Q?X=01@FI%ldK4P^ zYr0o^9?5tU(Im)Z69UT;%0AHe?SV+-#s~%cU8<=}XP+L2QyZE+n_Hi?KQl`pfDb1! zL&;M08wNH*%@ii^9C%6g2~uzVHj1xyuvaW|-VkqDY6&sKmD48f^@(jLry!LIvrJcU zYPnatTn6+)H7G8Zks2HmxHiF93-Y2UAtspSapNSmXsAO2n>%k*uVC& z6f9_Fz7X+7nT%<(EeGegSd|+D4j#!~uf$5CLVjm^N5==)ae$Pd+SaXr(?_MY^&OyQ zXoZ>rIVQ2nYdx>_Vr|PxqO+p~9j3|VDlh`vUu3I674n!Ksy%}I+N89oMn2$x=4=8u zix_`z(x0Z??}637Eid26uUL-1LV1v(M1i(#UsPa5X2YRp-FIWckS0k^j53EbfOl=; z>uiiuw_TvU<-J)CCF8jUzXrT>mA+bG#3@qrtBdBD_QYwOfhQLR@hJRvQD5fAl~8-mU(#t@K|O8wal^ULicls6*sD zlK}1F($UYPtp-IbccN5$@tQ(Kc#gL%UZ=)?atRBG(1kkHw)- zBvU%*H!`YR9j@FA9jlr++8*5Q;0OYQ5r>1A$B|ISe1gO(`RM|zB-_iq7BrZs1lkk5 zxPW_vovda3g6@FvAjIe=Q!FP12nI&e#=|v84Eu_lNn?hKqH|g+2u+J973II4i6l1KOZ+1tel?TSo>>19YKLcYgzZc)c@+pD2^K-#`VSM5tHu6Gc7EX9UjLzpxcY&>A z4PnL5cGhgp*eccBR}f($1rmWKMqxZnOm$K$_(`#BH~^6C-N}q`>0yO&FmKs%KIJU{KDw>Tk5;q z?QT3gqd~Tv-8J+NpHKKz;G**g`y9sVtH7<3 z7LGnP;XuWT?XM`a9^url?|2<@sLerFSLuVyQV*tOx{rBtL28JyHGFKq?rNaer2wvn ztc!eqj;1LkZ}c_iZTAqIZs|_ooB(9K70`>!$koJd(2@@v=mN6?CT;!K6|-kv61fC*%7P;nUYmYO(fU2bcLJqaiXfDiHaHzCICue?pJ0k%1t+DP8V&|t8cMer-3jvlE03V`XEII)4@CS?Hf0yB}m&~Vl zAO$W<8i2gY0aDZcg7+5SEB*tXsExLsnZ6=`eqPMdTwlu4($wDS&(JvQnhV_kkXt}6 z{k9?e_f_o;4iMw|12lm1*Ua7)aIQ?m*i4^aS6AQGR$ALa+wgCtg{OHRg4GiF#-M!z z@aO%ScU*v`=^qRz|E0_UaCI0M8`=ZtvjJ4{f6lv{JFf8-ph_?Sd8hw7GKuDgZ#G`Wq5(ul7z7{3GgL55;%v zZ<+pcMLd<<{TsU4J67h8xZkVwzYRZ6B@Tb!*(&}K@0X_kZ-R$UYvZYW-VZD8%73)- z&m+!L)tn!2Q*Zun^87vk|8WBSIe*_ax1Orr`~Wm~``N zkC|%!Qp#@>Hct~j6_NQnd9`=)?}`5o6ZmPl{>1tE6#l6&$Pai@z2EZo6YTewONQTj zI; zFTC?l;h$2b|A2pI_D}HNTjHMx)SsGq%Dwu-RGr=# zgZ4Yc(NoN)gbF_}J3@ZP{P*+ z^KkVvruGNsN!I_y{6mE8(@Z}NVEkcVBj;Zj_<5B2a|xb?kNq&vlmDB6zh{YmPPuuXtC}87KZ=LtMW<`6z~@KO + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp new file mode 100644 index 0000000..2254297 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp @@ -0,0 +1,395 @@ +#include +#include +#include +#include "IAgoraMediaEngine.h" +#include "IAgoraRtcEngine.h" +#include "AudioCircularBuffer.h" +#include +#include + +#include +#include + +#include +#include "time.h" + +#ifdef ANDROID +#include +#define XLOGD(...) __android_log_print(ANDROID_LOG_DEBUG,"[player_native]",__VA_ARGS__) +#define XLOGI(...) __android_log_print(ANDROID_LOG_INFO,"[player_native]",__VA_ARGS__) +#define XLOGW(...) __android_log_print(ANDROID_LOG_WARN,"[player_native]",__VA_ARGS__) +#define XLOGE(...) __android_log_print(ANDROID_LOG_ERROR,"[player_native]",__VA_ARGS__) +#else +#include +#define XLOGD(format, ...) printf("[player_native][DEBUG][%s][%d]: " format "\n", __FUNCTION__,\ + __LINE__, ##__VA_ARGS__) +#define XLOGI(format, ...) printf("[player_native][INFO][%s][%d]: " format "\n", __FUNCTION__,\ + __LINE__, ##__VA_ARGS__) +#define XLOGW(format, ...) printf("[player_native][WARN][%s][%d]: " format "\n", __FUNCTION__,\ + __LINE__, ##__VA_ARGS__) +#define XLOGE(format, ...) printf("[player_native][ERROR][%s][%d]: " format "\n", __FUNCTION__,\ + __LINE__, ##__VA_ARGS__) +#endif + +//#define DUMP_AUDIO_DATA + +using namespace AgoraRTC; +static scoped_ptr> agoraAudioBuf(new AudioCircularBuffer(2048, true)); +static scoped_ptr> playBackBuf(new AudioCircularBuffer(2048, true)); + +static bool is_init_new_agora_rtc_ = false; +static int totalTime= 0; +static JavaVM *gJVM = nullptr; +std::mutex recordMux; +std::mutex playoutMux; +static agora::rtc::IRtcEngine *rtcEngine = nullptr; +static agora::media::IMediaEngine* mediaEngine_ = nullptr; + + +static FILE *g_file_handle = NULL; + +extern "C" +JNIEXPORT +jint JNI_OnLoad(JavaVM *vm, void *res) { + XLOGD("JNI_OnLoad plugin_rtc"); + return JNI_VERSION_1_4; +} + +void Sleep(int mis){ + std::chrono::milliseconds du(mis); + std::this_thread::sleep_for(du); +} + +struct AudioRawFrame { + void * samples; + size_t sampleRataHz; + size_t bytesPerSample; + size_t channelNums; + size_t samplesPerChannel; + size_t timestamp; +}; + +void destroyAudioBuffer() { + recordMux.lock(); + agoraAudioBuf.release(); + agoraAudioBuf.reset(new AudioCircularBuffer(2048,true)); + recordMux.unlock(); + playoutMux.lock(); + playBackBuf.release(); + playBackBuf.reset(new AudioCircularBuffer(2048,true)); + playoutMux.unlock(); +} + + +class IAudioFrameObserver; + +class AgoraAudioFrameObserver : public agora::media::IAudioFrameObserver { + + + +public: + AgoraAudioFrameObserver() { + audio_sonSum = 1.00f; + audio_voiceSum = 1.00f; + audio_local_sonSum = 1.00f; + enable_local_playout_volume = false; + } + + ~AgoraAudioFrameObserver() { + } + + + +public: + double audio_sonSum; + double audio_voiceSum; + double audio_local_sonSum; + bool enable_local_playout_volume; + bool enable_push_playout_volume; + void pushAudioData(AudioRawFrame audioFrame){ + +// if(!readPcmPointer) { +// char *path = "/sdcard/file_in_7.pcm"; +// readPcmPointer = fopen(path, "wb"); +// } +// fwrite(data.data, 2, data.size, readPcmPointer); + + // 采集端的音频 + int size = audioFrame.samplesPerChannel*audioFrame.bytesPerSample; + char *audioBuf = (char *)malloc(sizeof(char)* size); +/* XLOGI("tjy pushAudioData: push address %d push data1 %d %d %d %d %d %d %d %d %d %d ",data.data, + data.data[0],data.data[1],data.data[2],data.data[3],data.data[4], + data.data[5],data.data[6],data.data[7],data.data[8],data.data[9]);*/ + memcpy(audioBuf, audioFrame.samples, size); +// audioPool.add_elements(audioBuf, (int)data.size); + if (enable_push_playout_volume) { + recordMux.lock(); + agoraAudioBuf->Push(audioBuf, size); + recordMux.unlock(); + } + if (enable_local_playout_volume){ + playoutMux.lock(); + playBackBuf->Push(audioBuf, size); + playoutMux.unlock(); + } + delete(audioBuf); + + } + + + virtual bool onRecordAudioFrame(AudioFrame &audioFrame) override { + if (!enable_push_playout_volume){ + return true; + } + size_t bytes = audioFrame.samples * audioFrame.bytesPerSample * audioFrame.channels; + //XLOGI("tjy onRecordAudioFrame want bytes: %d,%d,%d,%d,%d available bytes: %d", + // audioFrame.bytesPerSample,audioFrame.channels,audioFrame.samples,audioFrame.samplesPerSec,bytes,agoraAudioBuf->mAvailSamples); + if (agoraAudioBuf->mAvailSamples < bytes) { + return true; + } + + //XLOGI("tjy onRecordAudioFrame got audio frame %f,%f",audio_sonSum,audio_voiceSum); + char *data = (char *) malloc(sizeof(short) * bytes); + recordMux.lock(); + agoraAudioBuf->Pop(data, (int)bytes); + recordMux.unlock(); + short *mixedBuffer = (short *)data; + short *tmpBuf = (short *)malloc((u_int16_t)bytes); + +#ifdef DUMP_AUDIO_DATA + FILE* fp_ = fopen("/sdcard/test_record_1_cpp.pcm", "ab+"); + fwrite(audioFrame.buffer, 1, bytes, fp_); + fclose(fp_); +#endif + memcpy(tmpBuf, audioFrame.buffer, bytes); + ///*** + for (int i = 0 ; i < (short)bytes/2; i++) { + int tmp = (short)(((double)1.00f * mixedBuffer[i]) * audio_sonSum); + tmpBuf[i] = (short)(((double)1.00f * tmpBuf[i]) * audio_voiceSum); + tmp += tmpBuf[i]; + + if (tmp > 32767) { + tmpBuf[i] = 32767; + } else if (tmp < -32768) { + tmpBuf[i] = -32768; + } else { + tmpBuf[i] = tmp; + } + } + //***/ + memcpy(audioFrame.buffer, tmpBuf,bytes); + +#ifdef DUMP_AUDIO_DATA + FILE* fp_2 = fopen("/sdcard/test_record_2_cpp.pcm", "ab+"); + fwrite(audioFrame.buffer, 1, bytes, fp_2); + fclose(fp_2); +#endif + + free(mixedBuffer); + free(tmpBuf); + return true; + } + + virtual bool onPlaybackAudioFrame(AudioFrame &audioFrame) override { + //XLOGI("tjy onPlaybackAudioFrame");playBackBuf + if (!enable_local_playout_volume){ + return true; + } + size_t bytes = audioFrame.samples * audioFrame.bytesPerSample * audioFrame.channels; + if (playBackBuf->mAvailSamples < bytes) { + return true; + } + XLOGI("tjy onPlaybackAudioFrame want bytes: %d,%d,%d,%d,%d available bytes: %d", + audioFrame.bytesPerSample,audioFrame.channels,audioFrame.samples,audioFrame.samplesPerSec,bytes,agoraAudioBuf->mAvailSamples); + + char *data = (char *) malloc(sizeof(short) * bytes); + playoutMux.lock(); + playBackBuf->Pop(data, (int)bytes); + playoutMux.unlock(); + short *mixedBuffer = (short *)data; + short *tmpBuf = (short *)malloc((u_int16_t)bytes); + +#ifdef DUMP_AUDIO_DATA + FILE* fp_ = fopen("/sdcard/test_playout_1_cpp.pcm", "ab+"); + fwrite(audioFrame.buffer, 1, bytes, fp_); + fclose(fp_); +#endif + memcpy(tmpBuf, audioFrame.buffer, bytes); + ///*** + for (int i = 0 ; i < (short)bytes/2; i++) { + int tmp = (short)(((double)1.00f * mixedBuffer[i]) * audio_local_sonSum); + tmp += tmpBuf[i]; + + if (tmp > 32767) { + tmpBuf[i] = 32767; + } else if (tmp < -32768) { + tmpBuf[i] = -32768; + } else { + tmpBuf[i] = tmp; + } + } + //***/ + memcpy(audioFrame.buffer, tmpBuf,bytes); + +#ifdef DUMP_AUDIO_DATA + FILE* fp_2 = fopen("/sdcard/test_playout_2_cpp.pcm", "ab+"); + fwrite(audioFrame.buffer, 1, bytes, fp_2); + fclose(fp_2); +#endif + + free(mixedBuffer); + free(tmpBuf); + return true; + } + + virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, AudioFrame &audioFrame) override { + //XLOGI("tjy onPlaybackAudioFrameBeforeMixing"); + return true; + } + + virtual bool onMixedAudioFrame(AudioFrame &audioFrame) override { + //XLOGI("tjy onMixedAudioFrame"); + return true; + } +}; + + +static AgoraAudioFrameObserver s_audioFrameObserver; + +#ifdef __cplusplus +extern "C" { +#endif + +int __attribute__((visibility("default"))) +loadAgoraRtcEnginePlugin(agora::rtc::IRtcEngine *engine) { + XLOGI("TJY loadAgoraRtcEnginePlugin--------- "); + rtcEngine = engine; + return 0; +} + +void __attribute__((visibility("default"))) +unloadAgoraRtcEnginePlugin(agora::rtc::IRtcEngine *engine) { + XLOGI("TJY unloadAgoraRtcEnginePlugin--------- "); + is_init_new_agora_rtc_ = false; + rtcEngine = nullptr; + +} +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_ktvkit_KTVKit_destroyAudioBuf(JNIEnv *env, jobject instance) { + agoraAudioBuf.release(); + playBackBuf.release(); + agoraAudioBuf.reset(new AudioCircularBuffer(2048,true)); + playBackBuf.reset(new AudioCircularBuffer(2048,true)); +} + + + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeOnAudioData(JNIEnv *env, jobject instance, + jobject audio_buffer, jint sampleRataHz, jint bytesPerSample, jint channelNums, jint samplesPerChannel, jlong timestamp) { + if(!s_audioFrameObserver.enable_push_playout_volume && !s_audioFrameObserver.enable_local_playout_volume) { + return; + } + //XLOGI("tjy jni nativeOnAudioData %d,%d,%d,%d",bytesPerSample,channelNums,samplesPerChannel,bytesPerSample*channelNums*samplesPerChannel); + void * direct_audio_buffer = env->GetDirectBufferAddress(audio_buffer); + AudioRawFrame audio_frame; + audio_frame.samples = direct_audio_buffer; + audio_frame.sampleRataHz = sampleRataHz; + audio_frame.bytesPerSample = bytesPerSample; + audio_frame.channelNums = channelNums; + audio_frame.samplesPerChannel = samplesPerChannel; + audio_frame.timestamp = timestamp; + s_audioFrameObserver.pushAudioData(audio_frame); +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeEnablePushToRtc(JNIEnv *env, jobject instance) { + XLOGI("TJY Java_io_agora_RtcChannelPublishHelper_nativeEnablePushToRtc %d",is_init_new_agora_rtc_); + if (!is_init_new_agora_rtc_) { + is_init_new_agora_rtc_ = true; + rtcEngine->queryInterface(agora::AGORA_IID_MEDIA_ENGINE, + reinterpret_cast(&mediaEngine_)); + XLOGI("TJY mediaEngine_ init %X",mediaEngine_); + if (mediaEngine_) { + mediaEngine_->registerAudioFrameObserver(&s_audioFrameObserver); + if (rtcEngine) { + rtcEngine->setRecordingAudioFrameParameters(48000,2,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + rtcEngine->setPlaybackAudioFrameParameters(48000,2,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + //agora::rtc::RtcEngineParameters *param = new agora::rtc::RtcEngineParameters(rtcEngine); + //param->setRecordingAudioFrameParameters(32000,1,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + //param->setPlaybackAudioFrameParameters(32000,1,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + + //delete param; + } + + XLOGI("TJY jni nativeEnablePushToRtc mediaEngine ok"); + } else { + XLOGE("TJY jni nativeEnablePushToRtc mediaEngine init error"); + } + } +} + + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_adjustPublishSignalVolume(JNIEnv *env, jobject instance,jfloat volume) { + XLOGI("jni nativeMovieVolume %f",volume); + s_audioFrameObserver.audio_sonSum = volume; +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_adjustPublishVoiceVolume(JNIEnv *env, jobject instance,jfloat volume) { + XLOGI("TJY nativeVoiceVolume %f",volume); + s_audioFrameObserver.audio_voiceSum = volume; +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeEnablePushAudioToRtc(JNIEnv *env, jobject instance,jboolean enable) { + XLOGI("TJY nativeEnablePushAudioToRtc %d",enable); + s_audioFrameObserver.enable_push_playout_volume = enable; + if(!enable) { + destroyAudioBuffer(); + } + if (rtcEngine && enable) { + //rtcEngine->setRecordingAudioFrameParameters(32000,1,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + //rtcEngine->setPlaybackAudioFrameParameters(32000,1,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + //agora::rtc::RtcEngineParameters *param = new agora::rtc::RtcEngineParameters(rtcEngine); + //param->setRecordingAudioFrameParameters(32000,1,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + //param->setPlaybackAudioFrameParameters(32000,1,agora::rtc::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE,1024); + + //delete param; + XLOGI("TJY jni nativeEnablePushAudioToRtc mediaEngine ok"); + } else { + XLOGE("TJY jni nativeEnablePushAudioToRtc mediaEngine init error"); + } +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeEnableLocalPlayoutVolume(JNIEnv *env, jobject instance,jboolean enable) { + XLOGI("TJY nativeEnableLocalPlayoutVolume %d",enable); + s_audioFrameObserver.enable_local_playout_volume = enable; +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeAdjustPublishLocalVoiceVolume(JNIEnv *env, jobject instance,jfloat volume) { +XLOGI("jni adjustPublishLocalSignalVolume %f",volume); +s_audioFrameObserver.audio_local_sonSum = volume; +} + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeRelease(JNIEnv *env, jobject instance) { + XLOGI("TJY nativeRelease"); + if (is_init_new_agora_rtc_) { + is_init_new_agora_rtc_ = false; + } +} diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h new file mode 100644 index 0000000..955d13d --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h @@ -0,0 +1,786 @@ +// Agora Engine SDK +// +// Copyright (c) 2019 Agora.io. All rights reserved. +// + +#ifndef AGORA_BASE_H +#define AGORA_BASE_H + +#include +#include +#include +#include +#include + +#if defined(_WIN32) +#define WIN32_LEAN_AND_MEAN +#include +#define AGORA_CALL __cdecl +#if defined(AGORARTC_EXPORT) +#define AGORA_API extern "C" __declspec(dllexport) +#else +#define AGORA_API extern "C" __declspec(dllimport) +#endif +#elif defined(__APPLE__) +#include +#define AGORA_API __attribute__((visibility("default"))) extern "C" +#define AGORA_CALL +#elif defined(__ANDROID__) || defined(__linux__) +#define AGORA_API extern "C" __attribute__((visibility("default"))) +#define AGORA_CALL +#else +#define AGORA_API extern "C" +#define AGORA_CALL +#endif + +namespace agora { +namespace util { + +template +class AutoPtr { + typedef T value_type; + typedef T* pointer_type; +public: + AutoPtr(pointer_type p=0) + :ptr_(p) + {} + ~AutoPtr() { + if (ptr_) + ptr_->release(); + } + operator bool() const { return ptr_ != (pointer_type)0; } + value_type& operator*() const { + return *get(); + } + + pointer_type operator->() const { + return get(); + } + + pointer_type get() const { + return ptr_; + } + + pointer_type release() { + pointer_type tmp = ptr_; + ptr_ = 0; + return tmp; + } + + void reset(pointer_type ptr = 0) { + if (ptr != ptr_ && ptr_) + ptr_->release(); + ptr_ = ptr; + } + template + bool queryInterface(C1* c, C2 iid) { + pointer_type p = NULL; + if (c && !c->queryInterface(iid, (void**)&p)) + { + reset(p); + } + return p != NULL; + } +private: + AutoPtr(const AutoPtr&); + AutoPtr& operator=(const AutoPtr&); +private: + pointer_type ptr_; +}; +class IString { +protected: + virtual ~IString(){} +public: + virtual bool empty() const = 0; + virtual const char* c_str() = 0; + virtual const char* data() = 0; + virtual size_t length() = 0; + virtual void release() = 0; +}; +typedef AutoPtr AString; + +}//namespace util + +enum INTERFACE_ID_TYPE +{ + AGORA_IID_AUDIO_DEVICE_MANAGER = 1, + AGORA_IID_VIDEO_DEVICE_MANAGER = 2, + AGORA_IID_RTC_ENGINE_PARAMETER = 3, + AGORA_IID_MEDIA_ENGINE = 4, + AGORA_IID_SIGNALING_ENGINE = 8, +}; + + /** Warning code. + */ +enum WARN_CODE_TYPE +{ + /** 8: The specified view is invalid. Specify a view when using the video call function. + */ + WARN_INVALID_VIEW = 8, + /** 16: Failed to initialize the video function, possibly caused by a lack of resources. The users cannot see the video while the voice communication is not affected. + */ + WARN_INIT_VIDEO = 16, + /** 20: The request is pending, usually due to some module not being ready, and the SDK postponed processing the request. + */ + WARN_PENDING = 20, + /** 103: No channel resources are available. Maybe because the server cannot allocate any channel resource. + */ + WARN_NO_AVAILABLE_CHANNEL = 103, + /** 104: A timeout occurs when looking up the channel. When joining a channel, the SDK looks up the specified channel. This warning usually occurs when the network condition is too poor for the SDK to connect to the server. + */ + WARN_LOOKUP_CHANNEL_TIMEOUT = 104, + /** **DEPRECATED** 105: The server rejects the request to look up the channel. The server cannot process this request or the request is illegal. + + Deprecated as of v2.4.1. Use CONNECTION_CHANGED_REJECTED_BY_SERVER(10) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. + */ + WARN_LOOKUP_CHANNEL_REJECTED = 105, + /** 106: A timeout occurs when opening the channel. Once the specific channel is found, the SDK opens the channel. This warning usually occurs when the network condition is too poor for the SDK to connect to the server. + */ + WARN_OPEN_CHANNEL_TIMEOUT = 106, + /** 107: The server rejects the request to open the channel. The server cannot process this request or the request is illegal. + */ + WARN_OPEN_CHANNEL_REJECTED = 107, + + // sdk: 100~1000 + /** 111: A timeout occurs when switching to the live video. + */ + WARN_SWITCH_LIVE_VIDEO_TIMEOUT = 111, + /** 118: A timeout occurs when setting the client role in the live broadcast profile. + */ + WARN_SET_CLIENT_ROLE_TIMEOUT = 118, + /** 121: The ticket to open the channel is invalid. + */ + WARN_OPEN_CHANNEL_INVALID_TICKET = 121, + /** 122: Try connecting to another server. + */ + WARN_OPEN_CHANNEL_TRY_NEXT_VOS = 122, + WARN_CHANNEL_CONNECTION_UNRECOVERABLE = 131, + WARN_CHANNEL_CONNECTION_IP_CHANGED = 132, + WARN_CHANNEL_CONNECTION_PORT_CHANGED = 133, + /** 701: An error occurs in opening the audio mixing file. + */ + WARN_AUDIO_MIXING_OPEN_ERROR = 701, + /** 1014: Audio Device Module: a warning occurs in the playback device. + */ + WARN_ADM_RUNTIME_PLAYOUT_WARNING = 1014, + /** 1016: Audio Device Module: a warning occurs in the recording device. + */ + WARN_ADM_RUNTIME_RECORDING_WARNING = 1016, + /** 1019: Audio Device Module: no valid audio data is collected. + */ + WARN_ADM_RECORD_AUDIO_SILENCE = 1019, + /** 1020: Audio Device Module: the playback device fails. + */ + WARN_ADM_PLAYOUT_MALFUNCTION = 1020, + /** 1021: Audio Device Module: the recording device fails. + */ + WARN_ADM_RECORD_MALFUNCTION = 1021, + /** 1025: The audio playback or recording is interrupted by system events (such as a phone call). + */ + WARN_ADM_CALL_INTERRUPTION = 1025, + /** 1029: During a call, the audio session category should be set to + * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. + * If the audio session category is set to other values, this warning code + * is triggered and RtcEngine will forcefully set it back to + * AVAudioSessionCategoryPlayAndRecord. + */ + WARN_ADM_IOS_CATEGORY_NOT_PLAYANDRECORD = 1029, + /** + */ + WARN_ADM_IOS_SAMPLERATE_CHANGE = 1030, + /** 1031: Audio Device Module: the recorded audio voice is too low. + */ + WARN_ADM_RECORD_AUDIO_LOWLEVEL = 1031, + /** 1032: Audio Device Module: the playback audio voice is too low. + */ + WARN_ADM_PLAYOUT_AUDIO_LOWLEVEL = 1032, + /** 1040: Audio device module: An exception occurs with the audio drive. + * Solutions: + * - Disable or re-enable the audio device. + * - Re-enable your device. + * - Update the sound card drive. + */ + WARN_ADM_WINDOWS_NO_DATA_READY_EVENT = 1040, + /** 1051: Audio Device Module: howling is detected. + */ + WARN_APM_HOWLING = 1051, + /** 1052: Audio Device Module: the device is in the glitch state. + */ + WARN_ADM_GLITCH_STATE = 1052, + /** 1053: Audio Device Module: the underlying audio settings have changed. + */ + WARN_ADM_IMPROPER_SETTINGS = 1053, + /** + */ + WARN_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, + /** 1323: Audio device module: No available playback device. + * Solution: Plug in the audio device. + */ + WARN_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, + /** Audio device module: The capture device is released improperly. + * Solutions: + * - Disable or re-enable the audio device. + * - Re-enable your device. + * - Update the sound card drive. + */ + WARN_ADM_WIN_CORE_IMPROPER_CAPTURE_RELEASE = 1324, + /** 1610: Super-resolution warning: the original video dimensions of the remote user exceed 640 × 480. + */ + WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION = 1610, + /** 1611: Super-resolution warning: another user is using super resolution. + */ + WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION = 1611, + /** 1612: The device is not supported. + */ + WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED = 1612, + + WARN_RTM_LOGIN_TIMEOUT = 2005, + WARN_RTM_KEEP_ALIVE_TIMEOUT = 2009 +}; + +/** Error code. +*/ +enum ERROR_CODE_TYPE +{ + /** 0: No error occurs. + */ + ERR_OK = 0, + //1~1000 + /** 1: A general error occurs (no specified reason). + */ + ERR_FAILED = 1, + /** 2: An invalid parameter is used. For example, the specific channel name includes illegal characters. + */ + ERR_INVALID_ARGUMENT = 2, + /** 3: The SDK module is not ready. Possible solutions: + + - Check the audio device. + - Check the completeness of the application. + - Re-initialize the RTC engine. + */ + ERR_NOT_READY = 3, + /** 4: The SDK does not support this function. + */ + ERR_NOT_SUPPORTED = 4, + /** 5: The request is rejected. + */ + ERR_REFUSED = 5, + /** 6: The buffer size is not big enough to store the returned data. + */ + ERR_BUFFER_TOO_SMALL = 6, + /** 7: The SDK is not initialized before calling this method. + */ + ERR_NOT_INITIALIZED = 7, + /** 9: No permission exists. Check if the user has granted access to the audio or video device. + */ + ERR_NO_PERMISSION = 9, + /** 10: An API method timeout occurs. Some API methods require the SDK to return the execution result, and this error occurs if the request takes too long (more than 10 seconds) for the SDK to process. + */ + ERR_TIMEDOUT = 10, + /** 11: The request is canceled. This is for internal SDK use only, and it does not return to the application through any method or callback. + */ + ERR_CANCELED = 11, + /** 12: The method is called too often. This is for internal SDK use only, and it does not return to the application through any method or callback. + */ + ERR_TOO_OFTEN = 12, + /** 13: The SDK fails to bind to the network socket. This is for internal SDK use only, and it does not return to the application through any method or callback. + */ + ERR_BIND_SOCKET = 13, + /** 14: The network is unavailable. This is for internal SDK use only, and it does not return to the application through any method or callback. + */ + ERR_NET_DOWN = 14, + /** 15: No network buffers are available. This is for internal SDK internal use only, and it does not return to the application through any method or callback. + */ + ERR_NET_NOBUFS = 15, + /** 17: The request to join the channel is rejected. This error usually occurs when the user is already in the channel, and still calls the method to join the channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + */ + ERR_JOIN_CHANNEL_REJECTED = 17, + /** 18: The request to leave the channel is rejected. + + This error usually occurs: + + - When the user has left the channel and still calls \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" to leave the channel. In this case, stop calling \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel". + - When the user has not joined the channel and still calls \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" to leave the channel. In this case, no extra operation is needed. + */ + ERR_LEAVE_CHANNEL_REJECTED = 18, + /** 19: Resources are occupied and cannot be reused. + */ + ERR_ALREADY_IN_USE = 19, + /** 20: The SDK gives up the request due to too many requests. + */ + ERR_ABORTED = 20, + /** 21: In Windows, specific firewall settings can cause the SDK to fail to initialize and crash. + */ + ERR_INIT_NET_ENGINE = 21, + /** 22: The application uses too much of the system resources and the SDK fails to allocate the resources. + */ + ERR_RESOURCE_LIMITED = 22, + /** 101: The specified App ID is invalid. Please try to rejoin the channel with a valid App ID. + */ + ERR_INVALID_APP_ID = 101, + /** 102: The specified channel name is invalid. Please try to rejoin the channel with a valid channel name. + */ + ERR_INVALID_CHANNEL_NAME = 102, + /** **DEPRECATED** 109: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. + + The token expired due to one of the following reasons: + + - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within five minutes after the Token is generated. If the user does not access the Agora service after five minutes, this Token is no longer valid. + - Call Expiration Timestamp expired: The timestamp is the exact time when a user can no longer use the Agora service (for example, when a user is forced to leave an ongoing call). When a value is set for the Call Expiration Timestamp, it does not mean that the token will expire, but that the user will be banned from the channel. + */ + ERR_TOKEN_EXPIRED = 109, + /** **DEPRECATED** 110: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_INVALID_TOKEN(8) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. + + The token is invalid due to one of the following reasons: + + - The App Certificate for the project is enabled in Console, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token. + - The uid is mandatory, and users must set the same uid as the one set in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. + */ + ERR_INVALID_TOKEN = 110, + /** 111: The internet connection is interrupted. This applies to the Agora Web SDK only. + */ + ERR_CONNECTION_INTERRUPTED = 111, // only used in web sdk + /** 112: The internet connection is lost. This applies to the Agora Web SDK only. + */ + ERR_CONNECTION_LOST = 112, // only used in web sdk + /** 113: The user is not in the channel when calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" or \ref agora::rtc::IRtcEngine::getUserInfoByUserAccount "getUserInfoByUserAccount" method. + */ + ERR_NOT_IN_CHANNEL = 113, + /** 114: The size of the sent data is over 1024 bytes when the user calls the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. + */ + ERR_SIZE_TOO_LARGE = 114, + /** 115: The bitrate of the sent data exceeds the limit of 6 Kbps when the user calls the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. + */ + ERR_BITRATE_LIMIT = 115, + /** 116: Too many data streams (over 5 streams) are created when the user calls the \ref agora::rtc::IRtcEngine::createDataStream "createDataStream" method. + */ + ERR_TOO_MANY_DATA_STREAMS = 116, + /** 117: The data stream transmission timed out. + */ + ERR_STREAM_MESSAGE_TIMEOUT = 117, + /** 119: Switching roles fail. Please try to rejoin the channel. + */ + ERR_SET_CLIENT_ROLE_NOT_AUTHORIZED = 119, + /** 120: Decryption fails. The user may have used a different encryption password to join the channel. Check your settings or try rejoining the channel. + */ + ERR_DECRYPTION_FAILED = 120, + /** 123: The client is banned by the server. + */ + ERR_CLIENT_IS_BANNED_BY_SERVER = 123, + /** 124: Incorrect watermark file parameter. + */ + ERR_WATERMARK_PARAM = 124, + /** 125: Incorrect watermark file path. + */ + ERR_WATERMARK_PATH = 125, + /** 126: Incorrect watermark file format. + */ + ERR_WATERMARK_PNG = 126, + /** 127: Incorrect watermark file information. + */ + ERR_WATERMARKR_INFO = 127, + /** 128: Incorrect watermark file data format. + */ + ERR_WATERMARK_ARGB = 128, + /** 129: An error occurs in reading the watermark file. + */ + ERR_WATERMARK_READ = 129, + /** 130: Encryption is enabled when the user calls the \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method (CDN live streaming does not support encrypted streams). + */ + ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH = 130, + /** 134: The user account is invalid. */ + ERR_INVALID_USER_ACCOUNT = 134, + + /** 151: CDN related errors. Remove the original URL address and add a new one by calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" and \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" methods. + */ + ERR_PUBLISH_STREAM_CDN_ERROR = 151, + /** 152: The host publishes more than 10 URLs. Delete the unnecessary URLs before adding new ones. + */ + ERR_PUBLISH_STREAM_NUM_REACH_LIMIT = 152, + /** 153: The host manipulates other hosts' URLs. Check your app logic. + */ + ERR_PUBLISH_STREAM_NOT_AUTHORIZED = 153, + /** 154: An error occurs in Agora's streaming server. Call the addPublishStreamUrl method to publish the streaming again. + */ + ERR_PUBLISH_STREAM_INTERNAL_SERVER_ERROR = 154, + /** 155: The server fails to find the stream. + */ + ERR_PUBLISH_STREAM_NOT_FOUND = 155, + /** 156: The format of the RTMP stream URL is not supported. Check whether the URL format is correct. + */ + ERR_PUBLISH_STREAM_FORMAT_NOT_SUPPORTED = 156, + + //signaling: 400~600 + /** + */ + ERR_LOGOUT_OTHER = 400, // + /** 401: The user logged out. + */ + ERR_LOGOUT_USER = 401, // logout by user + /** 402: Network failure. + */ + ERR_LOGOUT_NET = 402, // network failure + /** 403: Logged in another device. + */ + ERR_LOGOUT_KICKED = 403, // login in other device + /** + */ + ERR_LOGOUT_PACKET = 404, // + /** 405: The token expired. + */ + ERR_LOGOUT_TOKEN_EXPIRED = 405, // token expired + /** + */ + ERR_LOGOUT_OLDVERSION = 406, // + /** + */ + ERR_LOGOUT_TOKEN_WRONG = 407, + /** + */ + ERR_LOGOUT_ALREADY_LOGOUT = 408, + /** + */ + ERR_LOGIN_OTHER = 420, + /** + */ + ERR_LOGIN_NET = 421, + /** + */ + ERR_LOGIN_FAILED = 422, + /** + */ + ERR_LOGIN_CANCELED = 423, + /** + */ + ERR_LOGIN_TOKEN_EXPIRED = 424, + /** + */ + ERR_LOGIN_OLD_VERSION = 425, + /** + */ + ERR_LOGIN_TOKEN_WRONG = 426, + /** + */ + ERR_LOGIN_TOKEN_KICKED = 427, + /** + */ + ERR_LOGIN_ALREADY_LOGIN = 428, + /** + */ + ERR_JOIN_CHANNEL_OTHER = 440, + /** + */ + ERR_SEND_MESSAGE_OTHER = 440, + /** + */ + ERR_SEND_MESSAGE_TIMEOUT = 441, + /** + */ + ERR_QUERY_USERNUM_OTHER = 450, + /** + */ + ERR_QUERY_USERNUM_TIMEOUT = 451, + /** + */ + ERR_QUERY_USERNUM_BYUSER = 452, + /** + */ + ERR_LEAVE_CHANNEL_OTHER = 460, + /** + */ + ERR_LEAVE_CHANNEL_KICKED = 461, + /** + */ + ERR_LEAVE_CHANNEL_BYUSER = 462, + /** + */ + ERR_LEAVE_CHANNEL_LOGOUT = 463, + /** + */ + ERR_LEAVE_CHANNEL_DISCONNECTED = 464, + /** + */ + ERR_INVITE_OTHER = 470, + /** + */ + ERR_INVITE_REINVITE = 471, + /** + */ + ERR_INVITE_NET = 472, + /** + */ + ERR_INVITE_PEER_OFFLINE = 473, + ERR_INVITE_TIMEOUT = 474, + ERR_INVITE_CANT_RECV = 475, + + + //1001~2000 + /** 1001: Fails to load the media engine. + */ + ERR_LOAD_MEDIA_ENGINE = 1001, + /** 1002: Fails to start the call after enabling the media engine. + */ + ERR_START_CALL = 1002, + /** **DEPRECATED** 1003: Fails to start the camera. + + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. + */ + ERR_START_CAMERA = 1003, + /** 1004: Fails to start the video rendering module. + */ + ERR_START_VIDEO_RENDER = 1004, + /** 1005: A general error occurs in the Audio Device Module (no specified reason). Check if the audio device is used by another application, or try rejoining the channel. + */ + ERR_ADM_GENERAL_ERROR = 1005, + /** 1006: Audio Device Module: An error occurs in using the Java resources. + */ + ERR_ADM_JAVA_RESOURCE = 1006, + /** 1007: Audio Device Module: An error occurs in setting the sampling frequency. + */ + ERR_ADM_SAMPLE_RATE = 1007, + /** 1008: Audio Device Module: An error occurs in initializing the playback device. + */ + ERR_ADM_INIT_PLAYOUT = 1008, + /** 1009: Audio Device Module: An error occurs in starting the playback device. + */ + ERR_ADM_START_PLAYOUT = 1009, + /** 1010: Audio Device Module: An error occurs in stopping the playback device. + */ + ERR_ADM_STOP_PLAYOUT = 1010, + /** 1011: Audio Device Module: An error occurs in initializing the recording device. + */ + ERR_ADM_INIT_RECORDING = 1011, + /** 1012: Audio Device Module: An error occurs in starting the recording device. + */ + ERR_ADM_START_RECORDING = 1012, + /** 1013: Audio Device Module: An error occurs in stopping the recording device. + */ + ERR_ADM_STOP_RECORDING = 1013, + /** 1015: Audio Device Module: A playback error occurs. Check your playback device and try rejoining the channel. + */ + ERR_ADM_RUNTIME_PLAYOUT_ERROR = 1015, + /** 1017: Audio Device Module: A recording error occurs. + */ + ERR_ADM_RUNTIME_RECORDING_ERROR = 1017, + /** 1018: Audio Device Module: Fails to record. + */ + ERR_ADM_RECORD_AUDIO_FAILED = 1018, + /** 1022: Audio Device Module: An error occurs in initializing the + * loopback device. + */ + ERR_ADM_INIT_LOOPBACK = 1022, + /** 1023: Audio Device Module: An error occurs in starting the loopback + * device. + */ + ERR_ADM_START_LOOPBACK = 1023, + /** 1027: Audio Device Module: No recording permission exists. Check if the + * recording permission is granted. + */ + ERR_ADM_NO_PERMISSION = 1027, + /** 1033: Audio device module: The device is occupied. + */ + ERR_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, + /** 1101: Audio device module: A fatal exception occurs. + */ + ERR_ADM_ANDROID_JNI_JAVA_RESOURCE = 1101, + /** 1108: Audio device module: The recording frequency is lower than 50. + * 0 indicates that the recording is not yet started. We recommend + * checking your recording permission. + */ + ERR_ADM_ANDROID_JNI_NO_RECORD_FREQUENCY = 1108, + /** 1109: The playback frequency is lower than 50. 0 indicates that the + * playback is not yet started. We recommend checking if you have created + * too many AudioTrack instances. + */ + ERR_ADM_ANDROID_JNI_NO_PLAYBACK_FREQUENCY = 1109, + /** 1111: Audio device module: AudioRecord fails to start up. A ROM system + * error occurs. We recommend the following options to debug: + * - Restart your App. + * - Restart your cellphone. + * - Check your recording permission. + */ + ERR_ADM_ANDROID_JNI_JAVA_START_RECORD = 1111, + /** 1112: Audio device module: AudioTrack fails to start up. A ROM system + * error occurs. We recommend the following options to debug: + * - Restart your App. + * - Restart your cellphone. + * - Check your playback permission. + */ + ERR_ADM_ANDROID_JNI_JAVA_START_PLAYBACK = 1112, + /** 1115: Audio device module: AudioRecord returns error. The SDK will + * automatically restart AudioRecord. */ + ERR_ADM_ANDROID_JNI_JAVA_RECORD_ERROR = 1115, + /** **DEPRECATED** */ + ERR_ADM_ANDROID_OPENSL_CREATE_ENGINE = 1151, + /** **DEPRECATED** */ + ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_RECORDER = 1153, + /** **DEPRECATED** */ + ERR_ADM_ANDROID_OPENSL_START_RECORDER_THREAD = 1156, + /** **DEPRECATED** */ + ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_PLAYER = 1157, + /** **DEPRECATED** */ + ERR_ADM_ANDROID_OPENSL_START_PLAYER_THREAD = 1160, + /** 1201: Audio device module: The current device does not support audio + * input, possibly because you have mistakenly configured the audio session + * category, or because some other app is occupying the input device. We + * recommend terminating all background apps and re-joining the channel. */ + ERR_ADM_IOS_INPUT_NOT_AVAILABLE = 1201, + /** 1206: Audio device module: Cannot activate the Audio Session.*/ + ERR_ADM_IOS_ACTIVATE_SESSION_FAIL = 1206, + /** 1210: Audio device module: Fails to initialize the audio device, + * normally because the audio device parameters are wrongly set.*/ + ERR_ADM_IOS_VPIO_INIT_FAIL = 1210, + /** 1213: Audio device module: Fails to re-initialize the audio device, + * normally because the audio device parameters are wrongly set.*/ + ERR_ADM_IOS_VPIO_REINIT_FAIL = 1213, + /** 1214: Fails to re-start up the Audio Unit, possibly because the audio + * session category is not compatible with the settings of the Audio Unit. + */ + ERR_ADM_IOS_VPIO_RESTART_FAIL = 1214, + ERR_ADM_IOS_SET_RENDER_CALLBACK_FAIL = 1219, + /** **DEPRECATED** */ + ERR_ADM_IOS_SESSION_SAMPLERATR_ZERO = 1221, + /** 1301: Audio device module: An audio driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio + * device, or reboot the system.*/ + ERR_ADM_WIN_CORE_INIT = 1301, + /** 1303: Audio device module: A recording driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio + * device, or reboot the system. */ + ERR_ADM_WIN_CORE_INIT_RECORDING = 1303, + /** 1306: Audio device module: A playout driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio + * device, or reboot the system. */ + ERR_ADM_WIN_CORE_INIT_PLAYOUT = 1306, + /** 1307: Audio device module: No audio device is available. Solutions: + * Plug in a proper audio device. */ + ERR_ADM_WIN_CORE_INIT_PLAYOUT_NULL = 1307, + /** 1309: Audio device module: An audio driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio + * device, or reboot the system. */ + ERR_ADM_WIN_CORE_START_RECORDING = 1309, + /** 1311: Audio device module: Insufficient system memory or poor device + * performance. Solutions: Reboot the system or replace the device. + */ + ERR_ADM_WIN_CORE_CREATE_REC_THREAD = 1311, + /** 1314: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver.*/ + ERR_ADM_WIN_CORE_CAPTURE_NOT_STARTUP = 1314, + /** 1319: Audio device module: Insufficient system memory or poor device + * performance. Solutions: Reboot the system or replace the device. */ + ERR_ADM_WIN_CORE_CREATE_RENDER_THREAD = 1319, + /** 1320: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Replace the device. */ + ERR_ADM_WIN_CORE_RENDER_NOT_STARTUP = 1320, + /** 1322: Audio device module: No audio sampling device is available. + * Solutions: Plug in a proper recording device. */ + ERR_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, + /** 1323: Audio device module: No audio playout device is available. + * Solutions: Plug in a proper playback device.*/ + ERR_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, + /** 1351: Audio device module: An audio driver abnormality or a + * compatibility issue occurs. Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver. */ + ERR_ADM_WIN_WAVE_INIT = 1351, + /** 1353: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver. */ + ERR_ADM_WIN_WAVE_INIT_RECORDING = 1353, + /** 1354: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver. */ + ERR_ADM_WIN_WAVE_INIT_MICROPHONE = 1354, + /** 1355: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver. */ + ERR_ADM_WIN_WAVE_INIT_PLAYOUT = 1355, + /** 1356: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver. */ + ERR_ADM_WIN_WAVE_INIT_SPEAKER = 1356, + /** 1357: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver. */ + ERR_ADM_WIN_WAVE_START_RECORDING = 1357, + /** 1358: Audio device module: An audio driver abnormality occurs. + * Solutions: + * - Disable and then re-enable the audio device. + * - Reboot the system. + * - Upgrade your audio card driver.*/ + ERR_ADM_WIN_WAVE_START_PLAYOUT = 1358, + /** 1359: Audio Device Module: No recording device exists. + */ + ERR_ADM_NO_RECORDING_DEVICE = 1359, + /** 1360: Audio Device Module: No playback device exists. + */ + ERR_ADM_NO_PLAYOUT_DEVICE = 1360, + + // VDM error code starts from 1500 + /** 1501: Video Device Module: The camera is unauthorized. + */ + ERR_VDM_CAMERA_NOT_AUTHORIZED = 1501, + + // VDM error code starts from 1500 + /** **DEPRECATED** 1502: Video Device Module: The camera in use. + + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. + */ + ERR_VDM_WIN_DEVICE_IN_USE = 1502, + + // VCM error code starts from 1600 + /** 1600: Video Device Module: An unknown error occurs. + */ + ERR_VCM_UNKNOWN_ERROR = 1600, + /** 1601: Video Device Module: An error occurs in initializing the video encoder. + */ + ERR_VCM_ENCODER_INIT_ERROR = 1601, + /** 1602: Video Device Module: An error occurs in encoding. + */ + ERR_VCM_ENCODER_ENCODE_ERROR = 1602, + /** 1603: Video Device Module: An error occurs in setting the video encoder. + */ + ERR_VCM_ENCODER_SET_ERROR = 1603, +}; + + /** Output log filter level. */ +enum LOG_FILTER_TYPE +{ +/** 0: Do not output any log information. */ + LOG_FILTER_OFF = 0, + /** 0x080f: Output all log information. + Set your log filter as debug if you want to get the most complete log file. */ + LOG_FILTER_DEBUG = 0x080f, + /** 0x000f: Output CRITICAL, ERROR, WARNING, and INFO level log information. + We recommend setting your log filter as this level. + */ + LOG_FILTER_INFO = 0x000f, + /** 0x000e: Outputs CRITICAL, ERROR, and WARNING level log information. + */ + LOG_FILTER_WARN = 0x000e, + /** 0x000c: Outputs CRITICAL and ERROR level log information. */ + LOG_FILTER_ERROR = 0x000c, + /** 0x0008: Outputs CRITICAL level log information. */ + LOG_FILTER_CRITICAL = 0x0008, + LOG_FILTER_MASK = 0x80f, +}; +} // namespace agora + +#endif diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRefPtr.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRefPtr.h new file mode 100644 index 0000000..9452a87 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRefPtr.h @@ -0,0 +1,119 @@ + +// Copyright (c) 2019 Agora.io. All rights reserved + +// This program is confidential and proprietary to Agora.io. +// And may not be copied, reproduced, modified, disclosed to others, published +// or used, in whole or in part, without the express prior written permission +// of Agora.io. + +#pragma once + +#include + +namespace agora { + +enum class RefCountReleaseStatus { kDroppedLastRef, kOtherRefsRemained }; + +// Interfaces where refcounting is part of the public api should +// inherit this abstract interface. The implementation of these +// methods is usually provided by the RefCountedObject template class, +// applied as a leaf in the inheritance tree. +class RefCountInterface { + public: + virtual void AddRef() const = 0; + virtual RefCountReleaseStatus Release() const = 0; + + // Non-public destructor, because Release() has exclusive responsibility for + // destroying the object. + protected: + virtual ~RefCountInterface() {} +}; + +template +class agora_refptr { + public: + agora_refptr() : ptr_(nullptr) {} + + agora_refptr(T* p) : ptr_(p) { + if (ptr_) ptr_->AddRef(); + } + + agora_refptr(const agora_refptr& r) : ptr_(r.ptr_) { + if (ptr_) ptr_->AddRef(); + } + + template + agora_refptr(const agora_refptr& r) : ptr_(r.get()) { + if (ptr_) ptr_->AddRef(); + } + + // Move constructors. + agora_refptr(agora_refptr&& r) : ptr_(r.move()) {} + + template + agora_refptr(agora_refptr&& r) : ptr_(r.move()) {} + + ~agora_refptr() { + if (ptr_) ptr_->Release(); + } + + T* get() const { return ptr_; } + operator bool() const { return ptr_ != nullptr; } + T* operator->() const { return ptr_; } + + // Returns the (possibly null) raw pointer, and makes the agora_refptr hold a + // null pointer, all without touching the reference count of the underlying + // pointed-to object. The object is still reference counted, and the caller of + // move() is now the proud owner of one reference, so it is responsible for + // calling Release() once on the object when no longer using it. + T* move() { + T* retVal = ptr_; + ptr_ = nullptr; + return retVal; + } + + agora_refptr& operator=(T* p) { + // AddRef first so that self assignment should work + if (p) p->AddRef(); + if (ptr_) ptr_->Release(); + ptr_ = p; + return *this; + } + + agora_refptr& operator=(const agora_refptr& r) { return *this = r.ptr_; } + + template + agora_refptr& operator=(const agora_refptr& r) { + return *this = r.get(); + } + + agora_refptr& operator=(agora_refptr&& r) { + agora_refptr(std::move(r)).swap(*this); + return *this; + } + + template + agora_refptr& operator=(agora_refptr&& r) { + agora_refptr(std::move(r)).swap(*this); + return *this; + } + + // For working with std::find() + bool operator==(const agora_refptr& r) { return ptr_ == r.ptr_; } + + // For working with std::set + bool operator<(const agora_refptr& r) const { return ptr_ < r.ptr_; } + + void swap(T** pp) { + T* p = ptr_; + ptr_ = *pp; + *pp = p; + } + + void swap(agora_refptr& r) { swap(&r.ptr_); } + + protected: + T* ptr_; +}; + +} // namespace agora diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRtcCryptoCppLoader.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRtcCryptoCppLoader.h new file mode 100644 index 0000000..58e4902 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraRtcCryptoCppLoader.h @@ -0,0 +1,18 @@ +// +// AgoraRtcCryptoCppLoader.h +// AgoraRtcCryptoLoader +// +// Copyright © 2019 Agora IO. All rights reserved. +// + +#ifndef AgoraRtcCryptoCppLoader_h +#define AgoraRtcCryptoCppLoader_h + +class AgoraRtcCryptoCppLoader +{ +public: + AgoraRtcCryptoCppLoader(); + ~AgoraRtcCryptoCppLoader(); +}; + +#endif /* AgoraRtcCryptoCppLoader_h */ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AudioCircularBuffer.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AudioCircularBuffer.h new file mode 100644 index 0000000..4005754 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AudioCircularBuffer.h @@ -0,0 +1,174 @@ +/* + * Copyright (c) 2016 The Agora project authors. All Rights Reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#ifndef WEBRTC_CHAT_ENGINE_FILE_AUDIO_CIRCULAR_BUFFER_H_ +#define WEBRTC_CHAT_ENGINE_FILE_AUDIO_CIRCULAR_BUFFER_H_ + +#include "scoped_ptr.h" +#include +template + +class AudioCircularBuffer { + + public: + typedef Ty value; + AudioCircularBuffer(uint32_t initSize, bool newWay) + : pInt16BufferPtr(nullptr), + bNewWayProcessing(newWay) + { + mInt16BufferLength = initSize; + if (bNewWayProcessing) { + pInt16BufferPtr = new value[sizeof(value) * mInt16BufferLength]; + } + else { + if (!pInt16Buffer.get()) { + pInt16Buffer.reset(new value[sizeof(value) * mInt16BufferLength]); + } + } + } + + ~AudioCircularBuffer() + { + if (pInt16BufferPtr) { + delete [] pInt16BufferPtr; + pInt16BufferPtr = nullptr; + } + } + + void Push(value* data, int length) + { + if (bNewWayProcessing) { + // If the internal buffer is not large enough, first enlarge the buffer + if (mAvailSamples + length > mInt16BufferLength) { + int newLength = std::max(length + mAvailSamples + 960, 2 * mInt16BufferLength); + value * tmpBuffer = new value[sizeof(value) * newLength]; + if (mReadPtrPosition + mAvailSamples > mInt16BufferLength) { + int firstCopyLength = mInt16BufferLength - mReadPtrPosition; + + memcpy(tmpBuffer, pInt16BufferPtr + mReadPtrPosition, sizeof(value) * firstCopyLength); + memcpy(tmpBuffer + firstCopyLength, pInt16BufferPtr, sizeof(value) * (mAvailSamples - firstCopyLength)); + } + else { + memcpy(tmpBuffer, pInt16BufferPtr + mReadPtrPosition, sizeof(value) * mAvailSamples); + } + delete [] pInt16BufferPtr; + + // Construct the new internal array + mInt16BufferLength = newLength; + pInt16BufferPtr = tmpBuffer; + mReadPtrPosition = 0; + mWritePtrPosition = mAvailSamples; + memcpy(pInt16BufferPtr + mWritePtrPosition, data, sizeof(value) * length); + mWritePtrPosition += length; + } + else { + int availSlots = mInt16BufferLength - mWritePtrPosition; + if (availSlots < length) { + memcpy(pInt16BufferPtr + mWritePtrPosition, data, sizeof(value) * availSlots); + memcpy(pInt16BufferPtr, data + availSlots, sizeof(value) * (length - availSlots)); + } + else { + memcpy(pInt16BufferPtr + mWritePtrPosition, data, sizeof(value)*length); + } + mWritePtrPosition = IntModule(mWritePtrPosition, length, mInt16BufferLength); + } + mAvailSamples += length; + } + else { + // If the internal buffer is not large enough, first enlarge the buffer + if (length + mAvailSamples > mInt16BufferLength) { + value * tmpBuffer = new value[sizeof(value) * mAvailSamples]; + memmove(tmpBuffer, &pInt16Buffer[mReadPtrPosition], sizeof(value)*mAvailSamples); + + mInt16BufferLength = (length + mAvailSamples) * 2; + pInt16Buffer.reset(new value[sizeof(value) * mInt16BufferLength]); + memmove(&pInt16Buffer[0], tmpBuffer, sizeof(value)*mAvailSamples); + + delete[] tmpBuffer; + mReadPtrPosition = 0; + } + else { + memmove(&pInt16Buffer[0], &pInt16Buffer[mReadPtrPosition], sizeof(value)*mAvailSamples); + } + + memmove(&pInt16Buffer[mAvailSamples], data, sizeof(value)*length); + mAvailSamples += length; + mReadPtrPosition = 0; + } + } + + void Pop(value* data, int length) + { + if (bNewWayProcessing) { + int availSlots = mInt16BufferLength - mReadPtrPosition; + if (availSlots < length) { + memcpy(data, pInt16BufferPtr + mReadPtrPosition, sizeof(value) * availSlots); + memcpy(data + availSlots, pInt16BufferPtr, sizeof(value) * (length - availSlots)); + } + else { + memcpy(data, pInt16BufferPtr + mReadPtrPosition, sizeof(value)*length); + } + mReadPtrPosition = IntModule(mReadPtrPosition, length, mInt16BufferLength); + mAvailSamples -= length; + } + else { + memmove(data, &pInt16Buffer[mReadPtrPosition], sizeof(value)*length); + mAvailSamples -= length; + mReadPtrPosition += length; + } + } + + void Discard(int length) + { + if (bNewWayProcessing) { + mReadPtrPosition = IntModule(mReadPtrPosition, length, mInt16BufferLength); + mAvailSamples -= length; + } + else { + mAvailSamples -= length; + mReadPtrPosition += length; + } + } + + void Reset() + { + mAvailSamples = 0; + mReadPtrPosition = 0; + mWritePtrPosition = 0; + } + + bool dataAvailable(uint32_t requireLength) { + return mAvailSamples >= requireLength; + } + static uint32_t IntModule(uint32_t ptrIndex, int frmLength, int bufLength) + { + if (ptrIndex + frmLength >= bufLength) { + return ptrIndex + frmLength - bufLength; + } + else { + return ptrIndex + frmLength; + } + } + uint32_t mAvailSamples = 0; + uint32_t mReadPtrPosition = 0; + uint32_t mWritePtrPosition = 0; + uint32_t mInt16BufferLength; + value* pInt16BufferPtr; + AgoraRTC::scoped_array pInt16Buffer; + + private: + bool bNewWayProcessing; + + }; +//ptrIndex = (ptrIndex + frmLength) % bufLength + + + +#endif // WEBRTC_CHAT_ENGINE_FILE_AUDIO_CIRCULAR_BUFFER_H_ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h new file mode 100755 index 0000000..5b0b7a5 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h @@ -0,0 +1,227 @@ +#ifndef AGORA_MEDIA_ENGINE_H +#define AGORA_MEDIA_ENGINE_H +#if defined _WIN32 || defined __CYGWIN__ +typedef __int64 int64_t; +typedef unsigned __int64 uint64_t; +#else +#include +#endif + +namespace agora +{ +namespace media +{ + +enum MEDIA_SOURCE_TYPE { + AUDIO_PLAYOUT_SOURCE = 0, + AUDIO_RECORDING_SOURCE = 1, +}; + +class IAudioFrameObserver +{ +public: + enum AUDIO_FRAME_TYPE { + FRAME_TYPE_PCM16 = 0, //PCM 16bit little endian + }; + struct AudioFrame { + AUDIO_FRAME_TYPE type; + int samples; //number of samples in this frame + int bytesPerSample; //number of bytes per sample: 2 for PCM16 + int channels; //number of channels (data are interleaved if stereo) + int samplesPerSec; //sampling rate + void* buffer; //data buffer + int64_t renderTimeMs; + int avsync_type; + }; +public: + virtual bool onRecordAudioFrame(AudioFrame& audioFrame) = 0; + virtual bool onPlaybackAudioFrame(AudioFrame& audioFrame) = 0; + virtual bool onMixedAudioFrame(AudioFrame& audioFrame) = 0; + virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, AudioFrame& audioFrame) = 0; +}; + +class IVideoFrameObserver +{ +public: + enum VIDEO_FRAME_TYPE { + FRAME_TYPE_YUV420 = 0, //YUV 420 format + FRAME_TYPE_YUV422 = 1, //YUV 422P format + FRAME_TYPE_RGBA = 2, //RGBA + }; + struct VideoFrame { + VIDEO_FRAME_TYPE type; + int width; //width of video frame + int height; //height of video frame + int yStride; //stride of Y data buffer + int uStride; //stride of U data buffer + int vStride; //stride of V data buffer + void* yBuffer; //Y data buffer + void* uBuffer; //U data buffer + void* vBuffer; //V data buffer + int rotation; // rotation of this frame (0, 90, 180, 270) + int64_t renderTimeMs; + int avsync_type; + }; +public: + virtual bool onCaptureVideoFrame(VideoFrame& videoFrame) = 0; + virtual bool onPreEncodeVideoFrame(VideoFrame& videoFrame) { return true; } + virtual bool onRenderVideoFrame(unsigned int uid, VideoFrame& videoFrame) = 0; + virtual VIDEO_FRAME_TYPE getVideoFormatPreference() { return FRAME_TYPE_YUV420; } + virtual bool getRotationApplied() { return false; } + virtual bool getMirrorApplied() { return false; } + virtual bool getSmoothRenderingEnabled(){ return false; } +}; + +class IVideoFrame +{ +public: + enum PLANE_TYPE { + Y_PLANE = 0, + U_PLANE = 1, + V_PLANE = 2, + NUM_OF_PLANES = 3 + }; + enum VIDEO_TYPE { + VIDEO_TYPE_UNKNOWN = 0, + VIDEO_TYPE_I420 = 1, + VIDEO_TYPE_IYUV = 2, + VIDEO_TYPE_RGB24 = 3, + VIDEO_TYPE_ABGR = 4, + VIDEO_TYPE_ARGB = 5, + VIDEO_TYPE_ARGB4444 = 6, + VIDEO_TYPE_RGB565 = 7, + VIDEO_TYPE_ARGB1555 = 8, + VIDEO_TYPE_YUY2 = 9, + VIDEO_TYPE_YV12 = 10, + VIDEO_TYPE_UYVY = 11, + VIDEO_TYPE_MJPG = 12, + VIDEO_TYPE_NV21 = 13, + VIDEO_TYPE_NV12 = 14, + VIDEO_TYPE_BGRA = 15, + VIDEO_TYPE_RGBA = 16, + VIDEO_TYPE_I422 = 17, + }; + virtual void release() = 0; + virtual const unsigned char* buffer(PLANE_TYPE type) const = 0; + + // Copy frame: If required size is bigger than allocated one, new buffers of + // adequate size will be allocated. + // Return value: 0 on success ,-1 on error. + virtual int copyFrame(IVideoFrame** dest_frame) const = 0; + + // Convert frame + // Input: + // - src_frame : Reference to a source frame. + // - dst_video_type : Type of output video. + // - dst_sample_size : Required only for the parsing of MJPG. + // - dst_frame : Pointer to a destination frame. + // Return value: 0 if OK, < 0 otherwise. + // It is assumed that source and destination have equal height. + virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, unsigned char* dst_frame) const = 0; + + // Get allocated size per plane. + virtual int allocated_size(PLANE_TYPE type) const = 0; + + // Get allocated stride per plane. + virtual int stride(PLANE_TYPE type) const = 0; + + // Get frame width. + virtual int width() const = 0; + + // Get frame height. + virtual int height() const = 0; + + // Get frame timestamp (90kHz). + virtual unsigned int timestamp() const = 0; + + // Get render time in milliseconds. + virtual int64_t render_time_ms() const = 0; + + // Return true if underlying plane buffers are of zero size, false if not. + virtual bool IsZeroSize() const = 0; + + virtual VIDEO_TYPE GetVideoType() const = 0; +}; + +class IExternalVideoRenderCallback +{ +public: + virtual void onViewSizeChanged(int width, int height) = 0; + virtual void onViewDestroyed() = 0; +}; + +struct ExternalVideoRenerContext +{ + IExternalVideoRenderCallback* renderCallback; + void* view; + int renderMode; + int zOrder; + float left; + float top; + float right; + float bottom; +}; + +class IExternalVideoRender +{ +public: + virtual void release() = 0; + virtual int initialize() = 0; + virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, bool mirrored) = 0; +}; + +class IExternalVideoRenderFactory +{ +public: + virtual IExternalVideoRender* createRenderInstance(const ExternalVideoRenerContext& context) = 0; +}; + +struct ExternalVideoFrame +{ + enum VIDEO_BUFFER_TYPE + { + VIDEO_BUFFER_RAW_DATA = 1, + }; + + enum VIDEO_PIXEL_FORMAT + { + VIDEO_PIXEL_UNKNOWN = 0, + VIDEO_PIXEL_I420 = 1, + VIDEO_PIXEL_BGRA = 2, + + VIDEO_PIXEL_NV12 = 8, + VIDEO_PIXEL_I422 = 16, + }; + + VIDEO_BUFFER_TYPE type; + VIDEO_PIXEL_FORMAT format; + void* buffer; + int stride; + int height; + int cropLeft; + int cropTop; + int cropRight; + int cropBottom; + int rotation; + long long timestamp; +}; + +class IMediaEngine { +public: + virtual void release() = 0; + virtual int registerAudioFrameObserver(IAudioFrameObserver* observer) = 0; + virtual int registerVideoFrameObserver(IVideoFrameObserver* observer) = 0; + virtual int registerVideoRenderFactory(IExternalVideoRenderFactory* factory) = 0; + virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, IAudioFrameObserver::AudioFrame *frame, bool wrap) = 0; + virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; + virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; + + virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; + virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; +}; + +} //media + +} //agora + +#endif //AGORA_MEDIA_ENGINE_H diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraParameter.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraParameter.h new file mode 100644 index 0000000..6ec47a4 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraParameter.h @@ -0,0 +1,208 @@ +// +// Agora Engine SDK +// +// Created by minbo in 2019-10. +// Copyright (c) 2019 Agora.io. All rights reserved. + +/* + * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +#pragma once // NOLINT(build/header_guard) + +// external key +/** + * set the range of ports available for connection + * @example "{\"rtc.udp_port_range\":[4500, 5000]}" + */ +#define KEY_RTC_UDP_PORT_RANGE "rtc.udp_port_range" +/** + * set the list of ports available for connection + * @example "{\"rtc.udp_port_list\":[4501, 4502, 4503, 4504, 4505, 4506]}" + */ +#define KEY_RTC_UDP_PORT_LIST "rtc.udp_port_list" + + /** + * set the video encoder mode (hardware or software) + */ +#define KEY_RTC_VIDEO_ENABLED_HW_ENCODER "engine.video.enable_hw_encoder" + +namespace agora { + +namespace util { +template +class CopyableAutoPtr; + +class IString; +typedef CopyableAutoPtr AString; +} // namespace util + +namespace base { + +class IAgoraParameter { +public: + /** + * release the resource + */ + virtual void release() = 0; + + /** + * set bool value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setBool(const char* key, bool value) = 0; + + /** + * set int value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setInt(const char* key, int value) = 0; + + /** + * set unsigned int value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setUInt(const char* key, unsigned int value) = 0; + + /** + * set double value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setNumber(const char* key, double value) = 0; + + /** + * set string value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setString(const char* key, const char* value) = 0; + + /** + * set object value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setObject(const char* key, const char* value) = 0; + + /** + * set array value of the json + * @param [in] key + * the key name + * @param [in] value + * the value + * @return return 0 if success or an error code + */ + virtual int setArray(const char* key, const char* value) = 0; + /** + * get bool value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getBool(const char* key, bool& value) = 0; + + /** + * get int value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getInt(const char* key, int& value) = 0; + + /** + * get unsigned int value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getUInt(const char* key, unsigned int& value) = 0; + + /** + * get double value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getNumber(const char* key, double& value) = 0; + + /** + * get string value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getString(const char* key, agora::util::AString& value) = 0; + + /** + * get a child object value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getObject(const char* key, agora::util::AString& value) = 0; + + /** + * get array value of the json + * @param [in] key + * the key name + * @param [in, out] value + * the value + * @return return 0 if success or an error code + */ + virtual int getArray(const char* key, const char* args, agora::util::AString& value) = 0; + + /** + * set parameters of the sdk or engine + * @param [in] parameters + * the parameters + * @return return 0 if success or an error code + */ + virtual int setParameters(const char* parameters) = 0; + + virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; + + virtual ~IAgoraParameter() {} +}; + +} // namespace base +} // namespace agora diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h new file mode 100755 index 0000000..b19c71c --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h @@ -0,0 +1,1203 @@ +// +// AgoraRtcEngine SDK +// +// Copyright (c) 2019 Agora.io. All rights reserved. +// + +#ifndef IAgoraRtcChannel_h +#define IAgoraRtcChannel_h +#include "IAgoraRtcEngine.h" + +namespace agora { +namespace rtc { +/** The channel media options. */ +struct ChannelMediaOptions { + /** Determines whether to subscribe to audio streams when the user joins the channel: + - true: (Default) Subscribe. + - false: Do not subscribe. + + This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method. After joining the channel, + you can call the `muteAllRemoteAudioStreams` method to set whether to subscribe to audio streams in the channel. + */ + bool autoSubscribeAudio; + /** Determines whether to subscribe to video streams when the user joins the channel: + - true: (Default) Subscribe. + - false: Do not subscribe. + + This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method. After joining the channel, + you can call the `muteAllRemoteVideoStreams` method to set whether to subscribe to video streams in the channel. + */ + bool autoSubscribeVideo; + ChannelMediaOptions() + : autoSubscribeAudio(true) + , autoSubscribeVideo(true) + {} +}; +/** The IChannel class. */ +class IChannel; +/** The IChannelEventHandler class. */ +class IChannelEventHandler +{ +public: + virtual ~IChannelEventHandler() {} + /** Reports the warning code of `IChannel`. + + @param rtcChannel IChannel + @param warn The warning code: #WARN_CODE_TYPE + @param msg The warning message. + + */ + virtual void onChannelWarning(IChannel *rtcChannel, int warn, const char* msg) { + (void)rtcChannel; + (void)warn; + (void)msg; + } + /** Reports the error code of `IChannel`. + + @param rtcChannel IChannel + @param err The error code: #ERROR_CODE_TYPE + @param msg The error message. + */ + virtual void onChannelError(IChannel *rtcChannel, int err, const char* msg) { + (void)rtcChannel; + (void)err; + (void)msg; + } + /** Occurs when a user joins a channel. + + This callback notifies the application that a user joins a specified channel. + + @param rtcChannel IChannel + @param uid The user ID. If the `uid` is not specified in the \ref IChannel::joinChannel "joinChannel" method, the server automatically assigns a `uid`. + + @param elapsed Time elapsed (ms) from the local user calling \ref IChannel::joinChannel "joinChannel" until this callback is triggered. + */ + virtual void onJoinChannelSuccess(IChannel *rtcChannel, uid_t uid, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)elapsed; + } + /** Occurs when a user rejoins the channel after being disconnected due to network problems. + + @param rtcChannel IChannel + @param uid The user ID. + @param elapsed Time elapsed (ms) from the local user starting to reconnect until this callback is triggered. + + */ + virtual void onRejoinChannelSuccess(IChannel *rtcChannel, uid_t uid, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)elapsed; + } + /** Occurs when a user leaves the channel. + + This callback notifies the application that a user leaves the channel when the application calls the \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method. + + The application retrieves information, such as the call duration and statistics. + + @param rtcChannel IChannel + @param stats The call statistics: RtcStats. + */ + virtual void onLeaveChannel(IChannel *rtcChannel, const RtcStats& stats) { + (void)rtcChannel; + (void)stats; + } + /** Occurs when the user role switches in a live broadcast. For example, from a host to an audience or vice versa. + + This callback notifies the application of a user role switch when the application calls the \ref IChannel::setClientRole "setClientRole" method. + + The SDK triggers this callback when the local user switches the user role by calling the \ref IChannel::setClientRole "setClientRole" method after joining the channel. + + @param rtcChannel IChannel + @param oldRole Role that the user switches from: #CLIENT_ROLE_TYPE. + @param newRole Role that the user switches to: #CLIENT_ROLE_TYPE. + */ + virtual void onClientRoleChanged(IChannel *rtcChannel, CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { + (void)rtcChannel; + (void)oldRole; + (void)newRole; + } + /** Occurs when a remote user (Communication)/ host (Live Broadcast) joins the channel. + + - Communication profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - Live-broadcast profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + + The SDK triggers this callback under one of the following circumstances: + - A remote user/host joins the channel by calling the \ref agora::rtc::IChannel::joinChannel "joinChannel" method. + - A remote user switches the user role to the host by calling the \ref agora::rtc::IChannel::setClientRole "setClientRole" method after joining the channel. + - A remote user/host rejoins the channel after a network interruption. + - The host injects an online media stream into the channel by calling the \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method. + + @note In the Live-broadcast profile: + - The host receives this callback when another host joins the channel. + - The audience in the channel receives this callback when a new host joins the channel. + - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. + + @param rtcChannel IChannel + @param uid User ID of the user or host joining the channel. + @param elapsed Time delay (ms) from the local user calling the \ref IChannel::joinChannel "joinChannel" method until the SDK triggers this callback. + */ + virtual void onUserJoined(IChannel *rtcChannel, uid_t uid, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)elapsed; + } + /** Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel. + + Reasons why the user is offline: + + - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. + - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using a signaling system for more reliable offline detection. + + @param rtcChannel IChannel + @param uid User ID of the user leaving the channel or going offline. + @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. + */ + virtual void onUserOffline(IChannel *rtcChannel, uid_t uid, USER_OFFLINE_REASON_TYPE reason) { + (void)rtcChannel; + (void)uid; + (void)reason; + } + /** Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted. + + The SDK triggers this callback when it cannot connect to the server 10 seconds after calling the \ref IChannel::joinChannel "joinChannel" method, whether or not it is in the channel. + + This callback is different from \ref agora::rtc::IChannelEventHandler::onConnectionInterrupted "onConnectionInterrupted": + + - The SDK triggers the \ref agora::rtc::IChannelEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. + - The SDK triggers the \ref agora::rtc::IChannelEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. + + If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. + + @param rtcChannel IChannel + */ + virtual void onConnectionLost(IChannel *rtcChannel) { + (void)rtcChannel; + } + /** Occurs when the token expires. + + After a token is specified by calling the \ref IChannel::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. + + This callback notifies the application to generate a new token. Call the \ref IChannel::renewToken "renewToken" method to renew the token. + + @param rtcChannel IChannel + */ + virtual void onRequestToken(IChannel *rtcChannel) { + (void)rtcChannel; + } + /** Occurs when the token expires in 30 seconds. + + The user becomes offline if the token used in the \ref IChannel::joinChannel "joinChannel" method expires. The SDK triggers this callback 30 seconds before the token expires to remind the application to get a new token. Upon receiving this callback, generate a new token on the server and call the \ref IChannel::renewToken "renewToken" method to pass the new token to the SDK. + + @param rtcChannel IChannel + @param token Token that expires in 30 seconds. + */ + virtual void onTokenPrivilegeWillExpire(IChannel *rtcChannel, const char* token) { + (void)rtcChannel; + (void)token; + } + /** Reports the statistics of the current call. + + The SDK triggers this callback once every two seconds after the user joins the channel. + + @param rtcChannel IChannel + @param stats Statistics of the RtcEngine: RtcStats. + */ + virtual void onRtcStats(IChannel *rtcChannel, const RtcStats& stats) { + (void)rtcChannel; + (void)stats; + } + /** Reports the last mile network quality of each user in the channel once every two seconds. + + Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. + + @param rtcChannel IChannel + @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 × 480 and a frame rate of 15 fps in the Live-broadcast profile, but may be inadequate for resolutions higher than 1280 × 720. See #QUALITY_TYPE. + @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. + */ + virtual void onNetworkQuality(IChannel *rtcChannel, uid_t uid, int txQuality, int rxQuality) { + (void)rtcChannel; + (void)uid; + (void)txQuality; + (void)rxQuality; + } + /** Reports the statistics of the video stream from each remote user/host. + * + * The SDK triggers this callback once every two seconds for each remote + * user/host. If a channel includes multiple remote users, the SDK + * triggers this callback as many times. + * + * @param rtcChannel IChannel + * @param stats Statistics of the remote video stream. See + * RemoteVideoStats. + */ + virtual void onRemoteVideoStats(IChannel *rtcChannel, const RemoteVideoStats& stats) { + (void)rtcChannel; + (void)stats; + } + /** Reports the statistics of the audio stream from each remote user/host. + + This callback replaces the \ref agora::rtc::IChannelEventHandler::onAudioQuality "onAudioQuality" callback. + + The SDK triggers this callback once every two seconds for each remote user/host. If a channel includes multiple remote users, the SDK triggers this callback as many times. + + @param rtcChannel IChannel + @param stats The statistics of the received remote audio streams. See RemoteAudioStats. + */ + virtual void onRemoteAudioStats(IChannel *rtcChannel, const RemoteAudioStats& stats) { + (void)rtcChannel; + (void)stats; + } + /** Occurs when the remote audio state changes. + * + * This callback indicates the state change of the remote audio stream. + * + * @param rtcChannel IChannel + * @param uid ID of the remote user whose audio state changes. + * @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + * @param reason The reason of the remote audio state change. + * See #REMOTE_AUDIO_STATE_REASON. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref IChannel::joinChannel "joinChannel" method until the SDK + * triggers this callback. + */ + virtual void onRemoteAudioStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)state; + (void)reason; + (void)elapsed; + } + /** Reports which user is the loudest speaker. + + If the user enables the audio volume indication by calling the \ref IChannel::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method, this callback returns the @p uid of the active speaker detected by the audio volume detection module of the SDK. + + @note + - To receive this callback, you need to call the \ref IChannel::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. + - This callback returns the user ID of the user with the highest voice volume during a period of time, instead of at the moment. + + @param rtcChannel IChannel + @param uid User ID of the active speaker. A @p uid of 0 represents the local user. + */ + virtual void onActiveSpeaker(IChannel *rtcChannel, uid_t uid) { + (void)rtcChannel; + (void)uid; + } + /** Occurs when the video size or rotation of a specified user changes. + + @param rtcChannel IChannel + @param uid User ID of the remote user or local user (0) whose video size or rotation changes. + @param width New width (pixels) of the video. + @param height New height (pixels) of the video. + @param rotation New rotation of the video [0 to 360). + */ + virtual void onVideoSizeChanged(IChannel *rtcChannel, uid_t uid, int width, int height, int rotation) { + (void)rtcChannel; + (void)uid; + (void)width; + (void)height; + (void)rotation; + } + /** Occurs when the remote video state changes. + * + * @param rtcChannel IChannel + * @param uid ID of the remote user whose video state changes. + * @param state State of the remote video. See #REMOTE_VIDEO_STATE. + * @param reason The reason of the remote video state change. See + * #REMOTE_VIDEO_STATE_REASON. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref agora::rtc::IChannel::joinChannel "joinChannel" method until the + * SDK triggers this callback. + */ + virtual void onRemoteVideoStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)state; + (void)reason; + (void)elapsed; + } + /** Occurs when the local user receives the data stream from the remote user within five seconds. + + The SDK triggers this callback when the local user receives the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. + + @param rtcChannel IChannel + @param uid User ID of the remote user sending the message. + @param streamId Stream ID. + @param data The data received by the local user. + @param length Length of the data in bytes. + */ + virtual void onStreamMessage(IChannel *rtcChannel, uid_t uid, int streamId, const char* data, size_t length) { + (void)rtcChannel; + (void)uid; + (void)streamId; + (void)data; + (void)length; + } + /** Occurs when the local user does not receive the data stream from the remote user within five seconds. + + The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. + + @param rtcChannel IChannel + @param uid User ID of the remote user sending the message. + @param streamId Stream ID. + @param code Error code: #ERROR_CODE_TYPE. + @param missed Number of lost messages. + @param cached Number of incoming cached messages when the data stream is interrupted. + */ + virtual void onStreamMessageError(IChannel *rtcChannel, uid_t uid, int streamId, int code, int missed, int cached) { + (void)rtcChannel; + (void)uid; + (void)streamId; + (void)code; + (void)missed; + (void)cached; + } + /** Occurs when the state of the media stream relay changes. + * + * The SDK returns the state of the current media relay with any error + * message. + * @param rtcChannel IChannel + * @param state The state code in #CHANNEL_MEDIA_RELAY_STATE. + * @param code The error code in #CHANNEL_MEDIA_RELAY_ERROR. + */ + virtual void onChannelMediaRelayStateChanged(IChannel *rtcChannel, CHANNEL_MEDIA_RELAY_STATE state,CHANNEL_MEDIA_RELAY_ERROR code) { + (void)rtcChannel; + (void)state; + (void)code; + } + /** Reports events during the media stream relay. + * @param rtcChannel IChannel + * @param code The event code in #CHANNEL_MEDIA_RELAY_EVENT. + */ + virtual void onChannelMediaRelayEvent(IChannel *rtcChannel, CHANNEL_MEDIA_RELAY_EVENT code) { + (void)rtcChannel; + (void)code; + } + /** + Occurs when the state of the RTMP streaming changes. + + The SDK triggers this callback to report the result of the local user calling the \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" or \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method. + + This callback indicates the state of the RTMP streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. + + @param rtcChannel IChannel + @param url The RTMP URL address. + @param state The RTMP streaming state. See: #RTMP_STREAM_PUBLISH_STATE. + @param errCode The detailed error information for streaming. See: #RTMP_STREAM_PUBLISH_ERROR. + */ + virtual void onRtmpStreamingStateChanged(IChannel *rtcChannel, const char *url, RTMP_STREAM_PUBLISH_STATE state, RTMP_STREAM_PUBLISH_ERROR errCode) { + (void)rtcChannel; + (void) url; + (RTMP_STREAM_PUBLISH_STATE) state; + (RTMP_STREAM_PUBLISH_ERROR) errCode; + } + /** Occurs when the publisher's transcoding is updated. + + When the `LiveTranscoding` class in the \ref agora::rtc::IChannel::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. + + @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + + @param rtcChannel IChannel + */ + virtual void onTranscodingUpdated(IChannel *rtcChannel) { + (void)rtcChannel; + } + /** Occurs when a voice or video stream URL address is added to a live broadcast. + + @param rtcChannel IChannel + @param url The URL address of the externally injected stream. + @param uid User ID. + @param status State of the externally injected stream: #INJECT_STREAM_STATUS. + */ + virtual void onStreamInjectedStatus(IChannel *rtcChannel, const char* url, uid_t uid, int status) { + (void)rtcChannel; + (void)url; + (void)uid; + (void)status; + } + /** Occurs when the remote media stream falls back to audio-only stream + * due to poor network conditions or switches back to the video stream + * after the network conditions improve. + * + * If you call + * \ref IChannel::setRemoteSubscribeFallbackOption + * "setRemoteSubscribeFallbackOption" and set + * @p option as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this + * callback when the remote media stream falls back to audio-only mode due + * to poor uplink conditions, or when the remote media stream switches + * back to the video after the uplink network condition improves. + * + * @note Once the remote media stream switches to the low stream due to + * poor network conditions, you can monitor the stream switch between a + * high and low stream in the RemoteVideoStats callback. + * @param rtcChannel IChannel + * @param uid ID of the remote user sending the stream. + * @param isFallbackOrRecover Whether the remotely subscribed media stream + * falls back to audio-only or switches back to the video: + * - true: The remotely subscribed media stream falls back to audio-only + * due to poor network conditions. + * - false: The remotely subscribed media stream switches back to the + * video stream after the network conditions improved. + */ + virtual void onRemoteSubscribeFallbackToAudioOnly(IChannel *rtcChannel, uid_t uid, bool isFallbackOrRecover) { + (void)rtcChannel; + (void)uid; + (void)isFallbackOrRecover; + } + /** Occurs when the connection state between the SDK and the server changes. + + @param rtcChannel IChannel + @param state See #CONNECTION_STATE_TYPE. + @param reason See #CONNECTION_CHANGED_REASON_TYPE. + */ + virtual void onConnectionStateChanged(IChannel *rtcChannel, + CONNECTION_STATE_TYPE state, + CONNECTION_CHANGED_REASON_TYPE reason) { + (void)rtcChannel; + (void)state; + (void)reason; + } +}; + +/** The IChannel class. */ +class IChannel +{ +public: + virtual ~IChannel() {} + /** Releases all IChannel resources. + + @return + - 0: Success. + - < 0: Failure. + - `ERR_NOT_INITIALIZED (7)`: The SDK is not initialized before calling this method. + */ + virtual int release() = 0; + /** Sets the channel event handler. + + After setting the channel event handler, you can listen for channel events and receive the statistics of the corresponding `IChannel` object. + + @param channelEh The event handler of the `IChannel` object. For details, see IChannelEventHandler. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setChannelEventHandler(IChannelEventHandler *channelEh) = 0; + /** Joins the channel with a user ID. + + This method differs from the `joinChannel` method in the `IRtcEngine` class in the following aspects: + + | IChannel::joinChannel | IRtcEngine::joinChannel | + |------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------| + | Does not contain the `channelId` parameter, because `channelId` is specified when creating the `IChannel` object. | Contains the `channelId` parameter, which specifies the channel to join. | + | Contains the `options` parameter, which decides whether to subscribe to all streams before joining the channel. | Does not contain the `options` parameter. By default, users subscribe to all streams when joining the channel. | + | Users can join multiple channels simultaneously by creating multiple `IChannel` objects and calling the `joinChannel` method of each object. | Users can join only one channel. | + | By default, the SDK does not publish any stream after the user joins the channel. You need to call the publish method to do that. | By default, the SDK publishes streams once the user joins the channel. | + + @note + - If you are already in a channel, you cannot rejoin it with the same `uid`. + - We recommend using different UIDs for different channels. + - If you want to join the same channel from different devices, ensure that the UIDs in all devices are different. + - Ensure that the app ID you use to generate the token is the same with the app ID used when creating the `IChannel` object. + + @param token The token for authentication: + - In situations not requiring high security: You can use the temporary token generated at Console. For details, see [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-temporary-token). + - In situations requiring high security: Set it as the token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-token). + @param info (Optional) Additional information about the channel. This parameter can be set as null. Other users in the channel do not receive this information. + @param uid The user ID. A 32-bit unsigned integer with a value ranging from 1 to (232-1). This parameter must be unique. If `uid` is not assigned (or set as `0`), the SDK assigns a `uid` and reports it in the \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. The app must maintain this user ID. + @param options The channel media options: ChannelMediaOptions. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) + */ + virtual int joinChannel(const char* token, + const char* info, + uid_t uid, + const ChannelMediaOptions& options) = 0; + /** Joins the channel with a user account. + + After the user successfully joins the channel, the SDK triggers the following callbacks: + + - The local client: \ref agora::rtc::IChannelEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . + The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IChannelEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + + @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. + If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. + + @param token The token generated at your server: + - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). + - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). + @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: + The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: + - The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) + */ + virtual int joinChannelWithUserAccount(const char* token, + const char* userAccount, + const ChannelMediaOptions& options) = 0; + /** Allows a user to leave a channel, such as hanging up or exiting a call. + + After joining a channel, the user must call the *leaveChannel* method to end the call before joining another channel. + + This method returns 0 if the user leaves the channel and releases all resources related to the call. + + This method call is asynchronous, and the user has not left the channel when the method call returns. Once the user leaves the channel, the SDK triggers the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback. + + A successful \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IChannelEventHandler::onLeaveChannel "onLeaveChannel" + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a BROADCASTER in the Live Broadcast profile. + + @note + - If you call the \ref IChannel::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. + - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IChannel::removePublishStreamUrl "removePublishStreamUrl" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int leaveChannel() = 0; + + /** Publishes the local stream to the channel. + + You must keep the following restrictions in mind when calling this method. Otherwise, the SDK returns the #ERR_REFUSED (5): + - This method publishes one stream only to the channel corresponding to the current `IChannel` object. + - In a Live Broadcast channel, only a broadcaster can call this method. To switch the client role, call \ref agora::rtc::IChannel::setClientRole "setClientRole" of the current `IChannel` object. + - You can publish a stream to only one channel at a time. For details on joining multiple channels, see the advanced guide *Join Multiple Channels*. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_REFUSED (5): The method call is refused. + */ + virtual int publish() = 0; + + /** Stops publishing a stream to the channel. + + If you call this method in a channel where you are not publishing streams, the SDK returns #ERR_REFUSED (5). + + @return + - 0: Success. + - < 0: Failure. + - #ERR_REFUSED (5): The method call is refused. + */ + virtual int unpublish() = 0; + + /** Gets the channel ID of the current `IChannel` object. + + @return + - The channel ID of the current `IChannel` object, if the method call succeeds. + - The empty string "", if the method call fails. + */ + virtual const char *channelId() = 0; + /** Retrieves the current call ID. + + When a user joins a channel on a client, a `callId` is generated to identify the call from the client. + Feedback methods, such as \ref IChannel::rate "rate" and \ref IChannel::complain "complain", must be called after the call ends to submit feedback to the SDK. + + The \ref `rate` and `complain` methods require the `callId` parameter retrieved from the `getCallId` method during a call. `callId` is passed as an argument into the `rate` and `complain` methods after the call ends. + + @param callId The current call ID. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getCallId(agora::util::AString& callId) = 0; + /** Gets a new token when the current token expires after a period of time. + + The `token` expires after a period of time once the token schema is enabled when: + + - The SDK triggers the \ref IChannelEventHandler::onTokenPrivilegeWillExpire "onTokenPrivilegeWillExpire" callback, or + - The \ref IChannelEventHandler::onConnectionStateChanged "onConnectionStateChanged" reports CONNECTION_CHANGED_TOKEN_EXPIRED(9). + + The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. + + @param token Pointer to the new token. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int renewToken(const char* token) = 0; + /** Enables built-in encryption with an encryption password before users join a channel. + + All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. + + If an encryption password is not specified, the encryption functionality will be disabled. + + @note + - Do not use this method for CDN live streaming. + - For optimal transmission, ensure that the encrypted data size does not exceed the original data size + 16 bytes. 16 bytes is the maximum padding size for AES encryption. + + @param secret Pointer to the encryption password. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setEncryptionSecret(const char* secret) = 0; + /** Sets the built-in encryption mode. + + The Agora SDK supports built-in encryption, which is set to the `aes-128-xts` mode by default. Call this method to use other encryption modes. + + All users in the same channel must use the same encryption mode and password. + + Refer to the information related to the AES encryption algorithm on the differences between the encryption modes. + + @note Call the \ref IChannel::setEncryptionSecret "setEncryptionSecret" method to enable the built-in encryption function before calling this method. + + @param encryptionMode The set encryption mode: + - "aes-128-xts": (Default) 128-bit AES encryption, XTS mode. + - "aes-128-ecb": 128-bit AES encryption, ECB mode. + - "aes-256-xts": 256-bit AES encryption, XTS mode. + - "": When encryptionMode is set as NULL, the encryption mode is set as "aes-128-xts" by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setEncryptionMode(const char* encryptionMode) = 0; + /** Registers a packet observer. + + The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. + + @note + - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. + - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. + - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. + + @param observer The registered packet observer. See IPacketObserver. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int registerPacketObserver(IPacketObserver* observer) = 0; + /** Registers the metadata observer. + + Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. + This method enables you to add synchronized metadata in the video stream for more diversified live broadcast interactions, such as sending shopping links, digital coupons, and online quizzes. + + @note + - Call this method before the joinChannel method. + - This method applies to the Live-broadcast channel profile. + + @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. + @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in a live broadcast. + + This method can be used to switch the user role in a live broadcast after the user joins a channel. + + In the Live Broadcast profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IChannel::setClientRole "setClientRole" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IChannelEventHandler::onClientRoleChanged "onClientRoleChanged" + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) + + @note + This method applies only to the Live-broadcast profile. + + @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; + /** Prioritizes a remote user's stream. + + Use this method with the \ref IChannel::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. + If the fallback function is enabled for a subscribed stream, the SDK ensures the high-priority user gets the best possible stream quality. + + @note The Agora SDK supports setting `serPriority` as high for one user only. + + @param uid The ID of the remote user. + @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; + /** Sets the sound position and gain of a remote user. + + When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the + local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, + such as Battle Royale games. + + @note + - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IChannel::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. + - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + + @param uid The ID of the remote user. + @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: + - 0.0: the remote sound comes from the front. + - -1.0: the remote sound comes from the left. + - 1.0: the remote sound comes from the right. + @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). + The smaller the value, the less the gain. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteVoicePosition(int uid, double pan, double gain) = 0; + /** Updates the display mode of the video view of a remote user. + + After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. + This method affects only the video view that the local user sees. + + @note + - Call this method after calling the \ref IChannel::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view. + - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. + + @param userId The ID of the remote user. + @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. + @param mirrorMode + - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. + - **Note**: The SDK disables the mirror mode by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** Stops/Resumes receiving all remote users' audio streams by default. + + @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: + - true: Stops receiving all remote users' audio streams by default. + - false: (Default) Receives all remote users' audio streams by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; + /** Stops/Resumes receiving all remote users' video streams by default. + + @param mute Sets whether to receive/stop receiving all remote users' video streams by default: + - true: Stop receiving all remote users' video streams by default. + - false: (Default) Receive all remote users' video streams by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; + /** Stops/Resumes receiving all remote users' audio streams. + + @param mute Sets whether to receive/stop receiving all remote users' audio streams. + - true: Stops receiving all remote users' audio streams. + - false: (Default) Receives all remote users' audio streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteAllRemoteAudioStreams(bool mute) = 0; + /** Adjust the playback volume of the specified remote user. + + After joining a channel, call \ref agora::rtc::IChannel::adjustPlaybackSignalVolume "adjustPlaybackSignalVolume" to adjust the playback volume of different remote users, + or adjust multiple times for one remote user. + + @note + - Call this method after joining a channel. + - This method adjusts the playback volume, which is the mixed volume for the specified remote user. + - This method can only adjust the playback volume of one specified remote user at a time. If you want to adjust the playback volume of several remote users, + call the method multiple times, once for each remote user. + + @param uid The user ID, which should be the same as the `uid` of \ref agora::rtc::IChannel::joinChannel "joinChannel" + @param volume The playback volume of the voice. The value ranges from 0 to 100: + - 0: Mute. + - 100: Original volume. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustUserPlaybackSignalVolume(uid_t userId, int volume) = 0; + /** Stops/Resumes receiving a specified remote user's audio stream. + + @note If you called the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set `mute` as `true` to stop + receiving all remote users' audio streams, call the m`uteAllRemoteAudioStreams` method and set `mute` as `false` before calling this method. + The `muteAllRemoteAudioStreams` method sets all remote audio streams, while the `muteRemoteAudioStream` method sets a specified remote audio stream. + + @param userId The user ID of the specified remote user sending the audio. + @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: + - true: Stops receiving the specified remote user's audio stream. + - false: (Default) Receives the specified remote user's audio stream. + + @return + - 0: Success. + - < 0: Failure. + + */ + virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; + /** Stops/Resumes receiving all video stream from a specified remote user. + + @param mute Sets whether to receive/stop receiving all remote users' video streams: + - true: Stop receiving all remote users' video streams. + - false: (Default) Receive all remote users' video streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteAllRemoteVideoStreams(bool mute) = 0; + /** Stops/Resumes receiving the video stream from a specified remote user. + + @note If you called the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and + set `mute` as `true` to stop receiving all remote video streams, call the `muteAllRemoteVideoStreams` method and + set `mute` as `false` before calling this method. + + @param userId The user ID of the specified remote user. + @param mute Sets whether to stop/resume receiving the video stream from a specified remote user: + - true: Stop receiving the specified remote user's video stream. + - false: (Default) Receive the specified remote user's video stream. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; + /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. + + This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. + + - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IChannel::enableDualStreamMode "enableDualStreamMode" method, + the SDK receives the high-stream video by default. + - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. + + The method result returns in the \ref agora::rtc::IChannelEventHandler::onApiCallExecuted "onApiCallExecuted" callback. + The SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. + By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, + the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. + + @param userId The ID of the remote user sending the video stream. + @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. + + - If the dual-stream mode is enabled by calling the \ref agora::rtc::IChannel::enableDualStreamMode "enableDualStreamMode" method, + the user receives the high-stream video by default. The `setRemoteDefaultVideoStreamType` method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. + - If the dual-stream mode is not enabled, the user receives the high-stream video by default. + + The result after calling this method is returned in the \ref agora::rtc::IChannelEventHandler::onApiCallExecuted "onApiCallExecuted" callback. + The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. + + @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Creates a data stream. + + Each user can create up to five data streams during the lifecycle of the IChannel. + + @note Set both the `reliable` and `ordered` parameters to `true` or `false`. Do not set one as `true` and the other as `false`. + + @param streamId The ID of the created data stream. + @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: + - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, + an error is reported to the application. + - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for + any delay or missing data stream. + @param ordered Sets whether or not the recipients receive the data stream in the sent order: + - true: The recipients receive the data stream in the sent order. + - false: The recipients do not receive the data stream in the sent order. + + @return + - Returns 0: Success. + - < 0: Failure. + */ + virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; + /** Sends data stream messages to all users in a channel. + + The SDK has the following restrictions on this method: + - Up to 30 packets can be sent per second in a channel with each packet having a maximum size of 1 kB. + - Each client can send up to 6 kB of data per second. + - Each user can have up to five data streams simultaneously. + + A successful \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers + the \ref agora::rtc::IChannelEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + + A failed \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers + the \ref agora::rtc::IChannelEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. + + @note This method applies only to the Communication profile or to the hosts in the Live-broadcast profile. + If an audience in the Live-broadcast profile calls this method, the audience may be switched to a host. + + @param streamId The ID of the sent data stream, returned in the \ref IChannel::createDataStream "createDataStream" method. + @param data The sent data. + @param length The length of the sent data. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int sendStreamMessage(int streamId, const char* data, size_t length) = 0; + /** Publishes the local stream to a specified CDN live RTMP address. (CDN live only.) + + The SDK returns the result of this method call in the \ref IChannelEventHandler::onStreamPublished "onStreamPublished" callback. + + The \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" method call triggers + the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client + to report the state of adding a local stream to the CDN. + + @note + - Ensure that the user joins the channel before calling this method. + - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - This method adds only one stream RTMP URL address each time it is called. + + @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. The RTMP URL address must not contain special characters, such as Chinese language characters. + @param transcodingEnabled Sets whether transcoding is enabled/disabled: + - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. If you set this parameter as `true`, ensure that you call the \ref IChannel::setLiveTranscoding "setLiveTranscoding" method before this method. + - false: Disable transcoding. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (2): The RTMP URL address is NULL or has a string length of 0. + - #ERR_NOT_INITIALIZED (7): You have not initialized `IChannel` when publishing the stream. + */ + virtual int addPublishStreamUrl(const char *url, bool transcodingEnabled) = 0; + /** Removes an RTMP stream from the CDN. + + This method removes the RTMP URL address (added by the \ref IChannel::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. + The SDK returns the result of this method call in the \ref IChannelEventHandler::onStreamUnpublished "onStreamUnpublished" callback. + + The \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method call triggers + the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP stream from the CDN. + + @note + - This method removes only one RTMP URL address each time it is called. + - The RTMP URL address must not contain special characters, such as Chinese language characters. + + @param url The RTMP URL address to be removed. The maximum length of this parameter is 1024 bytes. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int removePublishStreamUrl(const char *url) = 0; + /** Sets the video layout and audio settings for CDN live. (CDN live only.) + + The SDK triggers the \ref agora::rtc::IChannelEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you + call the `setLiveTranscoding` method to update the transcoding setting. + + @note + - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - If you call the `setLiveTranscoding` method to update the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + + @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; + /** Adds a voice or video stream URL address to a live broadcast. + + The \ref IChannelEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. + If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. + This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. + + The \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: + - The local client: + - \ref agora::rtc::IChannelEventHandler::onStreamInjectedStatus "onStreamInjectedStatus" , with the state of the injecting the online stream. + - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. + - The remote client: + - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. + + @note + - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - This method applies to the Native SDK v2.4.1 and later. + + @param url The URL address to be added to the ongoing live broadcast. Valid protocols are RTMP, HLS, and FLV. + - Supported FLV audio codec type: AAC. + - Supported FLV video codec type: H264 (AVC). + @param config The InjectStreamConfig object that contains the configuration of the added voice or video stream. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. + - #ERR_NOT_READY (3): The user is not in the channel. + - #ERR_NOT_SUPPORTED (4): The channel profile is not live broadcast. Call the \ref agora::rtc::IChannel::setChannelProfile "setChannelProfile" method and set the channel profile to live broadcast before calling this method. + - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IChannel object is initialized before calling this method. + */ + virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; + /** Removes the voice or video stream URL address from a live broadcast. + + This method removes the URL address (added by the \ref IChannel::addInjectStreamUrl "addInjectStreamUrl" method) from the live broadcast. + + @note If this method is called successfully, the SDK triggers the \ref IChannelEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. + + @param url Pointer to the URL address of the added stream to be removed. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int removeInjectStreamUrl(const char* url) = 0; + /** Starts to relay media streams across channels. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" and + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callbacks, and these callbacks return the + * state and events of the media stream relay. + * - If the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback returns + * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback returns + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the broadcaster starts + * sending data to the destination channel. + * - If the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback returns + * #RELAY_STATE_FAILURE (3), an exception occurs during the media stream + * relay. + * + * @note + * - Call this method after the \ref joinChannel() "joinChannel" method. + * - This method takes effect only when you are a broadcaster in a + * Live-broadcast channel. + * - After a successful method call, if you want to call this method + * again, ensure that you call the + * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the + * current relay. + * - Contact sales-us@agora.io before implementing this function. + * - We do not support string user accounts in this API. + * + * @param configuration The configuration of the media stream relay: + * ChannelMediaRelayConfiguration. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + /** Updates the channels for media stream relay. After a successful + * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if + * you want to relay the media stream to more channels, or leave the + * current relay channel, you can call the + * \ref updateChannelMediaRelay() "updateChannelMediaRelay" method. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback with the + * #RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL (7) state code. + * + * @note + * Call this method after the + * \ref startChannelMediaRelay() "startChannelMediaRelay" method to update + * the destination channel. + * + * @param configuration The media stream relay configuration: + * ChannelMediaRelayConfiguration. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + /** Stops the media stream relay. + * + * Once the relay stops, the broadcaster quits all the destination + * channels. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback. If the callback returns + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the broadcaster successfully + * stops the relay. + * + * @note + * If the method call fails, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback with the + * #RELAY_ERROR_SERVER_NO_RESPONSE (2) or + * #RELAY_ERROR_SERVER_CONNECTION_LOST (8) state code. You can leave the + * channel by calling the \ref leaveChannel() "leaveChannel" method, and + * the media stream relay automatically stops. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int stopChannelMediaRelay() = 0; + /** Gets the current connection state of the SDK. + + @return #CONNECTION_STATE_TYPE. + */ + virtual CONNECTION_STATE_TYPE getConnectionState() = 0; +}; +/** The IRtcEngine2 class. */ +class IRtcEngine2 : public IRtcEngine +{ +public: + + /** Creates and gets an `IChannel` object. + + To join more than one channel, call this method multiple times to create as many `IChannel` objects as needed, and + call the \ref agora::rtc::IChannel::joinChannel "joinChannel" method of each created `IChannel` object. + + After joining multiple channels, you can simultaneously subscribe to streams of all the channels, but publish a stream in only one channel at one time. + @param channelId The unique channel name for an Agora RTC session. It must be in the string format and not exceed 64 bytes in length. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @note + - This parameter does not have a default value. You must set it. + - Do not set it as the empty string "". Otherwise, the SDK returns #ERR_REFUSED (5). + + @return + - The `IChannel` object, if the method call succeeds. + - An empty pointer NULL, if the method call fails. + - #ERR_REFUSED(5), if you set channelId as the empty string "". + */ + virtual IChannel* createChannel(const char *channelId) = 0; + +}; + + +} +} + + +#endif diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h new file mode 100755 index 0000000..ebc52f3 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h @@ -0,0 +1,7155 @@ +// +// AgoraRtcEngine SDK +// +// Copyright (c) 2019 Agora.io. All rights reserved. +// + +/** + @defgroup createAgoraRtcEngine Create an AgoraRtcEngine + */ + +#ifndef AGORA_RTC_ENGINE_H +#define AGORA_RTC_ENGINE_H +#include "AgoraBase.h" +#include "IAgoraService.h" + +namespace agora { +namespace rtc { + typedef unsigned int uid_t; + typedef void* view_t; +/** Maximum length of the device ID. +*/ +enum MAX_DEVICE_ID_LENGTH_TYPE +{ + /** The maximum length of the device ID is 512 bytes. + */ + MAX_DEVICE_ID_LENGTH = 512 +}; +/** Maximum length of user account. + */ +enum MAX_USER_ACCOUNT_LENGTH_TYPE +{ + /** The maximum length of user account is 255 bytes. + */ + MAX_USER_ACCOUNT_LENGTH = 256 +}; +/** Maximum length of channel ID. + */ +enum MAX_CHANNEL_ID_LENGTH_TYPE +{ + /** The maximum length of channel id is 64 bytes. + */ + MAX_CHANNEL_ID_LENGTH = 65 +}; +/** Formats of the quality report. +*/ +enum QUALITY_REPORT_FORMAT_TYPE +{ + /** 0: The quality report in JSON format, + */ + QUALITY_REPORT_JSON = 0, + /** 1: The quality report in HTML format. + */ + QUALITY_REPORT_HTML = 1, +}; + +enum MEDIA_ENGINE_EVENT_CODE_TYPE +{ + /** 0: For internal use only. + */ + MEDIA_ENGINE_RECORDING_ERROR = 0, + /** 1: For internal use only. + */ + MEDIA_ENGINE_PLAYOUT_ERROR = 1, + /** 2: For internal use only. + */ + MEDIA_ENGINE_RECORDING_WARNING = 2, + /** 3: For internal use only. + */ + MEDIA_ENGINE_PLAYOUT_WARNING = 3, + /** 10: For internal use only. + */ + MEDIA_ENGINE_AUDIO_FILE_MIX_FINISH = 10, + /** 12: For internal use only. + */ + MEDIA_ENGINE_AUDIO_FAREND_MUSIC_BEGINS = 12, + /** 13: For internal use only. + */ + MEDIA_ENGINE_AUDIO_FAREND_MUSIC_ENDS = 13, + /** 14: For internal use only. + */ + MEDIA_ENGINE_LOCAL_AUDIO_RECORD_ENABLED = 14, + /** 15: For internal use only. + */ + MEDIA_ENGINE_LOCAL_AUDIO_RECORD_DISABLED = 15, + // media engine role changed + /** 20: For internal use only. + */ + MEDIA_ENGINE_ROLE_BROADCASTER_SOLO = 20, + /** 21: For internal use only. + */ + MEDIA_ENGINE_ROLE_BROADCASTER_INTERACTIVE = 21, + /** 22: For internal use only. + */ + MEDIA_ENGINE_ROLE_AUDIENCE = 22, + /** 23: For internal use only. + */ + MEDIA_ENGINE_ROLE_COMM_PEER = 23, + /** 24: For internal use only. + */ + MEDIA_ENGINE_ROLE_GAME_PEER = 24, + // iOS adm sample rate changed + /** 110: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ADM_REQUIRE_RESTART = 110, + /** 111: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ADM_SPECIAL_RESTART = 111, + /** 112: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ADM_USING_COMM_PARAMS = 112, + /** 113: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ADM_USING_NORM_PARAMS = 113, + // audio mix state + /** 710: For internal use only. + */ + MEDIA_ENGINE_AUDIO_EVENT_MIXING_PLAY = 710, + /** 711: For internal use only. + */ + MEDIA_ENGINE_AUDIO_EVENT_MIXING_PAUSED = 711, + /** 712: For internal use only. + */ + MEDIA_ENGINE_AUDIO_EVENT_MIXING_RESTART = 712, + /** 713: For internal use only. + */ + MEDIA_ENGINE_AUDIO_EVENT_MIXING_STOPPED = 713, + /** 714: For internal use only. + */ + MEDIA_ENGINE_AUDIO_EVENT_MIXING_ERROR = 714, + //Mixing error codes + /** 701: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ERROR_MIXING_OPEN = 701, + /** 702: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ERROR_MIXING_TOO_FREQUENT = 702, + /** 703: The audio mixing file playback is interrupted. For internal use only. + */ + MEDIA_ENGINE_AUDIO_ERROR_MIXING_INTERRUPTED_EOF = 703, + /** 0: For internal use only. + */ + MEDIA_ENGINE_AUDIO_ERROR_MIXING_NO_ERROR = 0, +}; + +/** The states of the local user's audio mixing file. +*/ +enum AUDIO_MIXING_STATE_TYPE{ + /** 710: The audio mixing file is playing. + */ + AUDIO_MIXING_STATE_PLAYING = 710, + /** 711: The audio mixing file pauses playing. + */ + AUDIO_MIXING_STATE_PAUSED = 711, + /** 713: The audio mixing file stops playing. + */ + AUDIO_MIXING_STATE_STOPPED = 713, + /** 714: An exception occurs when playing the audio mixing file. See #AUDIO_MIXING_ERROR_TYPE. + */ + AUDIO_MIXING_STATE_FAILED = 714, +}; + +/** The error codes of the local user's audio mixing file. +*/ +enum AUDIO_MIXING_ERROR_TYPE{ + /** 701: The SDK cannot open the audio mixing file. + */ + AUDIO_MIXING_ERROR_CAN_NOT_OPEN = 701, + /** 702: The SDK opens the audio mixing file too frequently. + */ + AUDIO_MIXING_ERROR_TOO_FREQUENT_CALL = 702, + /** 703: The audio mixing file playback is interrupted. + */ + AUDIO_MIXING_ERROR_INTERRUPTED_EOF = 703, + /** 0: The SDK can open the audio mixing file. + */ + AUDIO_MIXING_ERROR_OK = 0, +}; + +/** Media device states. + */ +enum MEDIA_DEVICE_STATE_TYPE +{ + /** 1: The device is active. + */ + MEDIA_DEVICE_STATE_ACTIVE = 1, + /** 2: The device is disabled. + */ + MEDIA_DEVICE_STATE_DISABLED = 2, + /** 4: The device is not present. + */ + MEDIA_DEVICE_STATE_NOT_PRESENT = 4, + /** 8: The device is unplugged. + */ + MEDIA_DEVICE_STATE_UNPLUGGED = 8 +}; + +/** Media device types. + */ +enum MEDIA_DEVICE_TYPE +{ + /** -1: Unknown device type. + */ + UNKNOWN_AUDIO_DEVICE = -1, + /** 0: Audio playback device. + */ + AUDIO_PLAYOUT_DEVICE = 0, + /** 1: Audio recording device. + */ + AUDIO_RECORDING_DEVICE = 1, + /** 2: Video renderer. + */ + VIDEO_RENDER_DEVICE = 2, + /** 3: Video capturer. + */ + VIDEO_CAPTURE_DEVICE = 3, + /** 4: Application audio playback device. + */ + AUDIO_APPLICATION_PLAYOUT_DEVICE = 4, +}; + +/** Local video state types + */ +enum LOCAL_VIDEO_STREAM_STATE +{ + /** Initial state */ + LOCAL_VIDEO_STREAM_STATE_STOPPED = 0, + /** The capturer starts successfully. */ + LOCAL_VIDEO_STREAM_STATE_CAPTURING = 1, + /** The first video frame is successfully encoded. */ + LOCAL_VIDEO_STREAM_STATE_ENCODING = 2, + /** The local video fails to start. */ + LOCAL_VIDEO_STREAM_STATE_FAILED = 3 +}; + +/** Local video state error codes + */ +enum LOCAL_VIDEO_STREAM_ERROR { + /** The local video is normal. */ + LOCAL_VIDEO_STREAM_ERROR_OK = 0, + /** No specified reason for the local video failure. */ + LOCAL_VIDEO_STREAM_ERROR_FAILURE = 1, + /** No permission to use the local video capturing device. */ + LOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSION = 2, + /** The local video capturing device is in use. */ + LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY = 3, + /** The local video capture fails. Check whether the capturing device is working properly. */ + LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE = 4, + /** The local video encoding fails. */ + LOCAL_VIDEO_STREAM_ERROR_ENCODE_FAILURE = 5 +}; + +/** Local audio state types. + */ +enum LOCAL_AUDIO_STREAM_STATE +{ + /** 0: The local audio is in the initial state. + */ + LOCAL_AUDIO_STREAM_STATE_STOPPED = 0, + /** 1: The recording device starts successfully. + */ + LOCAL_AUDIO_STREAM_STATE_RECORDING = 1, + /** 2: The first audio frame encodes successfully. + */ + LOCAL_AUDIO_STREAM_STATE_ENCODING = 2, + /** 3: The local audio fails to start. + */ + LOCAL_AUDIO_STREAM_STATE_FAILED = 3 +}; + +/** Local audio state error codes. + */ +enum LOCAL_AUDIO_STREAM_ERROR +{ + /** 0: The local audio is normal. + */ + LOCAL_AUDIO_STREAM_ERROR_OK = 0, + /** 1: No specified reason for the local audio failure. + */ + LOCAL_AUDIO_STREAM_ERROR_FAILURE = 1, + /** 2: No permission to use the local audio device. + */ + LOCAL_AUDIO_STREAM_ERROR_DEVICE_NO_PERMISSION = 2, + /** 3: The microphone is in use. + */ + LOCAL_AUDIO_STREAM_ERROR_DEVICE_BUSY = 3, + /** 4: The local audio recording fails. Check whether the recording device + * is working properly. + */ + LOCAL_AUDIO_STREAM_ERROR_RECORD_FAILURE = 4, + /** 5: The local audio encoding fails. + */ + LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE = 5 +}; + +/** Audio recording qualities. +*/ +enum AUDIO_RECORDING_QUALITY_TYPE +{ + /** 0: Low quality. The sample rate is 32 kHz, and the file size is around + * 1.2 MB after 10 minutes of recording. + */ + AUDIO_RECORDING_QUALITY_LOW = 0, + /** 1: Medium quality. The sample rate is 32 kHz, and the file size is + * around 2 MB after 10 minutes of recording. + */ + AUDIO_RECORDING_QUALITY_MEDIUM = 1, + /** 2: High quality. The sample rate is 32 kHz, and the file size is + * around 3.75 MB after 10 minutes of recording. + */ + AUDIO_RECORDING_QUALITY_HIGH = 2, +}; + +/** Network quality types. */ +enum QUALITY_TYPE +{ + /** 0: The network quality is unknown. */ + QUALITY_UNKNOWN = 0, + /** 1: The network quality is excellent. */ + QUALITY_EXCELLENT = 1, + /** 2: The network quality is quite good, but the bitrate may be slightly lower than excellent. */ + QUALITY_GOOD = 2, + /** 3: Users can feel the communication slightly impaired. */ + QUALITY_POOR = 3, + /** 4: Users cannot communicate smoothly. */ + QUALITY_BAD = 4, + /** 5: The network is so bad that users can barely communicate. */ + QUALITY_VBAD = 5, + /** 6: The network is down and users cannot communicate at all. */ + QUALITY_DOWN = 6, + /** 7: Users cannot detect the network quality. (Not in use.) */ + QUALITY_UNSUPPORTED = 7, + /** 8: Detecting the network quality. */ + QUALITY_DETECTING = 8, +}; + +/** Video display modes. */ +enum RENDER_MODE_TYPE +{ + /** +1: Uniformly scale the video until it fills the visible boundaries (cropped). One dimension of the video may have clipped contents. + */ + RENDER_MODE_HIDDEN = 1, + /** +2: Uniformly scale the video until one of its dimension fits the boundary (zoomed to fit). Areas that are not filled due to disparity in the aspect ratio are filled with black. + */ + RENDER_MODE_FIT = 2, + /** **DEPRECATED** 3: This mode is deprecated. + */ + RENDER_MODE_ADAPTIVE = 3, +}; + +/** Video mirror modes. */ +enum VIDEO_MIRROR_MODE_TYPE +{ + /** 0: (Default) The SDK enables the mirror mode. + */ + VIDEO_MIRROR_MODE_AUTO = 0,//determined by SDK + /** 1: Enable mirror mode. */ + VIDEO_MIRROR_MODE_ENABLED = 1,//enabled mirror + /** 2: Disable mirror mode. */ + VIDEO_MIRROR_MODE_DISABLED = 2,//disable mirror +}; + +/** **DEPRECATED** Video profiles. */ +enum VIDEO_PROFILE_TYPE +{ + /** 0: 160 × 120, frame rate 15 fps, bitrate 65 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_120P = 0, + /** 2: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_120P_3 = 2, + /** 10: 320×180, frame rate 15 fps, bitrate 140 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_180P = 10, + /** 12: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_180P_3 = 12, + /** 13: 240 × 180, frame rate 15 fps, bitrate 120 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_180P_4 = 13, + /** 20: 320 × 240, frame rate 15 fps, bitrate 200 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_240P = 20, + /** 22: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_240P_3 = 22, + /** 23: 424 × 240, frame rate 15 fps, bitrate 220 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_240P_4 = 23, + /** 30: 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_360P = 30, + /** 32: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_360P_3 = 32, + /** 33: 640 × 360, frame rate 30 fps, bitrate 600 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_360P_4 = 33, + /** 35: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_360P_6 = 35, + /** 36: 480 × 360, frame rate 15 fps, bitrate 320 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_360P_7 = 36, + /** 37: 480 × 360, frame rate 30 fps, bitrate 490 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_360P_8 = 37, + /** 38: 640 × 360, frame rate 15 fps, bitrate 800 Kbps. + @note Live broadcast profile only. + */ + VIDEO_PROFILE_LANDSCAPE_360P_9 = 38, + /** 39: 640 × 360, frame rate 24 fps, bitrate 800 Kbps. + @note Live broadcast profile only. + */ + VIDEO_PROFILE_LANDSCAPE_360P_10 = 39, + /** 100: 640 × 360, frame rate 24 fps, bitrate 1000 Kbps. + @note Live broadcast profile only. + */ + VIDEO_PROFILE_LANDSCAPE_360P_11 = 100, + /** 40: 640 × 480, frame rate 15 fps, bitrate 500 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P = 40, + /** 42: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P_3 = 42, + /** 43: 640 × 480, frame rate 30 fps, bitrate 750 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P_4 = 43, + /** 45: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P_6 = 45, + /** 47: 848 × 480, frame rate 15 fps, bitrate 610 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P_8 = 47, + /** 48: 848 × 480, frame rate 30 fps, bitrate 930 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P_9 = 48, + /** 49: 640 × 480, frame rate 10 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_480P_10 = 49, + /** 50: 1280 × 720, frame rate 15 fps, bitrate 1130 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_720P = 50, + /** 52: 1280 × 720, frame rate 30 fps, bitrate 1710 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_720P_3 = 52, + /** 54: 960 × 720, frame rate 15 fps, bitrate 910 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_720P_5 = 54, + /** 55: 960 × 720, frame rate 30 fps, bitrate 1380 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_720P_6 = 55, + /** 60: 1920 × 1080, frame rate 15 fps, bitrate 2080 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_1080P = 60, + /** 62: 1920 × 1080, frame rate 30 fps, bitrate 3150 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_1080P_3 = 62, + /** 64: 1920 × 1080, frame rate 60 fps, bitrate 4780 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_1080P_5 = 64, + /** 66: 2560 × 1440, frame rate 30 fps, bitrate 4850 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_1440P = 66, + /** 67: 2560 × 1440, frame rate 60 fps, bitrate 6500 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_1440P_2 = 67, + /** 70: 3840 × 2160, frame rate 30 fps, bitrate 6500 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_4K = 70, + /** 72: 3840 × 2160, frame rate 60 fps, bitrate 6500 Kbps. */ + VIDEO_PROFILE_LANDSCAPE_4K_3 = 72, + /** 1000: 120 × 160, frame rate 15 fps, bitrate 65 Kbps. */ + VIDEO_PROFILE_PORTRAIT_120P = 1000, + /** 1002: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ + VIDEO_PROFILE_PORTRAIT_120P_3 = 1002, + /** 1010: 180 × 320, frame rate 15 fps, bitrate 140 Kbps. */ + VIDEO_PROFILE_PORTRAIT_180P = 1010, + /** 1012: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ + VIDEO_PROFILE_PORTRAIT_180P_3 = 1012, + /** 1013: 180 × 240, frame rate 15 fps, bitrate 120 Kbps. */ + VIDEO_PROFILE_PORTRAIT_180P_4 = 1013, + /** 1020: 240 × 320, frame rate 15 fps, bitrate 200 Kbps. */ + VIDEO_PROFILE_PORTRAIT_240P = 1020, + /** 1022: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ + VIDEO_PROFILE_PORTRAIT_240P_3 = 1022, + /** 1023: 240 × 424, frame rate 15 fps, bitrate 220 Kbps. */ + VIDEO_PROFILE_PORTRAIT_240P_4 = 1023, + /** 1030: 360 × 640, frame rate 15 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_PORTRAIT_360P = 1030, + /** 1032: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ + VIDEO_PROFILE_PORTRAIT_360P_3 = 1032, + /** 1033: 360 × 640, frame rate 30 fps, bitrate 600 Kbps. */ + VIDEO_PROFILE_PORTRAIT_360P_4 = 1033, + /** 1035: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_PORTRAIT_360P_6 = 1035, + /** 1036: 360 × 480, frame rate 15 fps, bitrate 320 Kbps. */ + VIDEO_PROFILE_PORTRAIT_360P_7 = 1036, + /** 1037: 360 × 480, frame rate 30 fps, bitrate 490 Kbps. */ + VIDEO_PROFILE_PORTRAIT_360P_8 = 1037, + /** 1038: 360 × 640, frame rate 15 fps, bitrate 800 Kbps. + @note Live broadcast profile only. + */ + VIDEO_PROFILE_PORTRAIT_360P_9 = 1038, + /** 1039: 360 × 640, frame rate 24 fps, bitrate 800 Kbps. + @note Live broadcast profile only. + */ + VIDEO_PROFILE_PORTRAIT_360P_10 = 1039, + /** 1100: 360 × 640, frame rate 24 fps, bitrate 1000 Kbps. + @note Live broadcast profile only. + */ + VIDEO_PROFILE_PORTRAIT_360P_11 = 1100, + /** 1040: 480 × 640, frame rate 15 fps, bitrate 500 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P = 1040, + /** 1042: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P_3 = 1042, + /** 1043: 480 × 640, frame rate 30 fps, bitrate 750 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P_4 = 1043, + /** 1045: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P_6 = 1045, + /** 1047: 480 × 848, frame rate 15 fps, bitrate 610 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P_8 = 1047, + /** 1048: 480 × 848, frame rate 30 fps, bitrate 930 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P_9 = 1048, + /** 1049: 480 × 640, frame rate 10 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_PORTRAIT_480P_10 = 1049, + /** 1050: 720 × 1280, frame rate 15 fps, bitrate 1130 Kbps. */ + VIDEO_PROFILE_PORTRAIT_720P = 1050, + /** 1052: 720 × 1280, frame rate 30 fps, bitrate 1710 Kbps. */ + VIDEO_PROFILE_PORTRAIT_720P_3 = 1052, + /** 1054: 720 × 960, frame rate 15 fps, bitrate 910 Kbps. */ + VIDEO_PROFILE_PORTRAIT_720P_5 = 1054, + /** 1055: 720 × 960, frame rate 30 fps, bitrate 1380 Kbps. */ + VIDEO_PROFILE_PORTRAIT_720P_6 = 1055, + /** 1060: 1080 × 1920, frame rate 15 fps, bitrate 2080 Kbps. */ + VIDEO_PROFILE_PORTRAIT_1080P = 1060, + /** 1062: 1080 × 1920, frame rate 30 fps, bitrate 3150 Kbps. */ + VIDEO_PROFILE_PORTRAIT_1080P_3 = 1062, + /** 1064: 1080 × 1920, frame rate 60 fps, bitrate 4780 Kbps. */ + VIDEO_PROFILE_PORTRAIT_1080P_5 = 1064, + /** 1066: 1440 × 2560, frame rate 30 fps, bitrate 4850 Kbps. */ + VIDEO_PROFILE_PORTRAIT_1440P = 1066, + /** 1067: 1440 × 2560, frame rate 60 fps, bitrate 6500 Kbps. */ + VIDEO_PROFILE_PORTRAIT_1440P_2 = 1067, + /** 1070: 2160 × 3840, frame rate 30 fps, bitrate 6500 Kbps. */ + VIDEO_PROFILE_PORTRAIT_4K = 1070, + /** 1072: 2160 × 3840, frame rate 60 fps, bitrate 6500 Kbps. */ + VIDEO_PROFILE_PORTRAIT_4K_3 = 1072, + /** Default 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ + VIDEO_PROFILE_DEFAULT = VIDEO_PROFILE_LANDSCAPE_360P, +}; + +/** Audio profiles. + +Sets the sample rate, bitrate, encoding mode, and the number of channels:*/ +enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music codec +{ + /** + 0: Default audio profile. + + - In the Communication profile, the default value is #AUDIO_PROFILE_SPEECH_STANDARD; + - In the Live-broadcast profile, the default value is #AUDIO_PROFILE_MUSIC_STANDARD. + */ + AUDIO_PROFILE_DEFAULT = 0, // use default settings + /** + 1: A sample rate of 32 KHz, audio encoding, mono, and a bitrate of up to 18 Kbps. + */ + AUDIO_PROFILE_SPEECH_STANDARD = 1, // 32Khz, 18Kbps, mono, speech + /** + 2: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 48 Kbps. + */ + AUDIO_PROFILE_MUSIC_STANDARD = 2, // 48Khz, 48Kbps, mono, music + /** + 3: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 56 Kbps. + */ + AUDIO_PROFILE_MUSIC_STANDARD_STEREO = 3, // 48Khz, 56Kbps, stereo, music + /** + 4: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 128 Kbps. + */ + AUDIO_PROFILE_MUSIC_HIGH_QUALITY = 4, // 48Khz, 128Kbps, mono, music + /** + 5: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 192 Kbps. + */ + AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO = 5, // 48Khz, 192Kbps, stereo, music + /** + 6: A sample rate of 16 KHz, audio encoding, mono, and Acoustic Echo Cancellation (AES) enabled. + */ + AUDIO_PROFILE_IOT = 6, + AUDIO_PROFILE_NUM = 7, +}; + +/** Audio application scenarios. +*/ +enum AUDIO_SCENARIO_TYPE // set a suitable scenario for your app type +{ + /** 0: Default. */ + AUDIO_SCENARIO_DEFAULT = 0, + /** 1: Entertainment scenario, supporting voice during gameplay. */ + AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT = 1, + /** 2: Education scenario, prioritizing smoothness and stability. */ + AUDIO_SCENARIO_EDUCATION = 2, + /** 3: Live gaming scenario, enabling the gaming audio effects in the speaker mode in a live broadcast scenario. Choose this scenario for high-fidelity music playback. */ + AUDIO_SCENARIO_GAME_STREAMING = 3, + /** 4: Showroom scenario, optimizing the audio quality with external professional equipment. */ + AUDIO_SCENARIO_SHOWROOM = 4, + /** 5: Gaming scenario. */ + AUDIO_SCENARIO_CHATROOM_GAMING = 5, + /** 6: Applicable to the IoT scenario. */ + AUDIO_SCENARIO_IOT = 6, + AUDIO_SCENARIO_NUM = 7, +}; + + /** The channel profile of the Agora RtcEngine. + */ +enum CHANNEL_PROFILE_TYPE +{ + /** (Default) The Communication profile. Use this profile in one-on-one calls or group calls, where all users can talk freely. + */ + CHANNEL_PROFILE_COMMUNICATION = 0, + /** The Live-Broadcast profile. Users in a live-broadcast channel have a role as either broadcaster or audience. + A broadcaster can both send and receive streams; an audience can only receive streams. + */ + CHANNEL_PROFILE_LIVE_BROADCASTING = 1, + /** 2: The Gaming profile. This profile uses a codec with a lower bitrate and consumes less power. Applies to the gaming scenario, where all game players can talk freely. + */ + CHANNEL_PROFILE_GAME = 2, +}; + +/** Client roles in a live broadcast. */ +enum CLIENT_ROLE_TYPE +{ + /** 1: Host */ + CLIENT_ROLE_BROADCASTER = 1, + /** 2: Audience */ + CLIENT_ROLE_AUDIENCE = 2, +}; + +/** Reasons for a user being offline. */ +enum USER_OFFLINE_REASON_TYPE +{ + /** 0: The user quits the call. */ + USER_OFFLINE_QUIT = 0, + /** 1: The SDK times out and the user drops offline because no data packet is received within a certain period of time. If the user quits the call and the message is not passed to the SDK (due to an unreliable channel), the SDK assumes the user dropped offline. */ + USER_OFFLINE_DROPPED = 1, + /** 2: (Live broadcast only.) The client role switched from the host to the audience. */ + USER_OFFLINE_BECOME_AUDIENCE = 2, +}; +/** + States of the RTMP streaming. + */ +enum RTMP_STREAM_PUBLISH_STATE +{ + /** The RTMP streaming has not started or has ended. This state is also triggered after you remove an RTMP address from the CDN by calling removePublishStreamUrl. + */ + RTMP_STREAM_PUBLISH_STATE_IDLE = 0, + /** The SDK is connecting to Agora's streaming server and the RTMP server. This state is triggered after you call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. + */ + RTMP_STREAM_PUBLISH_STATE_CONNECTING = 1, + /** The RTMP streaming publishes. The SDK successfully publishes the RTMP streaming and returns this state. + */ + RTMP_STREAM_PUBLISH_STATE_RUNNING = 2, + /** The RTMP streaming is recovering. When exceptions occur to the CDN, or the streaming is interrupted, the SDK tries to resume RTMP streaming and returns this state. + + - If the SDK successfully resumes the streaming, #RTMP_STREAM_PUBLISH_STATE_RUNNING (2) returns. + - If the streaming does not resume within 60 seconds or server errors occur, #RTMP_STREAM_PUBLISH_STATE_FAILURE (4) returns. You can also reconnect to the server by calling the \ref IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" and \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" methods. + */ + RTMP_STREAM_PUBLISH_STATE_RECOVERING = 3, + /** The RTMP streaming fails. See the errCode parameter for the detailed error information. You can also call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method to publish the RTMP streaming again. + */ + RTMP_STREAM_PUBLISH_STATE_FAILURE = 4, +}; + +/** + Error codes of the RTMP streaming. + */ +enum RTMP_STREAM_PUBLISH_ERROR +{ + /** The RTMP streaming publishes successfully. */ + RTMP_STREAM_PUBLISH_ERROR_OK = 0, + /** Invalid argument used. If, for example, you do not call the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method to configure the LiveTranscoding parameters before calling the addPublishStreamUrl method, the SDK returns this error. Check whether you set the parameters in the *setLiveTranscoding* method properly. */ + RTMP_STREAM_PUBLISH_ERROR_INVALID_ARGUMENT = 1, + /** The RTMP streaming is encrypted and cannot be published. */ + RTMP_STREAM_PUBLISH_ERROR_ENCRYPTED_STREAM_NOT_ALLOWED = 2, + /** Timeout for the RTMP streaming. Call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method to publish the streaming again. */ + RTMP_STREAM_PUBLISH_ERROR_CONNECTION_TIMEOUT = 3, + /** An error occurs in Agora's streaming server. Call the addPublishStreamUrl method to publish the streaming again. */ + RTMP_STREAM_PUBLISH_ERROR_INTERNAL_SERVER_ERROR = 4, + /** An error occurs in the RTMP server. */ + RTMP_STREAM_PUBLISH_ERROR_RTMP_SERVER_ERROR = 5, + /** The RTMP streaming publishes too frequently. */ + RTMP_STREAM_PUBLISH_ERROR_TOO_OFTEN = 6, + /** The host publishes more than 10 URLs. Delete the unnecessary URLs before adding new ones. */ + RTMP_STREAM_PUBLISH_ERROR_REACH_LIMIT = 7, + /** The host manipulates other hosts' URLs. Check your app logic. */ + RTMP_STREAM_PUBLISH_ERROR_NOT_AUTHORIZED = 8, + /** Agora's server fails to find the RTMP streaming. */ + RTMP_STREAM_PUBLISH_ERROR_STREAM_NOT_FOUND = 9, + /** The format of the RTMP streaming URL is not supported. Check whether the URL format is correct. */ + RTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTED = 10, +}; + +/** States of importing an external video stream in a live broadcast. */ +enum INJECT_STREAM_STATUS +{ + /** 0: The external video stream imported successfully. */ + INJECT_STREAM_STATUS_START_SUCCESS = 0, + /** 1: The external video stream already exists. */ + INJECT_STREAM_STATUS_START_ALREADY_EXISTS = 1, + /** 2: The external video stream to be imported is unauthorized. */ + INJECT_STREAM_STATUS_START_UNAUTHORIZED = 2, + /** 3: Import external video stream timeout. */ + INJECT_STREAM_STATUS_START_TIMEDOUT = 3, + /** 4: Import external video stream failed. */ + INJECT_STREAM_STATUS_START_FAILED = 4, + /** 5: The external video stream stopped importing successfully. */ + INJECT_STREAM_STATUS_STOP_SUCCESS = 5, + /** 6: No external video stream is found. */ + INJECT_STREAM_STATUS_STOP_NOT_FOUND = 6, + /** 7: The external video stream to be stopped importing is unauthorized. */ + INJECT_STREAM_STATUS_STOP_UNAUTHORIZED = 7, + /** 8: Stop importing external video stream timeout. */ + INJECT_STREAM_STATUS_STOP_TIMEDOUT = 8, + /** 9: Stop importing external video stream failed. */ + INJECT_STREAM_STATUS_STOP_FAILED = 9, + /** 10: The external video stream is corrupted. */ + INJECT_STREAM_STATUS_BROKEN = 10, +}; +/** Remote video stream types. */ +enum REMOTE_VIDEO_STREAM_TYPE +{ + /** 0: High-stream video. */ + REMOTE_VIDEO_STREAM_HIGH = 0, + /** 1: Low-stream video. */ + REMOTE_VIDEO_STREAM_LOW = 1, +}; + +/** Use modes of the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. */ +enum RAW_AUDIO_FRAME_OP_MODE_TYPE +{ + /** 0: Read-only mode: Users only read the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data without modifying anything. For example, when users acquire the data with the Agora SDK, then push the RTMP streams. */ + RAW_AUDIO_FRAME_OP_MODE_READ_ONLY = 0, + /** 1: Write-only mode: Users replace the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data with their own data and pass the data to the SDK for encoding. For example, when users acquire the data. */ + RAW_AUDIO_FRAME_OP_MODE_WRITE_ONLY = 1, + /** 2: Read and write mode: Users read the data from \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame", modify it, and then play it. For example, when users have their own sound-effect processing module and perform some voice pre-processing, such as a voice change. */ + RAW_AUDIO_FRAME_OP_MODE_READ_WRITE = 2, +}; + +/** Audio-sample rates. */ +enum AUDIO_SAMPLE_RATE_TYPE +{ + /** 32000: 32 kHz */ + AUDIO_SAMPLE_RATE_32000 = 32000, + /** 44100: 44.1 kHz */ + AUDIO_SAMPLE_RATE_44100 = 44100, + /** 48000: 48 kHz */ + AUDIO_SAMPLE_RATE_48000 = 48000, +}; + +/** Video codec profile types. */ +enum VIDEO_CODEC_PROFILE_TYPE +{ /** 66: Baseline video codec profile. Generally used in video calls on mobile phones. */ + VIDEO_CODEC_PROFILE_BASELINE = 66, + /** 77: Main video codec profile. Generally used in mainstream electronics such as MP4 players, portable video players, PSP, and iPads. */ + VIDEO_CODEC_PROFILE_MAIN = 77, + /** 100: (Default) High video codec profile. Generally used in high-resolution broadcasts or television. */ + VIDEO_CODEC_PROFILE_HIGH = 100, +}; + +/** Video codec types */ +enum VIDEO_CODEC_TYPE { + /** Standard VP8 */ + VIDEO_CODEC_VP8 = 1, + /** Standard H264 */ + VIDEO_CODEC_H264 = 2, + /** Enhanced VP8 */ + VIDEO_CODEC_EVP = 3, + /** Enhanced H264 */ + VIDEO_CODEC_E264 = 4, +}; + +/** Audio equalization band frequencies. */ +enum AUDIO_EQUALIZATION_BAND_FREQUENCY +{ + /** 0: 31 Hz */ + AUDIO_EQUALIZATION_BAND_31 = 0, + /** 1: 62 Hz */ + AUDIO_EQUALIZATION_BAND_62 = 1, + /** 2: 125 Hz */ + AUDIO_EQUALIZATION_BAND_125 = 2, + /** 3: 250 Hz */ + AUDIO_EQUALIZATION_BAND_250 = 3, + /** 4: 500 Hz */ + AUDIO_EQUALIZATION_BAND_500 = 4, + /** 5: 1 kHz */ + AUDIO_EQUALIZATION_BAND_1K = 5, + /** 6: 2 kHz */ + AUDIO_EQUALIZATION_BAND_2K = 6, + /** 7: 4 kHz */ + AUDIO_EQUALIZATION_BAND_4K = 7, + /** 8: 8 kHz */ + AUDIO_EQUALIZATION_BAND_8K = 8, + /** 9: 16 kHz */ + AUDIO_EQUALIZATION_BAND_16K = 9, +}; + +/** Audio reverberation types. */ +enum AUDIO_REVERB_TYPE +{ + /** 0: The level of the dry signal (db). The value is between -20 and 10. */ + AUDIO_REVERB_DRY_LEVEL = 0, // (dB, [-20,10]), the level of the dry signal + /** 1: The level of the early reflection signal (wet signal) (dB). The value is between -20 and 10. */ + AUDIO_REVERB_WET_LEVEL = 1, // (dB, [-20,10]), the level of the early reflection signal (wet signal) + /** 2: The room size of the reflection. The value is between 0 and 100. */ + AUDIO_REVERB_ROOM_SIZE = 2, // ([0,100]), the room size of the reflection + /** 3: The length of the initial delay of the wet signal (ms). The value is between 0 and 200. */ + AUDIO_REVERB_WET_DELAY = 3, // (ms, [0,200]), the length of the initial delay of the wet signal in ms + /** 4: The reverberation strength. The value is between 0 and 100. */ + AUDIO_REVERB_STRENGTH = 4, // ([0,100]), the strength of the reverberation +}; + +/** Local voice changer options. */ +enum VOICE_CHANGER_PRESET { + /** 0: The original voice (no local voice change). + */ + VOICE_CHANGER_OFF = 0, //Turn off the voice changer + /** 1: An old man's voice. + */ + VOICE_CHANGER_OLDMAN = 1, + /** 2: A little boy's voice. + */ + VOICE_CHANGER_BABYBOY = 2, + /** 3: A little girl's voice. + */ + VOICE_CHANGER_BABYGIRL = 3, + /** 4: The voice of a growling bear. + */ + VOICE_CHANGER_ZHUBAJIE = 4, + /** 5: Ethereal vocal effects. + */ + VOICE_CHANGER_ETHEREAL = 5, + /** 6: Hulk's voice. + */ + VOICE_CHANGER_HULK = 6 +}; + +/** Local voice reverberation presets. */ +enum AUDIO_REVERB_PRESET { + /** 0: The original voice (no local voice reverberation). + */ + AUDIO_REVERB_OFF = 0, // Turn off audio reverb + /** 1: Pop music. + */ + AUDIO_REVERB_POPULAR = 1, + /** 2: R&B. + */ + AUDIO_REVERB_RNB = 2, + /** 3: Rock music. + */ + AUDIO_REVERB_ROCK = 3, + /** 4: Hip-hop. + */ + AUDIO_REVERB_HIPHOP = 4, + /** 5: Pop concert. + */ + AUDIO_REVERB_VOCAL_CONCERT = 5, + /** 6: Karaoke. + */ + AUDIO_REVERB_KTV = 6, + /** 7: Recording studio. + */ + AUDIO_REVERB_STUDIO = 7 +}; +/** Audio codec profile types. The default value is LC_ACC. */ +enum AUDIO_CODEC_PROFILE_TYPE +{ + /** 0: LC-AAC, which is the low-complexity audio codec type. */ + AUDIO_CODEC_PROFILE_LC_AAC = 0, + /** 1: HE-AAC, which is the high-efficiency audio codec type. */ + AUDIO_CODEC_PROFILE_HE_AAC = 1, +}; + +/** Remote audio states. + */ +enum REMOTE_AUDIO_STATE +{ + /** 0: The remote audio is in the default state, probably due to + * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), + * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or + * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). + */ + REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream + /** 1: The first remote audio packet is received. + */ + REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received + /** 2: The remote audio stream is decoded and plays normally, probably + * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), + * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or + * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). + */ + REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends + /** 3: The remote audio is frozen, probably due to + * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). + */ + REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue + /** 4: The remote audio fails to start, probably due to + * #REMOTE_AUDIO_REASON_INTERNAL (0). + */ + REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed +}; + +/** Remote audio state reasons. + */ +enum REMOTE_AUDIO_STATE_REASON +{ + /** 0: Internal reasons. + */ + REMOTE_AUDIO_REASON_INTERNAL = 0, + /** 1: Network congestion. + */ + REMOTE_AUDIO_REASON_NETWORK_CONGESTION = 1, + /** 2: Network recovery. + */ + REMOTE_AUDIO_REASON_NETWORK_RECOVERY = 2, + /** 3: The local user stops receiving the remote audio stream or + * disables the audio module. + */ + REMOTE_AUDIO_REASON_LOCAL_MUTED = 3, + /** 4: The local user resumes receiving the remote audio stream or + * enables the audio module. + */ + REMOTE_AUDIO_REASON_LOCAL_UNMUTED = 4, + /** 5: The remote user stops sending the audio stream or disables the + * audio module. + */ + REMOTE_AUDIO_REASON_REMOTE_MUTED = 5, + /** 6: The remote user resumes sending the audio stream or enables the + * audio module. + */ + REMOTE_AUDIO_REASON_REMOTE_UNMUTED = 6, + /** 7: The remote user leaves the channel. + */ + REMOTE_AUDIO_REASON_REMOTE_OFFLINE = 7, +}; + +/** Remote video states. */ +// enum REMOTE_VIDEO_STATE +// { +// // REMOTE_VIDEO_STATE_STOPPED is not used at this version. Ignore this value. +// // REMOTE_VIDEO_STATE_STOPPED = 0, // Default state, video is started or remote user disabled/muted video stream +// /** 1: The remote video is playing. */ +// REMOTE_VIDEO_STATE_RUNNING = 1, // Running state, remote video can be displayed normally +// /** 2: The remote video is frozen. */ +// REMOTE_VIDEO_STATE_FROZEN = 2, // Remote video is frozen, probably due to network issue. +// }; + +/** The state of the remote video. */ +enum REMOTE_VIDEO_STATE { + /** 0: The remote video is in the default state, probably due to #REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED (3), #REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED (5), or #REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE (7). + */ + REMOTE_VIDEO_STATE_STOPPED = 0, + + /** 1: The first remote video packet is received. + */ + REMOTE_VIDEO_STATE_STARTING = 1, + + /** 2: The remote video stream is decoded and plays normally, probably due to #REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY (2), #REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED (4), #REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED (6), or #REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY (9). + */ + REMOTE_VIDEO_STATE_DECODING = 2, + + /** 3: The remote video is frozen, probably due to #REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION (1) or #REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK (8). + */ + REMOTE_VIDEO_STATE_FROZEN = 3, + + /** 4: The remote video fails to start, probably due to #REMOTE_VIDEO_STATE_REASON_INTERNAL (0). + */ + REMOTE_VIDEO_STATE_FAILED = 4 +}; + +/** The reason of the remote video state change. */ +enum REMOTE_VIDEO_STATE_REASON { + /** 0: Internal reasons. + */ + REMOTE_VIDEO_STATE_REASON_INTERNAL = 0, + + /** 1: Network congestion. + */ + REMOTE_VIDEO_STATE_REASON_NETWORK_CONGESTION = 1, + + /** 2: Network recovery. + */ + REMOTE_VIDEO_STATE_REASON_NETWORK_RECOVERY = 2, + + /** 3: The local user stops receiving the remote video stream or disables the video module. + */ + REMOTE_VIDEO_STATE_REASON_LOCAL_MUTED = 3, + + /** 4: The local user resumes receiving the remote video stream or enables the video module. + */ + REMOTE_VIDEO_STATE_REASON_LOCAL_UNMUTED = 4, + + /** 5: The remote user stops sending the video stream or disables the video module. + */ + REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED = 5, + + /** 6: The remote user resumes sending the video stream or enables the video module. + */ + REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED = 6, + + /** 7: The remote user leaves the channel. + */ + REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE = 7, + + /** 8: The remote media stream falls back to the audio-only stream due to poor network conditions. + */ + REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK = 8, + + /** 9: The remote media stream switches back to the video stream after the network conditions improve. + */ + REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY = 9 + +}; + +/** Video frame rates. */ +enum FRAME_RATE +{ + /** 1: 1 fps */ + FRAME_RATE_FPS_1 = 1, + /** 7: 7 fps */ + FRAME_RATE_FPS_7 = 7, + /** 10: 10 fps */ + FRAME_RATE_FPS_10 = 10, + /** 15: 15 fps */ + FRAME_RATE_FPS_15 = 15, + /** 24: 24 fps */ + FRAME_RATE_FPS_24 = 24, + /** 30: 30 fps */ + FRAME_RATE_FPS_30 = 30, + /** 60: 60 fps (Windows and macOS only) */ + FRAME_RATE_FPS_60 = 60, +}; + +/** Video output orientation modes. + */ +enum ORIENTATION_MODE { + /** 0: (Default) Adaptive mode. + + The video encoder adapts to the orientation mode of the video input device. + + - If the width of the captured video from the SDK is greater than the height, the encoder sends the video in landscape mode. The encoder also sends the rotational information of the video, and the receiver uses the rotational information to rotate the received video. + - When you use a custom video source, the output video from the encoder inherits the orientation of the original video. If the original video is in portrait mode, the output video from the encoder is also in portrait mode. The encoder also sends the rotational information of the video to the receiver. + */ + ORIENTATION_MODE_ADAPTIVE = 0, + /** 1: Landscape mode. + + The video encoder always sends the video in landscape mode. The video encoder rotates the original video before sending it and the rotational infomation is 0. This mode applies to scenarios involving CDN live streaming. + */ + ORIENTATION_MODE_FIXED_LANDSCAPE = 1, + /** 2: Portrait mode. + + The video encoder always sends the video in portrait mode. The video encoder rotates the original video before sending it and the rotational infomation is 0. This mode applies to scenarios involving CDN live streaming. + */ + ORIENTATION_MODE_FIXED_PORTRAIT = 2, +}; + +/** Video degradation preferences when the bandwidth is a constraint. */ +enum DEGRADATION_PREFERENCE { + /** 0: (Default) Degrade the frame rate in order to maintain the video quality. */ + MAINTAIN_QUALITY = 0, + /** 1: Degrade the video quality in order to maintain the frame rate. */ + MAINTAIN_FRAMERATE = 1, + /** 2: (For future use) Maintain a balance between the frame rate and video quality. */ + MAINTAIN_BALANCED = 2, +}; + +/** Stream fallback options. */ +enum STREAM_FALLBACK_OPTIONS +{ + /** 0: No fallback behavior for the local/remote video stream when the uplink/downlink network conditions are poor. The quality of the stream is not guaranteed. */ + STREAM_FALLBACK_OPTION_DISABLED = 0, + /** 1: Under poor downlink network conditions, the remote video stream, to which you subscribe, falls back to the low-stream (low resolution and low bitrate) video. You can set this option only in the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. Nothing happens when you set this in the \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" method. */ + STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW = 1, + /** 2: Under poor uplink network conditions, the locally published video stream falls back to audio only. + + Under poor downlink network conditions, the remote video stream, to which you subscribe, first falls back to the low-stream (low resolution and low bitrate) video; and then to an audio-only stream if the network conditions worsen.*/ + STREAM_FALLBACK_OPTION_AUDIO_ONLY = 2, +}; + + /** Camera capturer configuration. + */ + enum CAPTURER_OUTPUT_PREFERENCE + { + /** 0: (Default) self-adapts the camera output parameters to the system performance and network conditions to balance CPU consumption and video preview quality. + */ + CAPTURER_OUTPUT_PREFERENCE_AUTO = 0, + /** 1: Prioritizes the system performance. The SDK chooses the dimension and frame rate of the local camera capture closest to those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". + */ + CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1, + /** 2: Prioritizes the local preview quality. The SDK chooses higher camera output parameters to improve the local video preview quality. This option requires extra CPU and RAM usage for video pre-processing. + */ + CAPTURER_OUTPUT_PREFERENCE_PREVIEW = 2, + }; + +/** The priority of the remote user. + */ +enum PRIORITY_TYPE +{ + /** 50: The user's priority is high. + */ + PRIORITY_HIGH = 50, + /** 100: (Default) The user's priority is normal. + */ + PRIORITY_NORMAL = 100, +}; + +/** Connection states. */ +enum CONNECTION_STATE_TYPE +{ + /** 1: The SDK is disconnected from Agora's edge server. + + - This is the initial state before calling the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. + - The SDK also enters this state when the application calls the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + */ + CONNECTION_STATE_DISCONNECTED = 1, + /** 2: The SDK is connecting to Agora's edge server. + + - When the application calls the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method, the SDK starts to establish a connection to the specified channel, triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback, and switches to the #CONNECTION_STATE_CONNECTING state. + - When the SDK successfully joins the channel, it triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback and switches to the #CONNECTION_STATE_CONNECTED state. + - After the SDK joins the channel and when it finishes initializing the media engine, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. + */ + CONNECTION_STATE_CONNECTING = 2, + /** 3: The SDK is connected to Agora's edge server and has joined a channel. You can now publish or subscribe to a media stream in the channel. + + If the connection to the channel is lost because, for example, if the network is down or switched, the SDK automatically tries to reconnect and triggers: + - The \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback (deprecated). + - The \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback and switches to the #CONNECTION_STATE_RECONNECTING state. + */ + CONNECTION_STATE_CONNECTED = 3, + /** 4: The SDK keeps rejoining the channel after being disconnected from a joined channel because of network issues. + + - If the SDK cannot rejoin the channel within 10 seconds after being disconnected from Agora's edge server, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback, stays in the #CONNECTION_STATE_RECONNECTING state, and keeps rejoining the channel. + - If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback, switches to the #CONNECTION_STATE_FAILED state, and stops rejoining the channel. + */ + CONNECTION_STATE_RECONNECTING = 4, + /** 5: The SDK fails to connect to Agora's edge server or join the channel. + + You must call the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method to leave this state, and call the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method again to rejoin the channel. + + If the SDK is banned from joining the channel by Agora's edge server (through the RESTful API), the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionBanned "onConnectionBanned" (deprecated) and \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callbacks. + */ + CONNECTION_STATE_FAILED = 5, +}; + +/** Reasons for a connection state change. */ +enum CONNECTION_CHANGED_REASON_TYPE +{ + /** 0: The SDK is connecting to Agora's edge server. */ + CONNECTION_CHANGED_CONNECTING = 0, + /** 1: The SDK has joined the channel successfully. */ + CONNECTION_CHANGED_JOIN_SUCCESS = 1, + /** 2: The connection between the SDK and Agora's edge server is interrupted. */ + CONNECTION_CHANGED_INTERRUPTED = 2, + /** 3: The connection between the SDK and Agora's edge server is banned by Agora's edge server. */ + CONNECTION_CHANGED_BANNED_BY_SERVER = 3, + /** 4: The SDK fails to join the channel for more than 20 minutes and stops reconnecting to the channel. */ + CONNECTION_CHANGED_JOIN_FAILED = 4, + /** 5: The SDK has left the channel. */ + CONNECTION_CHANGED_LEAVE_CHANNEL = 5, + /** 6: The connection failed since Appid is not valid. */ + CONNECTION_CHANGED_INVALID_APP_ID = 6, + /** 7: The connection failed since channel name is not valid. */ + CONNECTION_CHANGED_INVALID_CHANNEL_NAME = 7, + /** 8: The connection failed since token is not valid, possibly because: + + - The App Certificate for the project is enabled in Console, but you do not use Token when joining the channel. If you enable the App Certificate, you must use a token to join the channel. + - The uid that you specify in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method is different from the uid that you pass for generating the token. + */ + CONNECTION_CHANGED_INVALID_TOKEN = 8, + /** 9: The connection failed since token is expired. */ + CONNECTION_CHANGED_TOKEN_EXPIRED = 9, + /** 10: The connection is rejected by server. */ + CONNECTION_CHANGED_REJECTED_BY_SERVER = 10, + /** 11: The connection changed to reconnecting since SDK has set a proxy server. */ + CONNECTION_CHANGED_SETTING_PROXY_SERVER = 11, + /** 12: When SDK is in connection failed, the renew token operation will make it connecting. */ + CONNECTION_CHANGED_RENEW_TOKEN = 12, + /** 13: The IP Address of SDK client has changed. i.e., Network type or IP/Port changed by network operator might change client IP address. */ + CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED = 13, + /** 14: Timeout for the keep-alive of the connection between the SDK and Agora's edge server. The connection state changes to CONNECTION_STATE_RECONNECTING(4). */ + CONNECTION_CHANGED_KEEP_ALIVE_TIMEOUT = 14, +}; + +/** Network type. */ +enum NETWORK_TYPE +{ + /** -1: The network type is unknown. */ + NETWORK_TYPE_UNKNOWN = -1, + /** 0: The SDK disconnects from the network. */ + NETWORK_TYPE_DISCONNECTED = 0, + /** 1: The network type is LAN. */ + NETWORK_TYPE_LAN = 1, + /** 2: The network type is Wi-Fi(including hotspots). */ + NETWORK_TYPE_WIFI = 2, + /** 3: The network type is mobile 2G. */ + NETWORK_TYPE_MOBILE_2G = 3, + /** 4: The network type is mobile 3G. */ + NETWORK_TYPE_MOBILE_3G = 4, + /** 5: The network type is mobile 4G. */ + NETWORK_TYPE_MOBILE_4G = 5, +}; + +/** States of the last-mile network probe test. */ +enum LASTMILE_PROBE_RESULT_STATE { + /** 1: The last-mile network probe test is complete. */ + LASTMILE_PROBE_RESULT_COMPLETE = 1, + /** 2: The last-mile network probe test is incomplete and the bandwidth estimation is not available, probably due to limited test resources. */ + LASTMILE_PROBE_RESULT_INCOMPLETE_NO_BWE = 2, + /** 3: The last-mile network probe test is not carried out, probably due to poor network conditions. */ + LASTMILE_PROBE_RESULT_UNAVAILABLE = 3 +}; +/** Audio output routing. */ +enum AUDIO_ROUTE_TYPE { + /** Default. + */ + AUDIO_ROUTE_DEFAULT = -1, + /** Headset. + */ + AUDIO_ROUTE_HEADSET = 0, + /** Earpiece. + */ + AUDIO_ROUTE_EARPIECE = 1, + /** Headset with no microphone. + */ + AUDIO_ROUTE_HEADSET_NO_MIC = 2, + /** Speakerphone. + */ + AUDIO_ROUTE_SPEAKERPHONE = 3, + /** Loudspeaker. + */ + AUDIO_ROUTE_LOUDSPEAKER = 4, + /** Bluetooth headset. + */ + AUDIO_ROUTE_BLUETOOTH = 5 +}; + +#if (defined(__APPLE__) && TARGET_OS_IOS) +/** Audio session restriction. */ +enum AUDIO_SESSION_OPERATION_RESTRICTION { + /** No restriction, the SDK has full control of the audio session operations. */ + AUDIO_SESSION_OPERATION_RESTRICTION_NONE = 0, + /** The SDK does not change the audio session category. */ + AUDIO_SESSION_OPERATION_RESTRICTION_SET_CATEGORY = 1, + /** The SDK does not change any setting of the audio session (category, mode, categoryOptions). */ + AUDIO_SESSION_OPERATION_RESTRICTION_CONFIGURE_SESSION = 1 << 1, + /** The SDK keeps the audio session active when leaving a channel. */ + AUDIO_SESSION_OPERATION_RESTRICTION_DEACTIVATE_SESSION = 1 << 2, + /** The SDK does not configure the audio session anymore. */ + AUDIO_SESSION_OPERATION_RESTRICTION_ALL = 1 << 7, +}; +#endif + +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) +enum CAMERA_DIRECTION { + /** The rear camera. */ + CAMERA_REAR = 0, + /** The front camera. */ + CAMERA_FRONT = 1, +}; +#endif + +/** The uplink or downlink last-mile network probe test result. */ +struct LastmileProbeOneWayResult { + /** The packet loss rate (%). */ + unsigned int packetLossRate; + /** The network jitter (ms). */ + unsigned int jitter; + /* The estimated available bandwidth (Kbps). */ + unsigned int availableBandwidth; +}; + +/** The uplink and downlink last-mile network probe test result. */ +struct LastmileProbeResult{ + /** The state of the probe test. */ + LASTMILE_PROBE_RESULT_STATE state; + /** The uplink last-mile network probe test result. */ + LastmileProbeOneWayResult uplinkReport; + /** The downlink last-mile network probe test result. */ + LastmileProbeOneWayResult downlinkReport; + /** The round-trip delay time (ms). */ + unsigned int rtt; +}; + +/** Configurations of the last-mile network probe test. */ +struct LastmileProbeConfig { + /** Sets whether or not to test the uplink network. Some users, for example, the audience in a Live-broadcast channel, do not need such a test: + - true: test. + - false: do not test. */ + bool probeUplink; + /** Sets whether or not to test the downlink network: + - true: test. + - false: do not test. */ + bool probeDownlink; + /** The expected maximum sending bitrate (Kbps) of the local user. The value ranges between 100 and 5000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ + unsigned int expectedUplinkBitrate; + /** The expected maximum receiving bitrate (Kbps) of the local user. The value ranges between 100 and 5000. */ + unsigned int expectedDownlinkBitrate; +}; + +/** Properties of the audio volume information. + + An array containing the user ID and volume information for each speaker. + */ +struct AudioVolumeInfo +{ + /** + User ID of the speaker. The uid of the local user is 0. + */ + uid_t uid; + /** The volume of the speaker. The volume ranges between 0 (lowest volume) and 255 (highest volume). + */ + unsigned int volume; + /** Voice activity status of the local user. + * - 0: The local user is not speaking. + * - 1: The local user is speaking. + * + * @note + * - The `vad` parameter cannot report the voice activity status of the remote users. In the remote users' callback, `vad` = 0. + * - Ensure that you set `report_vad`(true) in the \ref agora::rtc::IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method to enable the voice activity detection of the local user. + */ + unsigned int vad; + /** The channel ID, which indicates which channel the speaker is in. + */ + const char * channelId; +}; + +/** Statistics of the channel. + */ +struct RtcStats +{ + /** + Call duration (s), represented by an aggregate value. + */ + unsigned int duration; + /** + Total number of bytes transmitted, represented by an aggregate value. + */ + unsigned int txBytes; + /** + Total number of bytes received, represented by an aggregate value. + */ + unsigned int rxBytes; + /** Total number of audio bytes sent (bytes), represented + * by an aggregate value. + */ + unsigned int txAudioBytes; + /** Total number of video bytes sent (bytes), represented + * by an aggregate value. + */ + unsigned int txVideoBytes; + /** Total number of audio bytes received (bytes) before + * network countermeasures, represented by an aggregate value. + */ + unsigned int rxAudioBytes; + /** Total number of video bytes received (bytes), + * represented by an aggregate value. + */ + unsigned int rxVideoBytes; + + /** + Transmission bitrate (Kbps), represented by an instantaneous value. + */ + unsigned short txKBitRate; + /** + Receive bitrate (Kbps), represented by an instantaneous value. + */ + unsigned short rxKBitRate; + /** + Audio receive bitrate (Kbps), represented by an instantaneous value. + */ + unsigned short rxAudioKBitRate; + /** + Audio transmission bitrate (Kbps), represented by an instantaneous value. + */ + unsigned short txAudioKBitRate; + /** + Video receive bitrate (Kbps), represented by an instantaneous value. + */ + unsigned short rxVideoKBitRate; + /** + Video transmission bitrate (Kbps), represented by an instantaneous value. + */ + unsigned short txVideoKBitRate; + /** Client-server latency (ms) + */ + unsigned short lastmileDelay; + /** The packet loss rate (%) from the local client to Agora's edge server, + * before using the anti-packet-loss method. + */ + unsigned short txPacketLossRate; + /** The packet loss rate (%) from Agora's edge server to the local client, + * before using the anti-packet-loss method. + */ + unsigned short rxPacketLossRate; + /** Number of users in the channel. + + - Communication profile: The number of users in the channel. + - Live broadcast profile: + + - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. + - If the user is a host: The number of users in the channel = The number of hosts in the channel. + */ + unsigned int userCount; + /** + Application CPU usage (%). + */ + double cpuAppUsage; + /** + System CPU usage (%). + */ + double cpuTotalUsage; + /** The round-trip time delay from the client to the local router. + */ + int gatewayRtt; + /** + The memory usage ratio of the app (%). + @note This value is for reference only. Due to system limitations, you may not get the value of this member. + */ + double memoryAppUsageRatio; + /** + The memory usage ratio of the system (%). + @note This value is for reference only. Due to system limitations, you may not get the value of this member. + */ + double memoryTotalUsageRatio; + /** + The memory usage of the app (KB). + @note This value is for reference only. Due to system limitations, you may not get the value of this member. + */ + int memoryAppUsageInKbytes; + RtcStats() + : duration(0) + , txBytes(0) + , rxBytes(0) + , txAudioBytes(0) + , txVideoBytes(0) + , rxAudioBytes(0) + , rxVideoBytes(0) + , txKBitRate(0) + , rxKBitRate(0) + , rxAudioKBitRate(0) + , txAudioKBitRate(0) + , rxVideoKBitRate(0) + , txVideoKBitRate(0) + , lastmileDelay(0) + , txPacketLossRate(0) + , rxPacketLossRate(0) + , userCount(0) + , cpuAppUsage(0) + , cpuTotalUsage(0) + , gatewayRtt(0) + , memoryAppUsageRatio(0) + , memoryTotalUsageRatio(0) + , memoryAppUsageInKbytes(0) {} +}; + +/** Quality change of the local video in terms of target frame rate and target bit rate since last count. + */ +enum QUALITY_ADAPT_INDICATION { + /** The quality of the local video stays the same. */ + ADAPT_NONE = 0, + /** The quality improves because the network bandwidth increases. */ + ADAPT_UP_BANDWIDTH = 1, + /** The quality worsens because the network bandwidth decreases. */ + ADAPT_DOWN_BANDWIDTH = 2, +}; + +/** The error code in CHANNEL_MEDIA_RELAY_ERROR. */ +enum CHANNEL_MEDIA_RELAY_ERROR { + /** 0: The state is normal. + */ + RELAY_OK = 0, + /** 1: An error occurs in the server response. + */ + RELAY_ERROR_SERVER_ERROR_RESPONSE = 1, + /** 2: No server response. You can call the + * \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method to + * leave the channel. + */ + RELAY_ERROR_SERVER_NO_RESPONSE = 2, + /** 3: The SDK fails to access the service, probably due to limited + * resources of the server. + */ + RELAY_ERROR_NO_RESOURCE_AVAILABLE = 3, + /** 4: Fails to send the relay request. + */ + RELAY_ERROR_FAILED_JOIN_SRC = 4, + /** 5: Fails to accept the relay request. + */ + RELAY_ERROR_FAILED_JOIN_DEST = 5, + /** 6: The server fails to receive the media stream. + */ + RELAY_ERROR_FAILED_PACKET_RECEIVED_FROM_SRC = 6, + /** 7: The server fails to send the media stream. + */ + RELAY_ERROR_FAILED_PACKET_SENT_TO_DEST = 7, + /** 8: The SDK disconnects from the server due to poor network + * connections. You can call the \ref agora::rtc::IRtcEngine::leaveChannel + * "leaveChannel" method to leave the channel. + */ + RELAY_ERROR_SERVER_CONNECTION_LOST = 8, + /** 9: An internal error occurs in the server. + */ + RELAY_ERROR_INTERNAL_ERROR = 9, + /** 10: The token of the source channel has expired. + */ + RELAY_ERROR_SRC_TOKEN_EXPIRED = 10, + /** 11: The token of the destination channel has expired. + */ + RELAY_ERROR_DEST_TOKEN_EXPIRED = 11, +}; + +/** The event code in CHANNEL_MEDIA_RELAY_EVENT. */ +enum CHANNEL_MEDIA_RELAY_EVENT { + /** 0: The user disconnects from the server due to poor network + * connections. + */ + RELAY_EVENT_NETWORK_DISCONNECTED = 0, + /** 1: The network reconnects. + */ + RELAY_EVENT_NETWORK_CONNECTED = 1, + /** 2: The user joins the source channel. + */ + RELAY_EVENT_PACKET_JOINED_SRC_CHANNEL = 2, + /** 3: The user joins the destination channel. + */ + RELAY_EVENT_PACKET_JOINED_DEST_CHANNEL = 3, + /** 4: The SDK starts relaying the media stream to the destination channel. + */ + RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL = 4, + /** 5: The server receives the video stream from the source channel. + */ + RELAY_EVENT_PACKET_RECEIVED_VIDEO_FROM_SRC = 5, + /** 6: The server receives the audio stream from the source channel. + */ + RELAY_EVENT_PACKET_RECEIVED_AUDIO_FROM_SRC = 6, + /** 7: The destination channel is updated. + */ + RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL = 7, + /** 8: The destination channel update fails due to internal reasons. + */ + RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_REFUSED = 8, + /** 9: The destination channel does not change, which means that the + * destination channel fails to be updated. + */ + RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_NOT_CHANGE = 9, + /** 10: The destination channel name is NULL. + */ + RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL_IS_NULL = 10, + /** 11: The video profile is sent to the server. + */ + RELAY_EVENT_VIDEO_PROFILE_UPDATE = 11, +}; + +/** The state code in CHANNEL_MEDIA_RELAY_STATE. */ +enum CHANNEL_MEDIA_RELAY_STATE { + /** 0: The SDK is initializing. + */ + RELAY_STATE_IDLE = 0, + /** 1: The SDK tries to relay the media stream to the destination channel. + */ + RELAY_STATE_CONNECTING = 1, + /** 2: The SDK successfully relays the media stream to the destination + * channel. + */ + RELAY_STATE_RUNNING = 2, + /** 3: A failure occurs. See the details in code. + */ + RELAY_STATE_FAILURE = 3, +}; + +/** Statistics of the local video stream. + */ +struct LocalVideoStats +{ + /** Bitrate (Kbps) sent in the reported interval, which does not include + * the bitrate of the retransmission video after packet loss. + */ + int sentBitrate; + /** Frame rate (fps) sent in the reported interval, which does not include + * the frame rate of the retransmission video after packet loss. + */ + int sentFrameRate; + /** The encoder output frame rate (fps) of the local video. + */ + int encoderOutputFrameRate; + /** The render output frame rate (fps) of the local video. + */ + int rendererOutputFrameRate; + /** The target bitrate (Kbps) of the current encoder. This value is estimated by the SDK based on the current network conditions. + */ + int targetBitrate; + /** The target frame rate (fps) of the current encoder. + */ + int targetFrameRate; + /** Quality change of the local video in terms of target frame rate and + * target bit rate in this reported interval. See #QUALITY_ADAPT_INDICATION. + */ + QUALITY_ADAPT_INDICATION qualityAdaptIndication; + /** The encoding bitrate (Kbps), which does not include the bitrate of the + * re-transmission video after packet loss. + */ + int encodedBitrate; + /** The width of the encoding frame (px). + */ + int encodedFrameWidth; + /** The height of the encoding frame (px). + */ + int encodedFrameHeight; + /** The value of the sent frames, represented by an aggregate value. + */ + int encodedFrameCount; + /** The codec type of the local video: + * - VIDEO_CODEC_VP8 = 1: VP8. + * - VIDEO_CODEC_H264 = 2: (Default) H.264. + */ + VIDEO_CODEC_TYPE codecType; +}; + +/** Statistics of the remote video stream. + */ +struct RemoteVideoStats +{ + /** + User ID of the remote user sending the video streams. + */ + uid_t uid; + /** **DEPRECATED** Time delay (ms). + */ + int delay; +/** + Width (pixels) of the video stream. + */ + int width; + /** + Height (pixels) of the video stream. + */ + int height; + /** + Bitrate (Kbps) received since the last count. + */ + int receivedBitrate; + /** The decoder output frame rate (fps) of the remote video. + */ + int decoderOutputFrameRate; + /** The render output frame rate (fps) of the remote video. + */ + int rendererOutputFrameRate; + /** Packet loss rate (%) of the remote video stream after using the anti-packet-loss method. + */ + int packetLossRate; + REMOTE_VIDEO_STREAM_TYPE rxStreamType; + /** + The total freeze time (ms) of the remote video stream after the remote user joins the channel. + In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when + the time interval between two adjacent renderable video frames is more than 500 ms. + */ + int totalFrozenTime; + /** + The total video freeze time as a percentage (%) of the total time when the video is available. + */ + int frozenRate; +}; + +/** Audio statistics of the local user */ +struct LocalAudioStats +{ + /** The number of channels. + */ + int numChannels; + /** The sample rate (Hz). + */ + int sentSampleRate; + /** The average sending bitrate (Kbps). + */ + int sentBitrate; +}; + +/** Audio statistics of a remote user */ +struct RemoteAudioStats +{ + /** User ID of the remote user sending the audio streams. + * + */ + uid_t uid; + /** Audio quality received by the user: #QUALITY_TYPE. + */ + int quality; + /** Network delay (ms) from the sender to the receiver. + */ + int networkTransportDelay; + /** Network delay (ms) from the receiver to the jitter buffer. + */ + int jitterBufferDelay; + /** The audio frame loss rate in the reported interval. + */ + int audioLossRate; + /** The number of channels. + */ + int numChannels; + /** The sample rate (Hz) of the received audio stream in the reported + * interval. + */ + int receivedSampleRate; + /** The average bitrate (Kbps) of the received audio stream in the + * reported interval. */ + int receivedBitrate; + /** The total freeze time (ms) of the remote audio stream after the remote user joins the channel. In a session, audio freeze occurs when the audio frame loss rate reaches 4%. + * Agora uses 2 seconds as an audio piece unit to calculate the audio freeze time. The total audio freeze time = The audio freeze number × 2 seconds + */ + int totalFrozenTime; + /** The total audio freeze time as a percentage (%) of the total time when the audio is available. */ + int frozenRate; +}; + +/** + * Video dimensions. + */ +struct VideoDimensions { + /** Width (pixels) of the video. */ + int width; + /** Height (pixels) of the video. */ + int height; + VideoDimensions() + : width(640), height(480) + {} + VideoDimensions(int w, int h) + : width(w), height(h) + {} +}; + +/** (Recommended) The standard bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. + + In this mode, the bitrates differ between the live broadcast and communication profiles: + + - Communication profile: The video bitrate is the same as the base bitrate. + - Live broadcast profile: The video bitrate is twice the base bitrate. + + */ +const int STANDARD_BITRATE = 0; + +/** The compatible bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. + + The bitrate remains the same regardless of the channel profile. If you choose this mode in the Live-broadcast profile, the video frame rate may be lower than the set value. + */ +const int COMPATIBLE_BITRATE = -1; + +/** Use the default minimum bitrate. + */ +const int DEFAULT_MIN_BITRATE = -1; + +/** Video encoder configurations. + */ +struct VideoEncoderConfiguration { + /** The video frame dimensions (px) used to specify the video quality and measured by the total number of pixels along a frame's width and height: VideoDimensions. The default value is 640 x 360. + */ + VideoDimensions dimensions; + /** The frame rate of the video: #FRAME_RATE. The default value is 15. + + Note that we do not recommend setting this to a value greater than 30. + */ + FRAME_RATE frameRate; + /** The minimum frame rate of the video. The default value is -1. + */ + int minFrameRate; + /** The video encoding bitrate (Kbps). + + Choose one of the following options: + + - #STANDARD_BITRATE: (Recommended) The standard bitrate. + - The Communication profile: the encoding bitrate equals the base bitrate. + - The Live-broadcast profile: the encoding bitrate is twice the base bitrate. + - #COMPATIBLE_BITRATE: The compatible bitrate: the bitrate stays the same regardless of the profile. + + The Communication profile prioritizes smoothness, while the Live-broadcast profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. + + The following table lists the recommended video encoder configurations, where the base bitrate applies to the Communication profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. + + | Resolution | Frame Rate (fps) | Base Bitrate (Kbps, for Communication) | Live Bitrate (Kbps, for Live Broadcast)| + |------------------------|------------------|----------------------------------------|----------------------------------------| + | 160 × 120 | 15 | 65 | 130 | + | 120 × 120 | 15 | 50 | 100 | + | 320 × 180 | 15 | 140 | 280 | + | 180 × 180 | 15 | 100 | 200 | + | 240 × 180 | 15 | 120 | 240 | + | 320 × 240 | 15 | 200 | 400 | + | 240 × 240 | 15 | 140 | 280 | + | 424 × 240 | 15 | 220 | 440 | + | 640 × 360 | 15 | 400 | 800 | + | 360 × 360 | 15 | 260 | 520 | + | 640 × 360 | 30 | 600 | 1200 | + | 360 × 360 | 30 | 400 | 800 | + | 480 × 360 | 15 | 320 | 640 | + | 480 × 360 | 30 | 490 | 980 | + | 640 × 480 | 15 | 500 | 1000 | + | 480 × 480 | 15 | 400 | 800 | + | 640 × 480 | 30 | 750 | 1500 | + | 480 × 480 | 30 | 600 | 1200 | + | 848 × 480 | 15 | 610 | 1220 | + | 848 × 480 | 30 | 930 | 1860 | + | 640 × 480 | 10 | 400 | 800 | + | 1280 × 720 | 15 | 1130 | 2260 | + | 1280 × 720 | 30 | 1710 | 3420 | + | 960 × 720 | 15 | 910 | 1820 | + | 960 × 720 | 30 | 1380 | 2760 | + | 1920 × 1080 | 15 | 2080 | 4160 | + | 1920 × 1080 | 30 | 3150 | 6300 | + | 1920 × 1080 | 60 | 4780 | 6500 | + | 2560 × 1440 | 30 | 4850 | 6500 | + | 2560 × 1440 | 60 | 6500 | 6500 | + | 3840 × 2160 | 30 | 6500 | 6500 | + | 3840 × 2160 | 60 | 6500 | 6500 | + + */ + int bitrate; + /** The minimum encoding bitrate (Kbps). + + The SDK automatically adjusts the encoding bitrate to adapt to the network conditions. Using a value greater than the default value forces the video encoder to output high-quality images but may cause more packet loss and hence sacrifice the smoothness of the video transmission. That said, unless you have special requirements for image quality, Agora does not recommend changing this value. + + @note This parameter applies only to the Live-broadcast profile. + */ + int minBitrate; + /** The video orientation mode of the video: #ORIENTATION_MODE. + */ + ORIENTATION_MODE orientationMode; + /** The video encoding degradation preference under limited bandwidth: #DEGRADATION_PREFERENCE. + */ + DEGRADATION_PREFERENCE degradationPreference; + /** Sets the mirror mode of the published local video stream. It only affects the video that the remote user sees. See #VIDEO_MIRROR_MODE_TYPE + + @note: The SDK disables the mirror mode by default. + */ + VIDEO_MIRROR_MODE_TYPE mirrorMode; + + VideoEncoderConfiguration( + const VideoDimensions& d, FRAME_RATE f, + int b, ORIENTATION_MODE m, VIDEO_MIRROR_MODE_TYPE mr = VIDEO_MIRROR_MODE_AUTO) + : dimensions(d), frameRate(f), minFrameRate(-1), bitrate(b), + minBitrate(DEFAULT_MIN_BITRATE), orientationMode(m), + degradationPreference(MAINTAIN_QUALITY), mirrorMode(mr) + {} + VideoEncoderConfiguration( + int width, int height, FRAME_RATE f, + int b, ORIENTATION_MODE m, VIDEO_MIRROR_MODE_TYPE mr = VIDEO_MIRROR_MODE_AUTO) + : dimensions(width, height), frameRate(f), + minFrameRate(-1), bitrate(b), + minBitrate(DEFAULT_MIN_BITRATE), orientationMode(m), + degradationPreference(MAINTAIN_QUALITY), mirrorMode(mr) + {} + VideoEncoderConfiguration() + : dimensions(640, 480) + , frameRate(FRAME_RATE_FPS_15) + , minFrameRate(-1) + , bitrate(STANDARD_BITRATE) + , minBitrate(DEFAULT_MIN_BITRATE) + , orientationMode(ORIENTATION_MODE_ADAPTIVE) + , degradationPreference(MAINTAIN_QUALITY) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) + {} +}; + +/** The video properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. +*/ +typedef struct TranscodingUser { + /** User ID of the user displaying the video in the CDN live. + */ + uid_t uid; + +/** Horizontal position (pixel) of the video frame relative to the top left corner. +*/ + int x; + /** Vertical position (pixel) of the video frame relative to the top left corner. + */ + int y; + /** Width (pixel) of the video frame. The default value is 360. + */ + int width; + /** Height (pixel) of the video frame. The default value is 640. + */ + int height; + + /** Layer position of the video frame. The value ranges between 0 and 100. + + - 0: (Default) Lowest + - 100: Highest + + @note + - If zOrder is beyond this range, the SDK reports #ERR_INVALID_ARGUMENT. + - As of v2.3, the SDK supports zOrder = 0. + */ + int zOrder; + /** Transparency of the video frame in CDN live. The value ranges between 0 and 1.0: + + - 0: Completely transparent + - 1.0: (Default) Opaque + */ + double alpha; + /** The audio channel of the sound. The default value is 0: + + - 0: (Default) Supports dual channels at most, depending on the upstream of the broadcaster. + - 1: The audio stream of the broadcaster uses the FL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 2: The audio stream of the broadcaster uses the FC audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 3: The audio stream of the broadcaster uses the FR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 4: The audio stream of the broadcaster uses the BL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 5: The audio stream of the broadcaster uses the BR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + + @note If your setting is not 0, you may need a specialized player. + */ + int audioChannel; + TranscodingUser() + : uid(0) + , x(0) + , y(0) + , width(0) + , height(0) + , zOrder(0) + , alpha(1.0) + , audioChannel(0) + {} + +} TranscodingUser; + +/** Image properties. + + The properties of the watermark and background images. + */ +typedef struct RtcImage { + RtcImage() : + url(NULL), + x(0), + y(0), + width(0), + height(0) + {} + /** HTTP/HTTPS URL address of the image on the broadcasting video. The maximum length of this parameter is 1024 bytes. */ + const char* url; + /** Horizontal position of the image from the upper left of the broadcasting video. */ + int x; + /** Vertical position of the image from the upper left of the broadcasting video. */ + int y; + /** Width of the image on the broadcasting video. */ + int width; + /** Height of the image on the broadcasting video. */ + int height; +} RtcImage; + +/** A struct for managing CDN live audio/video transcoding settings. +*/ +typedef struct LiveTranscoding { + /** Width of the video. The default value is 360. + * - If you push video streams to the CDN, set the value of width × height to at least 64 × 64 (px), or the SDK will adjust it to 64 × 64 (px). + * - If you push audio streams to the CDN, set the value of width × height to 0 × 0 (px). + */ + int width; + /** Height of the video. The default value is 640. + * - If you push video streams to the CDN, set the value of width × height to at least 64 × 64 (px), or the SDK will adjust it to 64 × 64 (px). + * - If you push audio streams to the CDN, set the value of width × height to 0 × 0 (px). + */ + int height; + /** Bitrate of the CDN live output video stream. The default value is 400 Kbps. + + Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. + */ + int videoBitrate; + /** Frame rate of the output video stream set for the CDN live broadcast. The default value is 15 fps, and the value range is (0,30]. + + @note Agora adjusts all values over 30 to 30. + */ + int videoFramerate; + + /** **DEPRECATED** Latency mode: + + - true: Low latency with unassured quality. + - false: (Default) High latency with assured quality. + */ + bool lowLatency; + + /** Video GOP in frames. The default value is 30 fps. + */ + int videoGop; + /** Self-defined video codec profile: #VIDEO_CODEC_PROFILE_TYPE. + + @note If you set this parameter to other values, Agora adjusts it to the default value of 100. + */ + VIDEO_CODEC_PROFILE_TYPE videoCodecProfile; + /** The background color in RGB hex value. Value only, do not include a #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). + */ + unsigned int backgroundColor; + /** The number of users in the live broadcast. + */ + unsigned int userCount; + /** TranscodingUser + */ + TranscodingUser *transcodingUsers; + /** Reserved property. Extra user-defined information to send SEI for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 Bytes. + + For more information on SEI frame, see [SEI-related questions](https://docs.agora.io/en/faq/sei). + */ + const char *transcodingExtraInfo; + + /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or FLV metadata. + */ + const char *metadata; + /** The watermark image added to the CDN live publishing stream. + + Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. + */ + RtcImage* watermark; + /** The background image added to the CDN live publishing stream. + + Once a background image is added, the audience of the CDN live publishing stream can see the background image. See RtcImage. + */ + RtcImage* backgroundImage; + /** Self-defined audio-sample rate: #AUDIO_SAMPLE_RATE_TYPE. + */ + AUDIO_SAMPLE_RATE_TYPE audioSampleRate; + /** Bitrate of the CDN live audio output stream. The default value is 48 Kbps, and the highest value is 128. + */ + int audioBitrate; + /** Agora's self-defined audio-channel types. We recommend choosing option 1 or 2. A special player is required if you choose option 3, 4, or 5: + + - 1: (Default) Mono + - 2: Two-channel stereo + - 3: Three-channel stereo + - 4: Four-channel stereo + - 5: Five-channel stereo + */ + int audioChannels; + /** Self-defined audio codec profile: #AUDIO_CODEC_PROFILE_TYPE. + */ + + AUDIO_CODEC_PROFILE_TYPE audioCodecProfile; + + + LiveTranscoding() + : width(360) + , height(640) + , videoBitrate(400) + , videoFramerate(15) + , lowLatency(false) + , videoGop(30) + , videoCodecProfile(VIDEO_CODEC_PROFILE_HIGH) + , backgroundColor(0x000000) + , userCount(0) + , transcodingUsers(NULL) + , transcodingExtraInfo(NULL) + , metadata(NULL) + , watermark(NULL) + , backgroundImage(NULL) + , audioSampleRate(AUDIO_SAMPLE_RATE_48000) + , audioBitrate(48) + , audioChannels(1) + , audioCodecProfile(AUDIO_CODEC_PROFILE_LC_AAC) + {} +} LiveTranscoding; + + /** Camera capturer configuration. + */ + struct CameraCapturerConfiguration{ + + /** Camera capturer preference settings. See: #CAPTURER_OUTPUT_PREFERENCE. */ + CAPTURER_OUTPUT_PREFERENCE preference; + #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** Camera direction settings (for Android/iOS only). See: #CAMERA_DIRECTION. */ + CAMERA_DIRECTION cameraDirection; + #endif + }; + +/** Configuration of the imported live broadcast voice or video stream. + */ +struct InjectStreamConfig { + /** Width of the added stream in the live broadcast. The default value is 0 (same width as the original stream). + */ + int width; + /** Height of the added stream in the live broadcast. The default value is 0 (same height as the original stream). + */ + int height; + /** Video GOP of the added stream in the live broadcast in frames. The default value is 30 fps. + */ + int videoGop; + /** Video frame rate of the added stream in the live broadcast. The default value is 15 fps. + */ + int videoFramerate; + /** Video bitrate of the added stream in the live broadcast. The default value is 400 Kbps. + + @note The setting of the video bitrate is closely linked to the resolution. If the video bitrate you set is beyond a reasonable range, the SDK sets it within a reasonable range. + */ + int videoBitrate; + /** Audio-sample rate of the added stream in the live broadcast: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. + + @note We recommend setting the default value. + */ + AUDIO_SAMPLE_RATE_TYPE audioSampleRate; + /** Audio bitrate of the added stream in the live broadcast. The default value is 48. + + @note We recommend setting the default value. + */ + int audioBitrate; + /** Audio channels in the live broadcast. + + - 1: (Default) Mono + - 2: Two-channel stereo + + @note We recommend setting the default value. + */ + int audioChannels; + + // width / height default set to 0 means pull the stream with its original resolution + InjectStreamConfig() + : width(0) + , height(0) + , videoGop(30) + , videoFramerate(15) + , videoBitrate(400) + , audioSampleRate(AUDIO_SAMPLE_RATE_48000) + , audioBitrate(48) + , audioChannels(1) + {} +}; +/** The definition of ChannelMediaInfo. + */ +struct ChannelMediaInfo { + /** The channel name. + */ + const char* channelName; + /** The token that enables the user to join the channel. + */ + const char* token; + /** The user ID. + */ + uid_t uid; +}; + +/** The definition of ChannelMediaRelayConfiguration. + */ +struct ChannelMediaRelayConfiguration { + /** Pointer to the information of the source channel: ChannelMediaInfo. It contains the following members: + * - `channelName`: The name of the source channel. The default value is `NULL`, which means the SDK applies the name of the current channel. + * - `uid`: ID of the broadcaster whose media stream you want to relay. The default value is 0, which means the SDK generates a random UID. You must set it as 0. + * - `token`: The token for joining the source channel. It is generated with the `channelName` and `uid` you set in `srcInfo`. + * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. + * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`, and the `uid` must be set as 0. + */ + ChannelMediaInfo *srcInfo; + /** Pointer to the information of the destination channel: ChannelMediaInfo. It contains the following members: + * - `channelName`: The name of the destination channel. + * - `uid`: ID of the broadcaster in the destination channel. The value ranges from 0 to (232-1). To avoid UID conflicts, this `uid` must be different from any other UIDs in the destination channel. The default value is 0, which means the SDK generates a random UID. + * - `token`: The token for joining the destination channel. It is generated with the `channelName` and `uid` you set in `destInfos`. + * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. + * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`. + */ + ChannelMediaInfo *destInfos; + /** The number of destination channels. The default value is 0, and the + * value range is [0,4). Ensure that the value of this parameter + * corresponds to the number of ChannelMediaInfo structs you define in + * `destInfos`. + */ + int destCount; + + ChannelMediaRelayConfiguration() + : srcInfo(nullptr) + , destInfos(nullptr) + , destCount(0) + {} +}; + +/** **DEPRECATED** Lifecycle of the CDN live video stream. +*/ +enum RTMP_STREAM_LIFE_CYCLE_TYPE +{ + /** Bind to the channel lifecycle. If all hosts leave the channel, the CDN live streaming stops after 30 seconds. + */ + RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, + /** Bind to the owner of the RTMP stream. If the owner leaves the channel, the CDN live streaming stops immediately. + */ + RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, +}; + +/** Content hints for screen sharing. +*/ +enum VideoContentHint +{ + /** (Default) No content hint. + */ + CONTENT_HINT_NONE, + /** Motion-intensive content. Choose this option if you prefer smoothness or when you are sharing a video clip, movie, or video game. + */ + CONTENT_HINT_MOTION, + /** Motionless content. Choose this option if you prefer sharpness or when you are sharing a picture, PowerPoint slide, or text. + */ + CONTENT_HINT_DETAILS +}; + +/** The relative location of the region to the screen or window. + */ +struct Rectangle +{ + /** The horizontal offset from the top-left corner. + */ + int x; + /** The vertical offset from the top-left corner. + */ + int y; + /** The width of the region. + */ + int width; + /** The height of the region. + */ + int height; + + Rectangle(): x(0), y(0), width(0), height(0) {} + Rectangle(int xx, int yy, int ww, int hh): x(xx), y(yy), width(ww), height(hh) {} +}; + +/** **DEPRECATED** Definition of the rectangular region. */ +typedef struct Rect { + /** Y-axis of the top line. + */ + int top; + /** X-axis of the left line. + */ + int left; + /** Y-axis of the bottom line. + */ + int bottom; + /** X-axis of the right line. + */ + int right; + + Rect(): top(0), left(0), bottom(0), right(0) {} + Rect(int t, int l, int b, int r): top(t), left(l), bottom(b), right(r) {} +} Rect; + +/** The options of the watermark image to be added. */ +typedef struct WatermarkOptions { + /** Sets whether or not the watermark image is visible in the local video preview: + * - true: (Default) The watermark image is visible in preview. + * - false: The watermark image is not visible in preview. + */ + bool visibleInPreview; + /** + * The watermark position in the landscape mode. See Rectangle. + * For detailed information on the landscape mode, see [Rotate the video](https://docs.agora.io/en/Interactive%20Broadcast/rotation_guide_windows?platform=Windows). + */ + Rectangle positionInLandscapeMode; + /** + * The watermark position in the portrait mode. See Rectangle. + * For detailed information on the portrait mode, see [Rotate the video](https://docs.agora.io/en/Interactive%20Broadcast/rotation_guide_windows?platform=Windows). + */ + Rectangle positionInPortraitMode; + + WatermarkOptions() + : visibleInPreview(true) + , positionInLandscapeMode(0, 0, 0, 0) + , positionInPortraitMode(0, 0, 0, 0) + {} +} WatermarkOptions; + +/** Screen sharing encoding parameters. +*/ +struct ScreenCaptureParameters +{ + /** The maximum encoding dimensions of the shared region in terms of width × height. + + The default value is 1920 × 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. + + If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: + + - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 × 1000, the SDK uses 1000 × 1000 for encoding. + - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 × 1500, the SDK uses the maximum value under 1920 × 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 × 1080. + */ + VideoDimensions dimensions; + /** The frame rate (fps) of the shared region. + + The default value is 5. We do not recommend setting this to a value greater than 15. + */ + int frameRate; + /** The bitrate (Kbps) of the shared region. + + The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). + */ + int bitrate; + /** Sets whether or not to capture the mouse for screen sharing: + + - true: (Default) Capture the mouse. + - false: Do not capture the mouse. + */ + bool captureMouseCursor; + + ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true) {} + ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c) {} + ScreenCaptureParameters(int width, int height, int f, int b, bool c) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c) {} +}; + +/** Video display settings of the VideoCanvas class. +*/ +struct VideoCanvas +{ + /** Video display window (view). + */ + view_t view; + /** The rendering mode of the video view. See RENDER_MODE_TYPE + */ + int renderMode; + /** The unique channel name for the AgoraRTC session in the string format. The string length must be less than 64 bytes. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @note + - The default value is the empty string "". Use the default value if the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IRtcEngine class. The `VideoCanvas` struct defines the video canvas of the user in the channel. + - If the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IChannel class, set this parameter as the `channelId` of the `IChannel` object. The `VideoCanvas` struct defines the video canvas of the user in the channel with the specified channel ID. + */ + char channelId[MAX_CHANNEL_ID_LENGTH]; + /** The user ID. */ + uid_t uid; + void *priv; // private data (underlying video engine denotes it) + /** The mirror mode of the video view. See VIDEO_MIRROR_MODE_TYPE + @note + - For the mirror mode of the local video view: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. + - For the mirror mode of the remote video view: The SDK disables the mirror mode by default. + */ + VIDEO_MIRROR_MODE_TYPE mirrorMode; + + VideoCanvas() + : view(NULL) + , renderMode(RENDER_MODE_HIDDEN) + , uid(0) + , priv(NULL) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) + { + channelId[0] = '\0'; + } + VideoCanvas(view_t v, int m, uid_t u) + : view(v) + , renderMode(m) + , uid(u) + , priv(NULL) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) + { + channelId[0] = '\0'; + } + VideoCanvas(view_t v, int m, const char *ch, uid_t u) + : view(v) + , renderMode(m) + , uid(u) + , priv(NULL) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) + { + strncpy(channelId, ch, MAX_CHANNEL_ID_LENGTH); + channelId[MAX_CHANNEL_ID_LENGTH - 1] = '\0'; + } + VideoCanvas(view_t v, int rm, uid_t u, VIDEO_MIRROR_MODE_TYPE mm) + : view(v) + , renderMode(rm) + , uid(u) + , priv(NULL) + , mirrorMode(mm) + { + channelId[0] = '\0'; + } + VideoCanvas(view_t v, int rm, const char *ch, uid_t u, VIDEO_MIRROR_MODE_TYPE mm) + : view(v) + , renderMode(rm) + , uid(u) + , priv(NULL) + , mirrorMode(mm) + { + strncpy(channelId, ch, MAX_CHANNEL_ID_LENGTH); + channelId[MAX_CHANNEL_ID_LENGTH - 1] = '\0'; + } +}; + +/** Image enhancement options. +*/ +struct BeautyOptions { + /** The contrast level, used with the @p lightening parameter. + */ + enum LIGHTENING_CONTRAST_LEVEL + { + /** Low contrast level. */ + LIGHTENING_CONTRAST_LOW = 0, + /** (Default) Normal contrast level. */ + LIGHTENING_CONTRAST_NORMAL, + /** High contrast level. */ + LIGHTENING_CONTRAST_HIGH + }; + +/** The contrast level, used with the @p lightening parameter. +*/ +LIGHTENING_CONTRAST_LEVEL lighteningContrastLevel; + +/** The brightness level. The value ranges from 0.0 (original) to 1.0. */ +float lighteningLevel; + +/** The sharpness level. The value ranges between 0 (original) and 1. This parameter is usually used to remove blemishes. + */ +float smoothnessLevel; + +/** The redness level. The value ranges between 0 (original) and 1. This parameter adjusts the red saturation level. +*/ +float rednessLevel; + +BeautyOptions(LIGHTENING_CONTRAST_LEVEL contrastLevel, float lightening, float smoothness, float redness) + : lighteningLevel(lightening), + smoothnessLevel(smoothness), + rednessLevel(redness), + lighteningContrastLevel(contrastLevel) {} + +BeautyOptions() + : lighteningLevel(0), + smoothnessLevel(0), + rednessLevel(0), + lighteningContrastLevel(LIGHTENING_CONTRAST_NORMAL) {} +}; + +struct UserInfo { + uid_t uid; + char userAccount[MAX_USER_ACCOUNT_LENGTH]; + UserInfo() + : uid(0) { + userAccount[0] = '\0'; + } +}; + +/** Definition of IPacketObserver. +*/ +class IPacketObserver +{ +public: +/** Definition of Packet. + */ + struct Packet + { + /** Buffer address of the sent or received data. + * @note Agora recommends that the value of buffer is more than 2048 bytes, otherwise, you may meet undefined behaviors such as a crash. + */ + const unsigned char* buffer; + /** Buffer size of the sent or received data. + */ + unsigned int size; + }; + /** Occurs when the local user sends an audio packet. + + @param packet The sent audio packet. See Packet. + @return + - true: The audio packet is sent successfully. + - false: The audio packet is discarded. + */ + virtual bool onSendAudioPacket(Packet& packet) = 0; + /** Occurs when the local user sends a video packet. + + @param packet The sent video packet. See Packet. + @return + - true: The video packet is sent successfully. + - false: The video packet is discarded. + */ + virtual bool onSendVideoPacket(Packet& packet) = 0; + /** Occurs when the local user receives an audio packet. + + @param packet The received audio packet. See Packet. + @return + - true: The audio packet is received successfully. + - false: The audio packet is discarded. + */ + virtual bool onReceiveAudioPacket(Packet& packet) = 0; + /** Occurs when the local user receives a video packet. + + @param packet The received video packet. See Packet. + @return + - true: The video packet is received successfully. + - false: The video packet is discarded. + */ + virtual bool onReceiveVideoPacket(Packet& packet) = 0; +}; + +/** The SDK uses the IRtcEngineEventHandler interface class to send callbacks to the application. The application inherits the methods of this interface class to retrieve these callbacks. + + All methods in this interface class have default (empty) implementations. Therefore, the application can only inherit some required events. In the callbacks, avoid time-consuming tasks or calling blocking APIs, such as the SendMessage method. Otherwise, the SDK may not work properly. + */ +class IRtcEngineEventHandler +{ +public: + virtual ~IRtcEngineEventHandler() {} + + /** Reports a warning during SDK runtime. + + In most cases, the application can ignore the warning reported by the SDK because the SDK can usually fix the issue and resume running. For example, when losing connection with the server, the SDK may report #WARN_LOOKUP_CHANNEL_TIMEOUT and automatically try to reconnect. + + @param warn Warning code: #WARN_CODE_TYPE. + @param msg Pointer to the warning message. + */ + virtual void onWarning(int warn, const char* msg) { + (void)warn; + (void)msg; + } + + /** Reports an error during SDK runtime. + + In most cases, the SDK cannot fix the issue and resume running. The SDK requires the application to take action or informs the user about the issue. + + For example, the SDK reports an #ERR_START_CALL error when failing to initialize a call. The application informs the user that the call initialization failed and invokes the \ref IRtcEngine::leaveChannel "leaveChannel" method to leave the channel. + + @param err Error code: #ERROR_CODE_TYPE. + @param msg Pointer to the error message. + */ + virtual void onError(int err, const char* msg) { + (void)err; + (void)msg; + } + + /** Occurs when a user joins a channel. + + This callback notifies the application that a user joins a specified channel when the application calls the \ref IRtcEngine::joinChannel "joinChannel" method. + + The channel name assignment is based on @p channelName specified in the \ref IRtcEngine::joinChannel "joinChannel" method. + + If the @p uid is not specified in the *joinChannel* method, the server automatically assigns a @p uid. + + @param channel Pointer to the channel name. + @param uid User ID of the user joining the channel. + @param elapsed Time elapsed (ms) from the user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + */ + virtual void onJoinChannelSuccess(const char* channel, uid_t uid, int elapsed) { + (void)channel; + (void)uid; + (void)elapsed; + } + + /** Occurs when a user rejoins the channel after disconnection due to network problems. + + When a user loses connection with the server because of network problems, the SDK automatically tries to reconnect and triggers this callback upon reconnection. + + @param channel Pointer to the channel name. + @param uid User ID of the user rejoining the channel. + @param elapsed Time elapsed (ms) from starting to reconnect until the SDK triggers this callback. + */ + virtual void onRejoinChannelSuccess(const char* channel, uid_t uid, int elapsed) { + (void)channel; + (void)uid; + (void)elapsed; + } + + /** Occurs when a user leaves the channel. + + This callback notifies the application that a user leaves the channel when the application calls the \ref IRtcEngine::leaveChannel "leaveChannel" method. + + The application retrieves information, such as the call duration and statistics. + + @param stats Pointer to the statistics of the call: RtcStats. + */ + virtual void onLeaveChannel(const RtcStats& stats) { + (void)stats; + } + + /** Occurs when the user role switches in a live broadcast. For example, from a host to an audience or vice versa. + + This callback notifies the application of a user role switch when the application calls the \ref IRtcEngine::setClientRole "setClientRole" method. + + The SDK triggers this callback when the local user switches the user role by calling the \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method after joining the channel. + @param oldRole Role that the user switches from: #CLIENT_ROLE_TYPE. + @param newRole Role that the user switches to: #CLIENT_ROLE_TYPE. + */ + virtual void onClientRoleChanged(CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { + } + + /** Occurs when a remote user (Communication)/ host (Live Broadcast) joins the channel. + + - Communication profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - Live-broadcast profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + + The SDK triggers this callback under one of the following circumstances: + - A remote user/host joins the channel by calling the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. + - A remote user switches the user role to the host by calling the \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method after joining the channel. + - A remote user/host rejoins the channel after a network interruption. + - The host injects an online media stream into the channel by calling the \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method. + + @note In the Live-broadcast profile: + - The host receives this callback when another host joins the channel. + - The audience in the channel receives this callback when a new host joins the channel. + - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. + + @param uid User ID of the user or host joining the channel. + @param elapsed Time delay (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + */ + virtual void onUserJoined(uid_t uid, int elapsed) { + (void)uid; + (void)elapsed; + } + + /** Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel. + + Reasons why the user is offline: + + - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. + - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using a signaling system for more reliable offline detection. + + @param uid User ID of the user leaving the channel or going offline. + @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. + */ + virtual void onUserOffline(uid_t uid, USER_OFFLINE_REASON_TYPE reason) { + (void)uid; + (void)reason; + } + + /** Reports the last mile network quality of the local user once every two seconds before the user joins the channel. + + Last mile refers to the connection between the local device and Agora's edge server. After the application calls the \ref IRtcEngine::enableLastmileTest "enableLastmileTest" method, this callback reports once every two seconds the uplink and downlink last mile network conditions of the local user before the user joins the channel. + + @param quality The last mile network quality: #QUALITY_TYPE. + */ + virtual void onLastmileQuality(int quality) { + (void)quality; + } + + /** Reports the last-mile network probe result. + + The SDK triggers this callback within 30 seconds after the app calls the \ref agora::rtc::IRtcEngine::startLastmileProbeTest "startLastmileProbeTest" method. + + @param result The uplink and downlink last-mile network probe test result. See LastmileProbeResult. + */ + virtual void onLastmileProbeResult(const LastmileProbeResult& result) { + (void)result; + } + + /** **DEPRECATED** Occurs when the connection between the SDK and the server is interrupted. + + Deprecated as of v2.3.2. Replaced by the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged(CONNECTION_STATE_RECONNECTING, CONNECTION_CHANGED_INTERRUPTED)" callback. + + The SDK triggers this callback when it loses connection with the server for more than four seconds after the connection is established. + + After triggering this callback, the SDK tries reconnecting to the server. You can use this callback to implement pop-up reminders. + + This callback is different from \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost": + - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. + - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. + + If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. + + */ + virtual void onConnectionInterrupted() {} + + /** Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted. + + The SDK triggers this callback when it cannot connect to the server 10 seconds after calling the \ref IRtcEngine::joinChannel "joinChannel" method, whether or not it is in the channel. + + This callback is different from \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted": + + - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. + - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. + + If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. + + */ + virtual void onConnectionLost() {} + + /** **DEPRECATED** Deprecated as of v2.3.2. Replaced by the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged(CONNECTION_STATE_FAILED, CONNECTION_CHANGED_BANNED_BY_SERVER)" callback. + + Occurs when your connection is banned by the Agora Server. + */ + virtual void onConnectionBanned() {} + + /** Occurs when a method is executed by the SDK. + + @param err The error code (#ERROR_CODE_TYPE) returned by the SDK when a method call fails. If the SDK returns 0, then the method call is successful. + @param api Pointer to the method executed by the SDK. + @param result Pointer to the result of the method call. + */ + virtual void onApiCallExecuted(int err, const char* api, const char* result) { + (void)err; + (void)api; + (void)result; + } + + /** Occurs when the token expires. + + After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. + + This callback notifies the application to generate a new token. Call the \ref IRtcEngine::renewToken "renewToken" method to renew the token. + */ + virtual void onRequestToken() { + } + + /** Occurs when the token expires in 30 seconds. + + The user becomes offline if the token used in the \ref IRtcEngine::joinChannel "joinChannel" method expires. The SDK triggers this callback 30 seconds before the token expires to remind the application to get a new token. Upon receiving this callback, generate a new token on the server and call the \ref IRtcEngine::renewToken "renewToken" method to pass the new token to the SDK. + + @param token Pointer to the token that expires in 30 seconds. + */ + virtual void onTokenPrivilegeWillExpire(const char* token) { + (void)token; + } + + /** **DEPRECATED** Reports the statistics of the audio stream from each remote user/host. + + Deprecated as of v2.3.2. Use the \ref agora::rtc::IRtcEngineEventHandler::onRemoteAudioStats "onRemoteAudioStats" callback instead. + + The SDK triggers this callback once every two seconds to report the audio quality of each remote user/host sending an audio stream. If a channel has multiple users/hosts sending audio streams, the SDK triggers this callback as many times. + + @param uid User ID of the speaker. + @param quality Audio quality of the user: #QUALITY_TYPE. + @param delay Time delay (ms) of sending the audio packet from the sender to the receiver, including the time delay of audio sampling pre-processing, transmission, and the jitter buffer. + @param lost Packet loss rate (%) of the audio packet sent from the sender to the receiver. + */ + virtual void onAudioQuality(uid_t uid, int quality, unsigned short delay, unsigned short lost) { + (void)uid; + (void)quality; + (void)delay; + (void)lost; + } + + /** Reports the statistics of the current call. + + The SDK triggers this callback once every two seconds after the user joins the channel. + + @param stats Statistics of the RtcEngine: RtcStats. + */ + virtual void onRtcStats(const RtcStats& stats) { + (void)stats; + } + + /** Reports the last mile network quality of each user in the channel once every two seconds. + + Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. + + @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 × 480 and a frame rate of 15 fps in the Live-broadcast profile, but may be inadequate for resolutions higher than 1280 × 720. See #QUALITY_TYPE. + @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. + */ + virtual void onNetworkQuality(uid_t uid, int txQuality, int rxQuality) { + (void)uid; + (void)txQuality; + (void)rxQuality; + } + + /** Reports the statistics of the local video stream. + * + * The SDK triggers this callback once every two seconds for each + * user/host. If there are multiple users/hosts in the channel, the SDK + * triggers this callback as many times. + * + * @note + * If you have called the \ref agora::rtc::IRtcEngine::enableDualStream + * "enableDualStream" method, the \ref onLocalVideoStats() + * "onLocalVideoStats" callback reports the statistics of the high-video + * stream (high bitrate, and high-resolution video stream). + * + * @param stats Statistics of the local video stream. See LocalVideoStats. + */ + virtual void onLocalVideoStats(const LocalVideoStats& stats) { + (void)stats; + } + + /** Reports the statistics of the video stream from each remote user/host. + * + * The SDK triggers this callback once every two seconds for each remote + * user/host. If a channel includes multiple remote users, the SDK + * triggers this callback as many times. + * + * @param stats Statistics of the remote video stream. See + * RemoteVideoStats. + */ + virtual void onRemoteVideoStats(const RemoteVideoStats& stats) { + (void)stats; + } + + /** Reports the statistics of the local audio stream. + * + * The SDK triggers this callback once every two seconds. + * + * @param stats The statistics of the local audio stream. + * See LocalAudioStats. + */ + virtual void onLocalAudioStats(const LocalAudioStats& stats) { + (void)stats; + } + + /** Reports the statistics of the audio stream from each remote user/host. + + This callback replaces the \ref agora::rtc::IRtcEngineEventHandler::onAudioQuality "onAudioQuality" callback. + + The SDK triggers this callback once every two seconds for each remote user/host. If a channel includes multiple remote users, the SDK triggers this callback as many times. + + @param stats Pointer to the statistics of the received remote audio streams. See RemoteAudioStats. + */ + virtual void onRemoteAudioStats(const RemoteAudioStats& stats) { + (void)stats; + } + + /** Occurs when the local audio state changes. + * + * This callback indicates the state change of the local audio stream, + * including the state of the audio recording and encoding, and allows + * you to troubleshoot issues when exceptions occur. + * + * @note + * When the state is #LOCAL_AUDIO_STREAM_STATE_FAILED (3), see the `error` + * parameter for details. + * + * @param state State of the local audio. See #LOCAL_AUDIO_STREAM_STATE. + * @param error The error information of the local audio. + * See #LOCAL_AUDIO_STREAM_ERROR. + */ + virtual void onLocalAudioStateChanged(LOCAL_AUDIO_STREAM_STATE state, LOCAL_AUDIO_STREAM_ERROR error) { + (void)state; + (void)error; + } + + /** Occurs when the remote audio state changes. + * + * This callback indicates the state change of the remote audio stream. + * + * @param uid ID of the remote user whose audio state changes. + * @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + * @param reason The reason of the remote audio state change. + * See #REMOTE_AUDIO_STATE_REASON. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK + * triggers this callback. + */ + virtual void onRemoteAudioStateChanged(uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { + (void)uid; + (void)state; + (void)reason; + (void)elapsed; + } + + /** Reports which users are speaking, the speakers' volume and whether the local user is speaking. + + This callback reports the IDs and volumes of the loudest speakers at the moment in the channel, and whether the local user is speaking. + + By default, this callback is disabled. You can enable it by calling the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. + Once enabled, this callback is triggered at the set interval, regardless of whether a user speaks or not. + + The SDK triggers two independent `onAudioVolumeIndication` callbacks at one time, which separately report the volume information of the local user and all the remote speakers. + For more information, see the detailed parameter descriptions. + + @note + - To enable the voice activity detection of the local user, ensure that you set `report_vad`(true) in the `enableAudioVolumeIndication` method. + - Calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method affects the SDK's behavior: + - If the local user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method, the SDK stops triggering the local user's callback. + - 20 seconds after a remote speaker calls the *muteLocalAudioStream* method, the remote speakers' callback excludes this remote user's information; 20 seconds after all remote users call the *muteLocalAudioStream* method, the SDK stops triggering the remote speakers' callback. + - An empty @p speakers array in the *onAudioVolumeIndication* callback suggests that no remote user is speaking at the moment. + + @param speakers A pointer to AudioVolumeInfo: + - In the local user's callback, this struct contains the following members: + - `uid` = 0, + - `volume` = `totalVolume`, which reports the sum of the voice volume and audio-mixing volume of the local user, and + - `vad`, which reports the voice activity status of the local user. + - In the remote speakers' callback, this array contains the following members: + - `uid` of the remote speaker, + - `volume`, which reports the sum of the voice volume and audio-mixing volume of each remote speaker, and + - `vad` = 0. + + An empty speakers array in the callback indicates that no remote user is speaking at the moment. + @param speakerNumber Total number of speakers. The value range is [0, 3]. + - In the local user’s callback, `speakerNumber` = 1, regardless of whether the local user speaks or not. + - In the remote speakers' callback, the callback reports the IDs and volumes of the three loudest speakers when there are more than three remote users in the channel, and `speakerNumber` = 3. + @param totalVolume Total volume after audio mixing. The value ranges between 0 (lowest volume) and 255 (highest volume). + - In the local user’s callback, `totalVolume` is the sum of the voice volume and audio-mixing volume of the local user. + - In the remote speakers' callback, `totalVolume` is the sum of the voice volume and audio-mixing volume of all the remote speakers. + */ + virtual void onAudioVolumeIndication(const AudioVolumeInfo* speakers, unsigned int speakerNumber, int totalVolume) { + (void)speakers; + (void)speakerNumber; + (void)totalVolume; + } + + /** Reports which user is the loudest speaker. + + If the user enables the audio volume indication by calling the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method, this callback returns the @p uid of the active speaker detected by the audio volume detection module of the SDK. + + @note + - To receive this callback, you need to call the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. + - This callback returns the user ID of the user with the highest voice volume during a period of time, instead of at the moment. + + @param uid User ID of the active speaker. A @p uid of 0 represents the local user. + */ + virtual void onActiveSpeaker(uid_t uid) { + (void)uid; + } + + /** **DEPRECATED** Occurs when the video stops playing. + + The application can use this callback to change the configuration of the view (for example, displaying other pictures in the view) after the video stops playing. + + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_STOPPED(0) in the \ref agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. + */ + virtual void onVideoStopped() {} + + /** Occurs when the first local video frame is displayed/rendered on the local video view. + + @param width Width (px) of the first local video frame. + @param height Height (px) of the first local video frame. + @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + If you call the \ref IRtcEngine::startPreview "startPreview" method before calling the *joinChannel* method, then @p elapsed is the time elapsed from calling the *startPreview* method until the SDK triggers this callback. + */ + virtual void onFirstLocalVideoFrame(int width, int height, int elapsed) { + (void)width; + (void)height; + (void)elapsed; + } + + /** Occurs when the first remote video frame is received and decoded. + * + * @deprecated + * This callback is deprecated and replaced by the + * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback + * with the following parameters: + * - #REMOTE_VIDEO_STATE_STARTING (1) + * - #REMOTE_VIDEO_STATE_DECODING (2) + * + * This callback is triggered in either of the following scenarios: + * + * - The remote user joins the channel and sends the video stream. + * - The remote user stops sending the video stream and re-sends it after + * 15 seconds. Reasons for such an interruption include: + * - The remote user leaves the channel. + * - The remote user drops offline. + * - The remote user calls the + * \ref agora::rtc::IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" + * method to stop sending the video stream. + * - The remote user calls the + * \ref agora::rtc::IRtcEngine::disableVideo "disableVideo" method to + * disable video. + * + * The application can configure the user view settings in this callback. + * + * @param uid User ID of the remote user sending the video stream. + * @param width Width (px) of the video stream. + * @param height Height (px) of the video stream. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK + * triggers this callback. + */ + virtual void onFirstRemoteVideoDecoded(uid_t uid, int width, int height, int elapsed) { + (void)uid; + (void)width; + (void)height; + (void)elapsed; + } + + /** Occurs when the first remote video frame is rendered. + + The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. + + @param uid User ID of the remote user sending the video stream. + @param width Width (px) of the video frame. + @param height Height (px) of the video stream. + @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + */ + virtual void onFirstRemoteVideoFrame(uid_t uid, int width, int height, int elapsed) { + (void)uid; + (void)width; + (void)height; + (void)elapsed; + } + + /** Occurs when a remote user's audio stream playback pauses/resumes. + + The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. + @note This callback returns invalid when the number of users in a channel exceeds 20. + + @param uid User ID of the remote user. + @param muted Whether the remote user's audio stream is muted/unmuted: + - true: Muted. + - false: Unmuted. + */ + virtual void onUserMuteAudio(uid_t uid, bool muted) { + (void)uid; + (void)muted; + } + + /** Occurs when a remote user's video stream playback pauses/resumes. + * + * You can also use the + * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback + * with the following parameters: + * - #REMOTE_VIDEO_STATE_STOPPED (0) and + * #REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED (5). + * - #REMOTE_VIDEO_STATE_DECODING (2) and + * #REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED (6). + * + * The SDK triggers this callback when the remote user stops or resumes + * sending the video stream by calling the + * \ref agora::rtc::IRtcEngine::muteLocalVideoStream + * "muteLocalVideoStream" method. + * + * @note This callback returns invalid when the number of users in a + * channel exceeds 20. + * + * @param uid User ID of the remote user. + * @param muted Whether the remote user's video stream playback is + * paused/resumed: + * - true: Paused. + * - false: Resumed. + */ + virtual void onUserMuteVideo(uid_t uid, bool muted) { + (void)uid; + (void)muted; + } + + /** Occurs when a specific remote user enables/disables the video + * module. + * + * @deprecated + * This callback is deprecated and replaced by the + * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback + * with the following parameters: + * - #REMOTE_VIDEO_STATE_STOPPED (0) and + * #REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED (5). + * - #REMOTE_VIDEO_STATE_DECODING (2) and + * #REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED (6). + * + * Once the video module is disabled, the remote user can only use a + * voice call. The remote user cannot send or receive any video from + * other users. + * + * The SDK triggers this callback when the remote user enables or disables + * the video module by calling the + * \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" or + * \ref agora::rtc::IRtcEngine::disableVideo "disableVideo" method. + * + * @note This callback returns invalid when the number of users in a + * channel exceeds 20. + * + * @param uid User ID of the remote user. + * @param enabled Whether the remote user enables/disables the video + * module: + * - true: Enable. The remote user can enter a video session. + * - false: Disable. The remote user can only enter a voice session, and + * cannot send or receive any video stream. + */ + virtual void onUserEnableVideo(uid_t uid, bool enabled) { + (void)uid; + (void)enabled; + } + + /** Occurs when the audio device state changes. + + This callback notifies the application that the system's audio device state is changed. For example, a headset is unplugged from the device. + + @param deviceId Pointer to the device ID. + @param deviceType Device type: #MEDIA_DEVICE_TYPE. + @param deviceState Device state: #MEDIA_DEVICE_STATE_TYPE. + */ + virtual void onAudioDeviceStateChanged(const char* deviceId, int deviceType, int deviceState) { + (void)deviceId; + (void)deviceType; + (void)deviceState; + } + + /** Occurs when the volume of the playback device, microphone, or application changes. + + @param deviceType Device type: #MEDIA_DEVICE_TYPE. + @param volume Volume of the device. The value ranges between 0 and 255. + @param muted + - true: The audio device is muted. + - false: The audio device is not muted. + */ + virtual void onAudioDeviceVolumeChanged(MEDIA_DEVICE_TYPE deviceType, int volume, bool muted) { + (void)deviceType; + (void)volume; + (void)muted; + } + + /** **DEPRECATED** Occurs when the camera turns on and is ready to capture the video. + + If the camera fails to turn on, fix the error reported in the \ref IRtcEngineEventHandler::onError "onError" callback. + + Deprecated as of v2.4.1. Use #LOCAL_VIDEO_STREAM_STATE_CAPTURING (1) in the \ref agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. + */ + virtual void onCameraReady() {} + + /** Occurs when the camera focus area changes. + + The SDK triggers this callback when the local user changes the camera focus position by calling the setCameraFocusPositionInPreview method. + + @note This callback is for Android and iOS only. + + @param x x coordinate of the changed camera focus area. + @param y y coordinate of the changed camera focus area. + @param width Width of the changed camera focus area. + @param height Height of the changed camera focus area. + */ + virtual void onCameraFocusAreaChanged(int x, int y, int width, int height) { + (void)x; + (void)y; + (void)width; + (void)height; + } + + /** Occurs when the camera exposure area changes. + + The SDK triggers this callback when the local user changes the camera exposure position by calling the setCameraExposurePosition method. + + @note This callback is for Android and iOS only. + + @param x x coordinate of the changed camera exposure area. + @param y y coordinate of the changed camera exposure area. + @param width Width of the changed camera exposure area. + @param height Height of the changed camera exposure area. + */ + virtual void onCameraExposureAreaChanged(int x, int y, int width, int height) { + (void)x; + (void)y; + (void)width; + (void)height; + } + + /** Occurs when the audio mixing file playback finishes. + + **DEPRECATED** use onAudioMixingStateChanged instead. + + You can start an audio mixing file playback by calling the \ref IRtcEngine::startAudioMixing "startAudioMixing" method. The SDK triggers this callback when the audio mixing file playback finishes. + + If the *startAudioMixing* method call fails, an error code returns in the \ref IRtcEngineEventHandler::onError "onError" callback. + + */ + virtual void onAudioMixingFinished() { + } + + /** Occurs when the state of the local user's audio mixing file changes. + + - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. + - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. + - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. + + @param state The state code. See #AUDIO_MIXING_STATE_TYPE. + @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. + */ + virtual void onAudioMixingStateChanged(AUDIO_MIXING_STATE_TYPE state, AUDIO_MIXING_ERROR_TYPE errorCode){ + } + /** Occurs when a remote user starts audio mixing. + + When a remote user calls \ref IRtcEngine::startAudioMixing "startAudioMixing" to play the background music, the SDK reports this callback. + */ + virtual void onRemoteAudioMixingBegin() { + } + /** Occurs when a remote user finishes audio mixing. + */ + virtual void onRemoteAudioMixingEnd() { + } + + /** Occurs when the local audio effect playback finishes. + + The SDK triggers this callback when the local audio effect file playback finishes. + + @param soundId ID of the local audio effect. Each local audio effect has a unique ID. + */ + virtual void onAudioEffectFinished(int soundId) { + } + + + /** + Occurs when the SDK decodes the first remote audio frame for playback. + + This callback is triggered in either of the following scenarios: + + - The remote user joins the channel and sends the audio stream. + - The remote user stops sending the audio stream and re-sends it after 15 seconds. Reasons for such an interruption include: + - The remote user leaves channel. + - The remote user drops offline. + - The remote user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method to stop sending the local audio stream. + - The remote user calls the \ref agora::rtc::IRtcEngine::disableAudio "disableAudio" method to disable audio. + + @param uid User ID of the remote user sending the audio stream. + @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + */ + virtual void onFirstRemoteAudioDecoded(uid_t uid, int elapsed) { + (void)uid; + (void)elapsed; + } + + /** Occurs when the video device state changes. + + @note On a Windows device with an external camera for video capturing, the video disables once the external camera is unplugged. + + @param deviceId Pointer to the device ID of the video device that changes state. + @param deviceType Device type: #MEDIA_DEVICE_TYPE. + @param deviceState Device state: #MEDIA_DEVICE_STATE_TYPE. + */ + virtual void onVideoDeviceStateChanged(const char* deviceId, int deviceType, int deviceState) { + (void)deviceId; + (void)deviceType; + (void)deviceState; + } + + /** Occurs when the local video stream state changes. + + This callback indicates the state of the local video stream, including camera capturing and video encoding, and allows you to troubleshoot issues when exceptions occur. + + @note For some device models, the SDK will not trigger this callback when the state of the local video changes while the local video capturing device is in use, so you have to make your own timeout judgment. + + @param localVideoState State type #LOCAL_VIDEO_STREAM_STATE. When the state is LOCAL_VIDEO_STREAM_STATE_FAILED (3), see the `error` parameter for details. + @param error The detailed error information: #LOCAL_VIDEO_STREAM_ERROR. + */ + virtual void onLocalVideoStateChanged(LOCAL_VIDEO_STREAM_STATE localVideoState, LOCAL_VIDEO_STREAM_ERROR error) { + (void)localVideoState; + (void)error; + } + + /** Occurs when the video size or rotation of a specified user changes. + + @param uid User ID of the remote user or local user (0) whose video size or rotation changes. + @param width New width (pixels) of the video. + @param height New height (pixels) of the video. + @param rotation New rotation of the video [0 to 360). + */ + virtual void onVideoSizeChanged(uid_t uid, int width, int height, int rotation) { + (void)uid; + (void)width; + (void)height; + (void)rotation; + } + /** Occurs when the remote video state changes. + * + * @param uid ID of the remote user whose video state changes. + * @param state State of the remote video. See #REMOTE_VIDEO_STATE. + * @param reason The reason of the remote video state change. See + * #REMOTE_VIDEO_STATE_REASON. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the + * SDK triggers this callback. + */ + virtual void onRemoteVideoStateChanged(uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { + (void)uid; + (void)state; + (void)reason; + (void)elapsed; + } + + /** Occurs when a specified remote user enables/disables the local video + * capturing function. + * + * @deprecated + * This callback is deprecated and replaced by the + * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback + * with the following parameters: + * - #REMOTE_VIDEO_STATE_STOPPED (0) and + * #REMOTE_VIDEO_STATE_REASON_REMOTE_MUTED (5). + * - #REMOTE_VIDEO_STATE_DECODING (2) and + * #REMOTE_VIDEO_STATE_REASON_REMOTE_UNMUTED (6). + * + * This callback is only applicable to the scenario when the user only + * wants to watch the remote video without sending any video stream to the + * other user. + * + * The SDK triggers this callback when the remote user resumes or stops + * capturing the video stream by calling the + * \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method. + * + * @param uid User ID of the remote user. + * @param enabled Whether the specified remote user enables/disables the + * local video capturing function: + * - true: Enable. Other users in the channel can see the video of this + * remote user. + * - false: Disable. Other users in the channel can no longer receive the + * video stream from this remote user, while this remote user can still + * receive the video streams from other users. + */ + virtual void onUserEnableLocalVideo(uid_t uid, bool enabled) { + (void)uid; + (void)enabled; + } + +// virtual void onStreamError(int streamId, int code, int parameter, const char* message, size_t length) {} + /** Occurs when the local user receives the data stream from the remote user within five seconds. + + The SDK triggers this callback when the local user receives the stream message that the remote user sends by calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. + @param uid User ID of the remote user sending the message. + @param streamId Stream ID. + @param data Pointer to the data received by the local user. + @param length Length of the data in bytes. + */ + virtual void onStreamMessage(uid_t uid, int streamId, const char* data, size_t length) { + (void)uid; + (void)streamId; + (void)data; + (void)length; + } + + /** Occurs when the local user does not receive the data stream from the remote user within five seconds. + + The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. + @param uid User ID of the remote user sending the message. + @param streamId Stream ID. + @param code Error code: #ERROR_CODE_TYPE. + @param missed Number of lost messages. + @param cached Number of incoming cached messages when the data stream is interrupted. + */ + virtual void onStreamMessageError(uid_t uid, int streamId, int code, int missed, int cached) { + (void)uid; + (void)streamId; + (void)code; + (void)missed; + (void)cached; + } + + /** Occurs when the media engine loads.*/ + virtual void onMediaEngineLoadSuccess() { + } + /** Occurs when the media engine call starts.*/ + virtual void onMediaEngineStartCallSuccess() { + } + + /** Occurs when the state of the media stream relay changes. + * + * The SDK returns the state of the current media relay with any error + * message. + * + * @param state The state code in #CHANNEL_MEDIA_RELAY_STATE. + * @param code The error code in #CHANNEL_MEDIA_RELAY_ERROR. + */ + virtual void onChannelMediaRelayStateChanged(CHANNEL_MEDIA_RELAY_STATE state,CHANNEL_MEDIA_RELAY_ERROR code) { + } + + /** Reports events during the media stream relay. + * + * @param code The event code in #CHANNEL_MEDIA_RELAY_EVENT. + */ + virtual void onChannelMediaRelayEvent(CHANNEL_MEDIA_RELAY_EVENT code) { + } + + /** Occurs when the engine sends the first local audio frame. + + @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ + virtual void onFirstLocalAudioFrame(int elapsed) { + (void)elapsed; + } + + /** Occurs when the engine receives the first audio frame from a specific remote user. + + @param uid User ID of the remote user. + @param elapsed Time elapsed (ms) from the remote user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ + virtual void onFirstRemoteAudioFrame(uid_t uid, int elapsed) { + (void)uid; + (void)elapsed; + } + + /** + Occurs when the state of the RTMP streaming changes. + + The SDK triggers this callback to report the result of the local user calling the \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" or \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. + + This callback indicates the state of the RTMP streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. + + @param url The RTMP URL address. + @param state The RTMP streaming state. See: #RTMP_STREAM_PUBLISH_STATE. + @param errCode The detailed error information for streaming. See: #RTMP_STREAM_PUBLISH_ERROR. + */ + virtual void onRtmpStreamingStateChanged(const char *url, RTMP_STREAM_PUBLISH_STATE state, RTMP_STREAM_PUBLISH_ERROR errCode) { + (void) url; + (void) state; + (void) errCode; + } + + /** Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) + + @param url The RTMP URL address. + @param error Error code: #ERROR_CODE_TYPE. Main errors include: + - #ERR_OK (0): The publishing succeeds. + - #ERR_FAILED (1): The publishing fails. + - #ERR_INVALID_ARGUMENT (2): Invalid argument used. If, for example, you did not call \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" to configure LiveTranscoding before calling \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl", the SDK reports #ERR_INVALID_ARGUMENT. + - #ERR_TIMEDOUT (10): The publishing timed out. + - #ERR_ALREADY_IN_USE (19): The chosen URL address is already in use for CDN live streaming. + - #ERR_RESOURCE_LIMITED (22): The backend system does not have enough resources for the CDN live streaming. + - #ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH (130): You cannot publish an encrypted stream. + - #ERR_PUBLISH_STREAM_CDN_ERROR (151) + - #ERR_PUBLISH_STREAM_NUM_REACH_LIMIT (152) + - #ERR_PUBLISH_STREAM_NOT_AUTHORIZED (153) + - #ERR_PUBLISH_STREAM_INTERNAL_SERVER_ERROR (154) + - #ERR_PUBLISH_STREAM_FORMAT_NOT_SUPPORTED (156) + */ + virtual void onStreamPublished(const char *url, int error) { + (void)url; + (void)error; + } + /** Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) + + This callback indicates whether you have successfully removed an RTMP stream from the CDN. + + @param url The RTMP URL address. + */ + virtual void onStreamUnpublished(const char *url) { + (void)url; + } +/** Occurs when the publisher's transcoding is updated. + * + * When the `LiveTranscoding` class in the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. + * + * @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + * + */ + virtual void onTranscodingUpdated() { + } + /** Occurs when a voice or video stream URL address is added to a live broadcast. + + @param url Pointer to the URL address of the externally injected stream. + @param uid User ID. + @param status State of the externally injected stream: #INJECT_STREAM_STATUS. + */ + virtual void onStreamInjectedStatus(const char* url, uid_t uid, int status) { + (void)url; + (void)uid; + (void)status; + } + + /** Occurs when the local audio route changes. + + The SDK triggers this callback when the local audio route switches to an earpiece, speakerphone, headset, or Bluetooth device. + + @note This callback is for Android and iOS only. + + @param routing Audio output routing. See: #AUDIO_ROUTE_TYPE. + */ + virtual void onAudioRouteChanged(AUDIO_ROUTE_TYPE routing) { + (void)routing; + } + + /** Occurs when the locally published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. + + If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the locally published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + + @param isFallbackOrRecover Whether the locally published stream falls back to audio-only or switches back to the video: + - true: The locally published stream falls back to audio-only due to poor network conditions. + - false: The locally published stream switches back to the video after the network conditions improve. + */ + virtual void onLocalPublishFallbackToAudioOnly(bool isFallbackOrRecover) { + (void)isFallbackOrRecover; + } + + /** Occurs when the remote media stream falls back to audio-only stream + * due to poor network conditions or switches back to the video stream + * after the network conditions improve. + * + * If you call + * \ref IRtcEngine::setRemoteSubscribeFallbackOption + * "setRemoteSubscribeFallbackOption" and set + * @p option as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this + * callback when the remote media stream falls back to audio-only mode due + * to poor uplink conditions, or when the remote media stream switches + * back to the video after the uplink network condition improves. + * + * @note Once the remote media stream switches to the low stream due to + * poor network conditions, you can monitor the stream switch between a + * high and low stream in the RemoteVideoStats callback. + * + * @param uid ID of the remote user sending the stream. + * @param isFallbackOrRecover Whether the remotely subscribed media stream + * falls back to audio-only or switches back to the video: + * - true: The remotely subscribed media stream falls back to audio-only + * due to poor network conditions. + * - false: The remotely subscribed media stream switches back to the + * video stream after the network conditions improved. + */ + virtual void onRemoteSubscribeFallbackToAudioOnly(uid_t uid, bool isFallbackOrRecover) { + (void)uid; + (void)isFallbackOrRecover; + } + + /** Reports the transport-layer statistics of each remote audio stream. + * + * @deprecated + * This callback is deprecated and replaced by the + * \ref onRemoteAudioStats() "onRemoteAudioStats" callback. + * + * This callback reports the transport-layer statistics, such as the + * packet loss rate and network time delay, once every two seconds after + * the local user receives an audio packet from a remote user. + * + * @param uid User ID of the remote user sending the audio packet. + * @param delay Network time delay (ms) from the remote user sending the + * audio packet to the local user. + * @param lost Packet loss rate (%) of the audio packet sent from the + * remote user. + * @param rxKBitRate Received bitrate (Kbps) of the audio packet sent + * from the remote user. + */ + virtual void onRemoteAudioTransportStats( + uid_t uid, unsigned short delay, unsigned short lost, + unsigned short rxKBitRate) { + (void)uid; + (void)delay; + (void)lost; + (void)rxKBitRate; + } + + /** Reports the transport-layer statistics of each remote video stream. + * + * @deprecated + * This callback is deprecated and replaced by the + * \ref onRemoteVideoStats() "onRemoteVideoStats" callback. + * + * This callback reports the transport-layer statistics, such as the + * packet loss rate and network time delay, once every two seconds after + * the local user receives a video packet from a remote user. + * + * @param uid User ID of the remote user sending the video packet. + * @param delay Network time delay (ms) from the remote user sending the + * video packet to the local user. + * @param lost Packet loss rate (%) of the video packet sent from the + * remote user. + * @param rxKBitRate Received bitrate (Kbps) of the video packet sent + * from the remote user. + */ + virtual void onRemoteVideoTransportStats( + uid_t uid, unsigned short delay, unsigned short lost, + unsigned short rxKBitRate) { + (void)uid; + (void)delay; + (void)lost; + (void)rxKBitRate; + } + + /** **DEPRECATED** Occurs when the microphone is enabled/disabled. + * + * The \ref onMicrophoneEnabled() "onMicrophoneEnabled" callback is + * deprecated. Use #LOCAL_AUDIO_STREAM_STATE_STOPPED (0) or + * #LOCAL_AUDIO_STREAM_STATE_RECORDING (1) in the + * \ref onLocalAudioStateChanged() "onLocalAudioStateChanged" callback + * instead. + * + * The SDK triggers this callback when the local user resumes or stops + * capturing the local audio stream by calling the + * \ref agora::rtc::IRtcEngine::enableLocalAudio "enbaleLocalAudio" method. + * + * @param enabled Whether the microphone is enabled/disabled: + * - true: Enabled. + * - false: Disabled. + */ + virtual void onMicrophoneEnabled(bool enabled) { + (void)enabled; + } + /** Occurs when the connection state between the SDK and the server changes. + + @param state See #CONNECTION_STATE_TYPE. + @param reason See #CONNECTION_CHANGED_REASON_TYPE. + */ + virtual void onConnectionStateChanged( + CONNECTION_STATE_TYPE state, CONNECTION_CHANGED_REASON_TYPE reason) { + (void)state; + (void)reason; + } + + /** Occurs when the local network type changes. + + When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. + + @param type See #NETWORK_TYPE. + */ + virtual void onNetworkTypeChanged(NETWORK_TYPE type) { + (void)type; + } + /** Occurs when the local user successfully registers a user account by calling the \ref agora::rtc::IRtcEngine::registerLocalUserAccount "registerLocalUserAccount" method or joins a channel by calling the \ref agora::rtc::IRtcEngine::joinChannelWithUserAccount "joinChannelWithUserAccount" method.This callback reports the user ID and user account of the local user. + + @param uid The ID of the local user. + @param userAccount The user account of the local user. + */ + virtual void onLocalUserRegistered(uid_t uid, const char* userAccount) { + (void)uid; + (void)userAccount; + } + /** Occurs when the SDK gets the user ID and user account of the remote user. + + After a remote user joins the channel, the SDK gets the UID and user account of the remote user, + caches them in a mapping table object (`userInfo`), and triggers this callback on the local client. + + @param uid The ID of the remote user. + @param info The `UserInfo` object that contains the user ID and user account of the remote user. + */ + virtual void onUserInfoUpdated(uid_t uid, const UserInfo& info) { + (void)uid; + (void)info; + } +}; + +/** +* Video device collection methods. + + The IVideoDeviceCollection interface class retrieves the video device information. +*/ +class IVideoDeviceCollection +{ +protected: + virtual ~IVideoDeviceCollection(){} +public: + /** Retrieves the total number of the indexed video devices in the system. + + @return Total number of the indexed video devices: + */ + virtual int getCount() = 0; + + /** Retrieves a specified piece of information about an indexed video device. + + @param index The specified index of the video device that must be less than the return value of \ref IVideoDeviceCollection::getCount "getCount". + @param deviceName Pointer to the video device name. + @param deviceId Pointer to the video device ID. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getDevice(int index, char deviceName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Sets the device with the device ID. + + @param deviceId Device ID of the device. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Releases all IVideoDeviceCollection resources. + */ + virtual void release() = 0; +}; + +/** Video device management methods. + + The IVideoDeviceManager interface class tests the video device interfaces. Instantiate an AVideoDeviceManager class to retrieve an IVideoDeviceManager interface. +*/ +class IVideoDeviceManager +{ +protected: + virtual ~IVideoDeviceManager(){} +public: + + /** Enumerates the video devices. + + This method returns an IVideoDeviceCollection object including all video devices in the system. With the IVideoDeviceCollection object, the application can enumerate the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. + + @return + - An IVideoDeviceCollection object including all video devices in the system: Success. + - NULL: Failure. + */ + virtual IVideoDeviceCollection* enumerateVideoDevices() = 0; + + /** Starts the video-capture device test. + + This method tests whether the video-capture device works properly. Before calling this method, ensure that you have already called the \ref IRtcEngine::enableVideo "enableVideo" method, and the window handle (*hwnd*) parameter is valid. + + @param hwnd The window handle used to display the screen. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startDeviceTest(view_t hwnd) = 0; + + /** Stops the video-capture device test. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopDeviceTest() = 0; + + /** Sets a device with the device ID. + + @param deviceId Pointer to the video-capture device ID. Call the \ref IVideoDeviceManager::enumerateVideoDevices "enumerateVideoDevices" method to retrieve it. + + @note Plugging or unplugging the device does not change the device ID. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Retrieves the video-capture device that is in use. + + @param deviceId Pointer to the video-capture device ID. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Releases all IVideoDeviceManager resources. + */ + virtual void release() = 0; +}; + +/** Audio device collection methods. + +The IAudioDeviceCollection interface class retrieves device-related information. +*/ +class IAudioDeviceCollection +{ +protected: + virtual ~IAudioDeviceCollection(){} +public: + + /** Retrieves the total number of audio playback or audio recording devices. + + @note You must first call the \ref IAudioDeviceManager::enumeratePlaybackDevices "enumeratePlaybackDevices" or \ref IAudioDeviceManager::enumerateRecordingDevices "enumerateRecordingDevices" method before calling this method to return the number of audio playback or audio recording devices. + + @return Number of audio playback or audio recording devices. + */ + virtual int getCount() = 0; + + /** Retrieves a specified piece of information about an indexed audio device. + + @param index The specified index that must be less than the return value of \ref IAudioDeviceCollection::getCount "getCount". + @param deviceName Pointer to the audio device name. + @param deviceId Pointer to the audio device ID. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getDevice(int index, char deviceName[MAX_DEVICE_ID_LENGTH], char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Specifies a device with the device ID. + + @param deviceId Pointer to the device ID of the device. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Sets the volume of the application. + + @param volume Application volume. The value ranges between 0 (lowest volume) and 255 (highest volume). + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setApplicationVolume(int volume) = 0; + + /** Retrieves the volume of the application. + + @param volume Pointer to the application volume. The volume value ranges between 0 (lowest volume) and 255 (highest volume). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getApplicationVolume(int& volume) = 0; + + /** Mutes the application. + + @param mute Sets whether to mute/unmute the application: + - true: Mute the application. + - false: Unmute the application. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setApplicationMute(bool mute) = 0; + /** Gets the mute state of the application. + + @param mute Pointer to whether the application is muted/unmuted. + - true: The application is muted. + - false: The application is not muted. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int isApplicationMute(bool& mute) = 0; + + /** Releases all IAudioDeviceCollection resources. + */ + virtual void release() = 0; +}; +/** Audio device management methods. + + The IAudioDeviceManager interface class allows for audio device interface testing. Instantiate an AAudioDeviceManager class to retrieve the IAudioDeviceManager interface. +*/ +class IAudioDeviceManager +{ +protected: + virtual ~IAudioDeviceManager(){} +public: + + /** Enumerates the audio playback devices. + + This method returns an IAudioDeviceCollection object that includes all audio playback devices in the system. With the IAudioDeviceCollection object, the application can enumerate the audio playback devices. + + @note The application must call the \ref IAudioDeviceCollection::release "release" method to release the returned object after using it. + + @return + - Success: Returns an IAudioDeviceCollection object that includes all audio playback devices in the system. For wireless Bluetooth headset devices with master and slave headsets, the master headset is the playback device. + - Returns NULL: Failure. + */ + virtual IAudioDeviceCollection* enumeratePlaybackDevices() = 0; + + /** Enumerates the audio recording devices. + + This method returns an IAudioDeviceCollection object that includes all audio recording devices in the system. With the IAudioDeviceCollection object, the application can enumerate the audio recording devices. + + @note The application needs to call the \ref IAudioDeviceCollection::release "release" method to release the returned object after using it. + + @return + - Returns an IAudioDeviceCollection object that includes all audio recording devices in the system: Success. + - Returns NULL: Failure. + */ + virtual IAudioDeviceCollection* enumerateRecordingDevices() = 0; + + /** Sets the audio playback device using the device ID. + + @note Plugging or unplugging the audio device does not change the device ID. + + @param deviceId Device ID of the audio playback device, retrieved by calling the \ref IAudioDeviceManager::enumeratePlaybackDevices "enumeratePlaybackDevices" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setPlaybackDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Sets the audio recording device using the device ID. + + @param deviceId Device ID of the audio recording device, retrieved by calling the \ref IAudioDeviceManager::enumerateRecordingDevices "enumerateRecordingDevices" method. + + @note Plugging or unplugging the audio device does not change the device ID. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRecordingDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Starts the audio playback device test. + + This method tests if the playback device works properly. In the test, the SDK plays an audio file specified by the user. If the user can hear the audio, the playback device works properly. + + @param testAudioFilePath Pointer to the path of the audio file for the audio playback device test in UTF-8: + - Supported file formats: wav, mp3, m4a, and aac. + - Supported file sample rates: 8000, 16000, 32000, 44100, and 48000 Hz. + + @return + - 0: Success, and you can hear the sound of the specified audio file. + - < 0: Failure. + */ + virtual int startPlaybackDeviceTest(const char* testAudioFilePath) = 0; + + /** Stops the audio playback device test. + + This method stops testing the audio playback device. You must call this method to stop the test after calling the \ref IAudioDeviceManager::startPlaybackDeviceTest "startPlaybackDeviceTest" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopPlaybackDeviceTest() = 0; + + /** Sets the volume of the audio playback device. + + @param volume Sets the volume of the audio playback device. The value ranges between 0 (lowest volume) and 255 (highest volume). + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setPlaybackDeviceVolume(int volume) = 0; + + /** Retrieves the volume of the audio playback device. + + @param volume Pointer to the audio playback device volume. The volume value ranges between 0 (lowest volume) and 255 (highest volume). + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getPlaybackDeviceVolume(int *volume) = 0; + + /** Sets the volume of the microphone. + + @param volume Sets the volume of the microphone. The value ranges between 0 (lowest volume) and 255 (highest volume). + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRecordingDeviceVolume(int volume) = 0; + + /** Retrieves the volume of the microphone. + + @param volume Pointer to the microphone volume. The volume value ranges between 0 (lowest volume) and 255 (highest volume). + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getRecordingDeviceVolume(int *volume) = 0; + + /** Mutes the audio playback device. + + @param mute Sets whether to mute/unmute the audio playback device: + - true: Mutes. + - false: Unmutes. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setPlaybackDeviceMute(bool mute) = 0; + /** Retrieves the mute status of the audio playback device. + + @param mute Pointer to whether the audio playback device is muted/unmuted. + - true: Muted. + - false: Unmuted. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getPlaybackDeviceMute(bool *mute) = 0; + /** Mutes/Unmutes the microphone. + + @param mute Sets whether to mute/unmute the microphone: + - true: Mutes. + - false: Unmutes. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRecordingDeviceMute(bool mute) = 0; + + /** Retrieves the microphone's mute status. + + @param mute Pointer to whether the microphone is muted/unmuted. + - true: Muted. + - false: Unmuted. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getRecordingDeviceMute(bool *mute) = 0; + + /** Starts the microphone test. + + This method tests whether the microphone works properly. Once the test starts, the SDK uses the \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback to notify the application with the volume information. + + @param indicationInterval Interval period (ms) of the \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback cycle. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startRecordingDeviceTest(int indicationInterval) = 0; + + /** Stops the microphone test. + + This method stops the microphone test. You must call this method to stop the test after calling the \ref IAudioDeviceManager::startRecordingDeviceTest "startRecordingDeviceTest" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopRecordingDeviceTest() = 0; + + /** Retrieves the audio playback device associated with the device ID. + + @param deviceId Pointer to the ID of the audio playback device. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getPlaybackDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Retrieves the audio playback device information associated with the device ID and device name. + + @param deviceId Pointer to the device ID of the audio playback device. + @param deviceName Pointer to the device name of the audio playback device. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getPlaybackDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Retrieves the audio recording device associated with the device ID. + + @param deviceId Pointer to the device ID of the audio recording device. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getRecordingDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Retrieves the audio recording device information associated with the device ID and device name. + + @param deviceId Pointer to the device ID of the recording audio device. + @param deviceName Pointer to the device name of the recording audio device. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getRecordingDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH]) = 0; + + /** Starts the audio device loopback test. + + This method tests whether the local audio devices are working properly. After calling this method, the microphone captures the local audio and plays it through the speaker. The \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback returns the local audio volume information at the set interval. + + @note This method tests the local audio devices and does not report the network conditions. + + @param indicationInterval The time interval (ms) at which the \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback returns. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startAudioDeviceLoopbackTest(int indicationInterval) = 0; + + /** Stops the audio device loopback test. + + @note Ensure that you call this method to stop the loopback test after calling the \ref IAudioDeviceManager::startAudioDeviceLoopbackTest "startAudioDeviceLoopbackTest" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopAudioDeviceLoopbackTest() = 0; + + /** Releases all IAudioDeviceManager resources. + */ + virtual void release() = 0; +}; + +/** Definition of RtcEngineContext. +*/ +struct RtcEngineContext +{ + /** The IRtcEngineEventHandler object. + */ + IRtcEngineEventHandler* eventHandler; + /** App ID issued to you by Agora. Apply for a new App ID from Agora if + * it is missing from your kit. + */ + const char* appId; + // For android, it the context(Activity or Application + // for windows,Video hot plug device + /** The video window handle. Once set, this parameter enables you to plug + * or unplug the video devices while they are powered. + */ + void* context; + RtcEngineContext() + :eventHandler(NULL) + ,appId(NULL) + ,context(NULL) + {} +}; + +/** Definition of IMetadataObserver +*/ +class IMetadataObserver +{ +public: + /** Metadata type of the observer. + @note We only support video metadata for now. + */ + enum METADATA_TYPE + { + /** -1: the metadata type is unknown. + */ + UNKNOWN_METADATA = -1, + /** 0: the metadata type is video. + */ + VIDEO_METADATA = 0, + }; + + struct Metadata + { + /** The User ID. + + - For the receiver: the ID of the user who sent the metadata. + - For the sender: ignore it. + */ + unsigned int uid; + /** Buffer size of the sent or received Metadata. + */ + unsigned int size; + /** Buffer address of the sent or received Metadata. + */ + unsigned char *buffer; + /** Time statmp of the frame following the metadata. + */ + long long timeStampMs; + }; + + virtual ~IMetadataObserver() {}; + + /** Occurs when the SDK requests the maximum size of the Metadata. + + The metadata includes the following parameters: + - `uid`: ID of the user who sends the metadata. + - `size`: The size of the sent or received metadata. + - `buffer`: The sent or received metadata. + - `timeStampMs`: The timestamp of the metadata. + + The SDK triggers this callback after you successfully call the \ref agora::rtc::IRtcEngine::registerMediaMetadataObserver "registerMediaMetadataObserver" method. You need to specify the maximum size of the metadata in the return value of this callback. + + @return The maximum size of the buffer of the metadata that you want to use. The highest value is 1024 bytes. Ensure that you set the return value. + */ + virtual int getMaxMetadataSize() = 0; + + /** Occurs when the SDK is ready to receive and send metadata. + + @note Ensure that the size of the metadata does not exceed the value set in the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. + + @param metadata The Metadata to be sent. + @return + - true: Send. + - false: Do not send. + */ + virtual bool onReadyToSendMetadata(Metadata &metadata) = 0; + + /** Occurs when the local user receives the metadata. + + @param metadata The received Metadata. + */ + virtual void onMetadataReceived(const Metadata &metadata) = 0; +}; + +/** IRtcEngine is the base interface class of the Agora SDK that provides the main Agora SDK methods invoked by your application. + +Enable the Agora SDK's communication functionality through the creation of an IRtcEngine object, then call the methods of this object. + */ +class IRtcEngine +{ +protected: + virtual ~IRtcEngine() {} +public: + + /** Initializes the Agora service. + * + * Ensure that you call the + * \ref agora::rtc::IRtcEngine::createAgoraRtcEngine + * "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize + * "initialize" methods before calling any other API. + * + * @param context Pointer to the RTC engine context. See RtcEngineContext. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - `ERR_INVALID_APP_ID (101)`: The app ID is invalid. Check if it is in the correct format. + */ + virtual int initialize(const RtcEngineContext& context) = 0; + + /** Releases all IRtcEngine resources. + + @param sync + - true: (Synchronous call) The result returns after the IRtcEngine resources are released. The application should not call this method in the SDK generated callbacks. Otherwise, the SDK must wait for the callbacks to return to recover the associated IRtcEngine resources, resulting in a deadlock. The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to take additional time. + - false: (Asynchronous call) The result returns immediately, even when the IRtcEngine resources have not been released. The SDK releases all resources. + + @note Do not immediately uninstall the SDK's dynamic library after the call, or it may cause a crash due to the SDK clean-up thread not quitting. + */ + virtual void release(bool sync=false) = 0; + + /** Sets the channel profile of the Agora RtcEngine. + + The Agora RtcEngine differentiates channel profiles and applies optimization algorithms accordingly. + For example, it prioritizes smoothness and low latency for a video call, and prioritizes video quality for a video broadcast. + + @note + - To ensure the quality of real-time communication, we recommend that all users in a channel use the same channel profile. + - Call this method before calling \ref IRtcEngine::joinChannel "joinChannel" . You cannot set the channel profile once you have joined the channel. + + @param profile The channel profile of the Agora RtcEngine. See #CHANNEL_PROFILE_TYPE + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setChannelProfile(CHANNEL_PROFILE_TYPE profile) = 0; + + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in a live broadcast. + + This method can be used to switch the user role in a live broadcast after the user joins a channel. + + In the Live Broadcast profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) + + @note + This method applies only to the Live-broadcast profile. + + @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; + + /** Joins a channel with the user ID. + + Users in the same channel can talk to each other, and multiple users in the same channel can start a group chat. Users with different App IDs cannot call each other. + + + You must call the \ref IRtcEngine::leaveChannel "leaveChannel" method to exit the current call before entering another channel. + + A successful \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + + When the connection between the client and Agora's server is interrupted due to poor network conditions, the SDK tries reconnecting to the server. When the local client successfully rejoins the channel, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRejoinChannelSuccess "onRejoinChannelSuccess" callback on the local client. + + @note A channel does not accept duplicate uids, such as two users with the same @p uid. If you set @p uid as 0, the system automatically assigns a @p uid. If you want to join a channel from different devices, ensure that each device has a different uid. + @warning Ensure that the App ID used for creating the token is the same App ID used by the \ref IRtcEngine::initialize "initialize" method for initializing the RTC engine. Otherwise, the CDN live streaming may fail. + + @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a Channel Key. + - If the user uses a static App ID, *token* is optional and can be set as NULL. + - If the user uses a Channel Key, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. + @param channelId Pointer to the unique channel name for the Agora RTC session in the string format smaller than 64 bytes. Supported characters: + - The 26 lowercase English letters: a to z + - The 26 uppercase English letters: A to Z + - The 10 numbers: 0 to 9 + - The space + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", "," + @param info (Optional) Pointer to additional information about the channel. This parameter can be set to NULL or contain channel related information. Other users in the channel will not receive this message. + @param uid (Optional) User ID. A 32-bit unsigned integer with a value ranging from 1 to 232-1. The @p uid must be unique. If a @p uid is not assigned (or set to 0), the SDK assigns and returns a @p uid in the \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. Your application must record and maintain the returned *uid* since the SDK does not do so. + + @return + - 0: Success. + - < 0: Failure: + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) + */ + virtual int joinChannel(const char* token, const char* channelId, const char* info, uid_t uid) = 0; + /** Switches to a different channel. + * + * This method allows the audience of a Live-broadcast channel to switch + * to a different channel. + * + * After the user successfully switches to another channel, the + * \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" + * and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess + * "onJoinChannelSuccess" callbacks are triggered to indicate that the + * user has left the original channel and joined a new one. + * + * @note + * This method applies to the audience role in a Live-broadcast channel + * only. + * + * @param token The token generated at your server: + * - For low-security requirements: You can use the temporary token + * generated in Console. For details, see + * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-temporary-token). + * - For high-security requirements: Use the token generated at your + * server. For details, see + * [Get a token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-token). + * @param channelId Unique channel name for the AgoraRTC session in the + * string format. The string length must be less than 64 bytes. Supported + * character scopes are: + * - The 26 lowercase English letters: a to z. + * - The 26 uppercase English letters: A to Z. + * - The 10 numbers: 0 to 9. + * - The space. + * - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", + * ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) + */ + virtual int switchChannel(const char* token, const char* channelId) = 0; + + /** Allows a user to leave a channel, such as hanging up or exiting a call. + + After joining a channel, the user must call the *leaveChannel* method to end the call before joining another channel. + + This method returns 0 if the user leaves the channel and releases all resources related to the call. + + This method call is asynchronous, and the user has not left the channel when the method call returns. Once the user leaves the channel, the SDK triggers the \ref IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback. + + A successful \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a BROADCASTER in the Live Broadcast profile. + + @note + - If you call the \ref IRtcEngine::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. + - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int leaveChannel() = 0; + + /** Gets a new token when the current token expires after a period of time. + + The `token` expires after a period of time once the token schema is enabled when: + + - The SDK triggers the \ref IRtcEngineEventHandler::onTokenPrivilegeWillExpire "onTokenPrivilegeWillExpire" callback, or + - The \ref IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" reports CONNECTION_CHANGED_TOKEN_EXPIRED(9). + + The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. + + @param token Pointer to the new token. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int renewToken(const char* token) = 0; + + /** Retrieves the pointer to the device manager object. + + @param iid ID of the interface. + @param inter Pointer to the *DeviceManager* object. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int queryInterface(INTERFACE_ID_TYPE iid, void** inter) = 0; + + /** Registers a user account. + + Once registered, the user account can be used to identify the local user when the user joins the channel. + After the user successfully registers a user account, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" callback on the local client, + reporting the user ID and user account of the local user. + + To join a channel with a user account, you can choose either of the following: + + - Call the \ref agora::rtc::IRtcEngine::registerLocalUserAccount "registerLocalUserAccount" method to create a user account, and then the \ref agora::rtc::IRtcEngine::joinChannelWithUserAccount "joinChannelWithUserAccount" method to join the channel. + - Call the \ref agora::rtc::IRtcEngine::joinChannelWithUserAccount "joinChannelWithUserAccount" method to join the channel. + + The difference between the two is that for the former, the time elapsed between calling the \ref agora::rtc::IRtcEngine::joinChannelWithUserAccount "joinChannelWithUserAccount" method + and joining the channel is shorter than the latter. + + @note + - Ensure that you set the `userAccount` parameter. Otherwise, this method does not take effect. + - Ensure that the value of the `userAccount` parameter is unique in the channel. + - To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. + + @param appId The App ID of your project. + @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: + - The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int registerLocalUserAccount( + const char* appId, const char* userAccount) = 0; + /** Joins the channel with a user account. + + After the user successfully joins the channel, the SDK triggers the following callbacks: + + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . + The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + + @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. + If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. + + @param token The token generated at your server: + - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). + - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). + @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: + The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: + - The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) + */ + virtual int joinChannelWithUserAccount(const char* token, + const char* channelId, + const char* userAccount) = 0; + + /** Gets the user information by passing in the user account. + + After a remote user joins the channel, the SDK gets the user ID and user account of the remote user, caches them + in a mapping table object (`userInfo`), and triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" callback on the local client. + + After receiving the o\ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" callback, you can call this method to get the user ID of the + remote user from the `userInfo` object by passing in the user account. + + @param userAccount The user account of the user. Ensure that you set this parameter. + @param[in/out] userInfo A userInfo object that identifies the user: + - Input: A userInfo object. + - Output: A userInfo object that contains the user account and user ID of the user. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getUserInfoByUserAccount(const char* userAccount, UserInfo* userInfo) = 0; + /** Gets the user information by passing in the user ID. + + After a remote user joins the channel, the SDK gets the user ID and user account of the remote user, + caches them in a mapping table object (`userInfo`), and triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" callback on the local client. + + After receiving the \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" callback, you can call this method to get the user account of the remote user + from the `userInfo` object by passing in the user ID. + + @param uid The user ID of the remote user. Ensure that you set this parameter. + @param[in/out] userInfo A userInfo object that identifies the user: + - Input: A userInfo object. + - Output: A userInfo object that contains the user account and user ID of the user. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getUserInfoByUid(uid_t uid, UserInfo* userInfo) = 0; + + /** **DEPRECATED** Starts an audio call test. + + This method is deprecated as of v2.4.0. + + This method starts an audio call test to check whether the audio devices (for example, headset and speaker) and the network connection are working properly. + + To conduct the test: + + - The user speaks and the recording is played back within 10 seconds. + - If the user can hear the recording within 10 seconds, the audio devices and network connection are working properly. + + @note + - After calling this method, always call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the application cannot run the next echo test. + - In the Live-broadcast profile, only the hosts can call this method. If the user switches from the Communication to Live-broadcast profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startEchoTest() = 0; + + /** Starts an audio call test. + + This method starts an audio call test to determine whether the audio devices (for example, headset and speaker) and the network connection are working properly. + + In the audio call test, you record your voice. If the recording plays back within the set time interval, the audio devices and the network connection are working properly. + + @note + - Call this method before joining a channel. + - After calling this method, call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the app cannot run the next echo test, or call the \ref IRtcEngine::joinChannel "joinChannel" method. + - In the Live-broadcast profile, only a host can call this method. + @param intervalInSeconds The time interval (s) between when you speak and when the recording plays back. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startEchoTest(int intervalInSeconds) = 0; + + /** Stops the audio call test. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopEchoTest() = 0; + + /** Enables the video module. + + Call this method either before joining a channel or during a call. If this method is called before joining a channel, the call starts in the video mode. If this method is called during an audio call, the audio mode switches to the video mode. To disable the video module, call the \ref IRtcEngine::disableVideo "disableVideo" method. + + A successful \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableVideo "onUserEnableVideo" (true) callback on the remote client. + @note + - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + - This method resets the internal engine and takes some time to take effect. We recommend using the following API methods to control the video engine modules separately: + - \ref IRtcEngine::enableLocalVideo "enableLocalVideo": Whether to enable the camera to create the local video stream. + - \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream": Whether to publish the local video stream. + - \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream": Whether to subscribe to and play the remote video stream. + - \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams": Whether to subscribe to and play all remote video streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableVideo() = 0; + + /** Disables the video module. + + This method can be called before joining a channel or during a call. If this method is called before joining a channel, the call starts in audio mode. If this method is called during a video call, the video mode switches to the audio mode. To enable the video module, call the \ref IRtcEngine::enableVideo "enableVideo" method. + + A successful \ref agora::rtc::IRtcEngine::disableVideo "disableVideo" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableVideo "onUserEnableVideo" (false) callback on the remote client. + @note + - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + - This method resets the internal engine and takes some time to take effect. We recommend using the following API methods to control the video engine modules separately: + - \ref IRtcEngine::enableLocalVideo "enableLocalVideo": Whether to enable the camera to create the local video stream. + - \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream": Whether to publish the local video stream. + - \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream": Whether to subscribe to and play the remote video stream. + - \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams": Whether to subscribe to and play all remote video streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int disableVideo() = 0; + + /** **DEPRECATED** Sets the video profile. + + This method is deprecated as of v2.3. Use the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method instead. + + Each video profile includes a set of parameters, such as the resolution, frame rate, and bitrate. If the camera device does not support the specified resolution, the SDK automatically chooses a suitable camera resolution, keeping the encoder resolution specified by the *setVideoProfile* method. + + @note + - If you do not need to set the video profile after joining the channel, call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. + - Always set the video profile before calling the \ref IRtcEngine::joinChannel "joinChannel" or \ref IRtcEngine::startPreview "startPreview" method. + + @param profile Sets the video profile. See #VIDEO_PROFILE_TYPE. + @param swapWidthAndHeight Sets whether to swap the width and height of the video stream: + - true: Swap the width and height. + - false: (Default) Do not swap the width and height. + The width and height of the output video are consistent with the set video profile. + @note Since the landscape or portrait mode of the output video can be decided directly by the video profile, We recommend setting *swapWidthAndHeight* to *false* (default). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setVideoProfile(VIDEO_PROFILE_TYPE profile, bool swapWidthAndHeight) = 0; + + /** Sets the video encoder configuration. + + Each video encoder configuration corresponds to a set of video parameters, including the resolution, frame rate, bitrate, and video orientation. + + The parameters specified in this method are the maximum values under ideal network conditions. If the video engine cannot render the video using the specified parameters due to poor network conditions, the parameters further down the list are considered until a successful configuration is found. + + @note If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. + + @param config Sets the local video encoder configuration. See VideoEncoderConfiguration. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setVideoEncoderConfiguration(const VideoEncoderConfiguration& config) = 0; + /** Sets the camera capture configuration. + + For a video call or live broadcast, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: + + - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to avoid such problems. + - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to optimize CPU and RAM usage. + - If you want better quality for the local video preview, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PREVIEW = 2. + + @note Call this method before enabling the local camera. That said, you can call this method before calling \ref agora::rtc::IRtcEngine::joinChannel "joinChannel", \ref agora::rtc::IRtcEngine::enableVideo "enableVideo", or \ref IRtcEngine::enableLocalVideo "enableLocalVideo", depending on which method you use to turn on your local camera. + + @param config Sets the camera capturer configuration. See CameraCapturerConfiguration. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) = 0; + + /** Initializes the local video view. + + This method initializes the video view of a local stream on the local device. It affects only the video view that the local user sees, not the published local video stream. + + Call this method to bind the local video stream to a video view and to set the rendering and mirror modes of the video view. + The binding is still valid after the user leaves the channel, which means that the window still displays. To unbind the view, set the *view* in VideoCanvas to NULL. + + @note + - Call this method before joining a channel. + - To update the rendering or mirror mode of the local video view during a call, use the \ref IRtcEngine::setLocalRenderMode "setLocalRenderMode" method. + @param canvas Pointer to the local video view and settings. See VideoCanvas. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setupLocalVideo(const VideoCanvas& canvas) = 0; + + /** Initializes the video view of a remote user. + + This method initializes the video view of a remote stream on the local device. It affects only the video view that the local user sees. + + Call this method to bind the remote video stream to a video view and to set the rendering and mirror modes of the video view. + + The application specifies the uid of the remote video in this method before the remote user joins the channel. If the remote uid is unknown to the application, set it after the application receives the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. + If the Video Recording function is enabled, the Video Recording Service joins the channel as a dummy client, causing other clients to also receive the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. Do not bind the dummy client to the application view because the dummy client does not send any video streams. If your application does not recognize the dummy client, bind the remote user to the view when the SDK triggers the \ref IRtcEngineEventHandler::onFirstRemoteVideoDecoded "onFirstRemoteVideoDecoded" callback. + To unbind the remote user from the view, set the view in VideoCanvas to NULL. Once the remote user leaves the channel, the SDK unbinds the remote user. + + @note To update the rendering or mirror mode of the remote video view during a call, use the \ref IRtcEngine::setRemoteRenderMode "setRemoteRenderMode" method. + + @param canvas Pointer to the remote video view and settings. See VideoCanvas. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setupRemoteVideo(const VideoCanvas& canvas) = 0; + + /** Starts the local video preview before joining the channel. + + Before calling this method, you must: + + - Call the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" method to set up the local preview window and configure the attributes. + - Call the \ref IRtcEngine::enableVideo "enableVideo" method to enable video. + + @note Once the startPreview method is called to start the local video preview, if you leave the channel by calling the \ref IRtcEngine::leaveChannel "leaveChannel" method, the local video preview remains until you call the \ref IRtcEngine::stopPreview "stopPreview" method to disable it. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startPreview() = 0; + + /** Prioritizes a remote user's stream. + + Use this method with the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. If the fallback function is enabled for a subscribed stream, the SDK ensures the high-priority user gets the best possible stream quality. + + @note The Agora SDK supports setting @p userPriority as high for one user only. + + @param uid The ID of the remote user. + @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; + + /** Stops the local video preview and disables video. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopPreview() = 0; + + /** Enables the audio module. + + The audio mode is enabled by default. + + @note + - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. You can call this method either before or after joining a channel. + - This method resets the internal engine and takes some time to take effect. We recommend using the following API methods to control the audio engine modules separately: + - \ref IRtcEngine::enableLocalAudio "enableLocalAudio": Whether to enable the microphone to create the local audio stream. + - \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream": Whether to publish the local audio stream. + - \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream": Whether to subscribe to and play the remote audio stream. + - \ref IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams": Whether to subscribe to and play all remote audio streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableAudio() = 0; + + /** Disables/Re-enables the local audio function. + + The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. + + This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to + receive remote audio streams without sending any audio stream to other users in the channel. + + The SDK triggers the \ref IRtcEngineEventHandler::onMicrophoneEnabled "onMicrophoneEnabled" callback once the local audio function is disabled or enabled. + + @note + - Call this method after the \ref IRtcEngine::joinChannel "joinChannel" method. + - This method is different from the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method: + + - \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio": Disables/Re-enables the local audio capturing and processing. + If you disable or re-enable local audio recording using the `enableLocalAudio` method, the local user may hear a pause in the remote audio playback. + - \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream": Sends/Stops sending the local audio streams. + + @param enabled Sets whether to disable/re-enable the local audio function: + - true: (Default) Re-enable the local audio function, that is, to start the local audio capturing device (for example, the microphone). + - false: Disable the local audio function, that is, to stop local audio capturing. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableLocalAudio(bool enabled) = 0; + + /** Disables the audio module. + + @note + - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. You can call this method either before or after joining a channel. + - This method resets the internal engine and takes some time to take effect. We recommend using the \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio" and \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" methods to capture, process, and send the local audio streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int disableAudio() = 0; + + /** Sets the audio parameters and application scenarios. + + @note + - The *setAudioProfile* method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. + - In the Communication and Live-broadcast profiles, the bitrate may be different from your settings due to network self-adaptation. + - In scenarios requiring high-quality audio, for example, a music teaching scenario, we recommend setting profile as AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) and scenario as AUDIO_SCENARIO_GAME_STREAMING (3). + + @param profile Sets the sample rate, bitrate, encoding mode, and the number of channels. See #AUDIO_PROFILE_TYPE. + @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. Under different audio scenarios, the device uses different volume tracks, i.e. either the in-call volume or the media volume. For details, see [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setAudioProfile(AUDIO_PROFILE_TYPE profile, AUDIO_SCENARIO_TYPE scenario) = 0; + /** Stops/Resumes sending the local audio stream. + + A successful \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteAudio "onUserMuteAudio" callback on the remote client. + @note + - When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. + - If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local audio according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. + + @param mute Sets whether to send/stop sending the local audio stream: + - true: Stops sending the local audio stream. + - false: (Default) Sends the local audio stream. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteLocalAudioStream(bool mute) = 0; + /** Stops/Resumes receiving all remote users' audio streams. + + @param mute Sets whether to receive/stop receiving all remote users' audio streams. + - true: Stops receiving all remote users' audio streams. + - false: (Default) Receives all remote users' audio streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteAllRemoteAudioStreams(bool mute) = 0; + /** Stops/Resumes receiving all remote users' audio streams by default. + + @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: + - true: Stops receiving all remote users' audio streams by default. + - false: (Default) Receives all remote users' audio streams by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; + + /** Adjusts the playback volume of a specified remote user. + + You can call this method as many times as necessary to adjust the playback volume of different remote users, or to repeatedly adjust the playback volume of the same remote user. + + @note + - Call this method after joining a channel. + - The playback volume here refers to the mixed volume of a specified remote user. + - This method can only adjust the playback volume of one specified remote user at a time. To adjust the playback volume of different remote users, call the method as many times, once for each remote user. + + @param uid The ID of the remote user. + @param volume The playback volume of the specified remote user. The value ranges from 0 to 100: + - 0: Mute. + - 100: Original volume. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustUserPlaybackSignalVolume(unsigned int uid, int volume) = 0; + /** Stops/Resumes receiving a specified remote user's audio stream. + + @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. + + @param userId User ID of the specified remote user sending the audio. + @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: + - true: Stops receiving the specified remote user's audio stream. + - false: (Default) Receives the specified remote user's audio stream. + + @return + - 0: Success. + - < 0: Failure. + + */ + virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; + /** Stops/Resumes sending the local video stream. + + A successful \ref agora::rtc::IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback on the remote client. + + @note + - When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. + - If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local video according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. + + @param mute Sets whether to send/stop sending the local video stream: + - true: Stop sending the local video stream. + - false: (Default) Send the local video stream. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteLocalVideoStream(bool mute) = 0; + /** Enables/Disables the local video capture. + + This method disables or re-enables the local video capturer, and does not affect receiving the remote video stream. + + After you call the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method, the local video capturer is enabled by default. You can call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local video capturer. If you want to re-enable it, call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(true)". + + After the local video capturer is successfully disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableLocalVideo "onUserEnableLocalVideo" callback on the remote client. + + @note This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + + @param enabled Sets whether to disable/re-enable the local video, including the capturer, renderer, and sender: + - true: (Default) Re-enable the local video. + - false: Disable the local video. Once the local video is disabled, the remote users can no longer receive the video stream of this user, while this user can still receive the video streams of the other remote users. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableLocalVideo(bool enabled) = 0; + /** Stops/Resumes receiving all video stream from a specified remote user. + + @param mute Sets whether to receive/stop receiving all remote users' video streams: + - true: Stop receiving all remote users' video streams. + - false: (Default) Receive all remote users' video streams. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteAllRemoteVideoStreams(bool mute) = 0; + /** Stops/Resumes receiving all remote users' video streams by default. + + @param mute Sets whether to receive/stop receiving all remote users' video streams by default: + - true: Stop receiving all remote users' video streams by default. + - false: (Default) Receive all remote users' video streams by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; + /** Stops/Resumes receiving the video stream from a specified remote user. + + @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. + + @param userId User ID of the specified remote user. + @param mute Sets whether to stop/resume receiving the video stream from a specified remote user: + - true: Stop receiving the specified remote user's video stream. + - false: (Default) Receive the specified remote user's video stream. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; + /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. + + This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. + + - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the SDK receives the high-stream video by default. + - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. + + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. + By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. + + @param userId ID of the remote user sending the video stream. + @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. + + - If the dual-stream mode is enabled by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the user receives the high-stream video by default. The @p setRemoteDefaultVideoStreamType method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. + - If the dual-stream mode is not enabled, the user receives the high-stream video by default. + + The result after calling this method is returned in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. + + @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + + /** Enables the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at a set time interval to report on which users are speaking and the speakers' volume. + + Once this method is enabled, the SDK returns the volume indication in the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the set time interval, whether or not any user is speaking in the channel. + + @param interval Sets the time interval between two consecutive volume indications: + - ≤ 0: Disables the volume indication. + - > 0: Time interval (ms) between two consecutive volume indications. We recommend setting @p interval > 200 ms. Do not set @p interval < 10 ms, or the *onAudioVolumeIndication* callback will not be triggered. + @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. + @param report_vad + + - true: Enable the voice activity detection of the local user. Once it is enabled, the `vad` parameter of the `onAudioVolumeIndication` callback reports the voice activity status of the local user. + - false: (Default) Disable the voice activity detection of the local user. Once it is disabled, the `vad` parameter of the `onAudioVolumeIndication` callback does not report the voice activity status of the local user, except for the scenario where the engine automatically detects the voice activity of the local user. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; + /** **DEPRECATED** Starts an audio recording. + * Use \ref IRtcEngine::startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) "startAudioRecording"2 instead. + + The SDK allows recording during a call. Supported formats: + + - .wav: Large file size with high fidelity. + - .aac: Small file size with low fidelity. + + This method has a fixed sample rate of 32 kHz. + + Ensure that the directory to save the recording file exists and is writable. + This method is usually called after the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. + The recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. + + @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8. + @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + + /** Starts an audio recording on the client. + * + * The SDK allows recording during a call. After successfully calling this method, you can record the audio of all the users in the channel and get an audio recording file. + * Supported formats of the recording file are as follows: + * - .wav: Large file size with high fidelity. + * - .aac: Small file size with low fidelity. + * + * @note + * - Ensure that the directory you use to save the recording file exists and is writable. + * - This method is usually called after the `joinChannel` method. The recording automatically stops when you call the `leaveChannel` method. + * - For better recording effects, set quality as #AUDIO_RECORDING_QUALITY_MEDIUM or #AUDIO_RECORDING_QUALITY_HIGH when `sampleRate` is 44.1 kHz or 48 kHz. + * + * @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8. + * @param sampleRate Sample rate (kHz) of the recording file. Supported values are as follows: + * - 16 + * - (Default) 32 + * - 44.1 + * - 48 + * @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + /** Stops an audio recording on the client. + + You can call this method before calling the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method else, the recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. + + @return + - 0: Success + - < 0: Failure. + */ + virtual int stopAudioRecording() = 0; + /** Starts playing and mixing the music file. + + This method mixes the specified local audio file with the audio stream from the microphone, or replaces the microphone's audio stream with the specified local audio file. You can choose whether the other user can hear the local audio playback and specify the number of playback loops. This method also supports online music playback. + + When the audio mixing file playback finishes after calling this method, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingFinished "onAudioMixingFinished" callback. + + A successful \ref agora::rtc::IRtcEngine::startAudioMixing "startAudioMixing" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingStateChanged "onAudioMixingStateChanged" (PLAY) callback on the local client. + + When the audio mixing file playback finishes, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingStateChanged "onAudioMixingStateChanged" (STOPPED) callback on the local client. + @note + - Call this method when you are in a channel. + - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. + + @param filePath Pointer to the absolute path of the local or online audio file to mix. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). + @param loopback Sets which user can hear the audio mixing: + - true: Only the local user can hear the audio mixing. + - false: Both users can hear the audio mixing. + @param replace Sets the audio mixing content: + - true: Only the specified audio file is published; the audio stream received by the microphone is not published. + - false: The local audio file is mixed with the audio stream from the microphone. + @param cycle Sets the number of playback loops: + - Positive integer: Number of playback loops. + - -1: Infinite playback loops. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; + /** Stops playing and mixing the music file. + + Call this method when you are in a channel. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopAudioMixing() = 0; + /** Pauses playing and mixing the music file. + + Call this method when you are in a channel. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pauseAudioMixing() = 0; + /** Resumes playing and mixing the music file. + + Call this method when you are in a channel. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int resumeAudioMixing() = 0; + /** **DEPRECATED** Agora does not recommend using this method. + + Sets the high-quality audio preferences. Call this method and set all parameters before joining a channel. + + Do not call this method again after joining a channel. + + @param fullband Sets whether to enable/disable full-band codec (48-kHz sample rate). Not compatible with SDK versions before v1.7.4: + - true: Enable full-band codec. + - false: Disable full-band codec. + @param stereo Sets whether to enable/disable stereo codec. Not compatible with SDK versions before v1.7.4: + - true: Enable stereo codec. + - false: Disable stereo codec. + @param fullBitrate Sets whether to enable/disable high-bitrate mode. Recommended in voice-only mode: + - true: Enable high-bitrate mode. + - false: Disable high-bitrate mode. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) = 0; + /** Adjusts the volume during audio mixing. + + Call this method when you are in a channel. + + @note Calling this method does not affect the volume of audio effect file playback invoked by the \ref agora::rtc::IRtcEngine::playEffect "playEffect" method. + + @param volume Audio mixing volume. The value ranges between 0 and 100 (default). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustAudioMixingVolume(int volume) = 0; + /** Adjusts the audio mixing volume for local playback. + + @note Call this method when you are in a channel. + + @param volume Audio mixing volume for local playback. The value ranges between 0 and 100 (default). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustAudioMixingPlayoutVolume(int volume) = 0; + /** Retrieves the audio mixing volume for local playback. + + This method helps troubleshoot audio volume related issues. + + @note Call this method when you are in a channel. + + @return + - ≥ 0: The audio mixing volume, if this method call succeeds. The value range is [0,100]. + - < 0: Failure. + */ + virtual int getAudioMixingPlayoutVolume() = 0; + /** Adjusts the audio mixing volume for publishing (for remote users). + + @note Call this method when you are in a channel. + + @param volume Audio mixing volume for publishing. The value ranges between 0 and 100 (default). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustAudioMixingPublishVolume(int volume) = 0; + /** Retrieves the audio mixing volume for publishing. + + This method helps troubleshoot audio volume related issues. + + @note Call this method when you are in a channel. + + @return + - ≥ 0: The audio mixing volume for publishing, if this method call succeeds. The value range is [0,100]. + - < 0: Failure. + */ + virtual int getAudioMixingPublishVolume() = 0; + + /** Retrieves the duration (ms) of the music file. + + Call this method when you are in a channel. + + @return + - ≥ 0: The audio mixing duration, if this method call succeeds. + - < 0: Failure. + */ + virtual int getAudioMixingDuration() = 0; + /** Retrieves the playback position (ms) of the music file. + + Call this method when you are in a channel. + + @return + - ≥ 0: The current playback position of the audio mixing, if this method call succeeds. + - < 0: Failure. + */ + virtual int getAudioMixingCurrentPosition() = 0; + /** Sets the playback position of the music file to a different starting position (the default plays from the beginning). + + @param pos The playback starting position (ms) of the music file. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; + /** Retrieves the volume of the audio effects. + + The value ranges between 0.0 and 100.0. + + @return + - ≥ 0: Volume of the audio effects, if this method call succeeds. + + - < 0: Failure. + */ + virtual int getEffectsVolume() = 0; + /** Sets the volume of the audio effects. + + @param volume Sets the volume of the audio effects. The value ranges between 0 and 100 (default). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setEffectsVolume(int volume) = 0; + /** Sets the volume of a specified audio effect. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param volume Sets the volume of the specified audio effect. The value ranges between 0 and 100 (default). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setVolumeOfEffect(int soundId, int volume) = 0; + + /** Plays a specified local or online audio effect file. + + This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. + + To play multiple audio effect files simultaneously, call this method multiple times with different soundIds and filePaths. We recommend playing no more than three audio effect files at the same time. + + @param soundId ID of the specified audio effect. Each audio effect has a unique ID. + + @note + - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. + - Playing multiple online audio effect files simultaneously is not supported on macOS and Windows. + + @param filePath The absolute path to the local audio effect file or the URL of the online audio effect file. + @param loopCount Sets the number of times the audio effect loops: + - 0: Play the audio effect once. + - 1: Play the audio effect twice. + - -1: Play the audio effect in an indefinite loop until the \ref IRtcEngine::stopEffect "stopEffect" or \ref IRtcEngine::stopAllEffects "stopAllEffects" method is called. + @param pitch Sets the pitch of the audio effect. The value ranges between 0.5 and 2. The default value is 1 (no change to the pitch). The lower the value, the lower the pitch. + @param pan Sets the spatial position of the audio effect. The value ranges between -1.0 and 1.0: + - 0.0: The audio effect displays ahead. + - 1.0: The audio effect displays to the right. + - -1.0: The audio effect displays to the left. + @param gain Sets the volume of the audio effect. The value ranges between 0 and 100 (default). The lower the value, the lower the volume of the audio effect. + @param publish Sets whether or not to publish the specified audio effect to the remote stream: + - true: The locally played audio effect is published to the Agora Cloud and the remote users can hear it. + - false: The locally played audio effect is not published to the Agora Cloud and the remote users cannot hear it. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) = 0; + /** Stops playing a specified audio effect. + + @param soundId ID of the audio effect to stop playing. Each audio effect has a unique ID. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopEffect(int soundId) = 0; + /** Stops playing all audio effects. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopAllEffects() = 0; + + /** Preloads a specified audio effect file into the memory. + + @note This method does not support online audio effect files. + + To ensure smooth communication, limit the size of the audio effect file. We recommend using this method to preload the audio effect before calling the \ref IRtcEngine::joinChannel "joinChannel" method. + + Supported audio formats: mp3, aac, m4a, 3gp, and wav. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param filePath Pointer to the absolute path of the audio effect file. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int preloadEffect(int soundId, const char* filePath) = 0; + /** Releases a specified preloaded audio effect from the memory. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int unloadEffect(int soundId) = 0; + /** Pauses a specified audio effect. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pauseEffect(int soundId) = 0; + /** Pauses all audio effects. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pauseAllEffects() = 0; + /** Resumes playing a specified audio effect. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int resumeEffect(int soundId) = 0; + /** Resumes playing all audio effects. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int resumeAllEffects() = 0; + /** Enables/Disables stereo panning for remote users. + + Ensure that you call this method before joinChannel to enable stereo panning for remote users so that the local user can track the position of a remote user by calling \ref agora::rtc::IRtcEngine::setRemoteVoicePosition "setRemoteVoicePosition". + + @param enabled Sets whether or not to enable stereo panning for remote users: + - true: enables stereo panning. + - false: disables stereo panning. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableSoundPositionIndication(bool enabled) = 0; + /** Sets the sound position and gain of a remote user. + + When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, such as Battle Royale games. + + @note + - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. + - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + + @param uid The ID of the remote user. + @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: + - 0.0: the remote sound comes from the front. + - -1.0: the remote sound comes from the left. + - 1.0: the remote sound comes from the right. + @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). The smaller the value, the less the gain. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteVoicePosition(uid_t uid, double pan, double gain) = 0; + + /** Changes the voice pitch of the local speaker. + + @param pitch Sets the voice pitch. The value ranges between 0.5 and 2.0. The lower the value, the lower the voice pitch. The default value is 1.0 (no change to the local voice pitch). + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVoicePitch(double pitch) = 0; + /** Sets the local voice equalization effect. + + @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. + @param bandGain Sets the gain of each band in dB. The value ranges between -15 and 15. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; + /** Sets the local voice reverberation. + + v2.4.0 adds the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, a more user-friendly method for setting the local voice reverberation. You can use this method to set the local reverberation effect, such as pop music, R&B, rock music, and hip-hop. + + @param reverbKey Sets the reverberation key. See #AUDIO_REVERB_TYPE. + @param value Sets the value of the reverberation key. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; + /** Sets the local voice changer option. + + @note Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, because the method called later overrides the one called earlier. + + @param voiceChanger Sets the local voice changer option. See #VOICE_CHANGER_PRESET. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; + /** Sets the preset local voice reverberation effect. + + @note + - Do not use this method together with \ref agora::rtc::IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb". + - Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" method, because the method called later overrides the one called earlier. + + @param reverbPreset Sets the preset audio reverberation configuration. See #AUDIO_REVERB_PRESET. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) = 0; + + /** Specifies an SDK output log file. + + The log file records all SDK operations during runtime. If it does not exist, the SDK creates one. + + @note + - The default log file is located at: C:\Users\\AppData\Local\Agora\. + - Ensure that you call this method immediately after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method, otherwise the output log may not be complete. + + @param filePath File path of the log file. The string of the log file is in UTF-8. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLogFile(const char* filePath) = 0; + /** Sets the output log level of the SDK. + + You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. + + If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. + + @param filter Sets the log filter level. See #LOG_FILTER_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLogFilter(unsigned int filter) = 0; + /** Sets the log file size (KB). + + The SDK has two log files, each with a default size of 512 KB. If you set @p fileSizeInBytes as 1024 KB, the SDK outputs log files with a total maximum size of 2 MB. If the total size of the log files exceed the set value, the new output log files overwrite the old output log files. + + @param fileSizeInKBytes The SDK log file size (KB). + @return + - 0: Success. + - <0: Failure. + */ + virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode"2 method instead. + Sets the local video display mode. + + This method can be called multiple times during a call to change the display mode. + + @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; + /** Updates the display mode of the local video view. + + After initializing the local video view, you can call this method to update its rendering and mirror modes. It affects only the video view that the local user sees, not the published local video stream. + + @note + - Ensure that you have called the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view before calling this method. + @param renderMode The rendering mode of the local video view. See #RENDER_MODE_TYPE. + @param mirrorMode + - The mirror mode of the local video view. See #VIDEO_MIRROR_MODE_TYPE. + - **Note**: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setRemoteRenderMode"2 method instead. + Sets the video display mode of a specified remote user. + + This method can be called multiple times during a call to change the display mode. + + @param userId ID of the remote user. + @param renderMode Sets the video display mode. See #RENDER_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; + /** Updates the display mode of the video view of a remote user. + + After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. This method affects only the video view that the local user sees. + + @note + - Ensure that you have called the \ref IRtcEngine::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view before calling this method. + - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. + + @param userId The ID of the remote user. + @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. + @param mirrorMode + - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. + - **Note**: The SDK disables the mirror mode by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" + or \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" method instead. + Sets the local video mirror mode. + + You must call this method before calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, otherwise the mirror mode will not work. + + @note The SDK enables the mirror mode by default. + + @param mirrorMode Sets the local video mirror mode. See #VIDEO_MIRROR_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** Sets the stream mode to the single-stream (default) or dual-stream mode. (Live broadcast only.) + + If the dual-stream mode is enabled, the receiver can choose to receive the high stream (high-resolution and high-bitrate video stream), or the low stream (low-resolution and low-bitrate video stream). + + @param enabled Sets the stream mode: + - true: Dual-stream mode. + - false: (Default) Single-stream mode. + */ + virtual int enableDualStreamMode(bool enabled) = 0; + /** Sets the external audio source. Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + + @param enabled Sets whether to enable/disable the external audio source: + - true: Enables the external audio source. + - false: (Default) Disables the external audio source. + @param sampleRate Sets the sample rate (Hz) of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channels Sets the number of audio channels of the external audio source: + - 1: Mono. + - 2: Stereo. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; + /** Sets the external audio sink. + * This method applies to scenarios where you want to use external audio + * data for playback. After enabling the external audio sink, you can call + * the \ref agora::media::IMediaEngine::pullAudioFrame "pullAudioFrame" method to pull the remote audio data, process + * it, and play it with the audio effects that you want. + * + * @note + * Once you enable the external audio sink, the app will not retrieve any + * audio data from the + * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + * + * @param enabled + * - true: Enables the external audio sink. + * - false: (Default) Disables the external audio sink. + * @param sampleRate Sets the sample rate (Hz) of the external audio sink, which can be set as 16000, 32000, 44100 or 48000. + * @param channels Sets the number of audio channels of the external + * audio sink: + * - 1: Mono. + * - 2: Stereo. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels) = 0; + /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. + + + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onRecordAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channel Sets the number of audio channels (@p channels) returned in the *onRecordAudioFrame* callback: + - 1: Mono + - 2: Stereo + @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onRecordAudioFrame* callback. + @param samplesPerCall Sets the number of samples returned in the *onRecordAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. + + + @note The SDK triggers the `onRecordAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + /** Sets the audio playback format for the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + + + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onPlaybackAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channel Sets the number of channels (@p channels) returned in the *onPlaybackAudioFrame* callback: + - 1: Mono + - 2: Stereo + @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onPlaybackAudioFrame* callback. + @param samplesPerCall Sets the number of samples returned in the *onPlaybackAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. + + @note The SDK triggers the `onPlaybackAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + /** Sets the mixed audio format for the \ref agora::media::IAudioFrameObserver::onMixedAudioFrame "onMixedAudioFrame" callback. + + + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onMixedAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param samplesPerCall Sets the number of samples (`samples`) returned in the *onMixedAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. + + @note The SDK triggers the `onMixedAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channels`). + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; + /** Adjusts the recording volume. + + @param volume Recording volume. The value ranges between 0 and 400: + - 0: Mute. + - 100: Original volume. + - 400: (Maximum) Four times the original volume with signal clipping protection. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustRecordingSignalVolume(int volume) = 0; + /** Adjusts the playback volume of all remote users. + + @note + - This method adjusts the playback volume that is the mixed volume of all remote users. + - (Since v2.3.2) To mute the local audio playback, call both the `adjustPlaybackSignalVolume` and \ref IRtcEngine::adjustAudioMixingVolume "adjustAudioMixingVolume" methods and set the volume as `0`. + + @param volume The playback volume of all remote users. The value ranges from 0 to 400: + - 0: Mute. + - 100: Original volume. + - 400: (Maximum) Four times the original volume with signal clipping protection. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustPlaybackSignalVolume(int volume) = 0; + + /** + @deprecated This method is deprecated. As of v3.0.0, the Native SDK automatically enables interoperability with the Web SDK, so you no longer need to call this method. + Enables interoperability with the Agora Web SDK. + + @note + - This method applies only to the Live-broadcast profile. In the Communication profile, interoperability with the Agora Web SDK is enabled by default. + - If the channel has Web SDK users, ensure that you call this method, or the video of the Native user will be a black screen for the Web user. + + @param enabled Sets whether to enable/disable interoperability with the Agora Web SDK: + - true: Enable. + - false: (Default) Disable. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableWebSdkInteroperability(bool enabled) = 0; + //only for live broadcast + /** **DEPRECATED** Sets the preferences for the high-quality video. (Live broadcast only). + + This method is deprecated as of v2.4.0. + + @param preferFrameRateOverImageQuality Sets the video quality preference: + - true: Frame rate over image quality. + - false: (Default) Image quality over frame rate. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setVideoQualityParameters(bool preferFrameRateOverImageQuality) = 0; + /** Sets the fallback option for the locally published video stream based on the network conditions. + + If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK will: + + - Disable the upstream video but enable audio only when the network conditions deteriorate and cannot support both video and audio. + - Re-enable the video when the network conditions improve. + + When the locally published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. + + @note Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the locally published video stream falls back to audio only. + + @param option Sets the fallback option for the locally published video stream: + - #STREAM_FALLBACK_OPTION_DISABLED (0): (Default) No fallback behavior for the locally published video stream when the uplink network condition is poor. The stream quality is not guaranteed. + - #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2): The locally published video stream falls back to audio only when the uplink network condition is poor. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; + /** Sets the fallback option for the remotely subscribed video stream based on the network conditions. + + The default setting for `option` is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW (1), where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. + + If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. + + When the remotely subscribed video stream falls back to audio only or when the audio-only stream switches back to the video stream, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRemoteSubscribeFallbackToAudioOnly "onRemoteSubscribeFallbackToAudioOnly" callback. + + @param option Sets the fallback option for the remotely subscribed video stream. See #STREAM_FALLBACK_OPTIONS. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; + +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** Switches between front and rear cameras. + + @note This method is for Android and iOS only. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int switchCamera() = 0; + /** Switches between front and rear cameras. + + @note This method is for Android and iOS only, and it is private. + + @param direction Sets the camera to be used: + - CAMERA_DIRECTION.CAMERA_REAR: Use the rear camera. + - CAMERA_DIRECTION.CAMERA_FRONT: Use the front camera. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int switchCamera(CAMERA_DIRECTION direction) = 0; + /** Sets the default audio playback route. + + This method sets whether the received audio is routed to the earpiece or speakerphone by default before joining a channel. + If a user does not call this method, the audio is routed to the earpiece by default. If you need to change the default audio route after joining a channel, call the \ref IRtcEngine::setEnableSpeakerphone "setEnableSpeakerphone" method. + + The default setting for each mode: + - Voice: Earpiece. + - Video: Speakerphone. If a user who is in the Communication profile calls the \ref IRtcEngine::disableVideo "disableVideo" method or if the user calls the \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" and \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the default audio route switches back to the earpiece automatically. + - Live Broadcast: Speakerphone. + - Gaming Voice: Speakerphone. + + @note + - This method is for Android and iOS only. + - This method only works in audio mode. + - Call this method before calling the \ref IRtcEngine::joinChannel "joinChannel" method. + - Regardless of whether the audio is routed to the speakerphone or earpiece by default, once a headset is plugged in or Bluetooth device is connected, the default audio route changes. The default audio route switches to the earpiece once removing the headset or disconnecting the Bluetooth device. + + @param defaultToSpeaker Sets the default audio route: + - true: Speakerphone. + - false: (Default) Earpiece. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; + /** Enables/Disables the audio playback route to the speakerphone. + + This method sets whether the audio is routed to the speakerphone or earpiece. + + See the default audio route explanation in the \ref IRtcEngine::setDefaultAudioRouteToSpeakerphone "setDefaultAudioRouteToSpeakerphone" method and check whether it is necessary to call this method. + + @note + - This method is for Android and iOS only. + - Ensure that you have successfully called the \ref IRtcEngine::joinChannel "joinChannel" method before calling this method. + - After calling this method, the SDK returns the \ref IRtcEngineEventHandler::onAudioRouteChanged "onAudioRouteChanged" callback to indicate the changes. + - This method does not take effect if a headset is used. + + @param speakerOn Sets whether to route the audio to the speakerphone or earpiece: + - true: Route the audio to the speakerphone. + - false: Route the audio to the earpiece. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setEnableSpeakerphone(bool speakerOn) = 0; + /** Enables in-ear monitoring (for Android and iOS only). + @param enabled Sets whether to enable/disable in-ear monitoring: + - true: Enable. + - false: (Default) Disable. + + * @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableInEarMonitoring(bool enabled) = 0; + /** Sets the volume of the in-ear monitor. + + @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). + + @note This method is for Android and iOS only. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setInEarMonitoringVolume(int volume) = 0; + /** Checks whether the speakerphone is enabled. + + @note This method is for Android and iOS only. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual bool isSpeakerphoneEnabled() = 0; +#endif + +#if (defined(__APPLE__) && TARGET_OS_IOS) + /** Sets the audio session’s operational restriction. + + The SDK and the app can both configure the audio session by default. The app may occasionally use other apps or third-party components to manipulate the audio session and restrict the SDK from doing so. This method allows the app to restrict the SDK’s manipulation of the audio session. + + You can call this method at any time to return the control of the audio sessions to the SDK. + + @note + - This method is for iOS only. + - This method restricts the SDK’s manipulation of the audio session. Any operation to the audio session relies solely on the app, other apps, or third-party components. + + @param restriction The operational restriction (bit mask) of the SDK on the audio session. See #AUDIO_SESSION_OPERATION_RESTRICTION. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setAudioSessionOperationRestriction(AUDIO_SESSION_OPERATION_RESTRICTION restriction) = 0; +#endif + +#if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) || defined(_WIN32) + /** Enables loopback recording. + + If you enable loopback recording, the output of the sound card is mixed into the audio stream sent to the other end. + + @param enabled Sets whether to enable/disable loopback recording. + - true: Enable loopback recording. + - false: (Default) Disable loopback recording. + @param deviceName Pointer to the device name of the sound card. The default value is NULL (the default sound card). + + @note + - This method is for macOS and Windows only. + - macOS does not support loopback recording of the default sound card. If you need to use this method, please use a virtual sound card and pass its name to the deviceName parameter. Agora has tested and recommends using soundflower. + + */ + virtual int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) = 0; + +#if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) + /** Shares the whole or part of a screen by specifying the display ID. + + @note This method is for macOS only. + + @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. + @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + + + @return + - 0: Success. + - < 0: Failure: + - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call \ref agora::rtc::IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. + - #ERR_INVALID_ARGUMENT: the argument is invalid. + */ + virtual int startScreenCaptureByDisplayId(unsigned int displayId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; +#endif + +#if defined(_WIN32) + /** Shares the whole or part of a screen by specifying the screen rect. + + @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see [Share the Screen](https://docs.agora.io/en/Video/screensharing_windows?platform=Windows). + @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + + @return + - 0: Success. + - < 0: Failure: + - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call \ref agora::rtc::IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. + - ERR_INVALID_ARGUMENT: the argument is invalid. + */ + virtual int startScreenCaptureByScreenRect(const Rectangle& screenRect, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; +#endif + + /** Shares the whole or part of a window by specifying the window ID. + + @param windowId The ID of the window to be shared. For information on how to get the windowId, see [Share the Screen](https://docs.agora.io/en/Video/screensharing_windows?platform=Windows). + @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. + @param captureParams Window sharing encoding parameters. See ScreenCaptureParameters. + + @return + - 0: Success. + - < 0: Failure: + - ERR_INVALID_STATE: the window sharing state is invalid, probably because another screen or window is being shared. Call \ref agora::rtc::IRtcEngine::stopScreenCapture "stopScreenCapture" to stop sharing the current window. + - #ERR_INVALID_ARGUMENT: the argument is invalid. + */ + virtual int startScreenCaptureByWindowId(view_t windowId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; + + /** Sets the content hint for screen sharing. + + A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. + + @param contentHint Sets the content hint for screen sharing. See VideoContentHint. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setScreenCaptureContentHint(VideoContentHint contentHint) = 0; + + /** Updates the screen sharing parameters. + + @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + + @return + - 0: Success. + - < 0: Failure: + - #ERR_NOT_READY: no screen or windows is being shared. + */ + virtual int updateScreenCaptureParameters(const ScreenCaptureParameters& captureParams) = 0; + + /** Updates the screen sharing region. + + @param regionRect Sets the relative location of the region to the screen or window. NULL means sharing the whole screen or window. See Rectangle. If the specified region overruns the screen or window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen or window. + + @return + - 0: Success. + - < 0: Failure: + - #ERR_NOT_READY: no screen or window is being shared. + */ + virtual int updateScreenCaptureRegion(const Rectangle& regionRect) = 0; + + /** Stop screen sharing. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int stopScreenCapture() = 0; + +#if defined(__APPLE__) + typedef unsigned int WindowIDType; +#elif defined(_WIN32) + typedef HWND WindowIDType; +#endif + + /** **DEPRECATED** Starts screen sharing. + + This method is deprecated as of v2.4.0. See the following methods instead: + + - \ref agora::rtc::IRtcEngine::startScreenCaptureByDisplayId "startScreenCaptureByDisplayId" + - \ref agora::rtc::IRtcEngine::startScreenCaptureByScreenRect "startScreenCaptureByScreenRect" + - \ref agora::rtc::IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" + + This method shares the whole screen, specified window, or specified region: + + - Whole screen: Set @p windowId as 0 and @p rect as NULL. + - Specified window: Set @p windowId as a value other than 0. Each window has a @p windowId that is not 0. + - Specified region: Set @p windowId as 0 and @p rect not as NULL. In this case, you can share the specified region, for example by dragging the mouse or implementing your own logic. + + @note The specified region is a region on the whole screen. Currently, sharing a specified region in a specific window is not supported. + *captureFreq* is the captured frame rate once the screen-sharing function is enabled. The mandatory value ranges between 1 fps and 15 fps. + + @param windowId Sets the screen sharing area. See WindowIDType. + @param captureFreq (Mandatory) The captured frame rate. The value ranges between 1 fps and 15 fps. + @param rect Specifies the screen-sharing region. @p rect is valid when @p windowsId is set as 0. When @p rect is set as NULL, the whole screen is shared. + @param bitrate The captured bitrate. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startScreenCapture(WindowIDType windowId, int captureFreq, const Rect *rect, int bitrate) = 0; + + /** **DEPRECATED** Updates the screen capture region. + + @param rect Specifies the required region inside the screen or window. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int updateScreenCaptureRegion(const Rect *rect) = 0; +#endif + + /** Retrieves the current call ID. + + When a user joins a channel on a client, a @p callId is generated to identify the call from the client. Feedback methods, such as \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain", must be called after the call ends to submit feedback to the SDK. + + The \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods require the @p callId parameter retrieved from the *getCallId* method during a call. @p callId is passed as an argument into the \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods after the call ends. + + @param callId Pointer to the current call ID. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getCallId(agora::util::AString& callId) = 0; + + /** Allows a user to rate a call after the call ends. + + @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. + @param rating Rating of the call. The value is between 1 (lowest score) and 5 (highest score). If you set a value out of this range, the #ERR_INVALID_ARGUMENT (2) error returns. + @param description (Optional) Pointer to the description of the rating, with a string length of less than 800 bytes. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int rate(const char* callId, int rating, const char* description) = 0; + + /** Allows a user to complain about the call quality after a call ends. + + @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. + @param description (Optional) Pointer to the description of the complaint, with a string length of less than 800 bytes. + + @return + - 0: Success. + - < 0: Failure. + + */ + virtual int complain(const char* callId, const char* description) = 0; + + /** Retrieves the SDK version number. + + @param build Pointer to the build number. + @return The version of the current SDK in the string format. For example, 2.3.1. + */ + virtual const char* getVersion(int* build) = 0; + + /** Enables the network connection quality test. + + This method tests the quality of the users' network connections and is disabled by default. + + Before a user joins a channel or before an audience switches to a host, call this method to check the uplink network quality. + + This method consumes additional network traffic, and hence may affect communication quality. + + Call the \ref IRtcEngine::disableLastmileTest "disableLastmileTest" method to disable this test after receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" callback, and before joining a channel. + + @note + - Do not call any other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" callback. Otherwise, the callback may be interrupted by other methods, and hence may not be triggered. + - A host should not call this method after joining a channel (when in a call). + - If you call this method to test the last-mile quality, the SDK consumes the bandwidth of a video stream, whose bitrate corresponds to the bitrate you set in the \ref agora::rtc::IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. After you join the channel, whether you have called the `disableLastmileTest` method or not, the SDK automatically stops consuming the bandwidth. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int enableLastmileTest() = 0; + + /** Disables the network connection quality test. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int disableLastmileTest() = 0; + + /** Starts the last-mile network probe test. + + This method starts the last-mile network probe test before joining a channel to get the uplink and downlink last-mile network statistics, including the bandwidth, packet loss, jitter, and round-trip time (RTT). + + Call this method to check the uplink network quality before users join a channel or before an audience switches to a host. + Once this method is enabled, the SDK returns the following callbacks: + - \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality": the SDK triggers this callback within two seconds depending on the network conditions. This callback rates the network conditions and is more closely linked to the user experience. + - \ref IRtcEngineEventHandler::onLastmileProbeResult "onLastmileProbeResult": the SDK triggers this callback within 30 seconds depending on the network conditions. This callback returns the real-time statistics of the network conditions and is more objective. + + @note + - This method consumes extra network traffic and may affect communication quality. We do not recommend calling this method together with enableLastmileTest. + - Do not call other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" and \ref IRtcEngineEventHandler::onLastmileProbeResult "onLastmileProbeResult" callbacks. Otherwise, the callbacks may be interrupted. + - In the Live-broadcast profile, a host should not call this method after joining a channel. + + @param config Sets the configurations of the last-mile network probe test. See LastmileProbeConfig. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int startLastmileProbeTest(const LastmileProbeConfig& config) = 0; + + /** Stops the last-mile network probe test. */ + virtual int stopLastmileProbeTest() = 0; + + /** Retrieves the warning or error description. + + @param code Warning code or error code returned in the \ref agora::rtc::IRtcEngineEventHandler::onWarning "onWarning" or \ref agora::rtc::IRtcEngineEventHandler::onError "onError" callback. + + @return #WARN_CODE_TYPE or #ERROR_CODE_TYPE. + */ + virtual const char* getErrorDescription(int code) = 0; + + /** Enables built-in encryption with an encryption password before users join a channel. + + All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. + + If an encryption password is not specified, the encryption functionality will be disabled. + + @note + - Do not use this method for CDN live streaming. + - For optimal transmission, ensure that the encrypted data size does not exceed the original data size + 16 bytes. 16 bytes is the maximum padding size for AES encryption. + + @param secret Pointer to the encryption password. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setEncryptionSecret(const char* secret) = 0; + + /** Sets the built-in encryption mode. + + The Agora SDK supports built-in encryption, which is set to the @p aes-128-xts mode by default. Call this method to use other encryption modes. + + All users in the same channel must use the same encryption mode and password. + + Refer to the information related to the AES encryption algorithm on the differences between the encryption modes. + + @note Call the \ref IRtcEngine::setEncryptionSecret "setEncryptionSecret" method to enable the built-in encryption function before calling this method. + + @param encryptionMode Pointer to the set encryption mode: + - "aes-128-xts": (Default) 128-bit AES encryption, XTS mode. + - "aes-128-ecb": 128-bit AES encryption, ECB mode. + - "aes-256-xts": 256-bit AES encryption, XTS mode. + - "": When encryptionMode is set as NULL, the encryption mode is set as "aes-128-xts" by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setEncryptionMode(const char* encryptionMode) = 0; + + /** Registers a packet observer. + + The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. + + @note + - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. + - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. + - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. + + @param observer Pointer to the registered packet observer. See IPacketObserver. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int registerPacketObserver(IPacketObserver* observer) = 0; + + /** Creates a data stream. + + Each user can create up to five data streams during the lifecycle of the IRtcEngine. + + @note Set both the @p reliable and @p ordered parameters to true or false. Do not set one as true and the other as false. + + @param streamId Pointer to the ID of the created data stream. + @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: + - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, an error is reported to the application. + - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for any delay or missing data stream. + @param ordered Sets whether or not the recipients receive the data stream in the sent order: + - true: The recipients receive the data stream in the sent order. + - false: The recipients do not receive the data stream in the sent order. + + @return + - Returns 0: Success. + - < 0: Failure. + */ + virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; + + /** Sends data stream messages to all users in a channel. + + The SDK has the following restrictions on this method: + - Up to 30 packets can be sent per second in a channel with each packet having a maximum size of 1 kB. + - Each client can send up to 6 kB of data per second. + - Each user can have up to five data streams simultaneously. + + A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + + A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. + @note This method applies only to the Communication profile or to the hosts in the Live-broadcast profile. If an audience in the Live-broadcast profile calls this method, the audience may be switched to a host. + + @param streamId ID of the sent data stream, returned in the \ref IRtcEngine::createDataStream "createDataStream" method. + @param data Pointer to the sent data. + @param length Length of the sent data. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int sendStreamMessage(int streamId, const char* data, size_t length) = 0; + + /** Publishes the local stream to a specified CDN live RTMP address. (CDN live only.) + + The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback. + + The \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of adding a local stream to the CDN. + @note + - Ensure that the user joins the channel before calling this method. + - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - This method adds only one stream RTMP URL address each time it is called. + - This method applies to Live Broadcast only. + + @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. The RTMP URL address must not contain special characters, such as Chinese language characters. + @param transcodingEnabled Sets whether transcoding is enabled/disabled: + - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. If you set this parameter as `true`, ensure that you call the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method before this method. + - false: Disable transcoding. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (2): The RTMP URL address is NULL or has a string length of 0. + - #ERR_NOT_INITIALIZED (7): You have not initialized the RTC engine when publishing the stream. + */ + virtual int addPublishStreamUrl(const char *url, bool transcodingEnabled) = 0; + + /** Removes an RTMP stream from the CDN. (CDN live only.) + + This method removes the RTMP URL address (added by the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamUnpublished "onStreamUnpublished" callback. + + The \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP stream from the CDN. + @note + - This method removes only one RTMP URL address each time it is called. + - The RTMP URL address must not contain special characters, such as Chinese language characters. + - This method applies to Live Broadcast only. + + @param url The RTMP URL address to be removed. The maximum length of this parameter is 1024 bytes. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int removePublishStreamUrl(const char *url) = 0; + + /** Sets the video layout and audio settings for CDN live. (CDN live only.) + + The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you call the `setLiveTranscoding` method to update the transcoding setting. + + @note + - This method applies to Live Broadcast only. + - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - If you call the `setLiveTranscoding` method to update the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + + @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; + + /** **DEPRECATED** Adds a watermark image to the local video or CDN live stream. + + This method is deprecated from v2.9.1. Use \ref agora::rtc::IRtcEngine::addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) "addVideoWatermark"2 instead. + + This method adds a PNG watermark image to the local video stream for the recording device, channel audience, and CDN live audience to view and capture. + + To add the PNG file to the CDN live publishing stream, see the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. + + @param watermark Pointer to the watermark image to be added to the local video stream. See RtcImage. + + @note + - The URL descriptions are different for the local video and CDN live streams: + - In a local video stream, @p url in RtcImage refers to the absolute path of the added watermark image file in the local video stream. + - In a CDN live stream, @p url in RtcImage refers to the URL address of the added watermark image in the CDN live broadcast. + - The source file of the watermark image must be in the PNG file format. If the width and height of the PNG file differ from your settings in this method, the PNG file will be cropped to conform to your settings. + - The Agora SDK supports adding only one watermark image onto a local video or CDN live stream. The newly added watermark image replaces the previous one. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int addVideoWatermark(const RtcImage& watermark) = 0; + + /** Adds a watermark image to the local video. + + This method adds a PNG watermark image to the local video in a live broadcast. Once the watermark image is added, all the audience in the channel (CDN audience included), + and the recording device can see and capture it. Agora supports adding only one watermark image onto the local video, and the newly watermark image replaces the previous one. + + The watermark position depends on the settings in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method: + - If the orientation mode of the encoding video is #ORIENTATION_MODE_FIXED_LANDSCAPE, or the landscape mode in #ORIENTATION_MODE_ADAPTIVE, the watermark uses the landscape orientation. + - If the orientation mode of the encoding video is #ORIENTATION_MODE_FIXED_PORTRAIT, or the portrait mode in #ORIENTATION_MODE_ADAPTIVE, the watermark uses the portrait orientation. + - When setting the watermark position, the region must be less than the dimensions set in the `setVideoEncoderConfiguration` method. Otherwise, the watermark image will be cropped. + + @note + - Ensure that you have called the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method to enable the video module before calling this method. + - If you only want to add a watermark image to the local video for the audience in the CDN live broadcast channel to see and capture, you can call this method or the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. + - This method supports adding a watermark image in the PNG file format only. Supported pixel formats of the PNG image are RGBA, RGB, Palette, Gray, and Alpha_gray. + - If the dimensions of the PNG image differ from your settings in this method, the image will be cropped or zoomed to conform to your settings. + - If you have enabled the local video preview by calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, you can use the `visibleInPreview` member in the WatermarkOptions class to set whether or not the watermark is visible in preview. + - If you have mirrored the local video by calling the \ref agora::rtc::IRtcEngine::setupLocalVideo "setupLocalVideo" or \ref agora::rtc::IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" method, the watermark image in preview is also mirrored. + + @param watermarkUrl The local file path of the watermark image to be added. This method supports adding a watermark image from the local absolute or relative file path. + @param options Pointer to the watermark's options to be added. See WatermarkOptions for more infomation. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) = 0; + + /** Removes the watermark image from the video stream added by the \ref agora::rtc::IRtcEngine::addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) "addVideoWatermark" method. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int clearVideoWatermarks() = 0; + + /** Enables/Disables image enhancement and sets the options. + + @note + - Call this method after calling the enableVideo method. + - Currently this method does not apply for macOS. + + @param enabled Sets whether or not to enable image enhancement: + - true: enables image enhancement. + - false: disables image enhancement. + @param options Sets the image enhancement option. See BeautyOptions. + */ + virtual int setBeautyEffectOptions(bool enabled, BeautyOptions options) = 0; + + /** Adds a voice or video stream URL address to a live broadcast. + + The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. + + The \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: + - The local client: + - \ref agora::rtc::IRtcEngineEventHandler::onStreamInjectedStatus "onStreamInjectedStatus" , with the state of the injecting the online stream. + - \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. + - The remote client: + - \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. + + @note + - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - This method applies to the Native SDK v2.4.1 and later. + + @param url Pointer to the URL address to be added to the ongoing live broadcast. Valid protocols are RTMP, HLS, and FLV. + - Supported FLV audio codec type: AAC. + - Supported FLV video codec type: H264 (AVC). + @param config Pointer to the InjectStreamConfig object that contains the configuration of the added voice or video stream. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. + - #ERR_NOT_READY (3): The user is not in the channel. + - #ERR_NOT_SUPPORTED (4): The channel profile is not live broadcast. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to live broadcast before calling this method. + - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IRtcEngine object is initialized before calling this method. + */ + virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; + /** Starts to relay media streams across channels. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" and + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callbacks, and these callbacks return the + * state and events of the media stream relay. + * - If the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback returns + * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback returns + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the broadcaster starts + * sending data to the destination channel. + * - If the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback returns + * #RELAY_STATE_FAILURE (3), an exception occurs during the media stream + * relay. + * + * @note + * - Call this method after the \ref joinChannel() "joinChannel" method. + * - This method takes effect only when you are a broadcaster in a + * Live-broadcast channel. + * - After a successful method call, if you want to call this method + * again, ensure that you call the + * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the + * current relay. + * - Contact sales-us@agora.io before implementing this function. + * - We do not support string user accounts in this API. + * + * @param configuration The configuration of the media stream relay: + * ChannelMediaRelayConfiguration. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + /** Updates the channels for media stream relay. After a successful + * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if + * you want to relay the media stream to more channels, or leave the + * current relay channel, you can call the + * \ref updateChannelMediaRelay() "updateChannelMediaRelay" method. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback with the + * #RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL (7) state code. + * + * @note + * Call this method after the + * \ref startChannelMediaRelay() "startChannelMediaRelay" method to update + * the destination channel. + * + * @param configuration The media stream relay configuration: + * ChannelMediaRelayConfiguration. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + /** Stops the media stream relay. + * + * Once the relay stops, the broadcaster quits all the destination + * channels. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback. If the callback returns + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the broadcaster successfully + * stops the relay. + * + * @note + * If the method call fails, the SDK triggers the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback with the + * #RELAY_ERROR_SERVER_NO_RESPONSE (2) or + * #RELAY_ERROR_SERVER_CONNECTION_LOST (8) state code. You can leave the + * channel by calling the \ref leaveChannel() "leaveChannel" method, and + * the media stream relay automatically stops. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int stopChannelMediaRelay() = 0; + + /** Removes the voice or video stream URL address from a live broadcast. + + This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live broadcast. + + @note If this method is called successfully, the SDK triggers the \ref IRtcEngineEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. + + @param url Pointer to the URL address of the added stream to be removed. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int removeInjectStreamUrl(const char* url) = 0; + virtual bool registerEventHandler(IRtcEngineEventHandler *eventHandler) = 0; + virtual bool unregisterEventHandler(IRtcEngineEventHandler *eventHandler) = 0; + /** Gets the current connection state of the SDK. + + @return #CONNECTION_STATE_TYPE. + */ + virtual CONNECTION_STATE_TYPE getConnectionState() = 0; + + /** Registers the metadata observer. + + Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. + This method enables you to add synchronized metadata in the video stream for more diversified live broadcast interactions, such as sending shopping links, digital coupons, and online quizzes. + + @note + - Call this method before the joinChannel method. + - This method applies to the Live-broadcast channel profile. + + @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. + @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; + /** Provides technical preview functionalities or special customizations by configuring the SDK with JSON options. + + The JSON options are not public by default. Agora is working on making commonly used JSON options public in a standard way. + + @param parameters Sets the parameter as a JSON string in the specified format. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setParameters(const char* parameters) = 0; +}; + + +class IRtcEngineParameter +{ +public: + /** + * Releases all IRtcEngineParameter resources. + */ + virtual void release() = 0; + + /** Sets the bool value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Sets the value. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setBool(const char* key, bool value) = 0; + + /** Sets the int value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Sets the value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setInt(const char* key, int value) = 0; + + /** Sets the unsigned int value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Sets the value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setUInt(const char* key, unsigned int value) = 0; + + /** Sets the double value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Sets the value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setNumber(const char* key, double value) = 0; + + /** Sets the string value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the set value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setString(const char* key, const char* value) = 0; + + /** Sets the object value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the set value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setObject(const char* key, const char* value) = 0; + + /** Retrieves the bool value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getBool(const char* key, bool& value) = 0; + + /** Retrieves the int value of the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getInt(const char* key, int& value) = 0; + + /** Retrieves the unsigned int value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getUInt(const char* key, unsigned int& value) = 0; + + /** Retrieves the double value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getNumber(const char* key, double& value) = 0; + + /** Retrieves the string value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getString(const char* key, agora::util::AString& value) = 0; + + /** Retrieves a child object value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getObject(const char* key, agora::util::AString& value) = 0; + + /** Retrieves the array value of a specified key in the JSON format. + + @param key Pointer to the name of the key. + @param value Pointer to the retrieved value. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int getArray(const char* key, agora::util::AString& value) = 0; + + /** Provides the technical preview functionalities or special customizations by configuring the SDK with JSON options. + + @param parameters Pointer to the set parameters in a JSON string. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setParameters(const char* parameters) = 0; + + /** Sets the profile to control the RTC engine. + + @param profile Pointer to the set profile. + @param merge Sets whether to merge the profile data with the original value: + - true: Merge the profile data with the original value. + - false: Do not merge the profile data with the original value. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setProfile(const char* profile, bool merge) = 0; + + virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; +}; + +class AAudioDeviceManager : public agora::util::AutoPtr +{ +public: + AAudioDeviceManager(IRtcEngine* engine) + { + queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); + } +}; + +class AVideoDeviceManager : public agora::util::AutoPtr +{ +public: + AVideoDeviceManager(IRtcEngine* engine) + { + queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); + } +}; + +class AParameter : public agora::util::AutoPtr +{ +public: + AParameter(IRtcEngine& engine) { initialize(&engine); } + AParameter(IRtcEngine* engine) { initialize(engine); } + AParameter(IRtcEngineParameter* p) :agora::util::AutoPtr(p) {} +private: + bool initialize(IRtcEngine* engine) + { + IRtcEngineParameter* p = NULL; + if (engine && !engine->queryInterface(AGORA_IID_RTC_ENGINE_PARAMETER, (void**)&p)) + reset(p); + return p != NULL; + } +}; +/** **DEPRECATED** The RtcEngineParameters class is deprecated, use the IRtcEngine class instead. +*/ +class RtcEngineParameters +{ +public: + RtcEngineParameters(IRtcEngine& engine) + :m_parameter(&engine){} + RtcEngineParameters(IRtcEngine* engine) + :m_parameter(engine){} + + + int enableLocalVideo(bool enabled) { + return setParameters("{\"rtc.video.capture\":%s,\"che.video.local.capture\":%s,\"che.video.local.render\":%s,\"che.video.local.send\":%s}", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false"); + } + + + + int muteLocalVideoStream(bool mute) { + return setParameters("{\"rtc.video.mute_me\":%s,\"che.video.local.send\":%s}", mute ? "true" : "false", mute ? "false" : "true"); + } + + + int muteAllRemoteVideoStreams(bool mute) { + return m_parameter ? m_parameter->setBool("rtc.video.mute_peers", mute) : -ERR_NOT_INITIALIZED; + } + + + + int setDefaultMuteAllRemoteVideoStreams(bool mute) { + return m_parameter ? m_parameter->setBool("rtc.video.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; + } + + + int muteRemoteVideoStream(uid_t uid, bool mute) { + return setObject("rtc.video.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute ? "true" : "false"); + } + + + int setPlaybackDeviceVolume(int volume) {// [0,255] + return m_parameter ? m_parameter->setInt("che.audio.output.volume", volume) : -ERR_NOT_INITIALIZED; + } + + + int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) { + return startAudioRecording(filePath, 32000, quality); + } + + int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) { + if (!m_parameter) return -ERR_NOT_INITIALIZED; +#if defined(_WIN32) + util::AString path; + if (!m_parameter->convertPath(filePath, path)) + filePath = path->c_str(); + else + return -ERR_INVALID_ARGUMENT; +#endif + return setObject("che.audio.start_recording", "{\"filePath\":\"%s\",\"sampleRate\":%d,\"quality\":%d}", filePath, sampleRate, quality); + } + + + int stopAudioRecording() { + return m_parameter ? m_parameter->setBool("che.audio.stop_recording", true) : -ERR_NOT_INITIALIZED; + } + + + int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) { + if (!m_parameter) return -ERR_NOT_INITIALIZED; +#if defined(_WIN32) + util::AString path; + if (!m_parameter->convertPath(filePath, path)) + filePath = path->c_str(); + else + return -ERR_INVALID_ARGUMENT; +#endif + return setObject("che.audio.start_file_as_playout", "{\"filePath\":\"%s\",\"loopback\":%s,\"replace\":%s,\"cycle\":%d}", + filePath, + loopback?"true":"false", + replace?"true":"false", + cycle); + } + + + int stopAudioMixing() { + return m_parameter ? m_parameter->setBool("che.audio.stop_file_as_playout", true) : -ERR_NOT_INITIALIZED; + } + + + int pauseAudioMixing() { + return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", true) : -ERR_NOT_INITIALIZED; + } + + + int resumeAudioMixing() { + return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", false) : -ERR_NOT_INITIALIZED; + } + + + int adjustAudioMixingVolume(int volume) { + int ret = adjustAudioMixingPlayoutVolume(volume); + if (ret == 0) { + adjustAudioMixingPublishVolume(volume); + } + return ret; + } + + + int adjustAudioMixingPlayoutVolume(int volume) { + return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; + } + + + int getAudioMixingPlayoutVolume() { + int volume = 0; + int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = volume; + return r; + } + + + int adjustAudioMixingPublishVolume(int volume) { + return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; + } + + + int getAudioMixingPublishVolume() { + int volume = 0; + int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = volume; + return r; + } + + + int getAudioMixingDuration() { + int duration = 0; + int r = m_parameter ? m_parameter->getInt("che.audio.get_mixing_file_length_ms", duration) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = duration; + return r; + } + + + int getAudioMixingCurrentPosition() { + if (!m_parameter) return -ERR_NOT_INITIALIZED; + int pos = 0; + int r = m_parameter->getInt("che.audio.get_mixing_file_played_ms", pos); + if (r == 0) + r = pos; + return r; + } + + int setAudioMixingPosition(int pos /*in ms*/) { + return m_parameter ? m_parameter->setInt("che.audio.mixing.file.position", pos) : -ERR_NOT_INITIALIZED; + } + + + int getEffectsVolume() { + if (!m_parameter) return -ERR_NOT_INITIALIZED; + int volume = 0; + int r = m_parameter->getInt("che.audio.game_get_effects_volume", volume); + if (r == 0) + r = volume; + return r; + } + + + int setEffectsVolume(int volume) { + return m_parameter ? m_parameter->setInt("che.audio.game_set_effects_volume", volume) : -ERR_NOT_INITIALIZED; + } + + + int setVolumeOfEffect(int soundId, int volume) { + return setObject( + "che.audio.game_adjust_effect_volume", + "{\"soundId\":%d,\"gain\":%d}", + soundId, volume); + } + + + int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) { +#if defined(_WIN32) + util::AString path; + if (!m_parameter->convertPath(filePath, path)) + filePath = path->c_str(); + else if (!filePath) + filePath = ""; +#endif + return setObject( + "che.audio.game_play_effect", + "{\"soundId\":%d,\"filePath\":\"%s\",\"loopCount\":%d, \"pitch\":%lf,\"pan\":%lf,\"gain\":%d, \"send2far\":%d}", + soundId, filePath, loopCount, pitch, pan, gain, publish); + } + + + int stopEffect(int soundId) { + return m_parameter ? m_parameter->setInt( + "che.audio.game_stop_effect", soundId) : -ERR_NOT_INITIALIZED; + } + + + int stopAllEffects() { + return m_parameter ? m_parameter->setBool( + "che.audio.game_stop_all_effects", true) : -ERR_NOT_INITIALIZED; + } + + + int preloadEffect(int soundId, char* filePath) { + return setObject( + "che.audio.game_preload_effect", + "{\"soundId\":%d,\"filePath\":\"%s\"}", + soundId, filePath); + } + + + int unloadEffect(int soundId) { + return m_parameter ? m_parameter->setInt( + "che.audio.game_unload_effect", soundId) : -ERR_NOT_INITIALIZED; + } + + + int pauseEffect(int soundId) { + return m_parameter ? m_parameter->setInt( + "che.audio.game_pause_effect", soundId) : -ERR_NOT_INITIALIZED; + } + + + int pauseAllEffects() { + return m_parameter ? m_parameter->setBool( + "che.audio.game_pause_all_effects", true) : -ERR_NOT_INITIALIZED; + } + + + int resumeEffect(int soundId) { + return m_parameter ? m_parameter->setInt( + "che.audio.game_resume_effect", soundId) : -ERR_NOT_INITIALIZED; + } + + + int resumeAllEffects() { + return m_parameter ? m_parameter->setBool( + "che.audio.game_resume_all_effects", true) : -ERR_NOT_INITIALIZED; + } + + + int enableSoundPositionIndication(bool enabled) { + return m_parameter ? m_parameter->setBool( + "che.audio.enable_sound_position", enabled) : -ERR_NOT_INITIALIZED; + } + + + int setRemoteVoicePosition(uid_t uid, double pan, double gain) { + return setObject("che.audio.game_place_sound_position", "{\"uid\":%u,\"pan\":%lf,\"gain\":%lf}", uid, pan, gain); + } + + + int setLocalVoicePitch(double pitch) { + return m_parameter ? m_parameter->setInt( + "che.audio.morph.pitch_shift", + static_cast(pitch * 100)) : -ERR_NOT_INITIALIZED; + } + + int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) { + return setObject( + "che.audio.morph.equalization", + "{\"index\":%d,\"gain\":%d}", + static_cast(bandFrequency), bandGain); + } + + int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) { + return setObject( + "che.audio.morph.reverb", + "{\"key\":%d,\"value\":%d}", + static_cast(reverbKey), value); + } + + + int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) { + return m_parameter ? m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)) : -ERR_NOT_INITIALIZED; + } + + + int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) { + return m_parameter ? m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)) : -ERR_NOT_INITIALIZED; + } + + + + int pauseAudio() { + return m_parameter ? m_parameter->setBool("che.pause.audio", true) : -ERR_NOT_INITIALIZED; + } + + + int resumeAudio() { + return m_parameter ? m_parameter->setBool("che.pause.audio", false) : -ERR_NOT_INITIALIZED; + } + + + int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) { + return setObject("che.audio.codec.hq", "{\"fullband\":%s,\"stereo\":%s,\"fullBitrate\":%s}", fullband ? "true" : "false", stereo ? "true" : "false", fullBitrate ? "true" : "false"); + } + + + int adjustRecordingSignalVolume(int volume) {//[0, 400]: e.g. 50~0.5x 100~1x 400~4x + if (volume < 0) + volume = 0; + else if (volume > 400) + volume = 400; + return m_parameter ? m_parameter->setInt("che.audio.record.signal.volume", volume) : -ERR_NOT_INITIALIZED; + } + + + int adjustPlaybackSignalVolume(int volume) {//[0, 400] + if (volume < 0) + volume = 0; + else if (volume > 400) + volume = 400; + return m_parameter ? m_parameter->setInt("che.audio.playout.signal.volume", volume) : -ERR_NOT_INITIALIZED; + } + + + int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) { // in ms: <= 0: disable, > 0: enable, interval in ms + if (interval < 0) + interval = 0; + return setObject("che.audio.volume_indication", "{\"interval\":%d,\"smooth\":%d,\"vad\":%d}", interval, smooth, report_vad); + } + + + int muteLocalAudioStream(bool mute) { + return setParameters("{\"rtc.audio.mute_me\":%s,\"che.audio.mute_me\":%s}", mute ? "true" : "false", mute ? "true" : "false"); + } + // mute/unmute all peers. unmute will clear all muted peers specified mutePeer() interface + + + int muteRemoteAudioStream(uid_t uid, bool mute) { + return setObject("rtc.audio.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute?"true":"false"); + } + + + int muteAllRemoteAudioStreams(bool mute) { + return m_parameter ? m_parameter->setBool("rtc.audio.mute_peers", mute) : -ERR_NOT_INITIALIZED; + } + + + int setDefaultMuteAllRemoteAudioStreams(bool mute) { + return m_parameter ? m_parameter->setBool("rtc.audio.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; + } + + + int setExternalAudioSource(bool enabled, int sampleRate, int channels) { + if (enabled) + return setParameters("{\"che.audio.external_capture\":true,\"che.audio.external_capture.push\":true,\"che.audio.set_capture_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE); + else + return setParameters("{\"che.audio.external_capture\":false,\"che.audio.external_capture.push\":false}"); + } + + + int setExternalAudioSink(bool enabled, int sampleRate, int channels) { + if (enabled) + return setParameters("{\"che.audio.external_render\":true,\"che.audio.external_render.pull\":true,\"che.audio.set_render_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_ONLY); + else + return setParameters("{\"che.audio.external_render\":false,\"che.audio.external_render.pull\":false}"); + } + + + int setLogFile(const char* filePath) { + if (!m_parameter) return -ERR_NOT_INITIALIZED; +#if defined(_WIN32) + util::AString path; + if (!m_parameter->convertPath(filePath, path)) + filePath = path->c_str(); + else if (!filePath) + filePath = ""; +#endif + return m_parameter->setString("rtc.log_file", filePath); + } + + + int setLogFilter(unsigned int filter) { + return m_parameter ? m_parameter->setUInt("rtc.log_filter", filter&LOG_FILTER_MASK) : -ERR_NOT_INITIALIZED; + } + + + int setLogFileSize(unsigned int fileSizeInKBytes) { + return m_parameter ? m_parameter->setUInt("rtc.log_size", fileSizeInKBytes) : -ERR_NOT_INITIALIZED; + } + + + int setLocalRenderMode(RENDER_MODE_TYPE renderMode) { + return setRemoteRenderMode(0, renderMode); + } + + + int setRemoteRenderMode(uid_t uid, RENDER_MODE_TYPE renderMode) { + return setObject("che.video.render_mode", "{\"uid\":%u,\"renderMode\":%d}", uid, renderMode); + } + + + int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) { + if (!m_parameter) return -ERR_NOT_INITIALIZED; + return m_parameter->setInt("che.video.camera_capture_mode", (int)config.preference); + } + + + int enableDualStreamMode(bool enabled) { + return setParameters("{\"rtc.dual_stream_mode\":%s,\"che.video.enableLowBitRateStream\":%d}", enabled ? "true" : "false", enabled ? 1 : 0); + } + + + int setRemoteVideoStreamType(uid_t uid, REMOTE_VIDEO_STREAM_TYPE streamType) { + return setParameters("{\"rtc.video.set_remote_video_stream\":{\"uid\":%u,\"stream\":%d}, \"che.video.setstream\":{\"uid\":%u,\"stream\":%d}}", uid, streamType, uid, streamType); +// return setObject("rtc.video.set_remote_video_stream", "{\"uid\":%u,\"stream\":%d}", uid, streamType); + } + + + int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) { + return m_parameter ? m_parameter->setInt("rtc.video.set_remote_default_video_stream_type", streamType) : -ERR_NOT_INITIALIZED; + } + + + int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { + return setObject("che.audio.set_capture_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); + } + + int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { + return setObject("che.audio.set_render_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); + } + + int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) { + return setObject("che.audio.set_mixed_raw_audio_format", "{\"sampleRate\":%d,\"samplesPerCall\":%d}", sampleRate, samplesPerCall); + } + + + int enableWebSdkInteroperability(bool enabled) {//enable interoperability with zero-plugin web sdk + return setParameters("{\"rtc.video.web_h264_interop_enable\":%s,\"che.video.web_h264_interop_enable\":%s}", enabled ? "true" : "false", enabled ? "true" : "false"); + } + + //only for live broadcast + + int setVideoQualityParameters(bool preferFrameRateOverImageQuality) { + return setParameters("{\"rtc.video.prefer_frame_rate\":%s,\"che.video.prefer_frame_rate\":%s}", preferFrameRateOverImageQuality ? "true" : "false", preferFrameRateOverImageQuality ? "true" : "false"); + } + + + int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) { + if (!m_parameter) return -ERR_NOT_INITIALIZED; + const char *value; + switch (mirrorMode) { + case VIDEO_MIRROR_MODE_AUTO: + value = "default"; + break; + case VIDEO_MIRROR_MODE_ENABLED: + value = "forceMirror"; + break; + case VIDEO_MIRROR_MODE_DISABLED: + value = "disableMirror"; + break; + default: + return -ERR_INVALID_ARGUMENT; + } + return m_parameter->setString("che.video.localViewMirrorSetting", value); + } + + + int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) { + return m_parameter ? m_parameter->setInt("rtc.local_publish_fallback_option", option) : -ERR_NOT_INITIALIZED; + } + + + int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) { + return m_parameter ? m_parameter->setInt("rtc.remote_subscribe_fallback_option", option) : -ERR_NOT_INITIALIZED; + } + +#if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) || defined(_WIN32) + + int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) { + if (!deviceName) { + return setParameters("{\"che.audio.loopback.recording\":%s}", enabled ? "true" : "false"); + } + else { + return setParameters("{\"che.audio.loopback.deviceName\":\"%s\",\"che.audio.loopback.recording\":%s}", deviceName, enabled ? "true" : "false"); + } + } +#endif + + + int setInEarMonitoringVolume(int volume) { + return m_parameter ? m_parameter->setInt("che.audio.headset.monitoring.parameter", volume) : -ERR_NOT_INITIALIZED; + } + +protected: + AParameter& parameter() { + return m_parameter; + } + int setParameters(const char* format, ...) { + char buf[512]; + va_list args; + va_start(args, format); + vsnprintf(buf, sizeof(buf)-1, format, args); + va_end(args); + return m_parameter ? m_parameter->setParameters(buf) : -ERR_NOT_INITIALIZED; + } + int setObject(const char* key, const char* format, ...) { + char buf[512]; + va_list args; + va_start(args, format); + vsnprintf(buf, sizeof(buf)-1, format, args); + va_end(args); + return m_parameter ? m_parameter->setObject(key, buf) : -ERR_NOT_INITIALIZED; + } + int stopAllRemoteVideo() { + return m_parameter ? m_parameter->setBool("che.video.peer.stop_render", true) : -ERR_NOT_INITIALIZED; + } +private: + AParameter m_parameter; +}; + +} //namespace rtc +} // namespace agora + + +#define getAgoraRtcEngineVersion getAgoraSdkVersion + +//////////////////////////////////////////////////////// +/** \addtogroup createAgoraRtcEngine + @{ + */ +//////////////////////////////////////////////////////// + +/** Creates the IRtcEngine object and returns the pointer. + * + * @return Pointer to the IRtcEngine object. + */ +AGORA_API agora::rtc::IRtcEngine* AGORA_CALL createAgoraRtcEngine(); + +//////////////////////////////////////////////////////// +/** @} */ +//////////////////////////////////////////////////////// + +#define getAgoraRtcEngineErrorDescription getAgoraSdkErrorDescription +#define setAgoraRtcEngineExternalSymbolLoader setAgoraSdkExternalSymbolLoader + +#endif diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h new file mode 100644 index 0000000..a607ed3 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h @@ -0,0 +1,76 @@ +// Agora SDK +// +// Copyright (c) 2019 Agora.io. All rights reserved. +// + +#ifndef AGORA_SERVICE_H +#define AGORA_SERVICE_H +#include "AgoraBase.h" + +namespace agora { + namespace rtc { + class IRtcEngine; + } + namespace rtm { + class IRtmService; + } +namespace base { + +struct AgoraServiceContext +{ +}; + + +class IAgoraService +{ +protected: + virtual ~IAgoraService(){} +public: + virtual void release() = 0; + + /** Initializes the engine. + + @param context RtcEngine context. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int initialize(const AgoraServiceContext& context) = 0; + + /** Retrieves the SDK version number. + * @param build Build number. + * @return The current SDK version in the string format. For example, 2.4.0 + */ + virtual const char* getVersion(int* build) = 0; + + virtual rtm::IRtmService* createRtmService() = 0; +}; + +} //namespace base +} // namespace agora + +/** Gets the SDK version number. + + @param build Build number of the Agora SDK. + @return + - 0: Success. + - < 0: Failure. +*/ +AGORA_API const char* AGORA_CALL getAgoraSdkVersion(int* build); + +/** +* Creates the RtcEngine object and returns the pointer. +* @param err Error code +* @return returns Description of the error code +*/ +AGORA_API const char* AGORA_CALL getAgoraSdkErrorDescription(int err); + +/** +* Creates the Agora Service object and returns the pointer. +* @return returns Pointer of the Agora Service object +*/ +AGORA_API agora::base::IAgoraService* AGORA_CALL createAgoraService(); + +AGORA_API int AGORA_CALL setAgoraSdkExternalSymbolLoader(void* (*func)(const char* symname)); + +#endif diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/constructor_magic.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/constructor_magic.h new file mode 100644 index 0000000..b2aabc5 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/constructor_magic.h @@ -0,0 +1,50 @@ +/* + * Copyright (c) 2011 The WebRTC project authors. All Rights Reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +/* + * WebRtc + * Copy from third_party/libjingle/source/talk/base/constructormagic.h + */ + +#ifndef WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CONSTRUCTOR_MAGIC_H_ +#define WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CONSTRUCTOR_MAGIC_H_ + +#ifndef DISALLOW_ASSIGN +#define DISALLOW_ASSIGN(TypeName) \ + void operator=(const TypeName&) +#endif + +#ifndef DISALLOW_COPY_AND_ASSIGN +// A macro to disallow the evil copy constructor and operator= functions +// This should be used in the private: declarations for a class +#define DISALLOW_COPY_AND_ASSIGN(TypeName) \ + TypeName(const TypeName&); \ + DISALLOW_ASSIGN(TypeName) +#endif + +#ifndef DISALLOW_EVIL_CONSTRUCTORS +// Alternative, less-accurate legacy name. +#define DISALLOW_EVIL_CONSTRUCTORS(TypeName) \ + DISALLOW_COPY_AND_ASSIGN(TypeName) +#endif + +#ifndef DISALLOW_IMPLICIT_CONSTRUCTORS +// A macro to disallow all the implicit constructors, namely the +// default constructor, copy constructor and operator= functions. +// +// This should be used in the private: declarations for a class +// that wants to prevent anyone from instantiating it. This is +// especially useful for classes containing only static methods. +#define DISALLOW_IMPLICIT_CONSTRUCTORS(TypeName) \ + TypeName(); \ + DISALLOW_EVIL_CONSTRUCTORS(TypeName) +#endif + +#endif // WEBRTC_SYSTEM_WRAPPERS_INTERFACE_CONSTRUCTOR_MAGIC_H_ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/scoped_ptr.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/scoped_ptr.h new file mode 100644 index 0000000..0eb86ef --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/scoped_ptr.h @@ -0,0 +1,719 @@ +// (C) Copyright Greg Colvin and Beman Dawes 1998, 1999. +// Copyright (c) 2001, 2002 Peter Dimov +// +// Permission to copy, use, modify, sell and distribute this software +// is granted provided this copyright notice appears in all copies. +// This software is provided "as is" without express or implied +// warranty, and with no claim as to its suitability for any purpose. +// +// See http://www.boost.org/libs/smart_ptr/scoped_ptr.htm for documentation. +// + +// scoped_ptr mimics a built-in pointer except that it guarantees deletion +// of the object pointed to, either on destruction of the scoped_ptr or via +// an explicit reset(). scoped_ptr is a simple solution for simple needs; +// use shared_ptr or std::auto_ptr if your needs are more complex. + +// scoped_ptr_malloc added in by Google. When one of +// these goes out of scope, instead of doing a delete or delete[], it +// calls free(). scoped_ptr_malloc is likely to see much more +// use than any other specializations. + +// release() added in by Google. Use this to conditionally +// transfer ownership of a heap-allocated object to the caller, usually on +// method success. +#ifndef WEBRTC_SYSTEM_WRAPPERS_INTERFACE_SCOPED_PTR_H_ +#define WEBRTC_SYSTEM_WRAPPERS_INTERFACE_SCOPED_PTR_H_ + +#include // for assert +#include // for ptrdiff_t +#include // for free() decl +#include "constructor_magic.h" +#include "template_util.h" +#include "typedefs.h" +#include // for std::swap + +#ifdef _WIN32 +namespace std { using ::ptrdiff_t; }; +#endif // _WIN32 + +namespace AgoraRTC { + +// Function object which deletes its parameter, which must be a pointer. +// If C is an array type, invokes 'delete[]' on the parameter; otherwise, +// invokes 'delete'. The default deleter for scoped_ptr. +template +struct DefaultDeleter { + DefaultDeleter() {} + template DefaultDeleter(const DefaultDeleter& other) { + // IMPLEMENTATION NOTE: C++11 20.7.1.1.2p2 only provides this constructor + // if U* is implicitly convertible to T* and U is not an array type. + // + // Correct implementation should use SFINAE to disable this + // constructor. However, since there are no other 1-argument constructors, + // using a static_assert based on is_convertible<> and requiring + // complete types is simpler and will cause compile failures for equivalent + // misuses. + // + // Note, the is_convertible check also ensures that U is not an + // array. T is guaranteed to be a non-array, so any U* where U is an array + // cannot convert to T*. + enum { T_must_be_complete = sizeof(T) }; + enum { U_must_be_complete = sizeof(U) }; + static_assert(is_convertible::value, + "U* must implicitly convert to T*"); + } + inline void operator()(T* ptr) const { + enum { type_must_be_complete = sizeof(T) }; + delete ptr; + } +}; + +// Specialization of DefaultDeleter for array types. +template +struct DefaultDeleter { + inline void operator()(T* ptr) const { + enum { type_must_be_complete = sizeof(T) }; + delete[] ptr; + } + +private: + // Disable this operator for any U != T because it is undefined to execute + // an array delete when the static type of the array mismatches the dynamic + // type. + // + // References: + // C++98 [expr.delete]p3 + // http://cplusplus.github.com/LWG/lwg-defects.html#938 + template void operator()(U* array) const; +}; + +// Function object which invokes 'free' on its parameter, which must be +// a pointer. Can be used to store malloc-allocated pointers in scoped_ptr: +// +// scoped_ptr foo_ptr( +// static_cast(malloc(sizeof(int)))); +struct FreeDeleter { + inline void operator()(void* ptr) const { + free(ptr); + } +}; + +namespace internal { + + template + struct ShouldAbortOnSelfReset { + template + static internal::NoType Test(const typename U::AllowSelfReset*); + + template + static internal::YesType Test(...); + + static const bool value = + sizeof(Test(0)) == sizeof(internal::YesType); + }; + + // Minimal implementation of the core logic of scoped_ptr, suitable for + // reuse in both scoped_ptr and its specializations. + template + class scoped_ptr_impl { + public: + explicit scoped_ptr_impl(T* p) : data_(p) {} + + // Initializer for deleters that have data parameters. + scoped_ptr_impl(T* p, const D& d) : data_(p, d) {} + + // Templated constructor that destructively takes the value from another + // scoped_ptr_impl. + template + scoped_ptr_impl(scoped_ptr_impl* other) + : data_(other->release(), other->get_deleter()) { + // We do not support move-only deleters. We could modify our move + // emulation to have rtc::subtle::move() and rtc::subtle::forward() + // functions that are imperfect emulations of their C++11 equivalents, + // but until there's a requirement, just assume deleters are copyable. + } + + template + void TakeState(scoped_ptr_impl* other) { + // See comment in templated constructor above regarding lack of support + // for move-only deleters. + reset(other->release()); + get_deleter() = other->get_deleter(); + } + + ~scoped_ptr_impl() { + if (data_.ptr != NULL) { + // Not using get_deleter() saves one function call in non-optimized + // builds. + static_cast(data_)(data_.ptr); + } + } + + void reset(T* p) { + // This is a self-reset, which is no longer allowed for default deleters: + // https://crbug.com/162971 + assert(!ShouldAbortOnSelfReset::value || p == NULL || p != data_.ptr); + + // Note that running data_.ptr = p can lead to undefined behavior if + // get_deleter()(get()) deletes this. In order to prevent this, reset() + // should update the stored pointer before deleting its old value. + // + // However, changing reset() to use that behavior may cause current code to + // break in unexpected ways. If the destruction of the owned object + // dereferences the scoped_ptr when it is destroyed by a call to reset(), + // then it will incorrectly dispatch calls to |p| rather than the original + // value of |data_.ptr|. + // + // During the transition period, set the stored pointer to NULL while + // deleting the object. Eventually, this safety check will be removed to + // prevent the scenario initially described from occurring and + // http://crbug.com/176091 can be closed. + T* old = data_.ptr; + data_.ptr = NULL; + if (old != NULL) + static_cast(data_)(old); + data_.ptr = p; + } + + T* get() const { return data_.ptr; } + + D& get_deleter() { return data_; } + const D& get_deleter() const { return data_; } + + void swap(scoped_ptr_impl& p2) { + // Standard swap idiom: 'using std::swap' ensures that std::swap is + // present in the overload set, but we call swap unqualified so that + // any more-specific overloads can be used, if available. + using std::swap; + swap(static_cast(data_), static_cast(p2.data_)); + swap(data_.ptr, p2.data_.ptr); + } + + T* release() { + T* old_ptr = data_.ptr; + data_.ptr = NULL; + return old_ptr; + } + + T** accept() { + reset(NULL); + return &(data_.ptr); + } + + T** use() { + return &(data_.ptr); + } + + private: + // Needed to allow type-converting constructor. + template friend class scoped_ptr_impl; + + // Use the empty base class optimization to allow us to have a D + // member, while avoiding any space overhead for it when D is an + // empty class. See e.g. http://www.cantrip.org/emptyopt.html for a good + // discussion of this technique. + struct Data : public D { + explicit Data(T* ptr_in) : ptr(ptr_in) {} + Data(T* ptr_in, const D& other) : D(other), ptr(ptr_in) {} + T* ptr; + }; + + Data data_; + + DISALLOW_COPY_AND_ASSIGN(scoped_ptr_impl); + }; + +} // namespace internal + +template +class scoped_ptr { + private: + + T* ptr; + + scoped_ptr(scoped_ptr const &); + scoped_ptr & operator=(scoped_ptr const &); + + public: + + typedef T element_type; + + explicit scoped_ptr(T* p = NULL): ptr(p) {} + scoped_ptr(scoped_ptr &&rhs) { + ptr = rhs.ptr; + rhs.ptr = NULL; + } + + scoped_ptr& operator=(scoped_ptr &&rhs) { + if (this != &rhs) { + ptr = rhs.ptr; + rhs.ptr = NULL; + } + + return *this; + } + + ~scoped_ptr() { + typedef char type_must_be_complete[sizeof(T)]; + delete ptr; + } + + void reset(T* p = NULL) { + typedef char type_must_be_complete[sizeof(T)]; + + if (ptr != p) { + T* obj = ptr; + ptr = p; + // Delete last, in case obj destructor indirectly results in ~scoped_ptr + delete obj; + } + } + + T& operator*() const { + assert(ptr != NULL); + return *ptr; + } + + T* operator->() const { + assert(ptr != NULL); + return ptr; + } + + T* get() const { + return ptr; + } + + void swap(scoped_ptr & b) { + T* tmp = b.ptr; + b.ptr = ptr; + ptr = tmp; + } + + T* release() { + T* tmp = ptr; + ptr = NULL; + return tmp; + } + + T** accept() { + if (ptr) { + delete ptr; + ptr = NULL; + } + return &ptr; + } + + T** use() { + return &ptr; + } +}; + +template inline +void swap(scoped_ptr& a, scoped_ptr& b) { + a.swap(b); +} + + + + +// scoped_array extends scoped_ptr to arrays. Deletion of the array pointed to +// is guaranteed, either on destruction of the scoped_array or via an explicit +// reset(). Use shared_array or std::vector if your needs are more complex. + +template +class scoped_array { + private: + + T* ptr; + + scoped_array(scoped_array const &); + scoped_array & operator=(scoped_array const &); + + public: + + typedef T element_type; + + explicit scoped_array(T* p = NULL) : ptr(p) {} + + ~scoped_array() { + typedef char type_must_be_complete[sizeof(T)]; + delete[] ptr; + } + + void reset(T* p = NULL) { + typedef char type_must_be_complete[sizeof(T)]; + + if (ptr != p) { + T* arr = ptr; + ptr = p; + // Delete last, in case arr destructor indirectly results in ~scoped_array + delete [] arr; + } + } + + T& operator[](ptrdiff_t i) const { + assert(ptr != NULL); + assert(i >= 0); + return ptr[i]; + } + + T* get() const { + return ptr; + } + + void swap(scoped_array & b) { + T* tmp = b.ptr; + b.ptr = ptr; + ptr = tmp; + } + + T* release() { + T* tmp = ptr; + ptr = NULL; + return tmp; + } + + T** accept() { + if (ptr) { + delete [] ptr; + ptr = NULL; + } + return &ptr; + } +}; + +template inline +void swap(scoped_array& a, scoped_array& b) { + a.swap(b); +} + +// scoped_ptr_malloc<> is similar to scoped_ptr<>, but it accepts a +// second template argument, the function used to free the object. + +template class scoped_ptr_malloc { + private: + + T* ptr; + + scoped_ptr_malloc(scoped_ptr_malloc const &); + scoped_ptr_malloc & operator=(scoped_ptr_malloc const &); + + public: + + typedef T element_type; + + explicit scoped_ptr_malloc(T* p = 0): ptr(p) {} + + ~scoped_ptr_malloc() { + FF(static_cast(ptr)); + } + + void reset(T* p = 0) { + if (ptr != p) { + FF(static_cast(ptr)); + ptr = p; + } + } + + T& operator*() const { + assert(ptr != 0); + return *ptr; + } + + T* operator->() const { + assert(ptr != 0); + return ptr; + } + + T* get() const { + return ptr; + } + + void swap(scoped_ptr_malloc & b) { + T* tmp = b.ptr; + b.ptr = ptr; + ptr = tmp; + } + + T* release() { + T* tmp = ptr; + ptr = 0; + return tmp; + } + + T** accept() { + if (ptr) { + FF(static_cast(ptr)); + ptr = 0; + } + return &ptr; + } +}; + +template inline +void swap(scoped_ptr_malloc& a, scoped_ptr_malloc& b) { + a.swap(b); +} + +} // namespace AgoraRTC + +namespace AgoraAPM { + template > + class scoped_ptr { + + // TODO(ajm): If we ever import RefCountedBase, this check needs to be + // enabled. + //static_assert(rtc::internal::IsNotRefCounted::value, + // "T is refcounted type and needs scoped refptr"); + + public: + // The element and deleter types. + typedef T element_type; + typedef D deleter_type; + + // Constructor. Takes ownership of p. + explicit scoped_ptr(element_type* p=NULL) : impl_(p) {} + + // Constructor. Allows initialization of a stateful deleter. + scoped_ptr(element_type* p, const D& d) : impl_(p, d) {} + + // Constructor. Allows construction from a scoped_ptr rvalue for a + // convertible type and deleter. + // + // IMPLEMENTATION NOTE: C++11 unique_ptr<> keeps this constructor distinct + // from the normal move constructor. By C++11 20.7.1.2.1.21, this constructor + // has different post-conditions if D is a reference type. Since this + // implementation does not support deleters with reference type, + // we do not need a separate move constructor allowing us to avoid one + // use of SFINAE. You only need to care about this if you modify the + // implementation of scoped_ptr. +// template +// scoped_ptr(scoped_ptr&& other) +// : impl_(&other.impl_) { +// // static_assert(!AgoraRTC::is_array::value, "U cannot be an array"); +// } +// +// // operator=. Allows assignment from a scoped_ptr rvalue for a convertible +// // type and deleter. +// // +// // IMPLEMENTATION NOTE: C++11 unique_ptr<> keeps this operator= distinct from +// // the normal move assignment operator. By C++11 20.7.1.2.3.4, this templated +// // form has different requirements on for move-only Deleters. Since this +// // implementation does not support move-only Deleters, we do not need a +// // separate move assignment operator allowing us to avoid one use of SFINAE. +// // You only need to care about this if you modify the implementation of +// // scoped_ptr. +// template +// scoped_ptr& operator=(scoped_ptr&& rhs) { +// // static_assert(!AgoraRTC::is_array::value, "U cannot be an array"); +// impl_.TakeState(&rhs.impl_); +// return *this; +// } + + // Deleted copy constructor and copy assignment, to make the type move-only. + private: + scoped_ptr(const scoped_ptr& other); + scoped_ptr& operator=(const scoped_ptr& other); + public: + // Reset. Deletes the currently owned object, if any. + // Then takes ownership of a new object, if given. + void reset(element_type* p = NULL) { impl_.reset(p); } + + // Accessors to get the owned object. + // operator* and operator-> will assert() if there is no current object. + element_type& operator*() const { + assert(impl_.get() != NULL); + return *impl_.get(); + } + element_type* operator->() const { + assert(impl_.get() != NULL); + return impl_.get(); + } + element_type* get() const { return impl_.get(); } + + // Access to the deleter. + deleter_type& get_deleter() { return impl_.get_deleter(); } + const deleter_type& get_deleter() const { return impl_.get_deleter(); } + + // Allow scoped_ptr to be used in boolean expressions, but not + // implicitly convertible to a real bool (which is dangerous). + // + // Note that this trick is only safe when the == and != operators + // are declared explicitly, as otherwise "scoped_ptr1 == + // scoped_ptr2" will compile but do the wrong thing (i.e., convert + // to Testable and then do the comparison). + private: + typedef AgoraRTC::internal::scoped_ptr_impl + scoped_ptr::*Testable; + + public: + operator Testable() const { + return impl_.get() ? &scoped_ptr::impl_ : NULL; + } + + // Comparison operators. + // These return whether two scoped_ptr refer to the same object, not just to + // two different but equal objects. + bool operator==(const element_type* p) const { return impl_.get() == p; } + bool operator!=(const element_type* p) const { return impl_.get() != p; } + + // Swap two scoped pointers. + void swap(scoped_ptr& p2) { + impl_.swap(p2.impl_); + } + + // Release a pointer. + // The return value is the current pointer held by this object. If this object + // holds a NULL, the return value is NULL. After this operation, this + // object will hold a NULL, and will not own the object any more. + element_type* release() WARN_UNUSED_RESULT { + return impl_.release(); + } + + // Delete the currently held pointer and return a pointer + // to allow overwriting of the current pointer address. + element_type** accept() WARN_UNUSED_RESULT { + return impl_.accept(); + } + + // Return a pointer to the current pointer address. + element_type** use() WARN_UNUSED_RESULT { + return impl_.use(); + } + + private: + // Needed to reach into |impl_| in the constructor. + template friend class scoped_ptr; + AgoraRTC::internal::scoped_ptr_impl impl_; + + // Forbidden for API compatibility with std::unique_ptr. + explicit scoped_ptr(int disallow_construction_from_null); + + // Forbid comparison of scoped_ptr types. If U != T, it totally + // doesn't make sense, and if U == T, it still doesn't make sense + // because you should never have the same object owned by two different + // scoped_ptrs. + template bool operator==(scoped_ptr const& p2) const; + template bool operator!=(scoped_ptr const& p2) const; + }; + + template + class scoped_ptr { + public: + // The element and deleter types. + typedef T element_type; + typedef D deleter_type; + + // Constructor. Stores the given array. Note that the argument's type + // must exactly match T*. In particular: + // - it cannot be a pointer to a type derived from T, because it is + // inherently unsafe in the general case to access an array through a + // pointer whose dynamic type does not match its static type (eg., if + // T and the derived types had different sizes access would be + // incorrectly calculated). Deletion is also always undefined + // (C++98 [expr.delete]p3). If you're doing this, fix your code. + // - it cannot be const-qualified differently from T per unique_ptr spec + // (http://cplusplus.github.com/LWG/lwg-active.html#2118). Users wanting + // to work around this may use implicit_cast(). + // However, because of the first bullet in this comment, users MUST + // NOT use implicit_cast() to upcast the static type of the array. + explicit scoped_ptr(element_type* array=NULL) : impl_(array) {} + + // operator=. Allows assignment from a NULL. Deletes the currently owned + // array, if any. + scoped_ptr& operator=(element_type *t) { + reset(t); + return *this; + } + private: + // Deleted copy constructor and copy assignment, to make the type move-only. + scoped_ptr(const scoped_ptr& other); + scoped_ptr& operator=(const scoped_ptr& other); + public: + // Reset. Deletes the currently owned array, if any. + // Then takes ownership of a new object, if given. + void reset(element_type* array = NULL) { impl_.reset(array); } + + // Accessors to get the owned array. + element_type& operator[](size_t i) const { + assert(impl_.get() != NULL); + return impl_.get()[i]; + } + element_type* get() const { return impl_.get(); } + + // Access to the deleter. + deleter_type& get_deleter() { return impl_.get_deleter(); } + const deleter_type& get_deleter() const { return impl_.get_deleter(); } + + // Allow scoped_ptr to be used in boolean expressions, but not + // implicitly convertible to a real bool (which is dangerous). + private: + typedef AgoraRTC::internal::scoped_ptr_impl + scoped_ptr::*Testable; + + public: + operator Testable() const { + return impl_.get() ? &scoped_ptr::impl_ : NULL; + } + + // Comparison operators. + // These return whether two scoped_ptr refer to the same object, not just to + // two different but equal objects. + bool operator==(element_type* array) const { return impl_.get() == array; } + bool operator!=(element_type* array) const { return impl_.get() != array; } + + // Swap two scoped pointers. + void swap(scoped_ptr& p2) { + impl_.swap(p2.impl_); + } + + // Release a pointer. + // The return value is the current pointer held by this object. If this object + // holds a NULL, the return value is NULL. After this operation, this + // object will hold a NULL, and will not own the object any more. + element_type* release() WARN_UNUSED_RESULT { + return impl_.release(); + } + + // Delete the currently held pointer and return a pointer + // to allow overwriting of the current pointer address. + element_type** accept() WARN_UNUSED_RESULT { + return impl_.accept(); +} + +// Return a pointer to the current pointer address. +element_type** use() WARN_UNUSED_RESULT { + return impl_.use(); +} + +private: + // Force element_type to be a complete type. + enum { type_must_be_complete = sizeof(element_type) }; + + // Actually hold the data. + AgoraRTC::internal::scoped_ptr_impl impl_; + + // Disable initialization from any type other than element_type*, by + // providing a constructor that matches such an initialization, but is + // private and has no definition. This is disabled because it is not safe to + // call delete[] on an array whose static type does not match its dynamic + // type. + template explicit scoped_ptr(U* array); + explicit scoped_ptr(int disallow_construction_from_null); + + // Disable reset() from any type other than element_type*, for the same + // reasons as the constructor above. + template void reset(U* array); + void reset(int disallow_reset_from_null); + + // Forbid comparison of scoped_ptr types. If U != T, it totally + // doesn't make sense, and if U == T, it still doesn't make sense + // because you should never have the same object owned by two different + // scoped_ptrs. + template bool operator==(scoped_ptr const& p2) const; + template bool operator!=(scoped_ptr const& p2) const; +}; +} + +#endif // #ifndef WEBRTC_SYSTEM_WRAPPERS_INTERFACE_SCOPED_PTR_H_ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/template_util.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/template_util.h new file mode 100644 index 0000000..3c347cd --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/template_util.h @@ -0,0 +1,114 @@ +/* + * Copyright (c) 2013 The WebRTC project authors. All Rights Reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +// Borrowed from Chromium's src/base/template_util.h. + +#ifndef WEBRTC_BASE_TEMPLATE_UTIL_H_ +#define WEBRTC_BASE_TEMPLATE_UTIL_H_ + +#include // For size_t. + +namespace AgoraRTC { + +// Template definitions from tr1. + +template +struct integral_constant { + static const T value = v; + typedef T value_type; + typedef integral_constant type; +}; + +template const T integral_constant::value; + +typedef integral_constant true_type; +typedef integral_constant false_type; + +template struct is_pointer : false_type {}; +template struct is_pointer : true_type {}; + +template struct is_same : public false_type {}; +template struct is_same : true_type {}; + +template struct is_array : public false_type {}; +template struct is_array : public true_type {}; +template struct is_array : public true_type {}; + +template struct is_non_const_reference : false_type {}; +template struct is_non_const_reference : true_type {}; +template struct is_non_const_reference : false_type {}; + +template struct is_void : false_type {}; +template <> struct is_void : true_type {}; + +namespace internal { + +// Types YesType and NoType are guaranteed such that sizeof(YesType) < +// sizeof(NoType). +typedef char YesType; + +struct NoType { + YesType dummy[2]; +}; + +// This class is an implementation detail for is_convertible, and you +// don't need to know how it works to use is_convertible. For those +// who care: we declare two different functions, one whose argument is +// of type To and one with a variadic argument list. We give them +// return types of different size, so we can use sizeof to trick the +// compiler into telling us which function it would have chosen if we +// had called it with an argument of type From. See Alexandrescu's +// _Modern C++ Design_ for more details on this sort of trick. + +struct ConvertHelper { + template + static YesType Test(To); + + template + static NoType Test(...); + + template + static From& Create(); +}; + +// Used to determine if a type is a struct/union/class. Inspired by Boost's +// is_class type_trait implementation. +struct IsClassHelper { + template + static YesType Test(void(C::*)(void)); + + template + static NoType Test(...); +}; + +} // namespace internal + +// Inherits from true_type if From is convertible to To, false_type otherwise. +// +// Note that if the type is convertible, this will be a true_type REGARDLESS +// of whether or not the conversion would emit a warning. +template +struct is_convertible + : integral_constant( + internal::ConvertHelper::Create())) == + sizeof(internal::YesType)> { +}; + +template +struct is_class + : integral_constant(0)) == + sizeof(internal::YesType)> { +}; + +} // namespace AgoraRTC + +#endif // WEBRTC_BASE_TEMPLATE_UTIL_H_ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/typedefs.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/typedefs.h new file mode 100644 index 0000000..c956349 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/typedefs.h @@ -0,0 +1,151 @@ +/* + * Copyright (c) 2012 The WebRTC project authors. All Rights Reserved. + * + * Use of this source code is governed by a BSD-style license + * that can be found in the LICENSE file in the root of the source + * tree. An additional intellectual property rights grant can be found + * in the file PATENTS. All contributing project authors may + * be found in the AUTHORS file in the root of the source tree. + */ + +// This file contains platform-specific typedefs and defines. +// Much of it is derived from Chromium's build/build_config.h. + +#ifndef WEBRTC_TYPEDEFS_H_ +#define WEBRTC_TYPEDEFS_H_ + +// For access to standard POSIXish features, use WEBRTC_POSIX instead of a +// more specific macro. +#if defined(WEBRTC_MAC) || defined(WEBRTC_LINUX) || \ + defined(WEBRTC_ANDROID) +#define WEBRTC_POSIX +#endif + +// Processor architecture detection. For more info on what's defined, see: +// http://msdn.microsoft.com/en-us/library/b0084kay.aspx +// http://www.agner.org/optimize/calling_conventions.pdf +// or with gcc, run: "echo | gcc -E -dM -" +// TODO(andrew): replace WEBRTC_LITTLE_ENDIAN with WEBRTC_ARCH_LITTLE_ENDIAN. +#if defined(_M_X64) || defined(__x86_64__) +#if !defined(WEBRTC_ARCH_X86_FAMILY) + #define WEBRTC_ARCH_X86_FAMILY +#endif +#define WEBRTC_ARCH_X86_64 +#define WEBRTC_ARCH_64_BITS +#define WEBRTC_ARCH_LITTLE_ENDIAN +#define WEBRTC_LITTLE_ENDIAN +#elif defined(__aarch64__) +#define WEBRTC_ARCH_64_BITS +#define WEBRTC_ARCH_LITTLE_ENDIAN +#define WEBRTC_LITTLE_ENDIAN +#elif defined(_M_IX86) || defined(__i386__) +#if !defined(WEBRTC_ARCH_X86_FAMILY) + #define WEBRTC_ARCH_X86_FAMILY +#endif +#define WEBRTC_ARCH_X86 +#define WEBRTC_ARCH_32_BITS +#define WEBRTC_ARCH_LITTLE_ENDIAN +#define WEBRTC_LITTLE_ENDIAN +#elif defined(__ARMEL__) +// TODO(andrew): We'd prefer to control platform defines here, but this is +// currently provided by the Android makefiles. Commented to avoid duplicate +// definition warnings. +//#define WEBRTC_ARCH_ARM +// TODO(andrew): Chromium uses the following two defines. Should we switch? +//#define WEBRTC_ARCH_ARM_FAMILY +//#define WEBRTC_ARCH_ARMEL +#define WEBRTC_ARCH_32_BITS +#define WEBRTC_ARCH_LITTLE_ENDIAN +#define WEBRTC_LITTLE_ENDIAN +#elif defined(__MIPSEL__) +#define WEBRTC_ARCH_32_BITS +#define WEBRTC_ARCH_LITTLE_ENDIAN +#define WEBRTC_LITTLE_ENDIAN +#else +//#error Please add support for your architecture in typedefs.h +#endif + +#if !defined(WARN_UNUSED_RESULT) +#if defined(__GNUC__) +#define WARN_UNUSED_RESULT __attribute__((warn_unused_result)) +#else +#define WARN_UNUSED_RESULT +#endif +#endif // WARN_UNUSED_RESULT + +#if defined(WEBRTC_IOS) +#if defined(__arm__) || defined(__arm64__) +#define WEBRTC_ARCH_ARM_NEON +#endif +#endif + +#if defined(__SSE2__) || defined(_MSC_VER) +#define WEBRTC_USE_SSE2 +#endif + +#if !defined(_MSC_VER) +#include +#else +// Define C99 equivalent types, since MSVC doesn't provide stdint.h. +typedef signed char int8_t; +typedef signed short int16_t; +typedef signed int int32_t; +typedef __int64 int64_t; +typedef unsigned char uint8_t; +typedef unsigned short uint16_t; +typedef unsigned int uint32_t; +typedef unsigned __int64 uint64_t; +#endif + +// Borrowed from Chromium's base/compiler_specific.h. +// Annotate a virtual method indicating it must be overriding a virtual +// method in the parent class. +// Use like: +// virtual void foo() OVERRIDE; +#if defined(_MSC_VER) +#define OVERRIDE override +#elif defined(__clang__) +// Clang defaults to C++03 and warns about using override. Squelch that. +// Intentionally no push/pop here so all users of OVERRIDE ignore the warning +// too. This is like passing -Wno-c++11-extensions, except that GCC won't die +// (because it won't see this pragma). +#pragma clang diagnostic ignored "-Wc++11-extensions" +#define OVERRIDE override +#else +#define OVERRIDE +#endif + +#define LJB +#define AECMax(a,b) ( a > b ? a:b ) +#define IMPROVED + +// Annotate a function that will not return control flow to the caller. +#if defined(_MSC_VER) +#define NO_RETURN __declspec(noreturn) +#elif defined(__GNUC__) +#define NO_RETURN __attribute__((noreturn)) +#else +#define NO_RETURN +#endif + +#ifndef AGORAVOICE_DLLEXPORT2 +#define AGORAVOICE_DLLEXPORT2 +#endif + +// handle DEBUG variants +#if defined(_DEBUG) +#define DEBUG +#endif + +#if defined(DEBUG) +#define VIDEO_INTERNAL_DEBUG +//#define ENABLE_PROFILING +#undef NDEBUG +#endif + +//#define ENABLE_SIMULATE_ERROR +#define ENABLE_PROFILING +// check profiling allowed or not +int isProfilingAllowed(); + +#endif // WEBRTC_TYPEDEFS_H_ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java new file mode 100644 index 0000000..a04de3a --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java @@ -0,0 +1,58 @@ +package io.agora; + +import android.util.Log; + +import io.agora.rtc.mediaio.IVideoFrameConsumer; +import io.agora.rtc.mediaio.IVideoSource; +import io.agora.rtc.mediaio.MediaIO; +import io.agora.rtc.video.AgoraVideoFrame; + +/** + * Created by lixiaochen on 2019/12/26. + */ + +public class MediaVideoSource implements IVideoSource { + private final static String TAG = "RtcChannelPublishHelper"; + private IVideoFrameConsumer mVideoFrameConsumer = null; + private boolean isEnablePushToRtc = false; + + @Override + public boolean onInitialize(IVideoFrameConsumer videoFrameConsumer) { + Log.i(TAG,"MediaVideoSource onInitialize"); + this.mVideoFrameConsumer = videoFrameConsumer; + isEnablePushToRtc = true; + return true; + } + + @Override + public boolean onStart() { + Log.i(TAG,"MediaVideoSource onStart"); + isEnablePushToRtc = true; + return true; + } + + @Override + public void onStop() { + isEnablePushToRtc = false; + Log.i(TAG,"MediaVideoSource onStop"); + } + + @Override + public void onDispose() { + isEnablePushToRtc = false; + Log.i(TAG,"MediaVideoSource onDispose"); + } + + public boolean isEnablePushToRtc() { + return isEnablePushToRtc; + } + + @Override + public int getBufferType() { + return MediaIO.BufferType.BYTE_ARRAY.intValue(); + } + + public IVideoFrameConsumer getFrameConsumer () { + return this.mVideoFrameConsumer; + } +} diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java new file mode 100644 index 0000000..895019e --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java @@ -0,0 +1,307 @@ +package io.agora; + + +import android.util.Log; + +import java.io.IOException; +import java.nio.ByteBuffer; +import java.util.Locale; + +import io.agora.mediaplayer.AgoraMediaPlayerKit; +import io.agora.mediaplayer.AudioFrameObserver; +import io.agora.mediaplayer.VideoFrameObserver; +import io.agora.mediaplayer.data.AudioFrame; +import io.agora.mediaplayer.data.VideoFrame; +import io.agora.mediaplayer.utils.ToolUtil; +import io.agora.rtc.IRtcEngineEventHandler; +import io.agora.rtc.RtcEngine; +import io.agora.rtc.internal.RtcEngineImpl; +import io.agora.rtc.mediaio.AgoraDefaultSource; +import io.agora.rtc.mediaio.MediaIO; +import io.agora.utils.LogUtil; + +/** + * Created by lixiaochen on 2019/12/25. + */ + +public class RtcChannelPublishHelper extends IRtcEngineEventHandler implements AudioFrameObserver, VideoFrameObserver { + private final static String TAG = "RtcChannelPublishHelper"; + private volatile static RtcChannelPublishHelper rtcChannelPublishHelper = null; + private RtcEngine mRtcEngine; + //FIXME + public boolean enablePushVideoToRtc = false; + public boolean enablePushAudioToRtc = false; + private AgoraMediaPlayerKit agoraMediaPlayerKit = null; + private MediaVideoSource mediaVideoSource; + private final static int MAX_VOLUME = 400; + private final static int ERROR_CODE = -1; + private int rotation = 0; + private RtcChannelPublishHelper() { + + } + + static { + Log.i(TAG, "TJY apm-plugin-agora-rtc-player"); + System.loadLibrary("apm-plugin-agora-rtc-player"); + } + + public static RtcChannelPublishHelper getInstance() { + if (rtcChannelPublishHelper == null) { + synchronized (RtcChannelPublishHelper.class) { + rtcChannelPublishHelper = new RtcChannelPublishHelper(); + Log.i(TAG, "getInstance"); + } + } + return rtcChannelPublishHelper; + } + + public int attachPlayerToRtc(AgoraMediaPlayerKit agoraMediaPlayerKit, RtcEngine rtcEngine) { + this.mRtcEngine = rtcEngine; + this.agoraMediaPlayerKit = agoraMediaPlayerKit; + + // for debug +// while (mediaVideoSource.isDetatchFormRtc()) { +// try { +// Log.i(TAG,"wait to attach"); +// Thread.sleep(20); +// } catch (Exception e) { +// LogUtil.e(e.toString()); +// } +// } + enablePushVideoToRtc = false; + enablePushAudioToRtc = false; + nativeEnablePushAudioToRtc(false); + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + nativeEnablePushToRtc(); + Log.i(TAG, "attachPlayerToRtc"); + return 0; + } + + public int publishVideo() { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + if (mediaVideoSource == null) { + mediaVideoSource = new MediaVideoSource(); + mRtcEngine.setVideoSource(mediaVideoSource); + } + enablePushVideoToRtc = true; + this.agoraMediaPlayerKit.registerVideoFrameObserver(this); + Log.i(TAG, "publishVideo"); + return 0; + } + + public int unpublishVideo() { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + enablePushVideoToRtc = false; + mediaVideoSource = null; + this.agoraMediaPlayerKit.unregisterVideoFrameObserver(this); + Log.i(TAG, "unpublishVideo"); + return 0; + } + + public int publishAudio() { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + enablePushAudioToRtc = true; + nativeEnablePushAudioToRtc(true); + this.agoraMediaPlayerKit.registerAudioFrameObserver(this); + Log.i(TAG, "publishAudio"); + return 0; + } + + public int unpublishAudio() { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + enablePushAudioToRtc = false; + nativeEnablePushAudioToRtc(false); + this.agoraMediaPlayerKit.unregisterAudioFrameObserver(this); + Log.i(TAG, "unpublishAudio"); + return 0; + } + + private int adjustPublishSignalVolume(int volume) { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + float volumeFloat = (float) (volume) / (float) (MAX_VOLUME); + if (volumeFloat > 1) { + volumeFloat = 1; + } + adjustPublishSignalVolume(volumeFloat); + return 0; + } + + private int adjustPublishVoiceVolume(int volume) { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + float volumeFloat = (float) (volume) / (float) (MAX_VOLUME); + if (volumeFloat > 1) { + volumeFloat = 1; + } + adjustPublishVoiceVolume(volumeFloat); + return 0; + } + + public int adjustPublishSignalVolume(int microphoneVolume, int movieVolume) { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + adjustPublishSignalVolume(movieVolume); + adjustPublishVoiceVolume(microphoneVolume); + Log.i(TAG, "adjustPublishSignalVolume:" + microphoneVolume + "movieVolume:" + movieVolume); + return 0; + } + + public void setRotation(int rotation) { + this.rotation = rotation; + } + + public int detachPlayerFromRtc() { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + //mRtcEngine.setVideoSource(new AgoraDefaultSource()); + //adjustPublishSignalVolume(400,0); + this.agoraMediaPlayerKit.unregisterAudioFrameObserver(this); + this.agoraMediaPlayerKit.unregisterVideoFrameObserver(this); + enablePushVideoToRtc = false; + enablePushAudioToRtc = false; + this.rotation = 0; + nativeEnablePushAudioToRtc(false); + nativeEnableLocalPlayoutVolume(false); + mediaVideoSource = null; + nativeRelease(); + Log.i(TAG, "detachPlayerFromRtc"); + return 0; + } + + public void release() { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return; + } + + this.agoraMediaPlayerKit.unregisterAudioFrameObserver(this); + this.agoraMediaPlayerKit.unregisterVideoFrameObserver(this); + enablePushVideoToRtc = false; + enablePushAudioToRtc = false; + nativeEnablePushAudioToRtc(false); + nativeEnableLocalPlayoutVolume(false); + // mRtcEngine.setVideoSource(new AgoraDefaultSource()); + adjustPublishSignalVolume(400, 0); + mediaVideoSource = null; + this.rotation = 0; + this.agoraMediaPlayerKit = null; + this.mRtcEngine = null; + nativeRelease(); + Log.i(TAG, "release"); + } + + private void onVideoData(ByteBuffer videoBuffer, byte[] bytes, int format, int stride, int height, int width, int rotation, long timestamp) { + if (mediaVideoSource == null) { + mediaVideoSource = new MediaVideoSource(); + mRtcEngine.setVideoSource(mediaVideoSource); + } + if (enablePushVideoToRtc && mediaVideoSource != null) { + if (mediaVideoSource.getFrameConsumer() != null && mediaVideoSource.isEnablePushToRtc()) { + mediaVideoSource.getFrameConsumer().consumeByteArrayFrame(bytes, MediaIO.PixelFormat.I420.intValue(), stride, height, this.rotation, System.currentTimeMillis()); + } + } + } + + private void onAudioData(ByteBuffer audioBuffer, byte[] bytes, int sampleRataHz, int bytesPerSample, int channelNums, int samplesPerChannel, long timestamp) { + if (enablePushAudioToRtc) { + nativeOnAudioData(audioBuffer, sampleRataHz, bytesPerSample, channelNums, samplesPerChannel, timestamp); + } + } + + public void enableLocalPlayoutVolume(boolean enable) { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return; + } + this.agoraMediaPlayerKit.mute(enable); + if (enable) { + this.agoraMediaPlayerKit.registerAudioFrameObserver(this); + mRtcEngine.setParameters("{\"che.audio.enable.aec\":true}"); + } else { + this.agoraMediaPlayerKit.unregisterAudioFrameObserver(this); + mRtcEngine.setParameters("{\"che.audio.enable.aec\":false}"); + } + nativeEnableLocalPlayoutVolume(enable); + } + + private int adjustPublishLocalVoiceVolume(int volume) { + if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { + return ERROR_CODE; + } + float volumeFloat = (float) (volume) / (float) (MAX_VOLUME); + if (volumeFloat > 1) { + volumeFloat = 1; + } + nativeAdjustPublishLocalVoiceVolume(volumeFloat); + return 0; + } + + @Override + public void onFrame(AudioFrame audioFrame) { +// try { +// ToolUtil.saveDataToFile("/sdcard/test_java.pcm",audioFrame.bytes); +// } catch (IOException e) { +// e.printStackTrace(); +// } + this.onAudioData(audioFrame.buffer, audioFrame.bytes, audioFrame.sampleRataHz, audioFrame.bytesPerSample, audioFrame.channelNums, audioFrame.samplesPerChannel, audioFrame.timestamp); + } + + @Override + public void onFrame(VideoFrame videoFrame) { + this.onVideoData(videoFrame.buffer, videoFrame.bytes, videoFrame.format, videoFrame.stride, videoFrame.height, videoFrame.width, videoFrame.rotation, System.currentTimeMillis()); + } + + + private native int nativeOnAudioData(ByteBuffer audioBuffer, int sampleRataHz, int bytesPerSample, int channelNums, int samplesPerChannel, long timestamp); + + private native int nativeEnablePushToRtc(); + + private native int nativeEnablePushAudioToRtc(boolean enable); + + private native int nativeRelease(); + + private native int adjustPublishSignalVolume(float volume); + + private native int nativeAdjustPublishLocalVoiceVolume(float volume); + + private native int nativeEnableLocalPlayoutVolume(boolean enable); + + private native int adjustPublishVoiceVolume(float volume); + + public void onJoinChannelSuccess(String channel, int uid, int elapsed) { + if (!enablePushVideoToRtc) { + enablePushVideoToRtc = true; + } + if (!enablePushAudioToRtc) { + enablePushAudioToRtc = true; + } + } + + public void onRejoinChannelSuccess(String channel, int uid, int elapsed) { + if (!enablePushVideoToRtc) { + enablePushVideoToRtc = true; + } + if (!enablePushAudioToRtc) { + enablePushAudioToRtc = true; + } + } + + public void onLeaveChannel(IRtcEngineEventHandler.RtcStats stats) { + enablePushVideoToRtc = false; + enablePushAudioToRtc = false; + } + +} diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/utils/LogUtil.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/utils/LogUtil.java new file mode 100644 index 0000000..daf571e --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/utils/LogUtil.java @@ -0,0 +1,110 @@ +package io.agora.utils; + +/** + * Created by yong on 2019/9/4. + */ + + +import android.util.Log; + +public class LogUtil { + + public static boolean OPEN_LOG = true; + + public static boolean DEBUG = false; + + private static String tag = "[player_java]"; + private String mClassName; + private static LogUtil log; + private static final String USER_NAME = "agora"; + + private LogUtil(String name) { + mClassName = name; + } + + /** + * Get The Current Function Name + * + * @return Name + */ + private String getFunctionName() { + StackTraceElement[] sts = Thread.currentThread().getStackTrace(); + if (sts == null) { + return null; + } + for (StackTraceElement st : sts) { + if (st.isNativeMethod()) { + continue; + } + if (st.getClassName().equals(Thread.class.getName())) { + continue; + } + if (st.getClassName().equals(this.getClass().getName())) { + continue; + } + return mClassName + "[ " + Thread.currentThread().getName() + ": " + + st.getFileName() + ":" + st.getLineNumber() + " " + + st.getMethodName() + " ]"; + } + return null; + } + + public static void i(Object str) { + print(Log.INFO, str); + } + + public static void d(Object str) { + print(Log.DEBUG, str); + } + + public static void v(Object str) { + print(Log.VERBOSE, str); + } + + public static void w(Object str) { + print(Log.WARN, str); + } + + public static void e(Object str) { + print(Log.ERROR, str); + } + + + private static void print(int index, Object str) { + if (!OPEN_LOG) { + return; + } + if (log == null) { + log = new LogUtil(USER_NAME); + } + // Close the debug log When DEBUG is false + if (!DEBUG) { + if (index <= Log.DEBUG) { + return; + } + } + String name = log.getFunctionName(); + if (name != null) { + str = name + " - " + str; + } + switch (index) { + case Log.VERBOSE: + Log.v(tag, str.toString()); + break; + case Log.DEBUG: + Log.d(tag, str.toString()); + break; + case Log.INFO: + Log.i(tag, str.toString()); + break; + case Log.WARN: + Log.w(tag, str.toString()); + break; + case Log.ERROR: + Log.e(tag, str.toString()); + break; + default: + break; + } + } +} diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/drawable-hdpi/ic_launcher.png b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/drawable-hdpi/ic_launcher.png new file mode 100644 index 0000000000000000000000000000000000000000..96a442e5b8e9394ccf50bab9988cb2316026245d GIT binary patch literal 9397 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 + + + 16dp + 16dp + + diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/strings.xml b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/strings.xml new file mode 100644 index 0000000..96d0e83 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/strings.xml @@ -0,0 +1,7 @@ + + + + agoraMediaPlayer + Settings + + diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/styles.xml b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/styles.xml new file mode 100644 index 0000000..6ce89c7 --- /dev/null +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/res/values/styles.xml @@ -0,0 +1,20 @@ + + + + + + + + + diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle index 38b00c3..2300317 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle @@ -32,7 +32,7 @@ android { externalNativeBuild { cmake { - path "CMakeLists.txt" + // path "CMakeLists.txt" } } @@ -46,8 +46,10 @@ android { dependencies { implementation fileTree(include: ['*.jar'], dir: 'libs') - implementation(name: 'RtcChannelPublishHelper', ext: 'aar') + // implementation(name: 'RtcChannelPublishHelper', ext: 'aar') + api project(':RtcChannelPublishHelper') implementation 'io.agora.rtc:full-sdk:3.0.1' - implementation 'io.agora:agoraplayer:1.1.4.0' + implementation files('lib/AgoraMediaPlayer.jar') + // implementation 'io.agora:agoraplayer:1.2.1' implementation 'com.android.support:support-v4:26.0.0' } diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java index 3ecb2c5..732a051 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java @@ -182,6 +182,11 @@ public void run() { } }); } + + @Override + public void onPlayBufferUpdated(long l) { + + } }); agoraMediaPlayerKit1.registerVideoFrameObserver(new VideoFrameObserver() { @@ -251,6 +256,11 @@ public void run() { } }); } + + @Override + public void onPlayBufferUpdated(long l) { + + } }); agoraMediaPlayerKit2.registerVideoFrameObserver(new VideoFrameObserver() { diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml index 0a3e0fe..75aa05f 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml @@ -6,5 +6,5 @@ - <#YOUR APP ID#> + aab8b8f5a8cd4469a63042fcfafe7063 diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/settings.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/settings.gradle index 9d495b3..d4d2546 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/settings.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/settings.gradle @@ -1 +1,2 @@ -include ':app' \ No newline at end of file +include ':app' +include ':RtcChannelPublishHelper' \ No newline at end of file From 92e5b021ee19bfa497f0c8399cb38bc50e7ad038 Mon Sep 17 00:00:00 2001 From: TongJiangyong <1246376353@qq.com> Date: Mon, 11 Jan 2021 14:33:03 +0800 Subject: [PATCH 2/7] add android 3.2.0 support --- .../RtcChannelPublishHelper/build.gradle | 7 +- .../src/main/cpp/include/AgoraBase.h | 265 +- .../src/main/cpp/include/IAgoraMediaEngine.h | 727 ++- .../src/main/cpp/include/IAgoraRtcChannel.h | 732 ++- .../src/main/cpp/include/IAgoraRtcEngine.h | 3966 ++++++++++++----- .../src/main/cpp/include/IAgoraService.h | 7 +- .../main/java/io/agora/MediaVideoSource.java | 10 + .../AgoraPlayer_Quickstart/app/build.gradle | 13 +- .../app/lib/RtcChannelPublishHelper.aar | Bin 0 -> 186216 bytes .../io/agora/mediaplayer/PlayerFragment.java | 14 +- .../src/main/jniLibs/armeabi-v7a/PLACEHOLDER | 1 - .../app/src/main/res/values/strings.xml | 2 +- .../AgoraPlayer_Quickstart/build.gradle | 9 +- 13 files changed, 4248 insertions(+), 1505 deletions(-) mode change 100755 => 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h mode change 100755 => 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h mode change 100755 => 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h create mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar delete mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/jniLibs/armeabi-v7a/PLACEHOLDER diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle index 59864e6..eb57206 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle @@ -48,14 +48,15 @@ android { } dependencies { - provided files('../app/lib/AgoraMediaPlayer.jar') - // implementation 'io.agora:agoraplayer:1.2.1' + //provided files('../app/lib/AgoraMediaPlayer.jar') + //provided files('../app/lib/agora-rtc-sdk.jar') + implementation 'io.agora:agoraplayer:1.2.2' //api fileTree(include: ['*.jar'], dir: 'libs') //api project(':proj.android') //dependencies { compile fileTree(dir:'../../../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} //provided files('../../../../build/android/arm/android/lib/agora-rtc-sdk/agora-rtc-sdk.jar') compile 'com.android.support:support-v4:23.2.0' - implementation 'io.agora.rtc:full-sdk:3.0.0' + implementation 'io.agora.rtc:full-sdk:3.2.0' //dependencies { compile fileTree(dir:'../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} //implementation 'net.butterflytv.utils:rtmp-client:0.2.6' //implementation 'net.butterflytv.utils:rtmp-client:3.1.0' diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h index 955d13d..ecb0c5a 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h @@ -18,18 +18,23 @@ #define AGORA_CALL __cdecl #if defined(AGORARTC_EXPORT) #define AGORA_API extern "C" __declspec(dllexport) +#define AGORA_CPP_API __declspec(dllexport) #else #define AGORA_API extern "C" __declspec(dllimport) +#define AGORA_CPP_API __declspec(dllimport) #endif #elif defined(__APPLE__) #include #define AGORA_API __attribute__((visibility("default"))) extern "C" +#define AGORA_CPP_API __attribute__((visibility("default"))) #define AGORA_CALL #elif defined(__ANDROID__) || defined(__linux__) #define AGORA_API extern "C" __attribute__((visibility("default"))) +#define AGORA_CPP_API __attribute__((visibility("default"))) #define AGORA_CALL #else #define AGORA_API extern "C" +#define AGORA_CPP_API #define AGORA_CALL #endif @@ -130,7 +135,7 @@ enum WARN_CODE_TYPE */ WARN_LOOKUP_CHANNEL_TIMEOUT = 104, /** **DEPRECATED** 105: The server rejects the request to look up the channel. The server cannot process this request or the request is illegal. - + Deprecated as of v2.4.1. Use CONNECTION_CHANGED_REJECTED_BY_SERVER(10) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ WARN_LOOKUP_CHANNEL_REJECTED = 105, @@ -145,7 +150,7 @@ enum WARN_CODE_TYPE /** 111: A timeout occurs when switching to the live video. */ WARN_SWITCH_LIVE_VIDEO_TIMEOUT = 111, - /** 118: A timeout occurs when setting the client role in the live broadcast profile. + /** 118: A timeout occurs when setting the client role in the live interactive streaming profile. */ WARN_SET_CLIENT_ROLE_TIMEOUT = 118, /** 121: The ticket to open the channel is invalid. @@ -154,88 +159,103 @@ enum WARN_CODE_TYPE /** 122: Try connecting to another server. */ WARN_OPEN_CHANNEL_TRY_NEXT_VOS = 122, + /** 131: The channel connection cannot be recovered. + */ WARN_CHANNEL_CONNECTION_UNRECOVERABLE = 131, + /** 132: The IP address has changed. + */ WARN_CHANNEL_CONNECTION_IP_CHANGED = 132, + /** 133: The port has changed. + */ WARN_CHANNEL_CONNECTION_PORT_CHANGED = 133, + /** 134: The socket error occurs, try to rejoin channel. + */ + WARN_CHANNEL_SOCKET_ERROR = 134, /** 701: An error occurs in opening the audio mixing file. */ WARN_AUDIO_MIXING_OPEN_ERROR = 701, - /** 1014: Audio Device Module: a warning occurs in the playback device. + /** 1014: Audio Device Module: A warning occurs in the playback device. */ WARN_ADM_RUNTIME_PLAYOUT_WARNING = 1014, /** 1016: Audio Device Module: a warning occurs in the recording device. */ WARN_ADM_RUNTIME_RECORDING_WARNING = 1016, - /** 1019: Audio Device Module: no valid audio data is collected. + /** 1019: Audio Device Module: no valid audio data is recorded. */ WARN_ADM_RECORD_AUDIO_SILENCE = 1019, - /** 1020: Audio Device Module: the playback device fails. + /** 1020: Audio device module: The audio playback frequency is abnormal, which may cause audio freezes. This abnormality is caused by high CPU usage. Agora recommends stopping other apps. */ WARN_ADM_PLAYOUT_MALFUNCTION = 1020, - /** 1021: Audio Device Module: the recording device fails. + /** 1021: Audio device module: the audio recording frequency is abnormal, which may cause audio freezes. This abnormality is caused by high CPU usage. Agora recommends stopping other apps. */ WARN_ADM_RECORD_MALFUNCTION = 1021, /** 1025: The audio playback or recording is interrupted by system events (such as a phone call). */ WARN_ADM_CALL_INTERRUPTION = 1025, - /** 1029: During a call, the audio session category should be set to - * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. - * If the audio session category is set to other values, this warning code - * is triggered and RtcEngine will forcefully set it back to + /** 1029: During a call, the audio session category should be set to + * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. + * If the audio session category is set to other values, this warning code + * is triggered and RtcEngine will forcefully set it back to * AVAudioSessionCategoryPlayAndRecord. */ WARN_ADM_IOS_CATEGORY_NOT_PLAYANDRECORD = 1029, - /** - */ - WARN_ADM_IOS_SAMPLERATE_CHANGE = 1030, - /** 1031: Audio Device Module: the recorded audio voice is too low. + /** 1031: Audio Device Module: The recorded audio voice is too low. */ WARN_ADM_RECORD_AUDIO_LOWLEVEL = 1031, - /** 1032: Audio Device Module: the playback audio voice is too low. + /** 1032: Audio Device Module: The playback audio voice is too low. */ WARN_ADM_PLAYOUT_AUDIO_LOWLEVEL = 1032, - /** 1040: Audio device module: An exception occurs with the audio drive. - * Solutions: + /** 1033: Audio device module: The audio recording device is occupied. + */ + WARN_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, + /** 1040: Audio device module: An exception occurs with the audio drive. + * Solutions: * - Disable or re-enable the audio device. * - Re-enable your device. * - Update the sound card drive. */ WARN_ADM_WINDOWS_NO_DATA_READY_EVENT = 1040, - /** 1051: Audio Device Module: howling is detected. + /** 1042: Audio device module: The audio recording device is different from the audio playback device, + * which may cause echoes problem. Agora recommends using the same audio device to record and playback + * audio. + */ + WARN_ADM_INCONSISTENT_AUDIO_DEVICE = 1042, + /** 1051: (Communication profile only) Audio processing module: A howling sound is detected when recording the audio data. */ WARN_APM_HOWLING = 1051, - /** 1052: Audio Device Module: the device is in the glitch state. + /** 1052: Audio Device Module: The device is in the glitch state. */ WARN_ADM_GLITCH_STATE = 1052, - /** 1053: Audio Device Module: the underlying audio settings have changed. + /** 1053: Audio Processing Module: A residual echo is detected, which may be caused by the belated scheduling of system threads or the signal overflow. */ - WARN_ADM_IMPROPER_SETTINGS = 1053, - /** - */ + WARN_APM_RESIDUAL_ECHO = 1053, + /// @cond WARN_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, - /** 1323: Audio device module: No available playback device. + /// @endcond + /** 1323: Audio device module: No available playback device. * Solution: Plug in the audio device. */ WARN_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, - /** Audio device module: The capture device is released improperly. - * Solutions: + /** Audio device module: The capture device is released improperly. + * Solutions: * - Disable or re-enable the audio device. * - Re-enable your device. * - Update the sound card drive. */ WARN_ADM_WIN_CORE_IMPROPER_CAPTURE_RELEASE = 1324, - /** 1610: Super-resolution warning: the original video dimensions of the remote user exceed 640 × 480. + /** 1610: The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. */ WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION = 1610, - /** 1611: Super-resolution warning: another user is using super resolution. + /** 1611: Another user is already using the super-resolution algorithm. */ WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION = 1611, - /** 1612: The device is not supported. + /** 1612: The device does not support the super-resolution algorithm. */ WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED = 1612, - + /// @cond WARN_RTM_LOGIN_TIMEOUT = 2005, WARN_RTM_KEEP_ALIVE_TIMEOUT = 2009 + /// @endcond }; /** Error code. @@ -292,7 +312,15 @@ enum ERROR_CODE_TYPE /** 15: No network buffers are available. This is for internal SDK internal use only, and it does not return to the application through any method or callback. */ ERR_NET_NOBUFS = 15, - /** 17: The request to join the channel is rejected. This error usually occurs when the user is already in the channel, and still calls the method to join the channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + /** 17: The request to join the channel is rejected. + * + * - This error usually occurs when the user is already in the channel, and still calls the method to join the + * channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + * - This error usually occurs when the user tries to join a channel + * during \ref agora::rtc::IRtcEngine::startEchoTest "startEchoTest". Once you + * call \ref agora::rtc::IRtcEngine::startEchoTest "startEchoTest", you need to + * call \ref agora::rtc::IRtcEngine::stopEchoTest "stopEchoTest" before joining a channel. + * - The user tries to join the channel with a token that is expired. */ ERR_JOIN_CHANNEL_REJECTED = 17, /** 18: The request to leave the channel is rejected. @@ -321,18 +349,21 @@ enum ERROR_CODE_TYPE /** 102: The specified channel name is invalid. Please try to rejoin the channel with a valid channel name. */ ERR_INVALID_CHANNEL_NAME = 102, + /** 103: Fails to get server resources in the specified region. Please try to specify another region when calling \ref agora::rtc::IRtcEngine::initialize "initialize". + */ + ERR_NO_SERVER_RESOURCES = 103, /** **DEPRECATED** 109: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. - + The token expired due to one of the following reasons: - - - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within five minutes after the Token is generated. If the user does not access the Agora service after five minutes, this Token is no longer valid. + + - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within 24 hours after the Token is generated. If the user does not access the Agora service after 24 hours, this Token is no longer valid. - Call Expiration Timestamp expired: The timestamp is the exact time when a user can no longer use the Agora service (for example, when a user is forced to leave an ongoing call). When a value is set for the Call Expiration Timestamp, it does not mean that the token will expire, but that the user will be banned from the channel. */ ERR_TOKEN_EXPIRED = 109, /** **DEPRECATED** 110: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_INVALID_TOKEN(8) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. - + The token is invalid due to one of the following reasons: - + - The App Certificate for the project is enabled in Console, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token. - The uid is mandatory, and users must set the same uid as the one set in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. */ @@ -343,7 +374,7 @@ enum ERROR_CODE_TYPE /** 112: The internet connection is lost. This applies to the Agora Web SDK only. */ ERR_CONNECTION_LOST = 112, // only used in web sdk - /** 113: The user is not in the channel when calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" or \ref agora::rtc::IRtcEngine::getUserInfoByUserAccount "getUserInfoByUserAccount" method. + /** 113: The user is not in the channel when calling the method. */ ERR_NOT_IN_CHANNEL = 113, /** 114: The size of the sent data is over 1024 bytes when the user calls the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. @@ -364,7 +395,7 @@ enum ERROR_CODE_TYPE /** 120: Decryption fails. The user may have used a different encryption password to join the channel. Check your settings or try rejoining the channel. */ ERR_DECRYPTION_FAILED = 120, - /** 123: The client is banned by the server. + /** 123: The user is banned by the server. This error occurs when the user is kicked off the channel from the server. */ ERR_CLIENT_IS_BANNED_BY_SERVER = 123, /** 124: Incorrect watermark file parameter. @@ -411,104 +442,38 @@ enum ERROR_CODE_TYPE ERR_PUBLISH_STREAM_FORMAT_NOT_SUPPORTED = 156, //signaling: 400~600 - /** - */ ERR_LOGOUT_OTHER = 400, // - /** 401: The user logged out. - */ ERR_LOGOUT_USER = 401, // logout by user - /** 402: Network failure. - */ ERR_LOGOUT_NET = 402, // network failure - /** 403: Logged in another device. - */ ERR_LOGOUT_KICKED = 403, // login in other device - /** - */ ERR_LOGOUT_PACKET = 404, // - /** 405: The token expired. - */ ERR_LOGOUT_TOKEN_EXPIRED = 405, // token expired - /** - */ ERR_LOGOUT_OLDVERSION = 406, // - /** - */ ERR_LOGOUT_TOKEN_WRONG = 407, - /** - */ ERR_LOGOUT_ALREADY_LOGOUT = 408, - /** - */ ERR_LOGIN_OTHER = 420, - /** - */ ERR_LOGIN_NET = 421, - /** - */ ERR_LOGIN_FAILED = 422, - /** - */ ERR_LOGIN_CANCELED = 423, - /** - */ ERR_LOGIN_TOKEN_EXPIRED = 424, - /** - */ ERR_LOGIN_OLD_VERSION = 425, - /** - */ ERR_LOGIN_TOKEN_WRONG = 426, - /** - */ ERR_LOGIN_TOKEN_KICKED = 427, - /** - */ ERR_LOGIN_ALREADY_LOGIN = 428, - /** - */ ERR_JOIN_CHANNEL_OTHER = 440, - /** - */ ERR_SEND_MESSAGE_OTHER = 440, - /** - */ ERR_SEND_MESSAGE_TIMEOUT = 441, - /** - */ ERR_QUERY_USERNUM_OTHER = 450, - /** - */ ERR_QUERY_USERNUM_TIMEOUT = 451, - /** - */ ERR_QUERY_USERNUM_BYUSER = 452, - /** - */ ERR_LEAVE_CHANNEL_OTHER = 460, - /** - */ ERR_LEAVE_CHANNEL_KICKED = 461, - /** - */ ERR_LEAVE_CHANNEL_BYUSER = 462, - /** - */ ERR_LEAVE_CHANNEL_LOGOUT = 463, - /** - */ ERR_LEAVE_CHANNEL_DISCONNECTED = 464, - /** - */ ERR_INVITE_OTHER = 470, - /** - */ ERR_INVITE_REINVITE = 471, - /** - */ ERR_INVITE_NET = 472, - /** - */ ERR_INVITE_PEER_OFFLINE = 473, ERR_INVITE_TIMEOUT = 474, ERR_INVITE_CANT_RECV = 475, @@ -522,7 +487,7 @@ enum ERROR_CODE_TYPE */ ERR_START_CALL = 1002, /** **DEPRECATED** 1003: Fails to start the camera. - + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ ERR_START_CAMERA = 1003, @@ -565,11 +530,11 @@ enum ERROR_CODE_TYPE /** 1018: Audio Device Module: Fails to record. */ ERR_ADM_RECORD_AUDIO_FAILED = 1018, - /** 1022: Audio Device Module: An error occurs in initializing the + /** 1022: Audio Device Module: An error occurs in initializing the * loopback device. */ ERR_ADM_INIT_LOOPBACK = 1022, - /** 1023: Audio Device Module: An error occurs in starting the loopback + /** 1023: Audio Device Module: An error occurs in starting the loopback * device. */ ERR_ADM_START_LOOPBACK = 1023, @@ -577,37 +542,37 @@ enum ERROR_CODE_TYPE * recording permission is granted. */ ERR_ADM_NO_PERMISSION = 1027, - /** 1033: Audio device module: The device is occupied. + /** 1033: Audio device module: The device is occupied. */ ERR_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, /** 1101: Audio device module: A fatal exception occurs. */ ERR_ADM_ANDROID_JNI_JAVA_RESOURCE = 1101, - /** 1108: Audio device module: The recording frequency is lower than 50. - * 0 indicates that the recording is not yet started. We recommend + /** 1108: Audio device module: The recording frequency is lower than 50. + * 0 indicates that the recording is not yet started. We recommend * checking your recording permission. */ ERR_ADM_ANDROID_JNI_NO_RECORD_FREQUENCY = 1108, - /** 1109: The playback frequency is lower than 50. 0 indicates that the - * playback is not yet started. We recommend checking if you have created - * too many AudioTrack instances. + /** 1109: The playback frequency is lower than 50. 0 indicates that the + * playback is not yet started. We recommend checking if you have created + * too many AudioTrack instances. */ ERR_ADM_ANDROID_JNI_NO_PLAYBACK_FREQUENCY = 1109, - /** 1111: Audio device module: AudioRecord fails to start up. A ROM system - * error occurs. We recommend the following options to debug: + /** 1111: Audio device module: AudioRecord fails to start up. A ROM system + * error occurs. We recommend the following options to debug: * - Restart your App. - * - Restart your cellphone. + * - Restart your cellphone. * - Check your recording permission. */ ERR_ADM_ANDROID_JNI_JAVA_START_RECORD = 1111, - /** 1112: Audio device module: AudioTrack fails to start up. A ROM system - * error occurs. We recommend the following options to debug: + /** 1112: Audio device module: AudioTrack fails to start up. A ROM system + * error occurs. We recommend the following options to debug: * - Restart your App. - * - Restart your cellphone. + * - Restart your cellphone. * - Check your playback permission. */ ERR_ADM_ANDROID_JNI_JAVA_START_PLAYBACK = 1112, - /** 1115: Audio device module: AudioRecord returns error. The SDK will + /** 1115: Audio device module: AudioRecord returns error. The SDK will * automatically restart AudioRecord. */ ERR_ADM_ANDROID_JNI_JAVA_RECORD_ERROR = 1115, /** **DEPRECATED** */ @@ -620,107 +585,109 @@ enum ERROR_CODE_TYPE ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_PLAYER = 1157, /** **DEPRECATED** */ ERR_ADM_ANDROID_OPENSL_START_PLAYER_THREAD = 1160, - /** 1201: Audio device module: The current device does not support audio + /** 1201: Audio device module: The current device does not support audio * input, possibly because you have mistakenly configured the audio session - * category, or because some other app is occupying the input device. We + * category, or because some other app is occupying the input device. We * recommend terminating all background apps and re-joining the channel. */ ERR_ADM_IOS_INPUT_NOT_AVAILABLE = 1201, /** 1206: Audio device module: Cannot activate the Audio Session.*/ ERR_ADM_IOS_ACTIVATE_SESSION_FAIL = 1206, - /** 1210: Audio device module: Fails to initialize the audio device, + /** 1210: Audio device module: Fails to initialize the audio device, * normally because the audio device parameters are wrongly set.*/ ERR_ADM_IOS_VPIO_INIT_FAIL = 1210, - /** 1213: Audio device module: Fails to re-initialize the audio device, + /** 1213: Audio device module: Fails to re-initialize the audio device, * normally because the audio device parameters are wrongly set.*/ ERR_ADM_IOS_VPIO_REINIT_FAIL = 1213, - /** 1214: Fails to re-start up the Audio Unit, possibly because the audio + /** 1214: Fails to re-start up the Audio Unit, possibly because the audio * session category is not compatible with the settings of the Audio Unit. */ ERR_ADM_IOS_VPIO_RESTART_FAIL = 1214, + ERR_ADM_IOS_SET_RENDER_CALLBACK_FAIL = 1219, + /** **DEPRECATED** */ ERR_ADM_IOS_SESSION_SAMPLERATR_ZERO = 1221, - /** 1301: Audio device module: An audio driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1301: Audio device module: An audio driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system.*/ ERR_ADM_WIN_CORE_INIT = 1301, - /** 1303: Audio device module: A recording driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1303: Audio device module: A recording driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_INIT_RECORDING = 1303, - /** 1306: Audio device module: A playout driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1306: Audio device module: A playout driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_INIT_PLAYOUT = 1306, - /** 1307: Audio device module: No audio device is available. Solutions: + /** 1307: Audio device module: No audio device is available. Solutions: * Plug in a proper audio device. */ ERR_ADM_WIN_CORE_INIT_PLAYOUT_NULL = 1307, - /** 1309: Audio device module: An audio driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1309: Audio device module: An audio driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_START_RECORDING = 1309, - /** 1311: Audio device module: Insufficient system memory or poor device + /** 1311: Audio device module: Insufficient system memory or poor device * performance. Solutions: Reboot the system or replace the device. */ ERR_ADM_WIN_CORE_CREATE_REC_THREAD = 1311, - /** 1314: Audio device module: An audio driver abnormality occurs. + /** 1314: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver.*/ ERR_ADM_WIN_CORE_CAPTURE_NOT_STARTUP = 1314, - /** 1319: Audio device module: Insufficient system memory or poor device + /** 1319: Audio device module: Insufficient system memory or poor device * performance. Solutions: Reboot the system or replace the device. */ ERR_ADM_WIN_CORE_CREATE_RENDER_THREAD = 1319, - /** 1320: Audio device module: An audio driver abnormality occurs. + /** 1320: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Replace the device. */ ERR_ADM_WIN_CORE_RENDER_NOT_STARTUP = 1320, - /** 1322: Audio device module: No audio sampling device is available. + /** 1322: Audio device module: No audio sampling device is available. * Solutions: Plug in a proper recording device. */ ERR_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, - /** 1323: Audio device module: No audio playout device is available. + /** 1323: Audio device module: No audio playout device is available. * Solutions: Plug in a proper playback device.*/ ERR_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, - /** 1351: Audio device module: An audio driver abnormality or a + /** 1351: Audio device module: An audio driver abnormality or a * compatibility issue occurs. Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT = 1351, - /** 1353: Audio device module: An audio driver abnormality occurs. + /** 1353: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_RECORDING = 1353, - /** 1354: Audio device module: An audio driver abnormality occurs. + /** 1354: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_MICROPHONE = 1354, - /** 1355: Audio device module: An audio driver abnormality occurs. + /** 1355: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_PLAYOUT = 1355, - /** 1356: Audio device module: An audio driver abnormality occurs. + /** 1356: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_SPEAKER = 1356, - /** 1357: Audio device module: An audio driver abnormality occurs. + /** 1357: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_START_RECORDING = 1357, - /** 1358: Audio device module: An audio driver abnormality occurs. + /** 1358: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. @@ -740,7 +707,7 @@ enum ERROR_CODE_TYPE // VDM error code starts from 1500 /** **DEPRECATED** 1502: Video Device Module: The camera in use. - + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ ERR_VDM_WIN_DEVICE_IN_USE = 1502, @@ -779,7 +746,9 @@ enum LOG_FILTER_TYPE LOG_FILTER_ERROR = 0x000c, /** 0x0008: Outputs CRITICAL level log information. */ LOG_FILTER_CRITICAL = 0x0008, + /// @cond LOG_FILTER_MASK = 0x80f, + /// @endcond }; } // namespace agora diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h old mode 100755 new mode 100644 index 5b0b7a5..e44fb6c --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h @@ -1,80 +1,394 @@ #ifndef AGORA_MEDIA_ENGINE_H #define AGORA_MEDIA_ENGINE_H -#if defined _WIN32 || defined __CYGWIN__ -typedef __int64 int64_t; -typedef unsigned __int64 uint64_t; -#else #include -#endif - -namespace agora -{ -namespace media -{ +namespace agora { +namespace media { +/** **DEPRECATED** Type of audio device. + */ enum MEDIA_SOURCE_TYPE { - AUDIO_PLAYOUT_SOURCE = 0, - AUDIO_RECORDING_SOURCE = 1, + /** Audio playback device. + */ + AUDIO_PLAYOUT_SOURCE = 0, + /** Microphone. + */ + AUDIO_RECORDING_SOURCE = 1, }; -class IAudioFrameObserver -{ -public: +/** + * The IAudioFrameObserver class. + */ +class IAudioFrameObserver { + public: + /** The frame type. */ enum AUDIO_FRAME_TYPE { - FRAME_TYPE_PCM16 = 0, //PCM 16bit little endian + /** 0: PCM16. */ + FRAME_TYPE_PCM16 = 0, // PCM 16bit little endian }; + /** Definition of AudioFrame */ struct AudioFrame { + /** The type of the audio frame. See #AUDIO_FRAME_TYPE + */ AUDIO_FRAME_TYPE type; - int samples; //number of samples in this frame + /** The number of samples per channel in the audio frame. + */ + int samples; //number of samples for each channel in this frame + /**The number of bytes per audio sample, which is usually 16-bit (2-byte). + */ int bytesPerSample; //number of bytes per sample: 2 for PCM16 + /** The number of audio channels. + - 1: Mono + - 2: Stereo (the data is interleaved) + */ int channels; //number of channels (data are interleaved if stereo) + /** The sample rate. + */ int samplesPerSec; //sampling rate + /** The data buffer of the audio frame. When the audio frame uses a stereo channel, the data buffer is interleaved. + The size of the data buffer is as follows: `buffer` = `samples` × `channels` × `bytesPerSample`. + */ void* buffer; //data buffer + /** The timestamp (ms) of the external audio frame. You can use this parameter for the following purposes: + - Restore the order of the captured audio frame. + - Synchronize audio and video frames in video-related scenarios, including where external video sources are used. + */ int64_t renderTimeMs; + /** Reserved parameter. + */ int avsync_type; }; -public: + + public: + /** Retrieves the recorded audio frame. + + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame, and the recorded audio frame is sent out. + - false: Invalid buffer in AudioFrame, and the recorded audio frame is discarded. + */ virtual bool onRecordAudioFrame(AudioFrame& audioFrame) = 0; + /** Retrieves the audio playback frame for getting the audio. + + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame, and the audio playback frame is sent out. + - false: Invalid buffer in AudioFrame, and the audio playback frame is discarded. + */ virtual bool onPlaybackAudioFrame(AudioFrame& audioFrame) = 0; + /** Retrieves the mixed recorded and playback audio frame. + + + @note This callback only returns the single-channel data. + + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame and the mixed recorded and playback audio frame is sent out. + - false: Invalid buffer in AudioFrame and the mixed recorded and playback audio frame is discarded. + */ virtual bool onMixedAudioFrame(AudioFrame& audioFrame) = 0; - virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, AudioFrame& audioFrame) = 0; + /** Retrieves the audio frame of a specified user before mixing. + + The SDK triggers this callback if isMultipleChannelFrameWanted returns false. + + @param uid The user ID + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame, and the mixed recorded and playback audio frame is sent out. + - false: Invalid buffer in AudioFrame, and the mixed recorded and playback audio frame is discarded. + */ + virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, + AudioFrame& audioFrame) = 0; + /** Determines whether to receive audio data from multiple channels. + + @since v3.0.1 + + After you register the audio frame observer, the SDK triggers this callback every time it captures an audio frame. + + In the multi-channel scenario, if you want to get audio data from multiple channels, + set the return value of this callback as true. After that, the SDK triggers the + \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixingEx "onPlaybackAudioFrameBeforeMixingEx" callback to send you the before-mixing + audio data from various channels. You can also get the channel ID of each audio frame. + + @note + - Once you set the return value of this callback as true, the SDK triggers + only the \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixingEx "onPlaybackAudioFrameBeforeMixingEx" callback + to send the before-mixing audio frame. \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixing "onPlaybackAudioFrameBeforeMixing" is not triggered. + In the multi-channel scenario, Agora recommends setting the return value as true. + - If you set the return value of this callback as false, the SDK triggers only the `onPlaybackAudioFrameBeforeMixing` callback to send the audio data. + @return + - `true`: Receive audio data from multiple channels. + - `false`: Do not receive audio data from multiple channels. + */ + virtual bool isMultipleChannelFrameWanted() { return false; } + + /** Gets the before-mixing playback audio frame from multiple channels. + + After you successfully register the audio frame observer, if you set the return + value of \ref IAudioFrameObserver::isMultipleChannelFrameWanted "isMultipleChannelFrameWanted" as true, the SDK triggers this callback each + time it receives a before-mixing audio frame from any of the channel. + + @param channelId The channel ID of this audio frame. + @param uid The ID of the user sending this audio frame. + @param audioFrame The pointer to AudioFrame. + @return + - `true`: The data in AudioFrame is valid, and send this audio frame. + - `false`: The data in AudioFrame in invalid, and do not send this audio frame. + */ + virtual bool onPlaybackAudioFrameBeforeMixingEx(const char *channelId, + unsigned int uid, AudioFrame& audioFrame) { return true; } + }; -class IVideoFrameObserver -{ -public: +/** + * The IVideoFrameObserver class. + */ +class IVideoFrameObserver { + public: + /** The video frame type. */ enum VIDEO_FRAME_TYPE { - FRAME_TYPE_YUV420 = 0, //YUV 420 format - FRAME_TYPE_YUV422 = 1, //YUV 422P format - FRAME_TYPE_RGBA = 2, //RGBA + /** + * 0: YUV420 + */ + FRAME_TYPE_YUV420 = 0, // YUV 420 format + /** + * 1: YUV422 + */ + FRAME_TYPE_YUV422 = 1, // YUV 422 format + /** + * 2: RGBA + */ + FRAME_TYPE_RGBA = 2, // RGBA format }; + /** + * The frame position of the video observer. + */ + enum VIDEO_OBSERVER_POSITION { + /** + * 1: The post-capturer position, which corresponds to the video data in the onCaptureVideoFrame callback. + */ + POSITION_POST_CAPTURER = 1 << 0, + /** + * 2: The pre-renderer position, which corresponds to the video data in the onRenderVideoFrame callback. + */ + POSITION_PRE_RENDERER = 1 << 1, + /** + * 4: The pre-encoder position, which corresponds to the video data in the onPreEncodeVideoFrame callback. + */ + POSITION_PRE_ENCODER = 1 << 2, + }; + /** Video frame information. The video data format is YUV420. The buffer provides a pointer to a pointer. The interface cannot modify the pointer of the buffer, but can modify the content of the buffer only. + */ struct VideoFrame { VIDEO_FRAME_TYPE type; + /** Video pixel width. + */ int width; //width of video frame + /** Video pixel height. + */ int height; //height of video frame + /** Line span of the Y buffer within the YUV data. + */ int yStride; //stride of Y data buffer + /** Line span of the U buffer within the YUV data. + */ int uStride; //stride of U data buffer + /** Line span of the V buffer within the YUV data. + */ int vStride; //stride of V data buffer + /** Pointer to the Y buffer pointer within the YUV data. + */ void* yBuffer; //Y data buffer + /** Pointer to the U buffer pointer within the YUV data. + */ void* uBuffer; //U data buffer + /** Pointer to the V buffer pointer within the YUV data. + */ void* vBuffer; //V data buffer + /** Set the rotation of this frame before rendering the video. Supports 0, 90, 180, 270 degrees clockwise. + */ int rotation; // rotation of this frame (0, 90, 180, 270) + /** The timestamp (ms) of the external audio frame. It is mandatory. You can use this parameter for the following purposes: + - Restore the order of the captured audio frame. + - Synchronize audio and video frames in video-related scenarios, including scenarios where external video sources are used. + @note This timestamp is for rendering the video stream, and not for capturing the video stream. + */ int64_t renderTimeMs; int avsync_type; }; -public: + + public: + /** Occurs each time the SDK receives a video frame captured by the local camera. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time a video frame is received. In this callback, + * you can get the video data captured by the local camera. You can then pre-process the data according to your scenarios. + * + * After pre-processing, you can send the processed video data back to the SDK by setting the `videoFrame` parameter in this callback. + * + * @note + * - This callback does not support sending processed RGBA video data back to the SDK. + * - The video data that this callback gets has not been pre-processed, without the watermark, the cropped content, the rotation, and the image enhancement. + * + * @param videoFrame Pointer to VideoFrame. + * @return Whether or not to ignore the current video frame if the pre-processing fails: + * - true: Do not ignore. + * - false: Ignore the current video frame, and do not send it back to the SDK. + */ virtual bool onCaptureVideoFrame(VideoFrame& videoFrame) = 0; + /** @since v3.0.0 + * + * Occurs each time the SDK receives a video frame before encoding. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time when it receives a video frame. In this callback, you can get the video data before encoding. You can then process the data according to your particular scenarios. + * + * After processing, you can send the processed video data back to the SDK by setting the `VideoFrame` parameter in this callback. + * + * @note + * - As of v3.0.1, if you want to receive this callback, you also need to set `POSITION_PRE_ENCODE(1 << 2)` as a frame position in the \ref getObservedFramePosition "getObservedFramePosition" callback. + * - The video data that this callback gets has been pre-processed, with its content cropped, rotated, and the image enhanced. + * - This callback does not support sending processed RGBA video data back to the SDK. + * + * @param videoFrame A pointer to VideoFrame + * @return Whether to ignore the current video frame if the processing fails: + * - true: Do not ignore the current video frame. + * - false: Ignore the current video frame, and do not send it back to the SDK. + */ virtual bool onPreEncodeVideoFrame(VideoFrame& videoFrame) { return true; } + /** Occurs each time the SDK receives a video frame sent by the remote user. + * + * After you successfully register the video frame observer and isMultipleChannelFrameWanted return false, the SDK triggers this callback each time a video frame is received. + * In this callback, you can get the video data sent by the remote user. You can then post-process the data according to your scenarios. + * + * After post-processing, you can send the processed data back to the SDK by setting the `videoFrame` parameter in this callback. + * + * @note + * This callback does not support sending processed RGBA video data back to the SDK. + * + * @param uid ID of the remote user who sends the current video frame. + * @param videoFrame Pointer to VideoFrame. + * @return Whether or not to ignore the current video frame if the post-processing fails: + * - true: Do not ignore. + * - false: Ignore the current video frame, and do not send it back to the SDK. + */ virtual bool onRenderVideoFrame(unsigned int uid, VideoFrame& videoFrame) = 0; + /** Occurs each time the SDK receives a video frame and prompts you to set the video format. + * + * YUV420 is the default video format. If you want to receive other video formats, register this callback in the IVideoFrameObserver class. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. + * You need to set your preferred video data in the return value of this callback. + * + * @return Sets the video format: #VIDEO_FRAME_TYPE + * - #FRAME_TYPE_YUV420 (0): (Default) YUV420. + * - #FRAME_TYPE_RGBA (2): RGBA + */ virtual VIDEO_FRAME_TYPE getVideoFormatPreference() { return FRAME_TYPE_YUV420; } + /** Occurs each time the SDK receives a video frame and prompts you whether or not to rotate the captured video according to the rotation member in the VideoFrame class. + * + * The SDK does not rotate the captured video by default. If you want to rotate the captured video according to the rotation member in the VideoFrame class, register this callback in the IVideoFrameObserver class. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. You need to set whether or not to rotate the video frame in the return value of this callback. + * + * @note + * This callback applies to RGBA video data only. + * + * @return Sets whether or not to rotate the captured video: + * - true: Rotate. + * - false: （Default) Do not rotate. + */ virtual bool getRotationApplied() { return false; } + /** Occurs each time the SDK receives a video frame and prompts you whether or not to mirror the captured video. + * + * The SDK does not mirror the captured video by default. Register this callback in the IVideoFrameObserver class if you want to mirror the captured video. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time a video frame is received. + * You need to set whether or not to mirror the captured video in the return value of this callback. + * + * @note + * This callback applies to RGBA video data only. + * + * @return Sets whether or not to mirror the captured video: + * - true: Mirror. + * - false: (Default) Do not mirror. + */ virtual bool getMirrorApplied() { return false; } + /** @since v3.0.0 + + Sets whether to output the acquired video frame smoothly. + + If you want the video frames acquired from \ref IVideoFrameObserver::onRenderVideoFrame "onRenderVideoFrame" to be more evenly spaced, you can register the `getSmoothRenderingEnabled` callback in the `IVideoFrameObserver` class and set its return value as `true`. + + @note + - Register this callback before joining a channel. + - This callback applies to scenarios where the acquired video frame is self-rendered after being processed, not to scenarios where the video frame is sent back to the SDK after being processed. + + @return Set whether or not to smooth the video frames: + - true: Smooth the video frame. + - false: (Default) Do not smooth. + */ virtual bool getSmoothRenderingEnabled(){ return false; } + /** + * Sets the frame position for the video observer. + * @since v3.0.1 + * + * After you successfully register the video observer, the SDK triggers this callback each time it receives a video frame. You can determine which position to observe by setting the return value. + * The SDK provides 3 positions for observer. Each position corresponds to a callback function: + * - `POSITION_POST_CAPTURER(1 << 0)`: The position after capturing the video data, which corresponds to the \ref onCaptureVideoFrame "onCaptureVideoFrame" callback. + * - `POSITION_PRE_RENDERER(1 << 1)`: The position before receiving the remote video data, which corresponds to the \ref onRenderVideoFrame "onRenderVideoFrame" callback. + * - `POSITION_PRE_ENCODER(1 << 2)`: The position before encoding the video data, which corresponds to the \ref onPreEncodeVideoFrame "onPreEncodeVideoFrame" callback. + * + * @note + * - Use '|' (the OR operator) to observe multiple frame positions. + * - This callback observes `POSITION_POST_CAPTURER(1 << 0)` and `POSITION_PRE_RENDERER(1 << 1)` by default. + * - To conserve the system consumption, you can reduce the number of frame positions that you want to observe. + * + * @return A bit mask that controls the frame position of the video observer: #VIDEO_OBSERVER_POSITION. + * + */ + virtual uint32_t getObservedFramePosition() { return static_cast(POSITION_POST_CAPTURER | POSITION_PRE_RENDERER); } + + /** Determines whether to receive video data from multiple channels. + + After you register the video frame observer, the SDK triggers this callback + every time it captures a video frame. + + In the multi-channel scenario, if you want to get video data from multiple channels, + set the return value of this callback as true. After that, the SDK triggers the + \ref IVideoFrameObserver::onRenderVideoFrameEx "onRenderVideoFrameEx" callback to send you + the video data from various channels. You can also get the channel ID of each video frame. + + @note + - Once you set the return value of this callback as true, the SDK triggers only the `onRenderVideoFrameEx` callback to + send the video frame. \ref IVideoFrameObserver::onRenderVideoFrame "onRenderVideoFrame" will not be triggered. In the multi-channel scenario, Agora recommends setting the return value as true. + - If you set the return value of this callback as false, the SDK triggers only the `onRenderVideoFrame` callback to send the video data. + @return + - `true`: Receive video data from multiple channels. + - `false`: Do not receive video data from multiple channels. + */ + virtual bool isMultipleChannelFrameWanted() { return false; } + + /** Gets the video frame from multiple channels. + + After you successfully register the video frame observer, if you set the return value of + \ref IVideoFrameObserver::isMultipleChannelFrameWanted "isMultipleChannelFrameWanted" as true, the SDK triggers this callback each time it receives a video frame + from any of the channel. + + You can process the video data retrieved from this callback according to your scenario, and send the + processed data back to the SDK using the `videoFrame` parameter in this callback. + + @note This callback does not support sending RGBA video data back to the SDK. + + @param channelId The channel ID of this video frame. + @param uid The ID of the user sending this video frame. + @param videoFrame The pointer to VideoFrame. + @return Whether to send this video frame to the SDK if post-processing fails: + - `true`: Send this video frame. + - `false`: Do not send this video frame. + */ + virtual bool onRenderVideoFrameEx(const char *channelId, unsigned int uid, VideoFrame& videoFrame) { return true; } }; -class IVideoFrame -{ -public: +class IVideoFrame { + public: enum PLANE_TYPE { Y_PLANE = 0, U_PLANE = 1, @@ -104,124 +418,337 @@ class IVideoFrame virtual void release() = 0; virtual const unsigned char* buffer(PLANE_TYPE type) const = 0; - // Copy frame: If required size is bigger than allocated one, new buffers of - // adequate size will be allocated. - // Return value: 0 on success ,-1 on error. + /** Copies the frame. + + If the required size is larger than the allocated size, new buffers of the adequate size will be allocated. + + @param dest_frame Address of the returned destination frame. See IVideoFrame. + @return + - 0: Success. + - -1: Failure. + */ virtual int copyFrame(IVideoFrame** dest_frame) const = 0; + /** Converts the frame. + + @note The source and destination frames have equal heights. - // Convert frame - // Input: - // - src_frame : Reference to a source frame. - // - dst_video_type : Type of output video. - // - dst_sample_size : Required only for the parsing of MJPG. - // - dst_frame : Pointer to a destination frame. - // Return value: 0 if OK, < 0 otherwise. - // It is assumed that source and destination have equal height. - virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, unsigned char* dst_frame) const = 0; - - // Get allocated size per plane. + @param dst_video_type Type of the output video. + @param dst_sample_size Required only for the parsing of M-JPEG. + @param dst_frame Pointer to a destination frame. See IVideoFrame. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, + unsigned char* dst_frame) const = 0; + /** Retrieves the specified component in the YUV space. + + @param type Component type: #PLANE_TYPE + */ virtual int allocated_size(PLANE_TYPE type) const = 0; + /** Retrieves the stride of the specified component in the YUV space. - // Get allocated stride per plane. + @param type Component type: #PLANE_TYPE + */ virtual int stride(PLANE_TYPE type) const = 0; - - // Get frame width. + /** Retrieves the width of the frame. + */ virtual int width() const = 0; - - // Get frame height. + /** Retrieves the height of the frame. + */ virtual int height() const = 0; - - // Get frame timestamp (90kHz). + /** Retrieves the timestamp (ms) of the frame. + */ virtual unsigned int timestamp() const = 0; - - // Get render time in milliseconds. + /** Retrieves the render time (ms). + */ virtual int64_t render_time_ms() const = 0; + /** Checks if a plane is of zero size. - // Return true if underlying plane buffers are of zero size, false if not. + @return + - true: The plane is of zero size. + - false: The plane is not of zero size. + */ virtual bool IsZeroSize() const = 0; virtual VIDEO_TYPE GetVideoType() const = 0; }; - -class IExternalVideoRenderCallback -{ -public: +/** **DEPRECATED** */ +class IExternalVideoRenderCallback { + public: + /** Occurs when the video view size has changed. + */ virtual void onViewSizeChanged(int width, int height) = 0; + /** Occurs when the video view is destroyed. + */ virtual void onViewDestroyed() = 0; }; - -struct ExternalVideoRenerContext -{ +/** **DEPRECATED** */ +struct ExternalVideoRenerContext { IExternalVideoRenderCallback* renderCallback; + /** Video display window. + */ void* view; + /** Video display mode: \ref agora::rtc::RENDER_MODE_TYPE "RENDER_MODE_TYPE" */ int renderMode; + /** The image layer location. + + - 0: (Default) The image is at the bottom of the stack + - 100: The image is at the top of the stack. + + @note If the value is set to below 0 or above 100, the #ERR_INVALID_ARGUMENT error occurs. + */ int zOrder; + /** Video layout distance from the left. + */ float left; + /** Video layout distance from the top. + */ float top; + /** Video layout distance from the right. + */ float right; + /** Video layout distance from the bottom. + */ float bottom; }; -class IExternalVideoRender -{ -public: +class IExternalVideoRender { + public: virtual void release() = 0; virtual int initialize() = 0; - virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, bool mirrored) = 0; + virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, + bool mirrored) = 0; }; -class IExternalVideoRenderFactory -{ -public: - virtual IExternalVideoRender* createRenderInstance(const ExternalVideoRenerContext& context) = 0; +class IExternalVideoRenderFactory { + public: + virtual IExternalVideoRender* createRenderInstance( + const ExternalVideoRenerContext& context) = 0; }; +/** The external video frame. + */ struct ExternalVideoFrame { - enum VIDEO_BUFFER_TYPE - { - VIDEO_BUFFER_RAW_DATA = 1, - }; + /** The video buffer type. + */ + enum VIDEO_BUFFER_TYPE + { + /** 1: The video buffer in the format of raw data. + */ + VIDEO_BUFFER_RAW_DATA = 1, + }; - enum VIDEO_PIXEL_FORMAT - { - VIDEO_PIXEL_UNKNOWN = 0, - VIDEO_PIXEL_I420 = 1, - VIDEO_PIXEL_BGRA = 2, + /** The video pixel format. + * + * @note The SDK does not support the alpha channel, and discards any alpha value passed to the SDK. + */ + enum VIDEO_PIXEL_FORMAT + { + /** 0: The video pixel format is unknown. + */ + VIDEO_PIXEL_UNKNOWN = 0, + /** 1: The video pixel format is I420. + */ + VIDEO_PIXEL_I420 = 1, + /** 2: The video pixel format is BGRA. + */ + VIDEO_PIXEL_BGRA = 2, + /** 3: The video pixel format is NV21. + */ + VIDEO_PIXEL_NV21 = 3, + /** 4: The video pixel format is RGBA. + */ + VIDEO_PIXEL_RGBA = 4, + /** 5: The video pixel format is IMC2. + */ + VIDEO_PIXEL_IMC2 = 5, + /** 7: The video pixel format is ARGB. + */ + VIDEO_PIXEL_ARGB = 7, + /** 8: The video pixel format is NV12. + */ + VIDEO_PIXEL_NV12 = 8, + /** 16: The video pixel format is I422. + */ + VIDEO_PIXEL_I422 = 16, + }; - VIDEO_PIXEL_NV12 = 8, - VIDEO_PIXEL_I422 = 16, - }; + /** The buffer type. See #VIDEO_BUFFER_TYPE + */ + VIDEO_BUFFER_TYPE type; + /** The pixel format. See #VIDEO_PIXEL_FORMAT + */ + VIDEO_PIXEL_FORMAT format; + /** The video buffer. + */ + void* buffer; + /** Line spacing of the incoming video frame, which must be in pixels instead of bytes. For textures, it is the width of the texture. + */ + int stride; + /** Height of the incoming video frame. + */ + int height; + /** [Raw data related parameter] The number of pixels trimmed from the left. The default value is 0. + */ + int cropLeft; + /** [Raw data related parameter] The number of pixels trimmed from the top. The default value is 0. + */ + int cropTop; + /** [Raw data related parameter] The number of pixels trimmed from the right. The default value is 0. + */ + int cropRight; + /** [Raw data related parameter] The number of pixels trimmed from the bottom. The default value is 0. + */ + int cropBottom; + /** [Raw data related parameter] The clockwise rotation of the video frame. You can set the rotation angle as 0, 90, 180, or 270. The default value is 0. + */ + int rotation; + /** Timestamp (ms) of the incoming video frame. An incorrect timestamp results in frame loss or unsynchronized audio and video. + */ + long long timestamp; - VIDEO_BUFFER_TYPE type; - VIDEO_PIXEL_FORMAT format; - void* buffer; - int stride; - int height; - int cropLeft; - int cropTop; - int cropRight; - int cropBottom; - int rotation; - long long timestamp; + ExternalVideoFrame() + :cropLeft(0) + ,cropTop(0) + ,cropRight(0) + ,cropBottom(0) + ,rotation(0) + {} }; class IMediaEngine { -public: + public: + virtual ~IMediaEngine () {}; virtual void release() = 0; + /** Registers an audio frame observer object. + + This method is used to register an audio frame observer object (register a callback). This method is required to register callbacks when the engine is required to provide an \ref IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" or \ref IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + + @note Ensure that you call this method before joining a channel. + + @param observer Audio frame observer object instance. See IAudioFrameObserver. Set the value as NULL to release the + audio observer object. Agora recommends calling `registerAudioFrameObserver(NULL)` after receiving the \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int registerAudioFrameObserver(IAudioFrameObserver* observer) = 0; + /** Registers a video frame observer object. + * + * You need to implement the IVideoFrameObserver class in this method, and register callbacks according to your scenarios. + * + * After you successfully register the video frame observer, the SDK triggers the registered callbacks each time a video frame is received. + * + * @note + * - When handling the video data returned in the callbacks, pay attention to the changes in the `width` and `height` parameters, + * which may be adapted under the following circumstances: + * - When the network condition deteriorates, the video resolution decreases incrementally. + * - If the user adjusts the video profile, the resolution of the video returned in the callbacks also changes. + * - Ensure that you call this method before joining a channel. + * @param observer Video frame observer object instance. If NULL is passed in, the registration is canceled. + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int registerVideoFrameObserver(IVideoFrameObserver* observer) = 0; + /** **DEPRECATED** */ virtual int registerVideoRenderFactory(IExternalVideoRenderFactory* factory) = 0; - virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, IAudioFrameObserver::AudioFrame *frame, bool wrap) = 0; - virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; - virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; + /** **DEPRECATED** Use \ref agora::media::IMediaEngine::pushAudioFrame(IAudioFrameObserver::AudioFrame* frame) "pushAudioFrame(IAudioFrameObserver::AudioFrame* frame)" instead. + + Pushes the external audio frame. + + @param type Type of audio capture device: #MEDIA_SOURCE_TYPE. + @param frame Audio frame pointer: \ref IAudioFrameObserver::AudioFrame "AudioFrame". + @param wrap Whether to use the placeholder. We recommend setting the default value. + - true: Use. + - false: (Default) Not use. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, + IAudioFrameObserver::AudioFrame* frame, + bool wrap) = 0; + /** Pushes the external audio frame. + + @param frame Pointer to the audio frame: \ref IAudioFrameObserver::AudioFrame "AudioFrame". + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0; + /** Pulls the remote audio data. + * + * Before calling this method, call the + * \ref agora::rtc::IRtcEngine::setExternalAudioSink + * "setExternalAudioSink(enabled: true)" method to enable and set the + * external audio sink. + * + * After a successful method call, the app pulls the decoded and mixed + * audio data for playback. + * + * @note + * - Once you call the \ref agora::media::IMediaEngine::pullAudioFrame + * "pullAudioFrame" method successfully, the app will not retrieve any audio + * data from the + * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame + * "onPlaybackAudioFrame" callback. + * - The difference between the + * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame + * "onPlaybackAudioFrame" callback and the + * \ref agora::media::IMediaEngine::pullAudioFrame "pullAudioFrame" method is as + * follows: + * - `onPlaybackAudioFrame`: The SDK sends the audio data to the app through this callback. + * Any delay in processing the audio frames may result in audio jitter. + * - `pullAudioFrame`: The app pulls the remote audio data. After setting the + * audio data parameters, the SDK adjusts the frame buffer and avoids + * problems caused by jitter in the external audio playback. + * + * @param frame Pointers to the audio frame. + * See: \ref IAudioFrameObserver::AudioFrame "AudioFrame". + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0; + /** Configures the external video source. + + @note Ensure that you call this method before joining a channel. + + @param enable Sets whether to use the external video source: + - true: Use the external video source. + - false: (Default) Do not use the external video source. + + @param useTexture Sets whether to use texture as an input: + - true: Use texture as an input. + - false: (Default) Do not use texture as an input. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; + /** Pushes the video frame using the \ref ExternalVideoFrame "ExternalVideoFrame" and passes the video frame to the Agora SDK. + + @param frame Video frame to be pushed. See \ref ExternalVideoFrame "ExternalVideoFrame". + + @note In the `COMMUNICATION` profile, this method does not support video frames in the Texture format. - virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; - virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; }; -} //media +} // namespace media -} //agora +} // namespace agora -#endif //AGORA_MEDIA_ENGINE_H +#endif // AGORA_MEDIA_ENGINE_H diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h old mode 100755 new mode 100644 index b19c71c..f354183 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h @@ -16,7 +16,7 @@ struct ChannelMediaOptions { - true: (Default) Subscribe. - false: Do not subscribe. - This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method. After joining the channel, + This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method. After joining the channel, you can call the `muteAllRemoteAudioStreams` method to set whether to subscribe to audio streams in the channel. */ bool autoSubscribeAudio; @@ -24,7 +24,7 @@ struct ChannelMediaOptions { - true: (Default) Subscribe. - false: Do not subscribe. - This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method. After joining the channel, + This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method. After joining the channel, you can call the `muteAllRemoteVideoStreams` method to set whether to subscribe to video streams in the channel. */ bool autoSubscribeVideo; @@ -53,7 +53,7 @@ class IChannelEventHandler (void)msg; } /** Reports the error code of `IChannel`. - + @param rtcChannel IChannel @param err The error code: #ERROR_CODE_TYPE @param msg The error message. @@ -78,7 +78,7 @@ class IChannelEventHandler (void)elapsed; } /** Occurs when a user rejoins the channel after being disconnected due to network problems. - + @param rtcChannel IChannel @param uid The user ID. @param elapsed Time elapsed (ms) from the local user starting to reconnect until this callback is triggered. @@ -102,12 +102,12 @@ class IChannelEventHandler (void)rtcChannel; (void)stats; } - /** Occurs when the user role switches in a live broadcast. For example, from a host to an audience or vice versa. + /** Occurs when the user role switches in the live interactive streaming. For example, from a host to an audience or vice versa. This callback notifies the application of a user role switch when the application calls the \ref IChannel::setClientRole "setClientRole" method. The SDK triggers this callback when the local user switches the user role by calling the \ref IChannel::setClientRole "setClientRole" method after joining the channel. - + @param rtcChannel IChannel @param oldRole Role that the user switches from: #CLIENT_ROLE_TYPE. @param newRole Role that the user switches to: #CLIENT_ROLE_TYPE. @@ -117,10 +117,10 @@ class IChannelEventHandler (void)oldRole; (void)newRole; } - /** Occurs when a remote user (Communication)/ host (Live Broadcast) joins the channel. + /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) joins the channel. - - Communication profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. - - Live-broadcast profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + - `COMMUNICATION` profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - `LIVE_BROADCASTING` profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. The SDK triggers this callback under one of the following circumstances: - A remote user/host joins the channel by calling the \ref agora::rtc::IChannel::joinChannel "joinChannel" method. @@ -128,11 +128,11 @@ class IChannelEventHandler - A remote user/host rejoins the channel after a network interruption. - The host injects an online media stream into the channel by calling the \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method. - @note In the Live-broadcast profile: + @note In the `LIVE_BROADCASTING` profile: - The host receives this callback when another host joins the channel. - The audience in the channel receives this callback when a new host joins the channel. - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. - + @param rtcChannel IChannel @param uid User ID of the user or host joining the channel. @param elapsed Time delay (ms) from the local user calling the \ref IChannel::joinChannel "joinChannel" method until the SDK triggers this callback. @@ -142,12 +142,12 @@ class IChannelEventHandler (void)uid; (void)elapsed; } - /** Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel. + /** Occurs when a remote user ( `COMMUNICATION`)/host (`LIVE_BROADCASTING`) leaves the channel. Reasons why the user is offline: - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. - - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using a signaling system for more reliable offline detection. + - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using the Agora RTM SDK for more reliable offline detection. @param rtcChannel IChannel @param uid User ID of the user leaving the channel or going offline. @@ -162,13 +162,13 @@ class IChannelEventHandler The SDK triggers this callback when it cannot connect to the server 10 seconds after calling the \ref IChannel::joinChannel "joinChannel" method, whether or not it is in the channel. - This callback is different from \ref agora::rtc::IChannelEventHandler::onConnectionInterrupted "onConnectionInterrupted": + This callback is different from \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted": - - The SDK triggers the \ref agora::rtc::IChannelEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. - - The SDK triggers the \ref agora::rtc::IChannelEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. + - The SDK triggers the `onConnectionInterrupted` callback when it loses connection with the server for more than four seconds after it successfully joins the channel. + - The SDK triggers the `onConnectionLost` callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. - + @param rtcChannel IChannel */ virtual void onConnectionLost(IChannel *rtcChannel) { @@ -178,8 +178,9 @@ class IChannelEventHandler After a token is specified by calling the \ref IChannel::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. - This callback notifies the application to generate a new token. Call the \ref IChannel::renewToken "renewToken" method to renew the token. - + Once you receive this callback, generate a new token on your app server, and call + \ref agora::rtc::IChannel::renewToken "renewToken" to pass the new token to the SDK. + @param rtcChannel IChannel */ virtual void onRequestToken(IChannel *rtcChannel) { @@ -196,10 +197,10 @@ class IChannelEventHandler (void)rtcChannel; (void)token; } - /** Reports the statistics of the current call. - + /** Reports the statistics of the current call. + The SDK triggers this callback once every two seconds after the user joins the channel. - + @param rtcChannel IChannel @param stats Statistics of the RtcEngine: RtcStats. */ @@ -213,7 +214,7 @@ class IChannelEventHandler @param rtcChannel IChannel @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. - @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 × 480 and a frame rate of 15 fps in the Live-broadcast profile, but may be inadequate for resolutions higher than 1280 × 720. See #QUALITY_TYPE. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 * 480 and a frame rate of 15 fps in the `LIVE_BROADCASTING` profile, but may be inadequate for resolutions higher than 1280 * 720. See #QUALITY_TYPE. @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. */ virtual void onNetworkQuality(IChannel *rtcChannel, uid_t uid, int txQuality, int rxQuality) { @@ -238,7 +239,7 @@ class IChannelEventHandler } /** Reports the statistics of the audio stream from each remote user/host. - This callback replaces the \ref agora::rtc::IChannelEventHandler::onAudioQuality "onAudioQuality" callback. + This callback replaces the \ref agora::rtc::IRtcEngineEventHandler::onAudioQuality "onAudioQuality" callback. The SDK triggers this callback once every two seconds for each remote user/host. If a channel includes multiple remote users, the SDK triggers this callback as many times. @@ -250,17 +251,18 @@ class IChannelEventHandler (void)stats; } /** Occurs when the remote audio state changes. - * - * This callback indicates the state change of the remote audio stream. - * - * @param rtcChannel IChannel - * @param uid ID of the remote user whose audio state changes. - * @param state State of the remote audio. See #REMOTE_AUDIO_STATE. - * @param reason The reason of the remote audio state change. - * See #REMOTE_AUDIO_STATE_REASON. - * @param elapsed Time elapsed (ms) from the local user calling the - * \ref IChannel::joinChannel "joinChannel" method until the SDK - * triggers this callback. + + This callback indicates the state change of the remote audio stream. + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param rtcChannel IChannel + @param uid ID of the remote user whose audio state changes. + @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + @param reason The reason of the remote audio state change. + See #REMOTE_AUDIO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref IChannel::joinChannel "joinChannel" method until the SDK + triggers this callback. */ virtual void onRemoteAudioStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { (void)rtcChannel; @@ -269,16 +271,118 @@ class IChannelEventHandler (void)reason; (void)elapsed; } - /** Reports which user is the loudest speaker. - If the user enables the audio volume indication by calling the \ref IChannel::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method, this callback returns the @p uid of the active speaker detected by the audio volume detection module of the SDK. + /** Occurs when the audio publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local audio stream. + * + * @param rtcChannel IChannel + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioPublishStateChanged(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + (void)rtcChannel; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + + /** Occurs when the video publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local video stream. + * + * @param rtcChannel IChannel + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoPublishStateChanged(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + (void)rtcChannel; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote audio stream. + * + * @param rtcChannel IChannel + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioSubscribeStateChanged(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + (void)rtcChannel; + (void)uid; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote video stream. + * + * @param rtcChannel IChannel + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoSubscribeStateChanged(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + (void)rtcChannel; + (void)uid; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + /// @cond + /** Reports whether the super-resolution algorithm is enabled. + * + * @since v3.2.0 + * + * After calling \ref IRtcChannel::enableRemoteSuperResolution "enableRemoteSuperResolution", the SDK triggers this + * callback to report whether the super-resolution algorithm is successfully enabled. If not successfully enabled, + * you can use reason for troubleshooting. + * + * @param rtcChannel IChannel + * @param uid The ID of the remote user. + * @param enabled Whether the super-resolution algorithm is successfully enabled: + * - true: The super-resolution algorithm is successfully enabled. + * - false: The super-resolution algorithm is not successfully enabled. + * @param reason The reason why the super-resolution algorithm is not successfully enabled. See #SUPER_RESOLUTION_STATE_REASON. + */ + virtual void onUserSuperResolutionEnabled(IChannel *rtcChannel, uid_t uid, bool enabled, SUPER_RESOLUTION_STATE_REASON reason) { + (void)rtcChannel; + (void)uid; + (void)enabled; + (void)reason; + } + /// @endcond + + /** Occurs when the most active speaker is detected. + + After a successful call of \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication", + the SDK continuously detects which remote user has the loudest volume. During the current period, the remote user, + who is detected as the loudest for the most times, is the most active user. + + When the number of user is no less than two and an active speaker exists, the SDK triggers this callback and reports the `uid` of the most active speaker. + - If the most active speaker is always the same user, the SDK triggers this callback only once. + - If the most active speaker changes to another user, the SDK triggers this callback again and reports the `uid` of the new active speaker. - @note - - To receive this callback, you need to call the \ref IChannel::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. - - This callback returns the user ID of the user with the highest voice volume during a period of time, instead of at the moment. - @param rtcChannel IChannel - @param uid User ID of the active speaker. A @p uid of 0 represents the local user. + @param uid The user ID of the most active speaker. */ virtual void onActiveSpeaker(IChannel *rtcChannel, uid_t uid) { (void)rtcChannel; @@ -291,7 +395,7 @@ class IChannelEventHandler @param width New width (pixels) of the video. @param height New height (pixels) of the video. @param rotation New rotation of the video [0 to 360). - */ + */ virtual void onVideoSizeChanged(IChannel *rtcChannel, uid_t uid, int width, int height, int rotation) { (void)rtcChannel; (void)uid; @@ -300,15 +404,17 @@ class IChannelEventHandler (void)rotation; } /** Occurs when the remote video state changes. - * - * @param rtcChannel IChannel - * @param uid ID of the remote user whose video state changes. - * @param state State of the remote video. See #REMOTE_VIDEO_STATE. - * @param reason The reason of the remote video state change. See - * #REMOTE_VIDEO_STATE_REASON. - * @param elapsed Time elapsed (ms) from the local user calling the - * \ref agora::rtc::IChannel::joinChannel "joinChannel" method until the - * SDK triggers this callback. + + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param rtcChannel IChannel + @param uid ID of the remote user whose video state changes. + @param state State of the remote video. See #REMOTE_VIDEO_STATE. + @param reason The reason of the remote video state change. See + #REMOTE_VIDEO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref agora::rtc::IChannel::joinChannel "joinChannel" method until the + SDK triggers this callback. */ virtual void onRemoteVideoStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { (void)rtcChannel; @@ -320,7 +426,7 @@ class IChannelEventHandler /** Occurs when the local user receives the data stream from the remote user within five seconds. The SDK triggers this callback when the local user receives the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. - + @param rtcChannel IChannel @param uid User ID of the remote user sending the message. @param streamId Stream ID. @@ -337,7 +443,7 @@ class IChannelEventHandler /** Occurs when the local user does not receive the data stream from the remote user within five seconds. The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. - + @param rtcChannel IChannel @param uid User ID of the remote user sending the message. @param streamId Stream ID. @@ -376,11 +482,11 @@ class IChannelEventHandler } /** Occurs when the state of the RTMP streaming changes. - + The SDK triggers this callback to report the result of the local user calling the \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" or \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method. This callback indicates the state of the RTMP streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. - + @param rtcChannel IChannel @param url The RTMP URL address. @param state The RTMP streaming state. See: #RTMP_STREAM_PUBLISH_STATE. @@ -392,19 +498,34 @@ class IChannelEventHandler (RTMP_STREAM_PUBLISH_STATE) state; (RTMP_STREAM_PUBLISH_ERROR) errCode; } - /** Occurs when the publisher's transcoding is updated. - + + /** Reports events during the RTMP streaming. + * + * @since v3.1.0 + * + * @param rtcChannel IChannel + * @param url The RTMP streaming URL. + * @param eventCode The event code. See #RTMP_STREAMING_EVENT + */ + virtual void onRtmpStreamingEvent(IChannel *rtcChannel, const char* url, RTMP_STREAMING_EVENT eventCode) { + (void) rtcChannel; + (void) url; + (RTMP_STREAMING_EVENT) eventCode; + } + + /** Occurs when the publisher's transcoding is updated. + When the `LiveTranscoding` class in the \ref agora::rtc::IChannel::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. - + @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - + @param rtcChannel IChannel - */ + */ virtual void onTranscodingUpdated(IChannel *rtcChannel) { (void)rtcChannel; } - /** Occurs when a voice or video stream URL address is added to a live broadcast. - + /** Occurs when a voice or video stream URL address is added to the live interactive streaming. + @param rtcChannel IChannel @param url The URL address of the externally injected stream. @param uid User ID. @@ -416,12 +537,25 @@ class IChannelEventHandler (void)uid; (void)status; } + /** Occurs when the published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. + + If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + + @param rtcChannel IChannel + @param isFallbackOrRecover Whether the published stream falls back to audio-only or switches back to the video: + - true: The published stream falls back to audio-only due to poor network conditions. + - false: The published stream switches back to the video after the network conditions improve. + */ + virtual void onLocalPublishFallbackToAudioOnly(IChannel *rtcChannel, bool isFallbackOrRecover) { + (void)rtcChannel; + (void)isFallbackOrRecover; + } /** Occurs when the remote media stream falls back to audio-only stream * due to poor network conditions or switches back to the video stream * after the network conditions improve. * * If you call - * \ref IChannel::setRemoteSubscribeFallbackOption + * \ref IRtcEngine::setRemoteSubscribeFallbackOption * "setRemoteSubscribeFallbackOption" and set * @p option as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this * callback when the remote media stream falls back to audio-only mode due @@ -446,7 +580,7 @@ class IChannelEventHandler (void)isFallbackOrRecover; } /** Occurs when the connection state between the SDK and the server changes. - + @param rtcChannel IChannel @param state See #CONNECTION_STATE_TYPE. @param reason See #CONNECTION_CHANGED_REASON_TYPE. @@ -467,7 +601,7 @@ class IChannel virtual ~IChannel() {} /** Releases all IChannel resources. - @return + @return - 0: Success. - < 0: Failure. - `ERR_NOT_INITIALIZED (7)`: The SDK is not initialized before calling this method. @@ -479,7 +613,7 @@ class IChannel @param channelEh The event handler of the `IChannel` object. For details, see IChannelEventHandler. - @return + @return - 0: Success. - < 0: Failure. */ @@ -495,25 +629,27 @@ class IChannel | Users can join multiple channels simultaneously by creating multiple `IChannel` objects and calling the `joinChannel` method of each object. | Users can join only one channel. | | By default, the SDK does not publish any stream after the user joins the channel. You need to call the publish method to do that. | By default, the SDK publishes streams once the user joins the channel. | - @note + @note - If you are already in a channel, you cannot rejoin it with the same `uid`. - We recommend using different UIDs for different channels. - If you want to join the same channel from different devices, ensure that the UIDs in all devices are different. - - Ensure that the app ID you use to generate the token is the same with the app ID used when creating the `IChannel` object. + - Ensure that the app ID you use to generate the token is the same with the app ID used when creating the `IRtcEngine` object. @param token The token for authentication: - - In situations not requiring high security: You can use the temporary token generated at Console. For details, see [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-temporary-token). - - In situations requiring high security: Set it as the token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-token). + - In situations not requiring high security: You can use the temporary token generated at Console. For details, see [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platform=All%20Platforms#generate-a-token). + - In situations requiring high security: Set it as the token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=All%20Platforms). @param info (Optional) Additional information about the channel. This parameter can be set as null. Other users in the channel do not receive this information. @param uid The user ID. A 32-bit unsigned integer with a value ranging from 1 to (232-1). This parameter must be unique. If `uid` is not assigned (or set as `0`), the SDK assigns a `uid` and reports it in the \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. The app must maintain this user ID. - @param options The channel media options: ChannelMediaOptions. + @param options The channel media options: \ref agora::rtc::ChannelMediaOptions::ChannelMediaOptions "ChannelMediaOptions" - @return - - 0: Success. + @return + - 0(ERR_OK): Success. - < 0: Failure. - - #ERR_INVALID_ARGUMENT (-2) - - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. + - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: + - You have created an IChannel object with the same channel name. + - You have joined and published a stream in a channel created by the IChannel object. */ virtual int joinChannel(const char* token, const char* info, @@ -523,8 +659,8 @@ class IChannel After the user successfully joins the channel, the SDK triggers the following callbacks: - - The local client: \ref agora::rtc::IChannelEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IChannelEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. @@ -532,18 +668,13 @@ class IChannel @param token The token generated at your server: - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). - @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + @param options The channel media options: \ref agora::rtc::ChannelMediaOptions::ChannelMediaOptions “ChannelMediaOptions”. @return - 0: Success. @@ -565,23 +696,26 @@ class IChannel A successful \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method call triggers the following callbacks: - The local client: \ref agora::rtc::IChannelEventHandler::onLeaveChannel "onLeaveChannel" - - The remote client: \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a BROADCASTER in the Live Broadcast profile. + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a host in the `LIVE_BROADCASTING` profile. @note - If you call the \ref IChannel::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IChannel::removePublishStreamUrl "removePublishStreamUrl" method. @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int leaveChannel() = 0; - + /** Publishes the local stream to the channel. You must keep the following restrictions in mind when calling this method. Otherwise, the SDK returns the #ERR_REFUSED (5): - This method publishes one stream only to the channel corresponding to the current `IChannel` object. - - In a Live Broadcast channel, only a broadcaster can call this method. To switch the client role, call \ref agora::rtc::IChannel::setClientRole "setClientRole" of the current `IChannel` object. + - In the live interactive streaming channel, only a host can call this method. To switch the client role, call \ref agora::rtc::IChannel::setClientRole "setClientRole" of the current `IChannel` object. - You can publish a stream to only one channel at a time. For details on joining multiple channels, see the advanced guide *Join Multiple Channels*. @return @@ -590,7 +724,7 @@ class IChannel - #ERR_REFUSED (5): The method call is refused. */ virtual int publish() = 0; - + /** Stops publishing a stream to the channel. If you call this method in a channel where you are not publishing streams, the SDK returns #ERR_REFUSED (5). @@ -601,20 +735,22 @@ class IChannel - #ERR_REFUSED (5): The method call is refused. */ virtual int unpublish() = 0; - + /** Gets the channel ID of the current `IChannel` object. - - @return + + @return - The channel ID of the current `IChannel` object, if the method call succeeds. - The empty string "", if the method call fails. */ virtual const char *channelId() = 0; /** Retrieves the current call ID. - When a user joins a channel on a client, a `callId` is generated to identify the call from the client. - Feedback methods, such as \ref IChannel::rate "rate" and \ref IChannel::complain "complain", must be called after the call ends to submit feedback to the SDK. + When a user joins a channel on a client, a `callId` is generated to identify the call from the client. + Feedback methods, such as \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain", must be called after the call ends to submit feedback to the SDK. + + The `rate` and `complain` methods require the `callId` parameter retrieved from the `getCallId` method during a call. `callId` is passed as an argument into the `rate` and `complain` methods after the call ends. - The \ref `rate` and `complain` methods require the `callId` parameter retrieved from the `getCallId` method during a call. `callId` is passed as an argument into the `rate` and `complain` methods after the call ends. + @note Ensure that you call this method after joining a channel. @param callId The current call ID. @@ -633,13 +769,19 @@ class IChannel The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. @param token Pointer to the new token. + @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int renewToken(const char* token) = 0; /** Enables built-in encryption with an encryption password before users join a channel. + @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IChannel::enableEncryption "enableEncryption" instead. + All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. If an encryption password is not specified, the encryption functionality will be disabled. @@ -657,6 +799,8 @@ class IChannel virtual int setEncryptionSecret(const char* secret) = 0; /** Sets the built-in encryption mode. + @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IChannel::enableEncryption "enableEncryption" instead. + The Agora SDK supports built-in encryption, which is set to the `aes-128-xts` mode by default. Call this method to use other encryption modes. All users in the same channel must use the same encryption mode and password. @@ -676,15 +820,40 @@ class IChannel - < 0: Failure. */ virtual int setEncryptionMode(const char* encryptionMode) = 0; + /** Enables/Disables the built-in encryption. + * + * @since v3.1.0 + * + * In scenarios requiring high security, Agora recommends calling this method to enable the built-in encryption before joining a channel. + * + * All users in the same channel must use the same encryption mode and encryption key. Once all users leave the channel, the encryption key of this channel is automatically cleared. + * + * @note + * - If you enable the built-in encryption, you cannot use the RTMP streaming function. + * - Agora supports four encryption modes. If you choose an encryption mode (excepting `SM4_128_ECB` mode), you need to add an external encryption library when integrating the Android and iOS SDK. See the advanced guide *Channel Encryption*. + * + * @param enabled Whether to enable the built-in encryption: + * - true: Enable the built-in encryption. + * - false: Disable the built-in encryption. + * @param config Configurations of built-in encryption schemas. See EncryptionConfig. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - -2(ERR_INVALID_ARGUMENT): An invalid parameter is used. Set the parameter with a valid value. + * - -4(ERR_NOT_SUPPORTED): The encryption mode is incorrect or the SDK fails to load the external encryption library. Check the enumeration or reload the external encryption library. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Initialize the `IRtcEngine` instance before calling this method. + */ + virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; /** Registers a packet observer. The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. - + @note - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. - + - Call this method before joining a channel. @param observer The registered packet observer. See IPacketObserver. @return @@ -695,11 +864,11 @@ class IChannel /** Registers the metadata observer. Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. - This method enables you to add synchronized metadata in the video stream for more diversified live broadcast interactions, such as sending shopping links, digital coupons, and online quizzes. + This method enables you to add synchronized metadata in the video stream for more diversified interactive live streaming, such as sending shopping links, digital coupons, and online quizzes. @note - Call this method before the joinChannel method. - - This method applies to the Live-broadcast channel profile. + - This method applies to the `LIVE_BROADCASTING` channel profile. @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. @@ -709,16 +878,16 @@ class IChannel - < 0: Failure. */ virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; - /** Sets the role of the user, such as a host or an audience (default), before joining a channel in a live broadcast. + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in the interactive live streaming. - This method can be used to switch the user role in a live broadcast after the user joins a channel. + This method can be used to switch the user role in the interactive live streaming after the user joins a channel. - In the Live Broadcast profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IChannel::setClientRole "setClientRole" method call triggers the following callbacks: + In the `LIVE_BROADCASTING` profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IChannel::setClientRole "setClientRole" method call triggers the following callbacks: - The local client: \ref agora::rtc::IChannelEventHandler::onClientRoleChanged "onClientRoleChanged" - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) @note - This method applies only to the Live-broadcast profile. + This method applies only to the `LIVE_BROADCASTING` profile. @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. @return @@ -726,56 +895,100 @@ class IChannel - < 0: Failure. */ virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; + /// @cond + /** Sets the role of a user in a live interactive streaming. + * + * @since v3.2.0 + * + * You can call this method either before or after joining the channel to set the user role as audience or host. If + * you call this method to switch the user role after joining the channel, the SDK triggers the following callbacks: + * - The local client: \ref IRtcChannelEventHandler::onClientRoleChanged "onClientRoleChanged". + * - The remote client: \ref IRtcChannelEventHandler::onUserJoined "onUserJoined" + * or \ref IRtcChannelEventHandler::onUserOffline "onUserOffline". + * + * @note + * - This method applies to the `LIVE_BROADCASTING` profile only (when the `profile` parameter in + * \ref IRtcChannel::setChannelProfile "setChannelProfile" is set as `CHANNEL_PROFILE_LIVE_BROADCASTING`). + * - The difference between this method and \ref IRtcChannel::setClientRole(CLIENT_ROLE_TYPE) "setClientRole1" is that + * this method can set the user level in addition to the user role. + * - The user role determines the permissions that the SDK grants to a user, such as permission to send local + * streams, receive remote streams, and push streams to a CDN address. + * - The user level determines the level of services that a user can enjoy within the permissions of the user's + * role. For example, an audience can choose to receive remote streams with low latency or ultra low latency. Levels + * affect prices. + * + * **Example** + * ```cpp + * ClientRoleOptions options; + * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY; + * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_LOW_LATENCY; + * agoraChannel->setClientRole(role, options); + * ``` + * + * @param role The role of a user in a live interactive streaming. See #CLIENT_ROLE_TYPE. + * @param options The detailed options of a user, including user level. See ClientRoleOptions. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + */ + virtual int setClientRole(CLIENT_ROLE_TYPE role, const ClientRoleOptions& options) = 0; + /// @endcond /** Prioritizes a remote user's stream. - - Use this method with the \ref IChannel::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. - If the fallback function is enabled for a subscribed stream, the SDK ensures the high-priority user gets the best possible stream quality. - - @note The Agora SDK supports setting `serPriority` as high for one user only. - - @param uid The ID of the remote user. - @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. - - @return - - 0: Success. - - < 0: Failure. + * + * The SDK ensures the high-priority user gets the best possible stream quality. + * + * @note + * - The Agora SDK supports setting `serPriority` as high for one user only. + * - Ensure that you call this method before joining a channel. + * + * @param uid The ID of the remote user. + * @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; /** Sets the sound position and gain of a remote user. - When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the - local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, + When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the + local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, such as Battle Royale games. @note - - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IChannel::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. + - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + - Ensure that you call this method after joining a channel. @param uid The ID of the remote user. @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: - 0.0: the remote sound comes from the front. - -1.0: the remote sound comes from the left. - 1.0: the remote sound comes from the right. - @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). + @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). The smaller the value, the less the gain. @return - 0: Success. - < 0: Failure. */ - virtual int setRemoteVoicePosition(int uid, double pan, double gain) = 0; + virtual int setRemoteVoicePosition(uid_t uid, double pan, double gain) = 0; /** Updates the display mode of the video view of a remote user. - After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. + After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. This method affects only the video view that the local user sees. @note - - Call this method after calling the \ref IChannel::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view. + - Call this method after calling the \ref agora::rtc::IRtcEngine::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view. - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. @param userId The ID of the remote user. @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. - @param mirrorMode + @param mirrorMode - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. - **Note**: The SDK disables the mirror mode by default. @@ -784,7 +997,14 @@ class IChannel - < 0: Failure. */ virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** Stops/Resumes receiving all remote users' audio streams by default. + /** Sets whether to receive all remote audio streams by default. + + You can call this method either before or after joining a channel. If you call `setDefaultMuteAllRemoteAudioStreams (true)` after joining a channel, the remote audio streams of all subsequent users are not received. + + @note If you want to resume receiving the audio stream, call \ref agora::rtc::IChannel::muteRemoteAudioStream "muteRemoteAudioStream (false)", + and specify the ID of the remote user whose audio stream you want to receive. + To receive the audio streams of multiple remote users, call `muteRemoteAudioStream (false)` as many times. + Calling `setDefaultMuteAllRemoteAudioStreams (false)` resumes receiving the audio streams of subsequent users only. @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: - true: Stops receiving all remote users' audio streams by default. @@ -795,7 +1015,18 @@ class IChannel - < 0: Failure. */ virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - /** Stops/Resumes receiving all remote users' video streams by default. + /** Sets whether to receive all remote video streams by default. + + You can call this method either before or after joining a channel. If you + call `setDefaultMuteAllRemoteVideoStreams (true)` after joining a channel, + the remote video streams of all subsequent users are not received. + + @note If you want to resume receiving the video stream, call + \ref agora::rtc::IChannel::muteRemoteVideoStream "muteRemoteVideoStream (false)", + and specify the ID of the remote user whose video stream you want to receive. + To receive the video streams of multiple remote users, call `muteRemoteVideoStream (false)` + as many times. Calling `setDefaultMuteAllRemoteVideoStreams (false)` resumes + receiving the video streams of subsequent users only. @param mute Sets whether to receive/stop receiving all remote users' video streams by default: - true: Stop receiving all remote users' video streams by default. @@ -819,29 +1050,32 @@ class IChannel virtual int muteAllRemoteAudioStreams(bool mute) = 0; /** Adjust the playback volume of the specified remote user. - After joining a channel, call \ref agora::rtc::IChannel::adjustPlaybackSignalVolume "adjustPlaybackSignalVolume" to adjust the playback volume of different remote users, + After joining a channel, call \ref agora::rtc::IRtcEngine::adjustPlaybackSignalVolume "adjustPlaybackSignalVolume" to adjust the playback volume of different remote users, or adjust multiple times for one remote user. - + @note - Call this method after joining a channel. - This method adjusts the playback volume, which is the mixed volume for the specified remote user. - - This method can only adjust the playback volume of one specified remote user at a time. If you want to adjust the playback volume of several remote users, + - This method can only adjust the playback volume of one specified remote user at a time. If you want to adjust the playback volume of several remote users, call the method multiple times, once for each remote user. - @param uid The user ID, which should be the same as the `uid` of \ref agora::rtc::IChannel::joinChannel "joinChannel" + @param userId The user ID, which should be the same as the `uid` of \ref agora::rtc::IChannel::joinChannel "joinChannel" @param volume The playback volume of the voice. The value ranges from 0 to 100: - 0: Mute. - 100: Original volume. @return - 0: Success. - - < 0: Failure. + - < 0: Failure. */ virtual int adjustUserPlaybackSignalVolume(uid_t userId, int volume) = 0; /** Stops/Resumes receiving a specified remote user's audio stream. - @note If you called the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set `mute` as `true` to stop - receiving all remote users' audio streams, call the m`uteAllRemoteAudioStreams` method and set `mute` as `false` before calling this method. + @note + - You can call this method either before or after joining a channel. If you call it before joining a channel, + you need to maintain the `uid` of the remote user on your app level. + - If you called the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set `mute` as `true` to stop + receiving all remote users' audio streams, call the `muteAllRemoteAudioStreams` method and set `mute` as `false` before calling this method. The `muteAllRemoteAudioStreams` method sets all remote audio streams, while the `muteRemoteAudioStream` method sets a specified remote audio stream. @param userId The user ID of the specified remote user sending the audio. @@ -857,7 +1091,9 @@ class IChannel virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; /** Stops/Resumes receiving all video stream from a specified remote user. - @param mute Sets whether to receive/stop receiving all remote users' video streams: + @note You can call this method either before or after joining a channel. + + @param mute Sets whether to receive/stop receiving all remote users' video streams: - true: Stop receiving all remote users' video streams. - false: (Default) Receive all remote users' video streams. @@ -868,8 +1104,11 @@ class IChannel virtual int muteAllRemoteVideoStreams(bool mute) = 0; /** Stops/Resumes receiving the video stream from a specified remote user. - @note If you called the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and - set `mute` as `true` to stop receiving all remote video streams, call the `muteAllRemoteVideoStreams` method and + @note + - You can call this method either before or after joining a channel. If you call it before joining a channel, you + need to maintain the `uid` of the remote user on your app level. + - If you called the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and + set `mute` as `true` to stop receiving all remote video streams, call the `muteAllRemoteVideoStreams` method and set `mute` as `false` before calling this method. @param userId The user ID of the specified remote user. @@ -882,18 +1121,21 @@ class IChannel - < 0: Failure. */ virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; - /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. + /** Sets the stream type of the remote video. - This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. + Under limited network conditions, if the publisher has not disabled the dual-stream mode using + \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" (false), + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). - - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IChannel::enableDualStreamMode "enableDualStreamMode" method, - the SDK receives the high-stream video by default. - - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. - The method result returns in the \ref agora::rtc::IChannelEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - The SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. - By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, - the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. + The aspect ratio of the low-video stream is the same as the high-quality video stream. Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. + + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. @param userId The ID of the remote user sending the video stream. @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -902,14 +1144,20 @@ class IChannel - < 0: Failure. */ virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. + /** Sets the default stream type of remote videos. + + Under limited network conditions, if the publisher has not disabled the dual-stream mode using + \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" (false), + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). - - If the dual-stream mode is enabled by calling the \ref agora::rtc::IChannel::enableDualStreamMode "enableDualStreamMode" method, - the user receives the high-stream video by default. The `setRemoteDefaultVideoStreamType` method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. - - If the dual-stream mode is not enabled, the user receives the high-stream video by default. + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. The aspect ratio of the low-video stream is the same as the high-quality video stream. + Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - The result after calling this method is returned in the \ref agora::rtc::IChannelEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -922,13 +1170,15 @@ class IChannel Each user can create up to five data streams during the lifecycle of the IChannel. - @note Set both the `reliable` and `ordered` parameters to `true` or `false`. Do not set one as `true` and the other as `false`. + @note + - Set both the `reliable` and `ordered` parameters to `true` or `false`. Do not set one as `true` and the other as `false`. + - Ensure that you call this method after joining a channel. - @param streamId The ID of the created data stream. + @param[out] streamId The ID of the created data stream. @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: - - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, + - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, an error is reported to the application. - - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for + - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for any delay or missing data stream. @param ordered Sets whether or not the recipients receive the data stream in the sent order: - true: The recipients receive the data stream in the sent order. @@ -946,14 +1196,15 @@ class IChannel - Each client can send up to 6 kB of data per second. - Each user can have up to five data streams simultaneously. - A successful \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers + A successful \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IChannelEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. - A failed \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers + A failed \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IChannelEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. - @note This method applies only to the Communication profile or to the hosts in the Live-broadcast profile. - If an audience in the Live-broadcast profile calls this method, the audience may be switched to a host. + @note + - This method applies only to the `COMMUNICATION` profile or to the hosts in the `LIVE_BROADCASTING` profile. If an audience in the `LIVE_BROADCASTING` profile calls this method, the audience may be switched to a host. + - Ensure that you have created the data stream using \ref agora::rtc::IChannel::createDataStream "createDataStream" before calling this method. @param streamId The ID of the sent data stream, returned in the \ref IChannel::createDataStream "createDataStream" method. @param data The sent data. @@ -966,15 +1217,15 @@ class IChannel virtual int sendStreamMessage(int streamId, const char* data, size_t length) = 0; /** Publishes the local stream to a specified CDN live RTMP address. (CDN live only.) - The SDK returns the result of this method call in the \ref IChannelEventHandler::onStreamPublished "onStreamPublished" callback. + The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback. - The \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" method call triggers - the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client + The \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" method call triggers + the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of adding a local stream to the CDN. @note - Ensure that the user joins the channel before calling this method. - - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*. - This method adds only one stream RTMP URL address each time it is called. @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. The RTMP URL address must not contain special characters, such as Chinese language characters. @@ -989,14 +1240,14 @@ class IChannel - #ERR_NOT_INITIALIZED (7): You have not initialized `IChannel` when publishing the stream. */ virtual int addPublishStreamUrl(const char *url, bool transcodingEnabled) = 0; - /** Removes an RTMP stream from the CDN. + /** Removes an RTMP stream from the CDN. - This method removes the RTMP URL address (added by the \ref IChannel::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. - The SDK returns the result of this method call in the \ref IChannelEventHandler::onStreamUnpublished "onStreamUnpublished" callback. + This method removes the RTMP URL address (added by the \ref IChannel::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. + The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamUnpublished "onStreamUnpublished" callback. - The \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method call triggers + The \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method call triggers the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP stream from the CDN. - + @note - This method removes only one RTMP URL address each time it is called. - The RTMP URL address must not contain special characters, such as Chinese language characters. @@ -1009,14 +1260,15 @@ class IChannel */ virtual int removePublishStreamUrl(const char *url) = 0; /** Sets the video layout and audio settings for CDN live. (CDN live only.) - - The SDK triggers the \ref agora::rtc::IChannelEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you + + The SDK triggers the \ref agora::rtc::IChannelEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you call the `setLiveTranscoding` method to update the transcoding setting. - + @note - - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). - - If you call the `setLiveTranscoding` method to update the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - + - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*.. + - If you call the `setLiveTranscoding` method to set the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + - Ensure that you call this method after joining a channel. + @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. @return @@ -1024,10 +1276,10 @@ class IChannel - < 0: Failure. */ virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; - /** Adds a voice or video stream URL address to a live broadcast. + /** Adds a voice or video stream URL address to the interactive live streaming. - The \ref IChannelEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. - If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. + The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. + If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. The \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: @@ -1038,12 +1290,15 @@ class IChannel - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. @note - - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*. - This method applies to the Native SDK v2.4.1 and later. + - This method applies to the `LIVE_BROADCASTING` profile only. + - You can inject only one media stream into the channel at the same time. + - Ensure that you call this method after joining a channel. - @param url The URL address to be added to the ongoing live broadcast. Valid protocols are RTMP, HLS, and FLV. - - Supported FLV audio codec type: AAC. - - Supported FLV video codec type: H264 (AVC). + @param url The URL address to be added to the ongoing live streaming. Valid protocols are RTMP, HLS, and HTTP-FLV. + - Supported audio codec type: AAC. + - Supported video codec type: H264 (AVC). @param config The InjectStreamConfig object that contains the configuration of the added voice or video stream. @return @@ -1051,13 +1306,13 @@ class IChannel - < 0: Failure. - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. - #ERR_NOT_READY (3): The user is not in the channel. - - #ERR_NOT_SUPPORTED (4): The channel profile is not live broadcast. Call the \ref agora::rtc::IChannel::setChannelProfile "setChannelProfile" method and set the channel profile to live broadcast before calling this method. + - #ERR_NOT_SUPPORTED (4): The channel profile is not `LIVE_BROADCASTING`. Call the \ref IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to `LIVE_BROADCASTING` before calling this method. - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IChannel object is initialized before calling this method. */ virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; - /** Removes the voice or video stream URL address from a live broadcast. + /** Removes the voice or video stream URL address from a live streaming. - This method removes the URL address (added by the \ref IChannel::addInjectStreamUrl "addInjectStreamUrl" method) from the live broadcast. + This method removes the URL address (added by the \ref IChannel::addInjectStreamUrl "addInjectStreamUrl" method) from the live streaming. @note If this method is called successfully, the SDK triggers the \ref IChannelEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. @@ -1082,7 +1337,7 @@ class IChannel * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent * "onChannelMediaRelayEvent" callback returns - * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the broadcaster starts + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the host starts * sending data to the destination channel. * - If the * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged @@ -1092,8 +1347,8 @@ class IChannel * * @note * - Call this method after the \ref joinChannel() "joinChannel" method. - * - This method takes effect only when you are a broadcaster in a - * Live-broadcast channel. + * - This method takes effect only when you are a host in a + * `LIVE_BROADCASTING` channel. * - After a successful method call, if you want to call this method * again, ensure that you call the * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the @@ -1109,7 +1364,9 @@ class IChannel * - < 0: Failure. */ virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; - /** Updates the channels for media stream relay. After a successful + /** Updates the channels for media stream relay. + * + * After a successful * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if * you want to relay the media stream to more channels, or leave the * current relay channel, you can call the @@ -1135,13 +1392,13 @@ class IChannel virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Stops the media stream relay. * - * Once the relay stops, the broadcaster quits all the destination + * Once the relay stops, the host quits all the destination * channels. * * After a successful method call, the SDK triggers the * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged * "onChannelMediaRelayStateChanged" callback. If the callback returns - * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the broadcaster successfully + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the host successfully * stops the relay. * * @note @@ -1160,39 +1417,100 @@ class IChannel virtual int stopChannelMediaRelay() = 0; /** Gets the current connection state of the SDK. + @note You can call this method either before or after joining a channel. + @return #CONNECTION_STATE_TYPE. */ virtual CONNECTION_STATE_TYPE getConnectionState() = 0; + /// @cond + /** Enables/Disables the super-resolution algorithm for a remote user's video stream. + * + * @since v3.2.0 + * + * The algorithm effectively improves the resolution of the specified remote user's video stream. When the original + * resolution of the remote video stream is a × b pixels, you can receive and render the stream at a higher + * resolution (2a × 2b pixels) by enabling the algorithm. + * + * After calling this method, the SDK triggers the + * \ref IRtcChannelEventHandler::onUserSuperResolutionEnabled "onUserSuperResolutionEnabled" callback to report + * whether you have successfully enabled the super-resolution algorithm. + * + * @warning The super-resolution algorithm requires extra system resources. + * To balance the visual experience and system usage, the SDK poses the following restrictions: + * - The algorithm can only be used for a single user at a time. + * - On the Android platform, the original resolution of the remote video must not exceed 640 × 360 pixels. + * - On the iOS platform, the original resolution of the remote video must not exceed 640 × 480 pixels. + * If you exceed these limitations, the SDK triggers the \ref IRtcChannelEventHandler::onWarning "onWarning" + * callback with the corresponding warning codes: + * - #WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION (1610): The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. + * - #WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION (1611): Another user is already using the super-resolution algorithm. + * - #WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED (1612): The device does not support the super-resolution algorithm. + * + * @note + * - This method applies to Android and iOS only. + * - Requirements for the user's device: + * - Android: The following devices are known to support the method: + * - VIVO: V1821A, NEX S, 1914A, 1916A, and 1824BA + * - OPPO: PCCM00 + * - OnePlus: A6000 + * - Xiaomi: Mi 8, Mi 9, MIX3, and Redmi K20 Pro + * - SAMSUNG: SM-G9600, SM-G9650, SM-N9600, SM-G9708, SM-G960U, and SM-G9750 + * - HUAWEI: SEA-AL00, ELE-AL00, VOG-AL00, YAL-AL10, HMA-AL00, and EVR-AN00 + * - iOS: This method is supported on devices running iOS 12.0 or later. The following + * device models are known to support the method: + * - iPhone XR + * - iPhone XS + * - iPhone XS Max + * - iPhone 11 + * - iPhone 11 Pro + * - iPhone 11 Pro Max + * - iPad Pro 11-inch (3rd Generation) + * - iPad Pro 12.9-inch (3rd Generation) + * - iPad Air 3 (3rd Generation) + * + * @param userId The ID of the remote user. + * @param enable Whether to enable the super-resolution algorithm: + * - true: Enable the super-resolution algorithm. + * - false: Disable the super-resolution algorithm. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableRemoteSuperResolution(uid_t userId, bool enable) = 0; + /// @endcond }; -/** The IRtcEngine2 class. */ +/** @since v3.0.0 + + The IRtcEngine2 class. */ class IRtcEngine2 : public IRtcEngine { public: - + /** Creates and gets an `IChannel` object. - To join more than one channel, call this method multiple times to create as many `IChannel` objects as needed, and + To join more than one channel, call this method multiple times to create as many `IChannel` objects as needed, and call the \ref agora::rtc::IChannel::joinChannel "joinChannel" method of each created `IChannel` object. - + After joining multiple channels, you can simultaneously subscribe to streams of all the channels, but publish a stream in only one channel at one time. @param channelId The unique channel name for an Agora RTC session. It must be in the string format and not exceed 64 bytes in length. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @note - This parameter does not have a default value. You must set it. - Do not set it as the empty string "". Otherwise, the SDK returns #ERR_REFUSED (5). - @return + @return - The `IChannel` object, if the method call succeeds. - An empty pointer NULL, if the method call fails. - - #ERR_REFUSED(5), if you set channelId as the empty string "". + - `ERR_REFUSED(5)`, if you set channelId as the empty string "". */ virtual IChannel* createChannel(const char *channelId) = 0; - + }; diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h old mode 100755 new mode 100644 index ebc52f3..ab6b753 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h @@ -13,6 +13,10 @@ #include "AgoraBase.h" #include "IAgoraService.h" +#if defined(_WIN32) +#include "IAgoraMediaEngine.h" +#endif + namespace agora { namespace rtc { typedef unsigned int uid_t; @@ -145,16 +149,17 @@ enum MEDIA_ENGINE_EVENT_CODE_TYPE /** The states of the local user's audio mixing file. */ enum AUDIO_MIXING_STATE_TYPE{ - /** 710: The audio mixing file is playing. - */ + /** 710: The audio mixing file is playing after the method call of + * \ref IRtcEngine::startAudioMixing "startAudioMixing" or \ref IRtcEngine::resumeAudioMixing "resumeAudioMixing" succeeds. + */ AUDIO_MIXING_STATE_PLAYING = 710, - /** 711: The audio mixing file pauses playing. + /** 711: The audio mixing file pauses playing after the method call of \ref IRtcEngine::pauseAudioMixing "pauseAudioMixing" succeeds. */ AUDIO_MIXING_STATE_PAUSED = 711, - /** 713: The audio mixing file stops playing. + /** 713: The audio mixing file stops playing after the method call of \ref IRtcEngine::stopAudioMixing "stopAudioMixing" succeeds. */ AUDIO_MIXING_STATE_STOPPED = 713, - /** 714: An exception occurs when playing the audio mixing file. See #AUDIO_MIXING_ERROR_TYPE. + /** 714: An exception occurs during the playback of the audio mixing file. See the `errorCode` for details. */ AUDIO_MIXING_STATE_FAILED = 714, }; @@ -222,31 +227,50 @@ enum MEDIA_DEVICE_TYPE */ enum LOCAL_VIDEO_STREAM_STATE { - /** Initial state */ + /** 0: Initial state */ LOCAL_VIDEO_STREAM_STATE_STOPPED = 0, - /** The capturer starts successfully. */ + /** 1: The local video capturing device starts successfully. + * + * The SDK also reports this state when you share a maximized window by calling \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId". + */ LOCAL_VIDEO_STREAM_STATE_CAPTURING = 1, - /** The first video frame is successfully encoded. */ + /** 2: The first video frame is successfully encoded. */ LOCAL_VIDEO_STREAM_STATE_ENCODING = 2, - /** The local video fails to start. */ + /** 3: The local video fails to start. */ LOCAL_VIDEO_STREAM_STATE_FAILED = 3 }; /** Local video state error codes */ enum LOCAL_VIDEO_STREAM_ERROR { - /** The local video is normal. */ + /** 0: The local video is normal. */ LOCAL_VIDEO_STREAM_ERROR_OK = 0, - /** No specified reason for the local video failure. */ + /** 1: No specified reason for the local video failure. */ LOCAL_VIDEO_STREAM_ERROR_FAILURE = 1, - /** No permission to use the local video capturing device. */ + /** 2: No permission to use the local video capturing device. */ LOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSION = 2, - /** The local video capturing device is in use. */ + /** 3: The local video capturing device is in use. */ LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY = 3, - /** The local video capture fails. Check whether the capturing device is working properly. */ + /** 4: The local video capture fails. Check whether the capturing device is working properly. */ LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE = 4, - /** The local video encoding fails. */ - LOCAL_VIDEO_STREAM_ERROR_ENCODE_FAILURE = 5 + /** 5: The local video encoding fails. */ + LOCAL_VIDEO_STREAM_ERROR_ENCODE_FAILURE = 5, + /** 11: The shared window is minimized when you call \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" to share a window. + */ + LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_MINIMIZED = 11, + /** 12: The error code indicates that a window shared by the window ID has been closed, or a full-screen window + * shared by the window ID has exited full-screen mode. + * After exiting full-screen mode, remote users cannot see the shared window. To prevent remote users from seeing a + * black screen, Agora recommends that you immediately stop screen sharing. + * + * Common scenarios for reporting this error code: + * - When the local user closes the shared window, the SDK reports this error code. + * - The local user shows some slides in full-screen mode first, and then shares the windows of the slides. After + * the user exits full-screen mode, the SDK reports this error code. + * - The local user watches web video or reads web document in full-screen mode first, and then shares the window of + * the web video or document. After the user exits full-screen mode, the SDK reports this error code. + */ + LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_CLOSED = 12, }; /** Local audio state types. @@ -347,12 +371,16 @@ enum RENDER_MODE_TYPE /** **DEPRECATED** 3: This mode is deprecated. */ RENDER_MODE_ADAPTIVE = 3, + /** + 4: The fill mode. In this mode, the SDK stretches or zooms the video to fill the display window. + */ + RENDER_MODE_FILL = 4, }; /** Video mirror modes. */ enum VIDEO_MIRROR_MODE_TYPE { - /** 0: (Default) The SDK enables the mirror mode. + /** 0: (Default) The SDK enables the mirror mode. */ VIDEO_MIRROR_MODE_AUTO = 0,//determined by SDK /** 1: Enable mirror mode. */ @@ -364,159 +392,159 @@ enum VIDEO_MIRROR_MODE_TYPE /** **DEPRECATED** Video profiles. */ enum VIDEO_PROFILE_TYPE { - /** 0: 160 × 120, frame rate 15 fps, bitrate 65 Kbps. */ + /** 0: 160 * 120, frame rate 15 fps, bitrate 65 Kbps. */ VIDEO_PROFILE_LANDSCAPE_120P = 0, - /** 2: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ + /** 2: 120 * 120, frame rate 15 fps, bitrate 50 Kbps. */ VIDEO_PROFILE_LANDSCAPE_120P_3 = 2, - /** 10: 320×180, frame rate 15 fps, bitrate 140 Kbps. */ + /** 10: 320*180, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P = 10, - /** 12: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ + /** 12: 180 * 180, frame rate 15 fps, bitrate 100 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P_3 = 12, - /** 13: 240 × 180, frame rate 15 fps, bitrate 120 Kbps. */ + /** 13: 240 * 180, frame rate 15 fps, bitrate 120 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P_4 = 13, - /** 20: 320 × 240, frame rate 15 fps, bitrate 200 Kbps. */ + /** 20: 320 * 240, frame rate 15 fps, bitrate 200 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P = 20, - /** 22: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ + /** 22: 240 * 240, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P_3 = 22, - /** 23: 424 × 240, frame rate 15 fps, bitrate 220 Kbps. */ + /** 23: 424 * 240, frame rate 15 fps, bitrate 220 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P_4 = 23, - /** 30: 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ + /** 30: 640 * 360, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P = 30, - /** 32: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ + /** 32: 360 * 360, frame rate 15 fps, bitrate 260 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_3 = 32, - /** 33: 640 × 360, frame rate 30 fps, bitrate 600 Kbps. */ + /** 33: 640 * 360, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_4 = 33, - /** 35: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ + /** 35: 360 * 360, frame rate 30 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_6 = 35, - /** 36: 480 × 360, frame rate 15 fps, bitrate 320 Kbps. */ + /** 36: 480 * 360, frame rate 15 fps, bitrate 320 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_7 = 36, - /** 37: 480 × 360, frame rate 30 fps, bitrate 490 Kbps. */ + /** 37: 480 * 360, frame rate 30 fps, bitrate 490 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_8 = 37, - /** 38: 640 × 360, frame rate 15 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 38: 640 * 360, frame rate 15 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_9 = 38, - /** 39: 640 × 360, frame rate 24 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 39: 640 * 360, frame rate 24 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_10 = 39, - /** 100: 640 × 360, frame rate 24 fps, bitrate 1000 Kbps. - @note Live broadcast profile only. + /** 100: 640 * 360, frame rate 24 fps, bitrate 1000 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_11 = 100, - /** 40: 640 × 480, frame rate 15 fps, bitrate 500 Kbps. */ + /** 40: 640 * 480, frame rate 15 fps, bitrate 500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P = 40, - /** 42: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ + /** 42: 480 * 480, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_3 = 42, - /** 43: 640 × 480, frame rate 30 fps, bitrate 750 Kbps. */ + /** 43: 640 * 480, frame rate 30 fps, bitrate 750 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_4 = 43, - /** 45: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ + /** 45: 480 * 480, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_6 = 45, - /** 47: 848 × 480, frame rate 15 fps, bitrate 610 Kbps. */ + /** 47: 848 * 480, frame rate 15 fps, bitrate 610 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_8 = 47, - /** 48: 848 × 480, frame rate 30 fps, bitrate 930 Kbps. */ + /** 48: 848 * 480, frame rate 30 fps, bitrate 930 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_9 = 48, - /** 49: 640 × 480, frame rate 10 fps, bitrate 400 Kbps. */ + /** 49: 640 * 480, frame rate 10 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_10 = 49, - /** 50: 1280 × 720, frame rate 15 fps, bitrate 1130 Kbps. */ + /** 50: 1280 * 720, frame rate 15 fps, bitrate 1130 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P = 50, - /** 52: 1280 × 720, frame rate 30 fps, bitrate 1710 Kbps. */ + /** 52: 1280 * 720, frame rate 30 fps, bitrate 1710 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_3 = 52, - /** 54: 960 × 720, frame rate 15 fps, bitrate 910 Kbps. */ + /** 54: 960 * 720, frame rate 15 fps, bitrate 910 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_5 = 54, - /** 55: 960 × 720, frame rate 30 fps, bitrate 1380 Kbps. */ + /** 55: 960 * 720, frame rate 30 fps, bitrate 1380 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_6 = 55, - /** 60: 1920 × 1080, frame rate 15 fps, bitrate 2080 Kbps. */ + /** 60: 1920 * 1080, frame rate 15 fps, bitrate 2080 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P = 60, - /** 62: 1920 × 1080, frame rate 30 fps, bitrate 3150 Kbps. */ + /** 62: 1920 * 1080, frame rate 30 fps, bitrate 3150 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P_3 = 62, - /** 64: 1920 × 1080, frame rate 60 fps, bitrate 4780 Kbps. */ + /** 64: 1920 * 1080, frame rate 60 fps, bitrate 4780 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P_5 = 64, - /** 66: 2560 × 1440, frame rate 30 fps, bitrate 4850 Kbps. */ + /** 66: 2560 * 1440, frame rate 30 fps, bitrate 4850 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1440P = 66, - /** 67: 2560 × 1440, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 67: 2560 * 1440, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1440P_2 = 67, - /** 70: 3840 × 2160, frame rate 30 fps, bitrate 6500 Kbps. */ + /** 70: 3840 * 2160, frame rate 30 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_4K = 70, - /** 72: 3840 × 2160, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 72: 3840 * 2160, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_4K_3 = 72, - /** 1000: 120 × 160, frame rate 15 fps, bitrate 65 Kbps. */ + /** 1000: 120 * 160, frame rate 15 fps, bitrate 65 Kbps. */ VIDEO_PROFILE_PORTRAIT_120P = 1000, - /** 1002: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ + /** 1002: 120 * 120, frame rate 15 fps, bitrate 50 Kbps. */ VIDEO_PROFILE_PORTRAIT_120P_3 = 1002, - /** 1010: 180 × 320, frame rate 15 fps, bitrate 140 Kbps. */ + /** 1010: 180 * 320, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P = 1010, - /** 1012: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ + /** 1012: 180 * 180, frame rate 15 fps, bitrate 100 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P_3 = 1012, - /** 1013: 180 × 240, frame rate 15 fps, bitrate 120 Kbps. */ + /** 1013: 180 * 240, frame rate 15 fps, bitrate 120 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P_4 = 1013, - /** 1020: 240 × 320, frame rate 15 fps, bitrate 200 Kbps. */ + /** 1020: 240 * 320, frame rate 15 fps, bitrate 200 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P = 1020, - /** 1022: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ + /** 1022: 240 * 240, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P_3 = 1022, - /** 1023: 240 × 424, frame rate 15 fps, bitrate 220 Kbps. */ + /** 1023: 240 * 424, frame rate 15 fps, bitrate 220 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P_4 = 1023, - /** 1030: 360 × 640, frame rate 15 fps, bitrate 400 Kbps. */ + /** 1030: 360 * 640, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P = 1030, - /** 1032: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ + /** 1032: 360 * 360, frame rate 15 fps, bitrate 260 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_3 = 1032, - /** 1033: 360 × 640, frame rate 30 fps, bitrate 600 Kbps. */ + /** 1033: 360 * 640, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_4 = 1033, - /** 1035: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ + /** 1035: 360 * 360, frame rate 30 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_6 = 1035, - /** 1036: 360 × 480, frame rate 15 fps, bitrate 320 Kbps. */ + /** 1036: 360 * 480, frame rate 15 fps, bitrate 320 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_7 = 1036, - /** 1037: 360 × 480, frame rate 30 fps, bitrate 490 Kbps. */ + /** 1037: 360 * 480, frame rate 30 fps, bitrate 490 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_8 = 1037, - /** 1038: 360 × 640, frame rate 15 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 1038: 360 * 640, frame rate 15 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_PORTRAIT_360P_9 = 1038, - /** 1039: 360 × 640, frame rate 24 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 1039: 360 * 640, frame rate 24 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_PORTRAIT_360P_10 = 1039, - /** 1100: 360 × 640, frame rate 24 fps, bitrate 1000 Kbps. - @note Live broadcast profile only. + /** 1100: 360 * 640, frame rate 24 fps, bitrate 1000 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_PORTRAIT_360P_11 = 1100, - /** 1040: 480 × 640, frame rate 15 fps, bitrate 500 Kbps. */ + /** 1040: 480 * 640, frame rate 15 fps, bitrate 500 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P = 1040, - /** 1042: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ + /** 1042: 480 * 480, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_3 = 1042, - /** 1043: 480 × 640, frame rate 30 fps, bitrate 750 Kbps. */ + /** 1043: 480 * 640, frame rate 30 fps, bitrate 750 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_4 = 1043, - /** 1045: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ + /** 1045: 480 * 480, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_6 = 1045, - /** 1047: 480 × 848, frame rate 15 fps, bitrate 610 Kbps. */ + /** 1047: 480 * 848, frame rate 15 fps, bitrate 610 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_8 = 1047, - /** 1048: 480 × 848, frame rate 30 fps, bitrate 930 Kbps. */ + /** 1048: 480 * 848, frame rate 30 fps, bitrate 930 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_9 = 1048, - /** 1049: 480 × 640, frame rate 10 fps, bitrate 400 Kbps. */ + /** 1049: 480 * 640, frame rate 10 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_10 = 1049, - /** 1050: 720 × 1280, frame rate 15 fps, bitrate 1130 Kbps. */ + /** 1050: 720 * 1280, frame rate 15 fps, bitrate 1130 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P = 1050, - /** 1052: 720 × 1280, frame rate 30 fps, bitrate 1710 Kbps. */ + /** 1052: 720 * 1280, frame rate 30 fps, bitrate 1710 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_3 = 1052, - /** 1054: 720 × 960, frame rate 15 fps, bitrate 910 Kbps. */ + /** 1054: 720 * 960, frame rate 15 fps, bitrate 910 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_5 = 1054, - /** 1055: 720 × 960, frame rate 30 fps, bitrate 1380 Kbps. */ + /** 1055: 720 * 960, frame rate 30 fps, bitrate 1380 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_6 = 1055, - /** 1060: 1080 × 1920, frame rate 15 fps, bitrate 2080 Kbps. */ + /** 1060: 1080 * 1920, frame rate 15 fps, bitrate 2080 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P = 1060, - /** 1062: 1080 × 1920, frame rate 30 fps, bitrate 3150 Kbps. */ + /** 1062: 1080 * 1920, frame rate 30 fps, bitrate 3150 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P_3 = 1062, - /** 1064: 1080 × 1920, frame rate 60 fps, bitrate 4780 Kbps. */ + /** 1064: 1080 * 1920, frame rate 60 fps, bitrate 4780 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P_5 = 1064, - /** 1066: 1440 × 2560, frame rate 30 fps, bitrate 4850 Kbps. */ + /** 1066: 1440 * 2560, frame rate 30 fps, bitrate 4850 Kbps. */ VIDEO_PROFILE_PORTRAIT_1440P = 1066, - /** 1067: 1440 × 2560, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 1067: 1440 * 2560, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_1440P_2 = 1067, - /** 1070: 2160 × 3840, frame rate 30 fps, bitrate 6500 Kbps. */ + /** 1070: 2160 * 3840, frame rate 30 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_4K = 1070, - /** 1072: 2160 × 3840, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 1072: 2160 * 3840, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_4K_3 = 1072, - /** Default 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ + /** Default 640 * 360, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_DEFAULT = VIDEO_PROFILE_LANDSCAPE_360P, }; @@ -525,31 +553,32 @@ enum VIDEO_PROFILE_TYPE Sets the sample rate, bitrate, encoding mode, and the number of channels:*/ enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music codec { - /** - 0: Default audio profile. - - - In the Communication profile, the default value is #AUDIO_PROFILE_SPEECH_STANDARD; - - In the Live-broadcast profile, the default value is #AUDIO_PROFILE_MUSIC_STANDARD. - */ + /** + 0: Default audio profile: + - For the interactive streaming profile: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 64 Kbps. + - For the `COMMUNICATION` profile: + - Windows: A sample rate of 16 KHz, music encoding, mono, and a bitrate of up to 16 Kbps. + - Android/macOS/iOS: A sample rate of 32 KHz, music encoding, mono, and a bitrate of up to 18 Kbps. + */ AUDIO_PROFILE_DEFAULT = 0, // use default settings /** 1: A sample rate of 32 KHz, audio encoding, mono, and a bitrate of up to 18 Kbps. */ AUDIO_PROFILE_SPEECH_STANDARD = 1, // 32Khz, 18Kbps, mono, speech /** - 2: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 48 Kbps. + 2: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 64 Kbps. */ AUDIO_PROFILE_MUSIC_STANDARD = 2, // 48Khz, 48Kbps, mono, music /** - 3: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 56 Kbps. + 3: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 80 Kbps. */ AUDIO_PROFILE_MUSIC_STANDARD_STEREO = 3, // 48Khz, 56Kbps, stereo, music /** - 4: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 128 Kbps. + 4: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 96 Kbps. */ AUDIO_PROFILE_MUSIC_HIGH_QUALITY = 4, // 48Khz, 128Kbps, mono, music /** - 5: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 192 Kbps. + 5: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 128 Kbps. */ AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO = 5, // 48Khz, 192Kbps, stereo, music /** @@ -563,48 +592,91 @@ enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music code */ enum AUDIO_SCENARIO_TYPE // set a suitable scenario for your app type { - /** 0: Default. */ + /** 0: Default audio scenario. */ AUDIO_SCENARIO_DEFAULT = 0, - /** 1: Entertainment scenario, supporting voice during gameplay. */ + /** 1: Entertainment scenario where users need to frequently switch the user role. */ AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT = 1, - /** 2: Education scenario, prioritizing smoothness and stability. */ + /** 2: Education scenario where users want smoothness and stability. */ AUDIO_SCENARIO_EDUCATION = 2, - /** 3: Live gaming scenario, enabling the gaming audio effects in the speaker mode in a live broadcast scenario. Choose this scenario for high-fidelity music playback. */ + /** 3: High-quality audio chatroom scenario where hosts mainly play music. */ AUDIO_SCENARIO_GAME_STREAMING = 3, - /** 4: Showroom scenario, optimizing the audio quality with external professional equipment. */ + /** 4: Showroom scenario where a single host wants high-quality audio. */ AUDIO_SCENARIO_SHOWROOM = 4, - /** 5: Gaming scenario. */ + /** 5: Gaming scenario for group chat that only contains the human voice. */ AUDIO_SCENARIO_CHATROOM_GAMING = 5, - /** 6: Applicable to the IoT scenario. */ + /** 6: IoT (Internet of Things) scenario where users use IoT devices with low power consumption. */ AUDIO_SCENARIO_IOT = 6, - AUDIO_SCENARIO_NUM = 7, + /** 8: Meeting scenario that mainly contains the human voice. + * + * @since v3.2.0 + */ + AUDIO_SCENARIO_MEETING = 8, + /** The number of elements in the enumeration. + */ + AUDIO_SCENARIO_NUM = 9, }; - /** The channel profile of the Agora RtcEngine. + /** The channel profile. */ enum CHANNEL_PROFILE_TYPE { - /** (Default) The Communication profile. Use this profile in one-on-one calls or group calls, where all users can talk freely. + /** (Default) Communication. This profile applies to scenarios such as an audio call or video call, + * where all users can publish and subscribe to streams. */ - CHANNEL_PROFILE_COMMUNICATION = 0, - /** The Live-Broadcast profile. Users in a live-broadcast channel have a role as either broadcaster or audience. - A broadcaster can both send and receive streams; an audience can only receive streams. + CHANNEL_PROFILE_COMMUNICATION = 0, + /** Live streaming. In this profile, uses have roles, namely, host and audience (default). + * A host both publishes and subscribes to streams, while an audience subscribes to streams only. + * This profile applies to scenarios such as a chat room or interactive video streaming. */ - CHANNEL_PROFILE_LIVE_BROADCASTING = 1, - /** 2: The Gaming profile. This profile uses a codec with a lower bitrate and consumes less power. Applies to the gaming scenario, where all game players can talk freely. + CHANNEL_PROFILE_LIVE_BROADCASTING = 1, + /** 2: Gaming. This profile uses a codec with a lower bitrate and consumes less power. Applies to the gaming scenario, where all game players can talk freely. + * + * @note Agora does not recommend using this setting. */ CHANNEL_PROFILE_GAME = 2, }; - -/** Client roles in a live broadcast. */ +/// @cond +/** The role of a user in a live interactive streaming. */ enum CLIENT_ROLE_TYPE { - /** 1: Host */ + /** 1: Host. A host can both send and receive streams. */ CLIENT_ROLE_BROADCASTER = 1, - /** 2: Audience */ + /** 2: (Default) Audience. An `audience` member can only receive streams. */ CLIENT_ROLE_AUDIENCE = 2, }; +/** The latency level of an audience member in a live interactive streaming. + * + * @note Takes effect only when the user role is `CLIENT_ROLE_BROADCASTER`. + */ +enum AUDIENCE_LATENCY_LEVEL_TYPE +{ + /** 1: Low latency. */ + AUDIENCE_LATENCY_LEVEL_LOW_LATENCY = 1, + /** 2: (Default) Ultra low latency. */ + AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY = 2, +}; +/// @cond +/** The reason why the super-resolution algorithm is not successfully enabled. + */ +enum SUPER_RESOLUTION_STATE_REASON +{ + /** 0: The super-resolution algorithm is successfully enabled. + */ + SR_STATE_REASON_SUCCESS = 0, + /** 1: The origin resolution of the remote video is beyond the range where + * the super-resolution algorithm can be applied. + */ + SR_STATE_REASON_STREAM_OVER_LIMITATION = 1, + /** 2: Another user is already using the super-resolution algorithm. + */ + SR_STATE_REASON_USER_COUNT_OVER_LIMITATION = 2, + /** 3: The device does not support the super-resolution algorithm. + */ + SR_STATE_REASON_DEVICE_NOT_SUPPORTED = 3, +}; +/// @endcond + /** Reasons for a user being offline. */ enum USER_OFFLINE_REASON_TYPE { @@ -612,7 +684,7 @@ enum USER_OFFLINE_REASON_TYPE USER_OFFLINE_QUIT = 0, /** 1: The SDK times out and the user drops offline because no data packet is received within a certain period of time. If the user quits the call and the message is not passed to the SDK (due to an unreliable channel), the SDK assumes the user dropped offline. */ USER_OFFLINE_DROPPED = 1, - /** 2: (Live broadcast only.) The client role switched from the host to the audience. */ + /** 2: (`LIVE_BROADCASTING` only.) The client role switched from the host to the audience. */ USER_OFFLINE_BECOME_AUDIENCE = 2, }; /** @@ -669,7 +741,15 @@ enum RTMP_STREAM_PUBLISH_ERROR RTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTED = 10, }; -/** States of importing an external video stream in a live broadcast. */ +/** Events during the RTMP streaming. */ +enum RTMP_STREAMING_EVENT +{ + /** An error occurs when you add a background image or a watermark image to the RTMP stream. + */ + RTMP_STREAMING_EVENT_FAILED_LOAD_IMAGE = 1, +}; + +/** States of importing an external video stream in the live interactive streaming. */ enum INJECT_STREAM_STATUS { /** 0: The external video stream imported successfully. */ @@ -704,8 +784,9 @@ enum REMOTE_VIDEO_STREAM_TYPE REMOTE_VIDEO_STREAM_LOW = 1, }; -/** Use modes of the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. */ -enum RAW_AUDIO_FRAME_OP_MODE_TYPE +/** The use mode of the audio data in the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" or \ref media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + */ + enum RAW_AUDIO_FRAME_OP_MODE_TYPE { /** 0: Read-only mode: Users only read the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data without modifying anything. For example, when users acquire the data with the Agora SDK, then push the RTMP streams. */ RAW_AUDIO_FRAME_OP_MODE_READ_ONLY = 0, @@ -732,7 +813,7 @@ enum VIDEO_CODEC_PROFILE_TYPE VIDEO_CODEC_PROFILE_BASELINE = 66, /** 77: Main video codec profile. Generally used in mainstream electronics such as MP4 players, portable video players, PSP, and iPads. */ VIDEO_CODEC_PROFILE_MAIN = 77, - /** 100: (Default) High video codec profile. Generally used in high-resolution broadcasts or television. */ + /** 100: (Default) High video codec profile. Generally used in high-resolution live streaming or television. */ VIDEO_CODEC_PROFILE_HIGH = 100, }; @@ -748,6 +829,13 @@ enum VIDEO_CODEC_TYPE { VIDEO_CODEC_E264 = 4, }; +/** Video Codec types for publishing streams. */ +enum VIDEO_CODEC_TYPE_FOR_STREAM +{ + VIDEO_CODEC_H264_FOR_STREAM = 1, + VIDEO_CODEC_H265_FOR_STREAM = 2, +}; + /** Audio equalization band frequencies. */ enum AUDIO_EQUALIZATION_BAND_FREQUENCY { @@ -788,101 +876,410 @@ enum AUDIO_REVERB_TYPE AUDIO_REVERB_STRENGTH = 4, // ([0,100]), the strength of the reverberation }; -/** Local voice changer options. */ +/** + * @deprecated Deprecated from v3.2.0. + * + * Local voice changer options. + */ enum VOICE_CHANGER_PRESET { - /** 0: The original voice (no local voice change). - */ - VOICE_CHANGER_OFF = 0, //Turn off the voice changer - /** 1: An old man's voice. - */ - VOICE_CHANGER_OLDMAN = 1, - /** 2: A little boy's voice. - */ - VOICE_CHANGER_BABYBOY = 2, - /** 3: A little girl's voice. - */ - VOICE_CHANGER_BABYGIRL = 3, - /** 4: The voice of a growling bear. - */ - VOICE_CHANGER_ZHUBAJIE = 4, - /** 5: Ethereal vocal effects. - */ - VOICE_CHANGER_ETHEREAL = 5, - /** 6: Hulk's voice. - */ - VOICE_CHANGER_HULK = 6 + /** + * The original voice (no local voice change). + */ + VOICE_CHANGER_OFF = 0x00000000, //Turn off the voice changer + /** + * The voice of an old man. + */ + VOICE_CHANGER_OLDMAN = 0x00000001, + /** + * The voice of a little boy. + */ + VOICE_CHANGER_BABYBOY = 0x00000002, + /** + * The voice of a little girl. + */ + VOICE_CHANGER_BABYGIRL = 0x00000003, + /** + * The voice of Zhu Bajie, a character in Journey to the West who has a voice like that of a growling bear. + */ + VOICE_CHANGER_ZHUBAJIE = 0x00000004, + /** + * The ethereal voice. + */ + VOICE_CHANGER_ETHEREAL = 0x00000005, + /** + * The voice of Hulk. + */ + VOICE_CHANGER_HULK = 0x00000006, + /** + * A more vigorous voice. + */ + VOICE_BEAUTY_VIGOROUS = 0x00100001,//7, + /** + * A deeper voice. + */ + VOICE_BEAUTY_DEEP = 0x00100002, + /** + * A mellower voice. + */ + VOICE_BEAUTY_MELLOW = 0x00100003, + /** + * Falsetto. + */ + VOICE_BEAUTY_FALSETTO = 0x00100004, + /** + * A fuller voice. + */ + VOICE_BEAUTY_FULL = 0x00100005, + /** + * A clearer voice. + */ + VOICE_BEAUTY_CLEAR = 0x00100006, + /** + * A more resounding voice. + */ + VOICE_BEAUTY_RESOUNDING = 0x00100007, + /** + * A more ringing voice. + */ + VOICE_BEAUTY_RINGING = 0x00100008, + /** + * A more spatially resonant voice. + */ + VOICE_BEAUTY_SPACIAL = 0x00100009, + /** + * (For male only) A more magnetic voice. Do not use it when the speaker is a female; otherwise, voice distortion occurs. + */ + GENERAL_BEAUTY_VOICE_MALE_MAGNETIC = 0x00200001, + /** + * (For female only) A fresher voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs. + */ + GENERAL_BEAUTY_VOICE_FEMALE_FRESH = 0x00200002, + /** + * (For female only) A more vital voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs. + */ + GENERAL_BEAUTY_VOICE_FEMALE_VITALITY = 0x00200003 + }; -/** Local voice reverberation presets. */ +/** @deprecated Deprecated from v3.2.0. + * + * Local voice reverberation presets. + */ enum AUDIO_REVERB_PRESET { - /** 0: The original voice (no local voice reverberation). - */ - AUDIO_REVERB_OFF = 0, // Turn off audio reverb - /** 1: Pop music. - */ - AUDIO_REVERB_POPULAR = 1, - /** 2: R&B. - */ - AUDIO_REVERB_RNB = 2, - /** 3: Rock music. - */ - AUDIO_REVERB_ROCK = 3, - /** 4: Hip-hop. - */ - AUDIO_REVERB_HIPHOP = 4, - /** 5: Pop concert. - */ - AUDIO_REVERB_VOCAL_CONCERT = 5, - /** 6: Karaoke. - */ - AUDIO_REVERB_KTV = 6, - /** 7: Recording studio. - */ - AUDIO_REVERB_STUDIO = 7 + /** + * Turn off local voice reverberation, that is, to use the original voice. + */ + AUDIO_REVERB_OFF = 0x00000000, // Turn off audio reverb + /** + * The reverberation style typical of a KTV venue (enhanced). + */ + AUDIO_REVERB_FX_KTV = 0x00100001, + /** + * The reverberation style typical of a concert hall (enhanced). + */ + AUDIO_REVERB_FX_VOCAL_CONCERT = 0x00100002, + /** + * The reverberation style typical of an uncle's voice. + */ + AUDIO_REVERB_FX_UNCLE = 0x00100003, + /** + * The reverberation style typical of a little sister's voice. + */ + AUDIO_REVERB_FX_SISTER = 0x00100004, + /** + * The reverberation style typical of a recording studio (enhanced). + */ + AUDIO_REVERB_FX_STUDIO = 0x00100005, + /** + * The reverberation style typical of popular music (enhanced). + */ + AUDIO_REVERB_FX_POPULAR = 0x00100006, + /** + * The reverberation style typical of R&B music (enhanced). + */ + AUDIO_REVERB_FX_RNB = 0x00100007, + /** + * The reverberation style typical of the vintage phonograph. + */ + AUDIO_REVERB_FX_PHONOGRAPH = 0x00100008, + /** + * The reverberation style typical of popular music. + */ + AUDIO_REVERB_POPULAR = 0x00000001, + /** + * The reverberation style typical of R&B music. + */ + AUDIO_REVERB_RNB = 0x00000002, + /** + * The reverberation style typical of rock music. + */ + AUDIO_REVERB_ROCK = 0x00000003, + /** + * The reverberation style typical of hip-hop music. + */ + AUDIO_REVERB_HIPHOP = 0x00000004, + /** + * The reverberation style typical of a concert hall. + */ + AUDIO_REVERB_VOCAL_CONCERT = 0x00000005, + /** + * The reverberation style typical of a KTV venue. + */ + AUDIO_REVERB_KTV = 0x00000006, + /** + * The reverberation style typical of a recording studio. + */ + AUDIO_REVERB_STUDIO = 0x00000007, + /** + * The reverberation of the virtual stereo. The virtual stereo is an effect that renders the monophonic + * audio as the stereo audio, so that all users in the channel can hear the stereo voice effect. + * To achieve better virtual stereo reverberation, Agora recommends setting `profile` in `setAudioProfile` + * as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. + */ + AUDIO_VIRTUAL_STEREO = 0x00200001, + /** 1: Electronic Voice.*/ + AUDIO_ELECTRONIC_VOICE = 0x00300001, + /** 1: 3D Voice.*/ + AUDIO_THREEDIM_VOICE = 0x00400001 +}; +/** The options for SDK preset voice beautifier effects. + */ +enum VOICE_BEAUTIFIER_PRESET +{ + /** Turn off voice beautifier effects and use the original voice. + */ + VOICE_BEAUTIFIER_OFF = 0x00000000, + /** A more magnetic voice. + * + * @note Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may experience vocal distortion. + */ + CHAT_BEAUTIFIER_MAGNETIC = 0x01010100, + /** A fresher voice. + * + * @note Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion. + */ + CHAT_BEAUTIFIER_FRESH = 0x01010200, + /** A more vital voice. + * + * @note Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion. + */ + CHAT_BEAUTIFIER_VITALITY = 0x01010300, + /** A more vigorous voice. + */ + TIMBRE_TRANSFORMATION_VIGOROUS = 0x01030100, + /** A deeper voice. + */ + TIMBRE_TRANSFORMATION_DEEP = 0x01030200, + /** A mellower voice. + */ + TIMBRE_TRANSFORMATION_MELLOW = 0x01030300, + /** A falsetto voice. + */ + TIMBRE_TRANSFORMATION_FALSETTO = 0x01030400, + /** A falsetto voice. + */ + TIMBRE_TRANSFORMATION_FULL = 0x01030500, + /** A clearer voice. + */ + TIMBRE_TRANSFORMATION_CLEAR = 0x01030600, + /** A more resounding voice. + */ + TIMBRE_TRANSFORMATION_RESOUNDING = 0x01030700, + /** A more ringing voice. + */ + TIMBRE_TRANSFORMATION_RINGING = 0x01030800 +}; +/** The options for SDK preset audio effects. + */ +enum AUDIO_EFFECT_PRESET +{ + /** Turn off audio effects and use the original voice. + */ + AUDIO_EFFECT_OFF = 0x00000000, + /** An audio effect typical of a KTV venue. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_KTV = 0x02010100, + /** An audio effect typical of a concert hall. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_VOCAL_CONCERT = 0x02010200, + /** An audio effect typical of a recording studio. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_STUDIO = 0x02010300, + /** An audio effect typical of a vintage phonograph. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_PHONOGRAPH = 0x02010400, + /** A virtual stereo effect that renders monophonic audio as stereo audio. + * + * @note Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to + * `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this + * enumerator; otherwise, the enumerator setting does not take effect. + */ + ROOM_ACOUSTICS_VIRTUAL_STEREO = 0x02010500, + /** A more spatial audio effect. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_SPACIAL = 0x02010600, + /** A more ethereal audio effect. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_ETHEREAL = 0x02010700, + /** A 3D voice effect that makes the voice appear to be moving around the user. The default cycle period of the 3D + * voice effect is 10 seconds. To change the cycle period, call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" + * after this method. + * + * @note + * - Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` + * or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator; otherwise, the enumerator setting does not take effect. + * - If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect. + */ + ROOM_ACOUSTICS_3D_VOICE = 0x02010800, + /** The voice of an uncle. + * + * @note + * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_UNCLE = 0x02020100, + /** The voice of an old man. + * + * @note + * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting + * this enumerator. + */ + VOICE_CHANGER_EFFECT_OLDMAN = 0x02020200, + /** The voice of a boy. + * + * @note + * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_BOY = 0x02020300, + /** The voice of a young woman. + * + * @note + * - Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_SISTER = 0x02020400, + /** The voice of a girl. + * + * @note + * - Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_GIRL = 0x02020500, + /** The voice of Pig King, a character in Journey to the West who has a voice like a growling bear. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_PIGKING = 0x02020600, + /** The voice of Hulk. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_HULK = 0x02020700, + /** An audio effect typical of R&B music. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + STYLE_TRANSFORMATION_RNB = 0x02030100, + /** An audio effect typical of popular music. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + STYLE_TRANSFORMATION_POPULAR = 0x02030200, + /** A pitch correction effect that corrects the user's pitch based on the pitch of the natural C major scale. + * To change the basic mode and tonic pitch, call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" after this method. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + PITCH_CORRECTION = 0x02040100 }; /** Audio codec profile types. The default value is LC_ACC. */ enum AUDIO_CODEC_PROFILE_TYPE { /** 0: LC-AAC, which is the low-complexity audio codec type. */ - AUDIO_CODEC_PROFILE_LC_AAC = 0, + AUDIO_CODEC_PROFILE_LC_AAC = 0, /** 1: HE-AAC, which is the high-efficiency audio codec type. */ - AUDIO_CODEC_PROFILE_HE_AAC = 1, + AUDIO_CODEC_PROFILE_HE_AAC = 1, }; /** Remote audio states. */ enum REMOTE_AUDIO_STATE { - /** 0: The remote audio is in the default state, probably due to - * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), - * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or - * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). - */ - REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream - /** 1: The first remote audio packet is received. - */ - REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received - /** 2: The remote audio stream is decoded and plays normally, probably - * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), - * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or - * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). - */ - REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends - /** 3: The remote audio is frozen, probably due to - * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). - */ - REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue - /** 4: The remote audio fails to start, probably due to - * #REMOTE_AUDIO_REASON_INTERNAL (0). - */ - REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed + /** 0: The remote audio is in the default state, probably due to + * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), + * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or + * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). + */ + REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream + /** 1: The first remote audio packet is received. + */ + REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received + /** 2: The remote audio stream is decoded and plays normally, probably + * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), + * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or + * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). + */ + REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends + /** 3: The remote audio is frozen, probably due to + * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). + */ + REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue + /** 4: The remote audio fails to start, probably due to + * #REMOTE_AUDIO_REASON_INTERNAL (0). + */ + REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed }; /** Remote audio state reasons. */ enum REMOTE_AUDIO_STATE_REASON { - /** 0: Internal reasons. + /** 0: The SDK reports this reason when the audio state changes. */ REMOTE_AUDIO_REASON_INTERNAL = 0, /** 1: Network congestion. @@ -945,10 +1342,83 @@ enum REMOTE_VIDEO_STATE { */ REMOTE_VIDEO_STATE_FAILED = 4 }; +/** The publishing state. + */ +enum STREAM_PUBLISH_STATE { + /** 0: The initial publishing state after joining the channel. + */ + PUB_STATE_IDLE = 0, + /** 1: Fails to publish the local stream. Possible reasons: + * - The local user calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" or \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" to stop sending local streams. + * - The local user calls \ref IRtcEngine::disableAudio "disableAudio" or \ref IRtcEngine::disableVideo "disableVideo" to disable the entire audio or video module. + * - The local user calls \ref IRtcEngine::enableLocalAudio "enableLocalAudio(false)" or \ref IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local audio sampling or video capturing. + * - The role of the local user is `AUDIENCE`. + */ + PUB_STATE_NO_PUBLISHED = 1, + /** 2: Publishing. + */ + PUB_STATE_PUBLISHING = 2, + /** 3: Publishes successfully. + */ + PUB_STATE_PUBLISHED = 3 +}; +/** The subscribing state. + */ +enum STREAM_SUBSCRIBE_STATE { + /** 0: The initial subscribing state after joining the channel. + */ + SUB_STATE_IDLE = 0, + /** 1: Fails to subscribe to the remote stream. Possible reasons: + * - The remote user: + * - Calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" or \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" to stop sending local streams. + * - Calls \ref IRtcEngine::disableAudio "disableAudio" or \ref IRtcEngine::disableVideo "disableVideo" to disable the entire audio or video modules. + * - Calls \ref IRtcEngine::enableLocalAudio "enableLocalAudio(false)" or \ref IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local audio sampling or video capturing. + * - The role of the remote user is `AUDIENCE`. + * - The local user calls the following methods to stop receiving remote streams: + * - Calls \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream(true)", \ref IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams(true)", or \ref IRtcEngine::setDefaultMuteAllRemoteAudioStreams "setDefaultMuteAllRemoteAudioStreams(true)" to stop receiving remote audio streams. + * - Calls \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream(true)", \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams(true)", or \ref IRtcEngine::setDefaultMuteAllRemoteVideoStreams "setDefaultMuteAllRemoteVideoStreams(true)" to stop receiving remote video streams. + */ + SUB_STATE_NO_SUBSCRIBED = 1, + /** 2: Subscribing. + */ + SUB_STATE_SUBSCRIBING = 2, + /** 3: Subscribes to and receives the remote stream successfully. + */ + SUB_STATE_SUBSCRIBED = 3 +}; + +/** The remote video frozen type. */ +enum XLA_REMOTE_VIDEO_FROZEN_TYPE { + /** 0: 500ms video frozen type. + */ + XLA_REMOTE_VIDEO_FROZEN_500MS = 0, + /** 1: 200ms video frozen type. + */ + XLA_REMOTE_VIDEO_FROZEN_200MS = 1, + /** 2: 600ms video frozen type. + */ + XLA_REMOTE_VIDEO_FROZEN_600MS = 2, + /** 3: max video frozen type. + */ + XLA_REMOTE_VIDEO_FROZEN_TYPE_MAX = 3, +}; + +/** The remote audio frozen type. */ +enum XLA_REMOTE_AUDIO_FROZEN_TYPE { + /** 0: 80ms audio frozen. + */ + XLA_REMOTE_AUDIO_FROZEN_80MS = 0, + /** 1: 200ms audio frozen. + */ + XLA_REMOTE_AUDIO_FROZEN_200MS = 1, + /** 2: max audio frozen type. + */ + XLA_REMOTE_AUDIO_FROZEN_TYPE_MAX = 2, +}; -/** The reason of the remote video state change. */ +/** The reason for the remote video state change. */ enum REMOTE_VIDEO_STATE_REASON { - /** 0: Internal reasons. + /** 0: The SDK reports this reason when the video state changes. */ REMOTE_VIDEO_STATE_REASON_INTERNAL = 0, @@ -980,11 +1450,11 @@ enum REMOTE_VIDEO_STATE_REASON { */ REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE = 7, - /** 8: The remote media stream falls back to the audio-only stream due to poor network conditions. + /** 8: The remote audio-and-video stream falls back to the audio-only stream due to poor network conditions. */ REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK = 8, - /** 9: The remote media stream switches back to the video stream after the network conditions improve. + /** 9: The remote audio-only stream switches back to the audio-and-video stream after the network conditions improve. */ REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY = 9 @@ -1049,7 +1519,7 @@ enum STREAM_FALLBACK_OPTIONS STREAM_FALLBACK_OPTION_DISABLED = 0, /** 1: Under poor downlink network conditions, the remote video stream, to which you subscribe, falls back to the low-stream (low resolution and low bitrate) video. You can set this option only in the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. Nothing happens when you set this in the \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" method. */ STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW = 1, - /** 2: Under poor uplink network conditions, the locally published video stream falls back to audio only. + /** 2: Under poor uplink network conditions, the published video stream falls back to audio only. Under poor downlink network conditions, the remote video stream, to which you subscribe, first falls back to the low-stream (low resolution and low bitrate) video; and then to an audio-only stream if the network conditions worsen.*/ STREAM_FALLBACK_OPTION_AUDIO_ONLY = 2, @@ -1147,7 +1617,13 @@ enum CONNECTION_CHANGED_REASON_TYPE CONNECTION_CHANGED_INVALID_TOKEN = 8, /** 9: The connection failed since token is expired. */ CONNECTION_CHANGED_TOKEN_EXPIRED = 9, - /** 10: The connection is rejected by server. */ + /** 10: The connection is rejected by server. This error usually occurs in the following situations: + * - When the user is already in the channel, and still calls the method to join the channel, for example, + * \ref IRtcEngine::joinChannel "joinChannel". + * - When the user tries to join a channel during \ref IRtcEngine::startEchoTest "startEchoTest". Once you + * call \ref IRtcEngine::startEchoTest "startEchoTest", you need to call \ref IRtcEngine::stopEchoTest "stopEchoTest" before joining a channel. + * + */ CONNECTION_CHANGED_REJECTED_BY_SERVER = 10, /** 11: The connection changed to reconnecting since SDK has set a proxy server. */ CONNECTION_CHANGED_SETTING_PROXY_SERVER = 11, @@ -1209,7 +1685,19 @@ enum AUDIO_ROUTE_TYPE { AUDIO_ROUTE_LOUDSPEAKER = 4, /** Bluetooth headset. */ - AUDIO_ROUTE_BLUETOOTH = 5 + AUDIO_ROUTE_BLUETOOTH = 5, + /** USB peripheral (macOS only). + */ + AUDIO_ROUTE_USB = 6, + /** HDMI peripheral (macOS only). + */ + AUDIO_ROUTE_HDMI = 7, + /** DisplayPort peripheral (macOS only). + */ + AUDIO_ROUTE_DISPLAYPORT = 8, + /** Apple AirPlay (macOS only). + */ + AUDIO_ROUTE_AIRPLAY = 9, }; #if (defined(__APPLE__) && TARGET_OS_IOS) @@ -1243,7 +1731,7 @@ struct LastmileProbeOneWayResult { unsigned int packetLossRate; /** The network jitter (ms). */ unsigned int jitter; - /* The estimated available bandwidth (Kbps). */ + /* The estimated available bandwidth (bps). */ unsigned int availableBandwidth; }; @@ -1261,7 +1749,7 @@ struct LastmileProbeResult{ /** Configurations of the last-mile network probe test. */ struct LastmileProbeConfig { - /** Sets whether or not to test the uplink network. Some users, for example, the audience in a Live-broadcast channel, do not need such a test: + /** Sets whether or not to test the uplink network. Some users, for example, the audience in a `LIVE_BROADCASTING` channel, do not need such a test: - true: test. - false: do not test. */ bool probeUplink; @@ -1269,9 +1757,9 @@ struct LastmileProbeConfig { - true: test. - false: do not test. */ bool probeDownlink; - /** The expected maximum sending bitrate (Kbps) of the local user. The value ranges between 100 and 5000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ + /** The expected maximum sending bitrate (bps) of the local user. The value ranges between 100000 and 5000000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ unsigned int expectedUplinkBitrate; - /** The expected maximum receiving bitrate (Kbps) of the local user. The value ranges between 100 and 5000. */ + /** The expected maximum receiving bitrate (bps) of the local user. The value ranges between 100000 and 5000000. */ unsigned int expectedDownlinkBitrate; }; @@ -1291,7 +1779,7 @@ struct AudioVolumeInfo /** Voice activity status of the local user. * - 0: The local user is not speaking. * - 1: The local user is speaking. - * + * * @note * - The `vad` parameter cannot report the voice activity status of the remote users. In the remote users' callback, `vad` = 0. * - Ensure that you set `report_vad`(true) in the \ref agora::rtc::IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method to enable the voice activity detection of the local user. @@ -1301,24 +1789,35 @@ struct AudioVolumeInfo */ const char * channelId; }; - +/// @cond +/** The detailed options of a user. + */ +struct ClientRoleOptions +{ + /** The latency level of an audience member in a live interactive streaming. See #AUDIENCE_LATENCY_LEVEL_TYPE. + */ + AUDIENCE_LATENCY_LEVEL_TYPE audienceLatencyLevel; + ClientRoleOptions() + : audienceLatencyLevel(AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY) {} +}; +/// @endcond /** Statistics of the channel. */ struct RtcStats { - /** - Call duration (s), represented by an aggregate value. - */ + /** + * Call duration of the local user in seconds, represented by an aggregate value. + */ unsigned int duration; /** - Total number of bytes transmitted, represented by an aggregate value. + * Total number of bytes transmitted, represented by an aggregate value. */ unsigned int txBytes; /** - Total number of bytes received, represented by an aggregate value. + * Total number of bytes received, represented by an aggregate value. */ unsigned int rxBytes; - /** Total number of audio bytes sent (bytes), represented + /** Total number of audio bytes sent (bytes), represented * by an aggregate value. */ unsigned int txAudioBytes; @@ -1336,27 +1835,27 @@ struct RtcStats unsigned int rxVideoBytes; /** - Transmission bitrate (Kbps), represented by an instantaneous value. + * Transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txKBitRate; /** - Receive bitrate (Kbps), represented by an instantaneous value. + * Receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxKBitRate; /** - Audio receive bitrate (Kbps), represented by an instantaneous value. + * Audio receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxAudioKBitRate; /** - Audio transmission bitrate (Kbps), represented by an instantaneous value. + * Audio transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txAudioKBitRate; /** - Video receive bitrate (Kbps), represented by an instantaneous value. + * Video receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxVideoKBitRate; /** - Video transmission bitrate (Kbps), represented by an instantaneous value. + * Video transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txVideoKBitRate; /** Client-server latency (ms) @@ -1371,38 +1870,43 @@ struct RtcStats */ unsigned short rxPacketLossRate; /** Number of users in the channel. - - - Communication profile: The number of users in the channel. - - Live broadcast profile: - - - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. - - If the user is a host: The number of users in the channel = The number of hosts in the channel. + * + * - `COMMUNICATION` profile: The number of users in the channel. + * - `LIVE_BROADCASTING` profile: + * - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. + * - If the user is a host: The number of users in the channel = The number of hosts in the channel. */ unsigned int userCount; /** - Application CPU usage (%). + * Application CPU usage (%). */ double cpuAppUsage; /** System CPU usage (%). + + In the multi-kernel environment, this member represents the average CPU usage. + The value **=** 100 **-** System Idle Progress in Task Manager (%). */ double cpuTotalUsage; /** The round-trip time delay from the client to the local router. */ int gatewayRtt; /** - The memory usage ratio of the app (%). - @note This value is for reference only. Due to system limitations, you may not get the value of this member. + * The memory usage ratio of the app (%). + * + * @note This value is for reference only. Due to system limitations, you may not get the value of this member. */ double memoryAppUsageRatio; /** - The memory usage ratio of the system (%). - @note This value is for reference only. Due to system limitations, you may not get the value of this member. + * The memory usage ratio of the system (%). + * + * @note This value is for reference only. Due to system limitations, you may not get the value of this member. */ double memoryTotalUsageRatio; /** - The memory usage of the app (KB). - @note This value is for reference only. Due to system limitations, you may not get the value of this member. + * The memory usage of the app (KB). + * + * @note This value is for reference only. Due to system limitations, you may not get the value of this member. */ int memoryAppUsageInKbytes; RtcStats() @@ -1450,9 +1954,15 @@ enum CHANNEL_MEDIA_RELAY_ERROR { /** 1: An error occurs in the server response. */ RELAY_ERROR_SERVER_ERROR_RESPONSE = 1, - /** 2: No server response. You can call the + /** 2: No server response. + * + * You can call the * \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method to * leave the channel. + * + * This error can also occur if your project has not enabled co-host token + * authentication. Contact support@agora.io to enable the co-host token + * authentication service before starting a channel media relay. */ RELAY_ERROR_SERVER_NO_RESPONSE = 2, /** 3: The SDK fails to access the service, probably due to limited @@ -1531,7 +2041,9 @@ enum CHANNEL_MEDIA_RELAY_EVENT { /** The state code in CHANNEL_MEDIA_RELAY_STATE. */ enum CHANNEL_MEDIA_RELAY_STATE { - /** 0: The SDK is initializing. + /** 0: The initial state. After you successfully stop the channel media + * relay by calling \ref IRtcEngine::stopChannelMediaRelay "stopChannelMediaRelay", + * the \ref IRtcEngineEventHandler::onChannelMediaRelayStateChanged "onChannelMediaRelayStateChanged" callback returns this state. */ RELAY_STATE_IDLE = 0, /** 1: The SDK tries to relay the media stream to the destination channel. @@ -1592,51 +2104,73 @@ struct LocalVideoStats * - VIDEO_CODEC_H264 = 2: (Default) H.264. */ VIDEO_CODEC_TYPE codecType; + /** The video packet loss rate (%) from the local client to the Agora edge server before applying the anti-packet loss strategies. + */ + unsigned short txPacketLossRate; + /** The capture frame rate (fps) of the local video. + */ + int captureFrameRate; }; /** Statistics of the remote video stream. */ struct RemoteVideoStats { - /** +/** User ID of the remote user sending the video streams. */ - uid_t uid; - /** **DEPRECATED** Time delay (ms). +uid_t uid; +/** **DEPRECATED** Time delay (ms). + * + * In scenarios where audio and video is synchronized, you can use the value of + * `networkTransportDelay` and `jitterBufferDelay` in `RemoteAudioStats` to know the delay statistics of the remote video. */ - int delay; -/** - Width (pixels) of the video stream. +int delay; +/** Width (pixels) of the video stream. */ - int width; - /** +int width; +/** Height (pixels) of the video stream. */ - int height; - /** +int height; +/** Bitrate (Kbps) received since the last count. */ - int receivedBitrate; - /** The decoder output frame rate (fps) of the remote video. - */ - int decoderOutputFrameRate; - /** The render output frame rate (fps) of the remote video. - */ - int rendererOutputFrameRate; - /** Packet loss rate (%) of the remote video stream after using the anti-packet-loss method. - */ - int packetLossRate; - REMOTE_VIDEO_STREAM_TYPE rxStreamType; - /** - The total freeze time (ms) of the remote video stream after the remote user joins the channel. - In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when - the time interval between two adjacent renderable video frames is more than 500 ms. - */ - int totalFrozenTime; - /** - The total video freeze time as a percentage (%) of the total time when the video is available. - */ - int frozenRate; +int receivedBitrate; +/** The decoder output frame rate (fps) of the remote video. + */ +int decoderOutputFrameRate; +/** The render output frame rate (fps) of the remote video. + */ +int rendererOutputFrameRate; +/** Packet loss rate (%) of the remote video stream after using the anti-packet-loss method. + */ +int packetLossRate; +/** The type of the remote video stream: #REMOTE_VIDEO_STREAM_TYPE + */ +REMOTE_VIDEO_STREAM_TYPE rxStreamType; +/** + The total freeze time (ms) of the remote video stream after the remote user joins the channel. + In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when + the time interval between two adjacent renderable video frames is more than 500 ms. + */ +int totalFrozenTime; +/** + The total video freeze time as a percentage (%) of the total time when the video is available. + */ +int frozenRate; +/** + The total time (ms) when the remote user in the Communication profile or the remote + broadcaster in the Live-broadcast profile neither stops sending the video stream nor + disables the video module after joining the channel. + + @since v3.0.1 +*/ +int totalActiveTime; +/** + * The total publish duration (ms) of the remote video stream. + */ +int publishDuration; }; /** Audio statistics of the local user */ @@ -1651,6 +2185,9 @@ struct LocalAudioStats /** The average sending bitrate (Kbps). */ int sentBitrate; + /** The audio packet loss rate (%) from the local client to the Agora edge server before applying the anti-packet loss strategies. + */ + unsigned short txPacketLossRate; }; /** Audio statistics of a remote user */ @@ -1683,11 +2220,18 @@ struct RemoteAudioStats * reported interval. */ int receivedBitrate; /** The total freeze time (ms) of the remote audio stream after the remote user joins the channel. In a session, audio freeze occurs when the audio frame loss rate reaches 4%. - * Agora uses 2 seconds as an audio piece unit to calculate the audio freeze time. The total audio freeze time = The audio freeze number × 2 seconds */ int totalFrozenTime; /** The total audio freeze time as a percentage (%) of the total time when the audio is available. */ int frozenRate; + /** The total time (ms) when the remote user in the `COMMUNICATION` profile or the remote host in + the `LIVE_BROADCASTING` profile neither stops sending the audio stream nor disables the audio module after joining the channel. + */ + int totalActiveTime; + /** + * The total publish duration (ms) of the remote audio stream. + */ + int publishDuration; }; /** @@ -1708,17 +2252,17 @@ struct VideoDimensions { /** (Recommended) The standard bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. - In this mode, the bitrates differ between the live broadcast and communication profiles: + In this mode, the bitrates differ between the live interactive streaming and communication profiles: - - Communication profile: The video bitrate is the same as the base bitrate. - - Live broadcast profile: The video bitrate is twice the base bitrate. + - `COMMUNICATION` profile: The video bitrate is the same as the base bitrate. + - `LIVE_BROADCASTING` profile: The video bitrate is twice the base bitrate. */ const int STANDARD_BITRATE = 0; /** The compatible bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. - The bitrate remains the same regardless of the channel profile. If you choose this mode in the Live-broadcast profile, the video frame rate may be lower than the set value. + The bitrate remains the same regardless of the channel profile. If you choose this mode in the `LIVE_BROADCASTING` profile, the video frame rate may be lower than the set value. */ const int COMPATIBLE_BITRATE = -1; @@ -1745,48 +2289,51 @@ struct VideoEncoderConfiguration { Choose one of the following options: - #STANDARD_BITRATE: (Recommended) The standard bitrate. - - The Communication profile: the encoding bitrate equals the base bitrate. - - The Live-broadcast profile: the encoding bitrate is twice the base bitrate. + - the `COMMUNICATION` profile: the encoding bitrate equals the base bitrate. + - the `LIVE_BROADCASTING` profile: the encoding bitrate is twice the base bitrate. - #COMPATIBLE_BITRATE: The compatible bitrate: the bitrate stays the same regardless of the profile. - The Communication profile prioritizes smoothness, while the Live-broadcast profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. + the `COMMUNICATION` profile prioritizes smoothness, while the `LIVE_BROADCASTING` profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. + + The following table lists the recommended video encoder configurations, where the base bitrate applies to the `COMMUNICATION` profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. - The following table lists the recommended video encoder configurations, where the base bitrate applies to the Communication profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. + @note + In the following table, **Base Bitrate** applies to the `COMMUNICATION` profile, and **Live Bitrate** applies to the `LIVE_BROADCASTING` profile. - | Resolution | Frame Rate (fps) | Base Bitrate (Kbps, for Communication) | Live Bitrate (Kbps, for Live Broadcast)| + | Resolution | Frame Rate (fps) | Base Bitrate (Kbps) | Live Bitrate (Kbps) | |------------------------|------------------|----------------------------------------|----------------------------------------| - | 160 × 120 | 15 | 65 | 130 | - | 120 × 120 | 15 | 50 | 100 | - | 320 × 180 | 15 | 140 | 280 | - | 180 × 180 | 15 | 100 | 200 | - | 240 × 180 | 15 | 120 | 240 | - | 320 × 240 | 15 | 200 | 400 | - | 240 × 240 | 15 | 140 | 280 | - | 424 × 240 | 15 | 220 | 440 | - | 640 × 360 | 15 | 400 | 800 | - | 360 × 360 | 15 | 260 | 520 | - | 640 × 360 | 30 | 600 | 1200 | - | 360 × 360 | 30 | 400 | 800 | - | 480 × 360 | 15 | 320 | 640 | - | 480 × 360 | 30 | 490 | 980 | - | 640 × 480 | 15 | 500 | 1000 | - | 480 × 480 | 15 | 400 | 800 | - | 640 × 480 | 30 | 750 | 1500 | - | 480 × 480 | 30 | 600 | 1200 | - | 848 × 480 | 15 | 610 | 1220 | - | 848 × 480 | 30 | 930 | 1860 | - | 640 × 480 | 10 | 400 | 800 | - | 1280 × 720 | 15 | 1130 | 2260 | - | 1280 × 720 | 30 | 1710 | 3420 | - | 960 × 720 | 15 | 910 | 1820 | - | 960 × 720 | 30 | 1380 | 2760 | - | 1920 × 1080 | 15 | 2080 | 4160 | - | 1920 × 1080 | 30 | 3150 | 6300 | - | 1920 × 1080 | 60 | 4780 | 6500 | - | 2560 × 1440 | 30 | 4850 | 6500 | - | 2560 × 1440 | 60 | 6500 | 6500 | - | 3840 × 2160 | 30 | 6500 | 6500 | - | 3840 × 2160 | 60 | 6500 | 6500 | + | 160 * 120 | 15 | 65 | 130 | + | 120 * 120 | 15 | 50 | 100 | + | 320 * 180 | 15 | 140 | 280 | + | 180 * 180 | 15 | 100 | 200 | + | 240 * 180 | 15 | 120 | 240 | + | 320 * 240 | 15 | 200 | 400 | + | 240 * 240 | 15 | 140 | 280 | + | 424 * 240 | 15 | 220 | 440 | + | 640 * 360 | 15 | 400 | 800 | + | 360 * 360 | 15 | 260 | 520 | + | 640 * 360 | 30 | 600 | 1200 | + | 360 * 360 | 30 | 400 | 800 | + | 480 * 360 | 15 | 320 | 640 | + | 480 * 360 | 30 | 490 | 980 | + | 640 * 480 | 15 | 500 | 1000 | + | 480 * 480 | 15 | 400 | 800 | + | 640 * 480 | 30 | 750 | 1500 | + | 480 * 480 | 30 | 600 | 1200 | + | 848 * 480 | 15 | 610 | 1220 | + | 848 * 480 | 30 | 930 | 1860 | + | 640 * 480 | 10 | 400 | 800 | + | 1280 * 720 | 15 | 1130 | 2260 | + | 1280 * 720 | 30 | 1710 | 3420 | + | 960 * 720 | 15 | 910 | 1820 | + | 960 * 720 | 30 | 1380 | 2760 | + | 1920 * 1080 | 15 | 2080 | 4160 | + | 1920 * 1080 | 30 | 3150 | 6300 | + | 1920 * 1080 | 60 | 4780 | 6500 | + | 2560 * 1440 | 30 | 4850 | 6500 | + | 2560 * 1440 | 60 | 6500 | 6500 | + | 3840 * 2160 | 30 | 6500 | 6500 | + | 3840 * 2160 | 60 | 6500 | 6500 | */ int bitrate; @@ -1794,7 +2341,7 @@ struct VideoEncoderConfiguration { The SDK automatically adjusts the encoding bitrate to adapt to the network conditions. Using a value greater than the default value forces the video encoder to output high-quality images but may cause more packet loss and hence sacrifice the smoothness of the video transmission. That said, unless you have special requirements for image quality, Agora does not recommend changing this value. - @note This parameter applies only to the Live-broadcast profile. + @note This parameter applies only to the `LIVE_BROADCASTING` profile. */ int minBitrate; /** The video orientation mode of the video: #ORIENTATION_MODE. @@ -1836,7 +2383,7 @@ struct VideoEncoderConfiguration { {} }; -/** The video properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. +/** The video and audio properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. */ typedef struct TranscodingUser { /** User ID of the user displaying the video in the CDN live. @@ -1856,17 +2403,17 @@ typedef struct TranscodingUser { */ int height; - /** Layer position of the video frame. The value ranges between 0 and 100. + /** The layer index of the video frame. An integer. The value range is [0, 100]. - - 0: (Default) Lowest - - 100: Highest + - 0: (Default) Bottom layer. + - 100: Top layer. @note - If zOrder is beyond this range, the SDK reports #ERR_INVALID_ARGUMENT. - As of v2.3, the SDK supports zOrder = 0. */ int zOrder; - /** Transparency of the video frame in CDN live. The value ranges between 0 and 1.0: + /** The transparency level of the user's video. The value ranges between 0 and 1.0: - 0: Completely transparent - 1.0: (Default) Opaque @@ -1874,12 +2421,12 @@ typedef struct TranscodingUser { double alpha; /** The audio channel of the sound. The default value is 0: - - 0: (Default) Supports dual channels at most, depending on the upstream of the broadcaster. - - 1: The audio stream of the broadcaster uses the FL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 2: The audio stream of the broadcaster uses the FC audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 3: The audio stream of the broadcaster uses the FR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 4: The audio stream of the broadcaster uses the BL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 5: The audio stream of the broadcaster uses the BR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 0: (Default) Supports dual channels at most, depending on the upstream of the host. + - 1: The audio stream of the host uses the FL audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. + - 2: The audio stream of the host uses the FC audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. + - 3: The audio stream of the host uses the FR audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. + - 4: The audio stream of the host uses the BL audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. + - 5: The audio stream of the host uses the BR audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. @note If your setting is not 0, you may need a specialized player. */ @@ -1909,39 +2456,61 @@ typedef struct RtcImage { width(0), height(0) {} - /** HTTP/HTTPS URL address of the image on the broadcasting video. The maximum length of this parameter is 1024 bytes. */ + /** HTTP/HTTPS URL address of the image on the live video. The maximum length of this parameter is 1024 bytes. */ const char* url; - /** Horizontal position of the image from the upper left of the broadcasting video. */ + /** Horizontal position of the image from the upper left of the live video. */ int x; - /** Vertical position of the image from the upper left of the broadcasting video. */ + /** Vertical position of the image from the upper left of the live video. */ int y; - /** Width of the image on the broadcasting video. */ + /** Width of the image on the live video. */ int width; - /** Height of the image on the broadcasting video. */ + /** Height of the image on the live video. */ int height; } RtcImage; +/// @cond +/** The configuration for advanced features of the RTMP streaming with transcoding. + */ +typedef struct LiveStreamAdvancedFeature { + LiveStreamAdvancedFeature() : featureName(NULL) , opened(false) { + } + + /** The advanced feature for high-quality video with a lower bitrate. */ + const char* LBHQ = "lbhq"; + /** The advanced feature for the optimized video encoder. */ + const char* VEO = "veo"; + /** The name of the advanced feature. It contains LBHQ and VEO. + */ + const char* featureName; + + /** Whether to enable the advanced feature: + * - true: Enable the advanced feature. + * - false: (Default) Disable the advanced feature. + */ + bool opened; +} LiveStreamAdvancedFeature; +/// @endcond /** A struct for managing CDN live audio/video transcoding settings. */ typedef struct LiveTranscoding { - /** Width of the video. The default value is 360. - * - If you push video streams to the CDN, set the value of width × height to at least 64 × 64 (px), or the SDK will adjust it to 64 × 64 (px). - * - If you push audio streams to the CDN, set the value of width × height to 0 × 0 (px). - */ + /** The width of the video in pixels. The default value is 360. + * - When pushing video streams to the CDN, ensure that `width` is at least 64; otherwise, the Agora server adjusts the value to 64. + * - When pushing audio streams to the CDN, set `width` and `height` as 0. + */ int width; - /** Height of the video. The default value is 640. - * - If you push video streams to the CDN, set the value of width × height to at least 64 × 64 (px), or the SDK will adjust it to 64 × 64 (px). - * - If you push audio streams to the CDN, set the value of width × height to 0 × 0 (px). + /** The height of the video in pixels. The default value is 640. + * - When pushing video streams to the CDN, ensure that `height` is at least 64; otherwise, the Agora server adjusts the value to 64. + * - When pushing audio streams to the CDN, set `width` and `height` as 0. */ int height; /** Bitrate of the CDN live output video stream. The default value is 400 Kbps. - Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. + Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. */ int videoBitrate; - /** Frame rate of the output video stream set for the CDN live broadcast. The default value is 15 fps, and the value range is (0,30]. + /** Frame rate of the output video stream set for the CDN live streaming. The default value is 15 fps, and the value range is (0,30]. - @note Agora adjusts all values over 30 to 30. + @note The Agora server adjusts any value over 30 to 30. */ int videoFramerate; @@ -1957,13 +2526,17 @@ typedef struct LiveTranscoding { int videoGop; /** Self-defined video codec profile: #VIDEO_CODEC_PROFILE_TYPE. - @note If you set this parameter to other values, Agora adjusts it to the default value of 100. + @note If you set this parameter to other values, Agora adjusts it to the default value of 100. */ VIDEO_CODEC_PROFILE_TYPE videoCodecProfile; - /** The background color in RGB hex value. Value only, do not include a #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). + /** The background color in RGB hex value. Value only. Do not include a preceeding #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). */ unsigned int backgroundColor; - /** The number of users in the live broadcast. + + /** video codec type */ + VIDEO_CODEC_TYPE_FOR_STREAM videoCodecType; + + /** The number of users in the live interactive streaming. */ unsigned int userCount; /** TranscodingUser @@ -1975,12 +2548,12 @@ typedef struct LiveTranscoding { */ const char *transcodingExtraInfo; - /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or FLV metadata. + /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or HTTP-FLV metadata. */ const char *metadata; /** The watermark image added to the CDN live publishing stream. - Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. + Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. */ RtcImage* watermark; /** The background image added to the CDN live publishing stream. @@ -1994,21 +2567,29 @@ typedef struct LiveTranscoding { /** Bitrate of the CDN live audio output stream. The default value is 48 Kbps, and the highest value is 128. */ int audioBitrate; - /** Agora's self-defined audio-channel types. We recommend choosing option 1 or 2. A special player is required if you choose option 3, 4, or 5: + /** The numbder of audio channels for the CDN live stream. Agora recommends choosing 1 (mono), or 2 (stereo) audio channels. Special players are required if you choose option 3, 4, or 5: - - 1: (Default) Mono - - 2: Two-channel stereo - - 3: Three-channel stereo - - 4: Four-channel stereo - - 5: Five-channel stereo + - 1: (Default) Mono. + - 2: Stereo. + - 3: Three audio channels. + - 4: Four audio channels. + - 5: Five audio channels. */ int audioChannels; /** Self-defined audio codec profile: #AUDIO_CODEC_PROFILE_TYPE. */ AUDIO_CODEC_PROFILE_TYPE audioCodecProfile; + /// @cond + /** Advanced features of the RTMP streaming with transcoding. See LiveStreamAdvancedFeature. + * + * @since v3.1.0 + */ + LiveStreamAdvancedFeature* advancedFeatures; - + /** The number of enabled advanced features. The default value is 0. */ + unsigned int advancedFeatureCount; + /// @endcond LiveTranscoding() : width(360) , height(640) @@ -2018,6 +2599,7 @@ typedef struct LiveTranscoding { , videoGop(30) , videoCodecProfile(VIDEO_CODEC_PROFILE_HIGH) , backgroundColor(0x000000) + , videoCodecType(VIDEO_CODEC_H264_FOR_STREAM) , userCount(0) , transcodingUsers(NULL) , transcodingExtraInfo(NULL) @@ -2028,6 +2610,8 @@ typedef struct LiveTranscoding { , audioBitrate(48) , audioChannels(1) , audioCodecProfile(AUDIO_CODEC_PROFILE_LC_AAC) + , advancedFeatures(NULL) + , advancedFeatureCount(0) {} } LiveTranscoding; @@ -2043,37 +2627,38 @@ typedef struct LiveTranscoding { #endif }; -/** Configuration of the imported live broadcast voice or video stream. +/** Configuration of the injected media stream. */ struct InjectStreamConfig { - /** Width of the added stream in the live broadcast. The default value is 0 (same width as the original stream). + /** Width of the injected stream in the live interactive streaming. The default value is 0 (same width as the original stream). */ int width; - /** Height of the added stream in the live broadcast. The default value is 0 (same height as the original stream). + /** Height of the injected stream in the live interactive streaming. The default value is 0 (same height as the original stream). */ int height; - /** Video GOP of the added stream in the live broadcast in frames. The default value is 30 fps. + /** Video GOP (in frames) of the injected stream in the live interactive streaming. The default value is 30 fps. */ int videoGop; - /** Video frame rate of the added stream in the live broadcast. The default value is 15 fps. + /** Video frame rate of the injected stream in the live interactive streaming. The default value is 15 fps. */ int videoFramerate; - /** Video bitrate of the added stream in the live broadcast. The default value is 400 Kbps. + /** Video bitrate of the injected stream in the live interactive streaming. The default value is 400 Kbps. @note The setting of the video bitrate is closely linked to the resolution. If the video bitrate you set is beyond a reasonable range, the SDK sets it within a reasonable range. */ int videoBitrate; - /** Audio-sample rate of the added stream in the live broadcast: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. + /** Audio-sample rate of the injected stream in the live interactive streaming: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. @note We recommend setting the default value. */ AUDIO_SAMPLE_RATE_TYPE audioSampleRate; - /** Audio bitrate of the added stream in the live broadcast. The default value is 48. + /** Audio bitrate of the injected stream in the live interactive streaming. The default value is 48. @note We recommend setting the default value. */ int audioBitrate; - /** Audio channels in the live broadcast. + /** Audio channels in the live interactive streaming. + - 1: (Default) Mono - 2: Two-channel stereo @@ -2097,15 +2682,15 @@ struct InjectStreamConfig { /** The definition of ChannelMediaInfo. */ struct ChannelMediaInfo { - /** The channel name. + /** The channel name. */ - const char* channelName; + const char* channelName; /** The token that enables the user to join the channel. */ - const char* token; + const char* token; /** The user ID. */ - uid_t uid; + uid_t uid; }; /** The definition of ChannelMediaRelayConfiguration. @@ -2113,26 +2698,29 @@ struct ChannelMediaInfo { struct ChannelMediaRelayConfiguration { /** Pointer to the information of the source channel: ChannelMediaInfo. It contains the following members: * - `channelName`: The name of the source channel. The default value is `NULL`, which means the SDK applies the name of the current channel. - * - `uid`: ID of the broadcaster whose media stream you want to relay. The default value is 0, which means the SDK generates a random UID. You must set it as 0. + * - `uid`: The unique ID to identify the relay stream in the source channel. The default value is 0, which means the SDK generates a random UID. You must set it as 0. * - `token`: The token for joining the source channel. It is generated with the `channelName` and `uid` you set in `srcInfo`. * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`, and the `uid` must be set as 0. */ - ChannelMediaInfo *srcInfo; + ChannelMediaInfo *srcInfo; /** Pointer to the information of the destination channel: ChannelMediaInfo. It contains the following members: * - `channelName`: The name of the destination channel. - * - `uid`: ID of the broadcaster in the destination channel. The value ranges from 0 to (232-1). To avoid UID conflicts, this `uid` must be different from any other UIDs in the destination channel. The default value is 0, which means the SDK generates a random UID. + * - `uid`: The unique ID to identify the relay stream in the destination channel. The value ranges from 0 to (232-1). + * To avoid UID conflicts, this `uid` must be different from any other UIDs in the destination channel. The default + * value is 0, which means the SDK generates a random UID. Do not set this parameter as the `uid` of the host in + * the destination channel, and ensure that this `uid` is different from any other `uid` in the channel. * - `token`: The token for joining the destination channel. It is generated with the `channelName` and `uid` you set in `destInfos`. * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`. */ - ChannelMediaInfo *destInfos; + ChannelMediaInfo *destInfos; /** The number of destination channels. The default value is 0, and the * value range is [0,4). Ensure that the value of this parameter * corresponds to the number of ChannelMediaInfo structs you define in * `destInfos`. */ - int destCount; + int destCount; ChannelMediaRelayConfiguration() : srcInfo(nullptr) @@ -2147,10 +2735,10 @@ enum RTMP_STREAM_LIFE_CYCLE_TYPE { /** Bind to the channel lifecycle. If all hosts leave the channel, the CDN live streaming stops after 30 seconds. */ - RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, + RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, /** Bind to the owner of the RTMP stream. If the owner leaves the channel, the CDN live streaming stops immediately. */ - RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, + RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, }; /** Content hints for screen sharing. @@ -2210,19 +2798,19 @@ typedef struct Rect { /** The options of the watermark image to be added. */ typedef struct WatermarkOptions { - /** Sets whether or not the watermark image is visible in the local video preview: + /** Sets whether or not the watermark image is visible in the local video preview: * - true: (Default) The watermark image is visible in preview. - * - false: The watermark image is not visible in preview. + * - false: The watermark image is not visible in preview. */ bool visibleInPreview; /** * The watermark position in the landscape mode. See Rectangle. - * For detailed information on the landscape mode, see [Rotate the video](https://docs.agora.io/en/Interactive%20Broadcast/rotation_guide_windows?platform=Windows). + * For detailed information on the landscape mode, see the advanced guide *Video Rotation*. */ Rectangle positionInLandscapeMode; /** * The watermark position in the portrait mode. See Rectangle. - * For detailed information on the portrait mode, see [Rotate the video](https://docs.agora.io/en/Interactive%20Broadcast/rotation_guide_windows?platform=Windows). + * For detailed information on the portrait mode, see the advanced guide *Video Rotation*. */ Rectangle positionInPortraitMode; @@ -2237,36 +2825,50 @@ typedef struct WatermarkOptions { */ struct ScreenCaptureParameters { - /** The maximum encoding dimensions of the shared region in terms of width × height. + /** The maximum encoding dimensions of the shared region in terms of width * height. - The default value is 1920 × 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. + The default value is 1920 * 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. - If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: + If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: - - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 × 1000, the SDK uses 1000 × 1000 for encoding. - - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 × 1500, the SDK uses the maximum value under 1920 × 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 × 1080. + - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 * 1000, the SDK uses 1000 * 1000 for encoding. + - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 * 1500, the SDK uses the maximum value under 1920 * 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 * 1080. */ VideoDimensions dimensions; /** The frame rate (fps) of the shared region. - The default value is 5. We do not recommend setting this to a value greater than 15. + The default value is 5. We do not recommend setting this to a value greater than 15. */ int frameRate; /** The bitrate (Kbps) of the shared region. - The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). + The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). */ int bitrate; /** Sets whether or not to capture the mouse for screen sharing: - - true: (Default) Capture the mouse. - - false: Do not capture the mouse. + - true: (Default) Capture the mouse. + - false: Do not capture the mouse. */ bool captureMouseCursor; + /** Whether to bring the window to the front when calling \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" to share the window: + * - true: Bring the window to the front. + * - false: (Default) Do not bring the window to the front. + */ + bool windowFocus; + /** A list of IDs of windows to be blocked. + * + * When calling \ref IRtcEngine::startScreenCaptureByScreenRect "startScreenCaptureByScreenRect" to start screen sharing, you can use this parameter to block the specified windows. + * When calling \ref IRtcEngine::updateScreenCaptureParameters "updateScreenCaptureParameters" to update the configuration for screen sharing, you can use this parameter to dynamically block the specified windows during screen sharing. + */ + view_t* excludeWindowList; + /** The number of windows to be blocked. + */ + int excludeWindowCount; - ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true) {} - ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c) {} - ScreenCaptureParameters(int width, int height, int f, int b, bool c) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c) {} + ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true), windowFocus(false), excludeWindowList(NULL), excludeWindowCount(0) {} + ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c, bool focus, view_t *ex = NULL, int cnt = 0) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c), windowFocus(focus), excludeWindowList(ex), excludeWindowCount(cnt) {} + ScreenCaptureParameters(int width, int height, int f, int b, bool c, bool focus, view_t *ex = NULL, int cnt = 0) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c), windowFocus(focus), excludeWindowList(ex), excludeWindowCount(cnt) {} }; /** Video display settings of the VideoCanvas class. @@ -2276,17 +2878,17 @@ struct VideoCanvas /** Video display window (view). */ view_t view; - /** The rendering mode of the video view. See RENDER_MODE_TYPE + /** The rendering mode of the video view. See #RENDER_MODE_TYPE */ int renderMode; /** The unique channel name for the AgoraRTC session in the string format. The string length must be less than 64 bytes. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". - @note + @note - The default value is the empty string "". Use the default value if the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IRtcEngine class. The `VideoCanvas` struct defines the video canvas of the user in the channel. - If the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IChannel class, set this parameter as the `channelId` of the `IChannel` object. The `VideoCanvas` struct defines the video canvas of the user in the channel with the specified channel ID. */ @@ -2393,8 +2995,17 @@ BeautyOptions() lighteningContrastLevel(LIGHTENING_CONTRAST_NORMAL) {} }; +/** + * The UserInfo struct. + */ struct UserInfo { + /** + * The user ID. + */ uid_t uid; + /** + * The user account. + */ char userAccount[MAX_USER_ACCOUNT_LENGTH]; UserInfo() : uid(0) { @@ -2402,6 +3013,52 @@ struct UserInfo { } }; +/** + * Regions for connetion. + */ +enum AREA_CODE { + /** + * Mainland China. + */ + AREA_CODE_CN = 0x00000001, + /** + * North America. + */ + AREA_CODE_NA = 0x00000002, + /** + * Europe. + */ + AREA_CODE_EU = 0x00000004, + /** + * Asia, excluding Mainland China. + */ + AREA_CODE_AS = 0x00000008, + /** + * Japan. + */ + AREA_CODE_JP = 0x00000010, + /** + * India. + */ + AREA_CODE_IN = 0x00000020, + /** + * (Default) Global. + */ + AREA_CODE_GLOB = 0xFFFFFFFF +}; + +enum ENCRYPTION_CONFIG { + /** + * - 1: Force set master key and mode; + * - 0: Not force set, checking whether encryption plugin exists + */ + ENCRYPTION_FORCE_SETTING = (1 << 0), + /** + * - 1: Force not encrypting packet; + * - 0: Not force encrypting; + */ + ENCRYPTION_FORCE_DISABLE_PACKET = (1 << 1) +}; /** Definition of IPacketObserver. */ class IPacketObserver @@ -2409,49 +3066,162 @@ class IPacketObserver public: /** Definition of Packet. */ - struct Packet - { + struct Packet + { /** Buffer address of the sent or received data. * @note Agora recommends that the value of buffer is more than 2048 bytes, otherwise, you may meet undefined behaviors such as a crash. */ - const unsigned char* buffer; + const unsigned char* buffer; /** Buffer size of the sent or received data. */ - unsigned int size; - }; - /** Occurs when the local user sends an audio packet. + unsigned int size; + }; + /** Occurs when the local user sends an audio packet. @param packet The sent audio packet. See Packet. @return - true: The audio packet is sent successfully. - false: The audio packet is discarded. */ - virtual bool onSendAudioPacket(Packet& packet) = 0; - /** Occurs when the local user sends a video packet. + virtual bool onSendAudioPacket(Packet& packet) = 0; + /** Occurs when the local user sends a video packet. @param packet The sent video packet. See Packet. @return - true: The video packet is sent successfully. - false: The video packet is discarded. */ - virtual bool onSendVideoPacket(Packet& packet) = 0; - /** Occurs when the local user receives an audio packet. + virtual bool onSendVideoPacket(Packet& packet) = 0; + /** Occurs when the local user receives an audio packet. @param packet The received audio packet. See Packet. @return - true: The audio packet is received successfully. - false: The audio packet is discarded. - */ - virtual bool onReceiveAudioPacket(Packet& packet) = 0; - /** Occurs when the local user receives a video packet. + */ + virtual bool onReceiveAudioPacket(Packet& packet) = 0; + /** Occurs when the local user receives a video packet. @param packet The received video packet. See Packet. @return - true: The video packet is received successfully. - false: The video packet is discarded. - */ - virtual bool onReceiveVideoPacket(Packet& packet) = 0; + */ + virtual bool onReceiveVideoPacket(Packet& packet) = 0; +}; + + +#if defined(_WIN32) +/** The capture type of the custom video source. + */ +enum VIDEO_CAPTURE_TYPE { + /** Unknown type. + */ + VIDEO_CAPTURE_UNKNOWN, + /** (Default) Video captured by the camera. + */ + VIDEO_CAPTURE_CAMERA, + /** Video for screen sharing. + */ + VIDEO_CAPTURE_SCREEN, +}; + +/** The IVideoFrameConsumer class. The SDK uses it to receive the video frame that you capture. + */ +class IVideoFrameConsumer { +public: + /** Receives the raw video frame. + * + * @note Ensure that the video frame type that you specify in this method is the same as that in the \ref agora::rtc::IVideoSource::getBufferType "getBufferType" callback. + * + * @param buffer The video buffer. + * @param frameType The video frame type. See \ref agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT "VIDEO_PIXEL_FORMAT". + * @param width The width (px) of the video frame. + * @param height The height (px) of the video frame. + * @param rotation The angle (degree) at which the video frame rotates clockwise. If you set the rotation angle, the + * SDK rotates the video frame after receiving it. You can set the rotation angle as `0`, `90`, `180`, and `270`. + * @param timestamp The Unix timestamp (ms) of the video frame. You must set a timestamp for each video frame. + */ + virtual void consumeRawVideoFrame(const unsigned char *buffer, agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT frameType, int width, int height, int rotation, long timestamp) = 0; +}; + +/** The IVideoSource class. You can use it to customize the video source. + */ +class IVideoSource { +public: + /** Notification for initializing the custom video source. + * + * The SDK triggers this callback to remind you to initialize the custom video source. After receiving this callback, + * you can do some preparation, such as enabling the camera, and then use the return value to tell the SDK whether the + * custom video source is prepared. + * + * @param consumer An IVideoFrameConsumer object that the SDK passes to you. You need to reserve this object and use it + * to send the video frame to the SDK once the custom video source is started. See IVideoFrameConsumer. + * + * @return + * - true: The custom video source is initialized. + * - false: The custom video source is not ready or fails to initialize. The SDK stops and reports the error. + */ + virtual bool onInitialize(IVideoFrameConsumer *consumer) = 0; + + /** Notification for disabling the custom video source. + * + * The SDK triggers this callback to remind you to disable the custom video source device. This callback tells you + * that the SDK is about to release the IVideoFrameConsumer object. Ensure that you no longer use IVideoFrameConsumer + * after receiving this callback. + */ + virtual void onDispose() = 0; + + /** Notification for starting the custom video source. + * + * The SDK triggers this callback to remind you to start the custom video source for capturing video. The SDK uses + * IVideoFrameConsumer to receive the video frame that you capture after the video source is started. You must use + * the return value to tell the SDK whether the custom video source is started. + * + * @return + * - true: The custom video source is started. + * - false: The custom video source fails to start. The SDK stops and reports the error. + */ + virtual bool onStart() = 0; + + /** Notification for stopping capturing video. + * + * The SDK triggers this callback to remind you to stop capturing video. This callback tells you that the SDK is about + * to stop using IVideoFrameConsumer to receive the video frame that you capture. + */ + virtual void onStop() = 0; + + /** Gets the video frame type. + * + * Before you initialize the custom video source, the SDK triggers this callback to query the video frame type. You + * must specify the video frame type in the return value and then pass it to the SDK. + * + * @note Ensure that the video frame type that you specify in this callback is the same as that in the \ref agora::rtc::IVideoFrameConsumer::consumeRawVideoFrame "consumeRawVideoFrame" method. + * + * @return \ref agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT "VIDEO_PIXEL_FORMAT" + */ + virtual agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT getBufferType() = 0; + /** Gets the capture type of the custom video source. + * + * Before you initialize the custom video source, the SDK triggers this callback to query the capture type of the video source. + * You must specify the capture type in the return value and then pass it to the SDK. The SDK enables the corresponding video + * processing algorithm according to the capture type after receiving the video frame. + * + * @return #VIDEO_CAPTURE_TYPE + */ + virtual VIDEO_CAPTURE_TYPE getVideoCaptureType() = 0; + /** Gets the content hint of the custom video source. + * + * If you specify the custom video source as a screen-sharing video, the SDK triggers this callback to query the + * content hint of the video source before you initialize the video source. You must specify the content hint in the + * return value and then pass it to the SDK. The SDK enables the corresponding video processing algorithm according + * to the content hint after receiving the video frame. + * + * @return \ref agora::rtc::VideoContentHint "VideoContentHint" + */ + virtual VideoContentHint getVideoContentHint() = 0; }; +#endif /** The SDK uses the IRtcEngineEventHandler interface class to send callbacks to the application. The application inherits the methods of this interface class to retrieve these callbacks. @@ -2461,7 +3231,7 @@ class IRtcEngineEventHandler { public: virtual ~IRtcEngineEventHandler() {} - + /** Reports a warning during SDK runtime. In most cases, the application can ignore the warning reported by the SDK because the SDK can usually fix the issue and resume running. For example, when losing connection with the server, the SDK may report #WARN_LOOKUP_CHANNEL_TIMEOUT and automatically try to reconnect. @@ -2532,7 +3302,7 @@ class IRtcEngineEventHandler (void)stats; } - /** Occurs when the user role switches in a live broadcast. For example, from a host to an audience or vice versa. + /** Occurs when the user role switches in the live interactive streaming. For example, from a host to an audience or vice versa. This callback notifies the application of a user role switch when the application calls the \ref IRtcEngine::setClientRole "setClientRole" method. @@ -2543,10 +3313,10 @@ class IRtcEngineEventHandler virtual void onClientRoleChanged(CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { } - /** Occurs when a remote user (Communication)/ host (Live Broadcast) joins the channel. + /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) joins the channel. - - Communication profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. - - Live-broadcast profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + - `COMMUNICATION` profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - `LIVE_BROADCASTING` profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. The SDK triggers this callback under one of the following circumstances: - A remote user/host joins the channel by calling the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. @@ -2554,7 +3324,7 @@ class IRtcEngineEventHandler - A remote user/host rejoins the channel after a network interruption. - The host injects an online media stream into the channel by calling the \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method. - @note In the Live-broadcast profile: + @note In the `LIVE_BROADCASTING` profile: - The host receives this callback when another host joins the channel. - The audience in the channel receives this callback when a new host joins the channel. - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. @@ -2567,12 +3337,12 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel. + /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) leaves the channel. Reasons why the user is offline: - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. - - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using a signaling system for more reliable offline detection. + - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using the Agora RTM SDK for more reliable offline detection. @param uid User ID of the user leaving the channel or going offline. @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. @@ -2653,9 +3423,12 @@ class IRtcEngineEventHandler /** Occurs when the token expires. - After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. + After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses + connection with the Agora server due to network issues, the token may expire after a certain period of time and a + new token may be required to reconnect to the server. - This callback notifies the application to generate a new token. Call the \ref IRtcEngine::renewToken "renewToken" method to renew the token. + Once you receive this callback, generate a new token on your app server, and call + \ref agora::rtc::IRtcEngine::renewToken "renewToken" to pass the new token to the SDK. */ virtual void onRequestToken() { } @@ -2688,11 +3461,11 @@ class IRtcEngineEventHandler (void)lost; } - /** Reports the statistics of the current call. - + /** Reports the statistics of the current call. + The SDK triggers this callback once every two seconds after the user joins the channel. - - @param stats Statistics of the RtcEngine: RtcStats. + + @param stats Statistics of the IRtcEngine: RtcStats. */ virtual void onRtcStats(const RtcStats& stats) { (void)stats; @@ -2703,7 +3476,7 @@ class IRtcEngineEventHandler Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. - @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 × 480 and a frame rate of 15 fps in the Live-broadcast profile, but may be inadequate for resolutions higher than 1280 × 720. See #QUALITY_TYPE. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 * 480 and a frame rate of 15 fps in the `LIVE_BROADCASTING` profile, but may be inadequate for resolutions higher than 1280 * 720. See #QUALITY_TYPE. @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. */ virtual void onNetworkQuality(uid_t uid, int txQuality, int rxQuality) { @@ -2719,14 +3492,15 @@ class IRtcEngineEventHandler * triggers this callback as many times. * * @note - * If you have called the \ref agora::rtc::IRtcEngine::enableDualStream - * "enableDualStream" method, the \ref onLocalVideoStats() - * "onLocalVideoStats" callback reports the statistics of the high-video + * If you have called the + * \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" + * method, the \ref onLocalVideoStats() "onLocalVideoStats" callback + * reports the statistics of the high-video * stream (high bitrate, and high-resolution video stream). * * @param stats Statistics of the local video stream. See LocalVideoStats. */ - virtual void onLocalVideoStats(const LocalVideoStats& stats) { + virtual void onLocalVideoStats(const LocalVideoStats& stats) { (void)stats; } @@ -2767,7 +3541,6 @@ class IRtcEngineEventHandler } /** Occurs when the local audio state changes. - * * This callback indicates the state change of the local audio stream, * including the state of the audio recording and encoding, and allows * you to troubleshoot issues when exceptions occur. @@ -2786,16 +3559,17 @@ class IRtcEngineEventHandler } /** Occurs when the remote audio state changes. - * - * This callback indicates the state change of the remote audio stream. - * - * @param uid ID of the remote user whose audio state changes. - * @param state State of the remote audio. See #REMOTE_AUDIO_STATE. - * @param reason The reason of the remote audio state change. - * See #REMOTE_AUDIO_STATE_REASON. - * @param elapsed Time elapsed (ms) from the local user calling the - * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK - * triggers this callback. + + This callback indicates the state change of the remote audio stream. + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param uid ID of the remote user whose audio state changes. + @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + @param reason The reason of the remote audio state change. + See #REMOTE_AUDIO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref IRtcEngine::joinChannel "joinChannel" method until the SDK + triggers this callback. */ virtual void onRemoteAudioStateChanged(uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { (void)uid; @@ -2804,14 +3578,90 @@ class IRtcEngineEventHandler (void)elapsed; } + /** Occurs when the audio publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local audio stream. + * + * @param channel The channel name. + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioPublishStateChanged(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + (void)channel; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + + /** Occurs when the video publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local video stream. + * + * @param channel The channel name. + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoPublishStateChanged(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + (void)channel; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote audio stream. + * + * @param channel The channel name. + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioSubscribeStateChanged(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + (void)channel; + (void)uid; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote video stream. + * + * @param channel The channel name. + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoSubscribeStateChanged(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + (void)channel; + (void)uid; + (void)oldState; + (void)newState; + (void)elapseSinceLastState; + } + /** Reports which users are speaking, the speakers' volume and whether the local user is speaking. - This callback reports the IDs and volumes of the loudest speakers at the moment in the channel, and whether the local user is speaking. + This callback reports the IDs and volumes of the loudest speakers (at most 3 users) at the moment in the channel, and whether the local user is speaking. By default, this callback is disabled. You can enable it by calling the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. Once enabled, this callback is triggered at the set interval, regardless of whether a user speaks or not. - The SDK triggers two independent `onAudioVolumeIndication` callbacks at one time, which separately report the volume information of the local user and all the remote speakers. + The SDK triggers two independent `onAudioVolumeIndication` callbacks at one time, which separately report the volume information of the local user and all the remote speakers. For more information, see the detailed parameter descriptions. @note @@ -2823,14 +3673,14 @@ class IRtcEngineEventHandler @param speakers A pointer to AudioVolumeInfo: - In the local user's callback, this struct contains the following members: - - `uid` = 0, + - `uid` = 0, - `volume` = `totalVolume`, which reports the sum of the voice volume and audio-mixing volume of the local user, and - `vad`, which reports the voice activity status of the local user. - In the remote speakers' callback, this array contains the following members: - `uid` of the remote speaker, - `volume`, which reports the sum of the voice volume and audio-mixing volume of each remote speaker, and - `vad` = 0. - + An empty speakers array in the callback indicates that no remote user is speaking at the moment. @param speakerNumber Total number of speakers. The value range is [0, 3]. - In the local user’s callback, `speakerNumber` = 1, regardless of whether the local user speaks or not. @@ -2845,15 +3695,17 @@ class IRtcEngineEventHandler (void)totalVolume; } - /** Reports which user is the loudest speaker. + /** Occurs when the most active speaker is detected. - If the user enables the audio volume indication by calling the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method, this callback returns the @p uid of the active speaker detected by the audio volume detection module of the SDK. + After a successful call of \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication", + the SDK continuously detects which remote user has the loudest volume. During the current period, the remote user, + who is detected as the loudest for the most times, is the most active user. - @note - - To receive this callback, you need to call the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. - - This callback returns the user ID of the user with the highest voice volume during a period of time, instead of at the moment. + When the number of user is no less than two and an active speaker exists, the SDK triggers this callback and reports the `uid` of the most active speaker. + - If the most active speaker is always the same user, the SDK triggers this callback only once. + - If the most active speaker changes to another user, the SDK triggers this callback again and reports the `uid` of the new active speaker. - @param uid User ID of the active speaker. A @p uid of 0 represents the local user. + @param uid The user ID of the most active speaker. */ virtual void onActiveSpeaker(uid_t uid) { (void)uid; @@ -2880,9 +3732,25 @@ class IRtcEngineEventHandler (void)elapsed; } + /** Occurs when the first video frame is published. + * + * @since v3.1.0 + * + * The SDK triggers this callback under one of the following circumstances: + * - The local client enables the video module and calls \ref IRtcEngine::joinChannel "joinChannel" successfully. + * - The local client calls \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" and \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(false)" in sequence. + * - The local client calls \ref IRtcEngine::disableVideo "disableVideo" and \ref IRtcEngine::enableVideo "enableVideo" in sequence. + * + * @param elapsed The time elapsed (ms) from the local client calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ + virtual void onFirstLocalVideoFramePublished(int elapsed) { + (void)elapsed; + } + /** Occurs when the first remote video frame is received and decoded. * - * @deprecated + * @deprecated v2.9.0 + * * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -2920,13 +3788,12 @@ class IRtcEngineEventHandler } /** Occurs when the first remote video frame is rendered. + The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. - The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. - - @param uid User ID of the remote user sending the video stream. - @param width Width (px) of the video frame. - @param height Height (px) of the video stream. - @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + @param uid User ID of the remote user sending the video stream. + @param width Width (px) of the video frame. + @param height Height (px) of the video stream. + @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. */ virtual void onFirstRemoteVideoFrame(uid_t uid, int width, int height, int elapsed) { (void)uid; @@ -2935,10 +3802,13 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a remote user's audio stream playback pauses/resumes. + /** @deprecated This method is deprecated from v3.0.0, use the \ref agora::rtc::IRtcEngineEventHandler::onRemoteAudioStateChanged "onRemoteAudioStateChanged" callback instead. + + Occurs when a remote user's audio stream playback pauses/resumes. - The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. - @note This callback returns invalid when the number of users in a channel exceeds 20. + The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. + + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. @param uid User ID of the remote user. @param muted Whether the remote user's audio stream is muted/unmuted: @@ -2949,7 +3819,7 @@ class IRtcEngineEventHandler (void)uid; (void)muted; } - + /** Occurs when a remote user's video stream playback pauses/resumes. * * You can also use the @@ -2965,8 +3835,7 @@ class IRtcEngineEventHandler * \ref agora::rtc::IRtcEngine::muteLocalVideoStream * "muteLocalVideoStream" method. * - * @note This callback returns invalid when the number of users in a - * channel exceeds 20. + * @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. * * @param uid User ID of the remote user. * @param muted Whether the remote user's video stream playback is @@ -2982,7 +3851,8 @@ class IRtcEngineEventHandler /** Occurs when a specific remote user enables/disables the video * module. * - * @deprecated + * @deprecated v2.9.0 + * * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -3054,7 +3924,7 @@ class IRtcEngineEventHandler /** Occurs when the camera focus area changes. The SDK triggers this callback when the local user changes the camera focus position by calling the setCameraFocusPositionInPreview method. - + @note This callback is for Android and iOS only. @param x x coordinate of the changed camera focus area. @@ -3068,13 +3938,47 @@ class IRtcEngineEventHandler (void)width; (void)height; } - +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** + * Reports the face detection result of the local user. Applies to Android and iOS only. + * @since v3.0.1 + * + * Once you enable face detection by calling \ref IRtcEngine::enableFaceDetection "enableFaceDetection"(true), you can get the following information on the local user in real-time: + * - The width and height of the local video. + * - The position of the human face in the local video. + * - The distance between the human face and the device screen. This value is based on the fitting calculation of the local video size and the position of the human face. + * + * @note + * - If the SDK does not detect a face, it reduces the frequency of this callback to reduce power consumption on the local device. + * - The SDK stops triggering this callback when a human face is in close proximity to the screen. + * - On Android, the `distance` value reported in this callback may be slightly different from the actual distance. Therefore, Agora does not recommend using it for + * accurate calculation. + * @param imageWidth The width (px) of the local video. + * @param imageHeight The height (px) of the local video. + * @param vecRectangle The position and size of the human face on the local video: + * - `x`: The x coordinate (px) of the human face in the local video. Taking the top left corner of the captured video as the origin, + * the x coordinate represents the relative lateral displacement of the top left corner of the human face to the origin. + * - `y`: The y coordinate (px) of the human face in the local video. Taking the top left corner of the captured video as the origin, + * the y coordinate represents the relative longitudinal displacement of the top left corner of the human face to the origin. + * - `width`: The width (px) of the human face in the captured video. + * - `height`: The height (px) of the human face in the captured video. + * @param vecDistance The distance (cm) between the human face and the screen. + * @param numFaces The number of faces detected. If the value is 0, it means that no human face is detected. + */ + virtual void onFacePositionChanged(int imageWidth, int imageHeight, Rectangle* vecRectangle, int* vecDistance, int numFaces){ + (void)imageWidth; + (void)imageHeight; + (void)vecRectangle; + (void)vecDistance; + (void)numFaces; + } +#endif /** Occurs when the camera exposure area changes. The SDK triggers this callback when the local user changes the camera exposure position by calling the setCameraExposurePosition method. - + @note This callback is for Android and iOS only. - + @param x x coordinate of the changed camera exposure area. @param y y coordinate of the changed camera exposure area. @param width Width of the changed camera exposure area. @@ -3101,13 +4005,14 @@ class IRtcEngineEventHandler /** Occurs when the state of the local user's audio mixing file changes. - - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. - - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. - - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. + When you call the \ref IRtcEngine::startAudioMixing "startAudioMixing" method and the state of audio mixing file changes, the SDK triggers this callback. + - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. + - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. + - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - @param state The state code. See #AUDIO_MIXING_STATE_TYPE. - @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. - */ + @param state The state code. See #AUDIO_MIXING_STATE_TYPE. + @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. + */ virtual void onAudioMixingStateChanged(AUDIO_MIXING_STATE_TYPE state, AUDIO_MIXING_ERROR_TYPE errorCode){ } /** Occurs when a remote user starts audio mixing. @@ -3134,6 +4039,10 @@ class IRtcEngineEventHandler /** Occurs when the SDK decodes the first remote audio frame for playback. + @deprecated v3.0.0 + + This callback is deprecated. Use `onRemoteAudioStateChanged` instead. + This callback is triggered in either of the following scenarios: - The remote user joins the channel and sends the audio stream. @@ -3193,14 +4102,15 @@ class IRtcEngineEventHandler (void)rotation; } /** Occurs when the remote video state changes. - * - * @param uid ID of the remote user whose video state changes. - * @param state State of the remote video. See #REMOTE_VIDEO_STATE. - * @param reason The reason of the remote video state change. See - * #REMOTE_VIDEO_STATE_REASON. - * @param elapsed Time elapsed (ms) from the local user calling the - * \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the - * SDK triggers this callback. + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param uid ID of the remote user whose video state changes. + @param state State of the remote video. See #REMOTE_VIDEO_STATE. + @param reason The reason of the remote video state change. See + #REMOTE_VIDEO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the + SDK triggers this callback. */ virtual void onRemoteVideoStateChanged(uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { (void)uid; @@ -3209,10 +4119,11 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a specified remote user enables/disables the local video + /** Occurs when a specified remote user enables/disables the local video * capturing function. * - * @deprecated + * @deprecated v2.9.0 + * * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -3282,6 +4193,27 @@ class IRtcEngineEventHandler /** Occurs when the media engine call starts.*/ virtual void onMediaEngineStartCallSuccess() { } + /// @cond + /** Reports whether the super-resolution algorithm is enabled. + * + * @since v3.2.0 + * + * After calling \ref IRtcEngine::enableRemoteSuperResolution "enableRemoteSuperResolution", the SDK triggers this + * callback to report whether the super-resolution algorithm is successfully enabled. If not successfully enabled, + * you can use reason for troubleshooting. + * + * @param uid The ID of the remote user. + * @param enabled Whether the super-resolution algorithm is successfully enabled: + * - true: The super-resolution algorithm is successfully enabled. + * - false: The super-resolution algorithm is not successfully enabled. + * @param reason The reason why the super-resolution algorithm is not successfully enabled. See #SUPER_RESOLUTION_STATE_REASON. + */ + virtual void onUserSuperResolutionEnabled(uid_t uid, bool enabled, SUPER_RESOLUTION_STATE_REASON reason) { + (void)uid; + (void)enabled; + (void)reason; + } + /// @endcond /** Occurs when the state of the media stream relay changes. * @@ -3303,14 +4235,35 @@ class IRtcEngineEventHandler /** Occurs when the engine sends the first local audio frame. - @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. - */ + @deprecated Deprecated as of v3.1.0. Use the \ref IRtcEngineEventHandler::onFirstLocalAudioFramePublished "onFirstLocalAudioFramePublished" callback instead. + + @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ virtual void onFirstLocalAudioFrame(int elapsed) { (void)elapsed; } + /** Occurs when the first audio frame is published. + * + * @since v3.1.0 + * + * The SDK triggers this callback under one of the following circumstances: + * - The local client enables the audio module and calls \ref IRtcEngine::joinChannel "joinChannel" successfully. + * - The local client calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" and \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(false)" in sequence. + * - The local client calls \ref IRtcEngine::disableAudio "disableAudio" and \ref IRtcEngine::enableAudio "enableAudio" in sequence. + * + * @param elapsed The time elapsed (ms) from the local client calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ + virtual void onFirstLocalAudioFramePublished(int elapsed) { + (void)elapsed; + } + /** Occurs when the engine receives the first audio frame from a specific remote user. + @deprecated v3.0.0 + + This callback is deprecated. Use `onRemoteAudioStateChanged` instead. + @param uid User ID of the remote user. @param elapsed Time elapsed (ms) from the remote user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. */ @@ -3336,7 +4289,21 @@ class IRtcEngineEventHandler (void) errCode; } - /** Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) + /** Reports events during the RTMP streaming. + * + * @since v3.1.0 + * + * @param url The RTMP streaming URL. + * @param eventCode The event code. See #RTMP_STREAMING_EVENT + */ + virtual void onRtmpStreamingEvent(const char* url, RTMP_STREAMING_EVENT eventCode) { + (void) url; + (void) eventCode; + } + + /** @deprecated This method is deprecated, use the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback instead. + + Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) @param url The RTMP URL address. @param error Error code: #ERROR_CODE_TYPE. Main errors include: @@ -3357,7 +4324,9 @@ class IRtcEngineEventHandler (void)url; (void)error; } - /** Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) + /** @deprecated This method is deprecated, use the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback instead. + + Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) This callback indicates whether you have successfully removed an RTMP stream from the CDN. @@ -3366,16 +4335,16 @@ class IRtcEngineEventHandler virtual void onStreamUnpublished(const char *url) { (void)url; } -/** Occurs when the publisher's transcoding is updated. - * +/** Occurs when the publisher's transcoding is updated. + * * When the `LiveTranscoding` class in the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. - * + * * @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - * + * */ virtual void onTranscodingUpdated() { } - /** Occurs when a voice or video stream URL address is added to a live broadcast. + /** Occurs when a voice or video stream URL address is added to the live interactive streaming. @param url Pointer to the URL address of the externally injected stream. @param uid User ID. @@ -3388,24 +4357,21 @@ class IRtcEngineEventHandler } /** Occurs when the local audio route changes. - - The SDK triggers this callback when the local audio route switches to an earpiece, speakerphone, headset, or Bluetooth device. - - @note This callback is for Android and iOS only. - - @param routing Audio output routing. See: #AUDIO_ROUTE_TYPE. + @param routing The current audio routing. See: #AUDIO_ROUTE_TYPE. */ virtual void onAudioRouteChanged(AUDIO_ROUTE_TYPE routing) { - (void)routing; - } + (void)routing; + } - /** Occurs when the locally published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. + /** Occurs when the published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. - If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the locally published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the + published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + @note If the local stream fallbacks to the audio-only stream, the remote user receives the \ref IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback. - @param isFallbackOrRecover Whether the locally published stream falls back to audio-only or switches back to the video: - - true: The locally published stream falls back to audio-only due to poor network conditions. - - false: The locally published stream switches back to the video after the network conditions improve. + @param isFallbackOrRecover Whether the published stream falls back to audio-only or switches back to the video: + - true: The published stream falls back to audio-only due to poor network conditions. + - false: The published stream switches back to the video after the network conditions improve. */ virtual void onLocalPublishFallbackToAudioOnly(bool isFallbackOrRecover) { (void)isFallbackOrRecover; @@ -3494,7 +4460,9 @@ class IRtcEngineEventHandler (void)rxKBitRate; } - /** **DEPRECATED** Occurs when the microphone is enabled/disabled. + /** Occurs when the microphone is enabled/disabled. + * + * @deprecated v2.9.0 * * The \ref onMicrophoneEnabled() "onMicrophoneEnabled" callback is * deprecated. Use #LOCAL_AUDIO_STREAM_STATE_STOPPED (0) or @@ -3504,7 +4472,7 @@ class IRtcEngineEventHandler * * The SDK triggers this callback when the local user resumes or stops * capturing the local audio stream by calling the - * \ref agora::rtc::IRtcEngine::enableLocalAudio "enbaleLocalAudio" method. + * \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio" method. * * @param enabled Whether the microphone is enabled/disabled: * - true: Enabled. @@ -3526,7 +4494,7 @@ class IRtcEngineEventHandler /** Occurs when the local network type changes. - When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. + When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. @param type See #NETWORK_TYPE. */ @@ -3609,7 +4577,9 @@ class IVideoDeviceManager /** Enumerates the video devices. - This method returns an IVideoDeviceCollection object including all video devices in the system. With the IVideoDeviceCollection object, the application can enumerate the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. + This method returns an IVideoDeviceCollection object including all video devices + in the system. With the IVideoDeviceCollection object, the application can enumerate + the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. @return - An IVideoDeviceCollection object including all video devices in the system: Success. @@ -4007,20 +4977,32 @@ struct RtcEngineContext /** The IRtcEngineEventHandler object. */ IRtcEngineEventHandler* eventHandler; - /** App ID issued to you by Agora. Apply for a new App ID from Agora if - * it is missing from your kit. + /** + * The App ID issued to you by Agora. See [How to get the App ID](https://docs.agora.io/en/Agora%20Platform/token#get-an-app-id). + * Only users in apps with the same App ID can join the same channel and communicate with each other. Use an App ID to create only + * one `IRtcEngine` instance. To change your App ID, call `release` to destroy the current `IRtcEngine` instance and then call `createAgoraRtcEngine` + * and `initialize` to create an `IRtcEngine` instance with the new App ID. */ const char* appId; // For android, it the context(Activity or Application - // for windows,Video hot plug device + // for windows,Video hot plug device /** The video window handle. Once set, this parameter enables you to plug * or unplug the video devices while they are powered. */ - void* context; + void* context; + /** + * The region for connection. This advanced feature applies to scenarios that have regional restrictions. + * + * For the regions that Agora supports, see #AREA_CODE. After specifying the region, the SDK connects to the Agora servers within that region. + * + * @note The SDK supports specify only one region. + */ + unsigned int areaCode; RtcEngineContext() :eventHandler(NULL) ,appId(NULL) ,context(NULL) + ,areaCode(rtc::AREA_CODE_GLOB) {} }; @@ -4056,7 +5038,7 @@ class IMetadataObserver /** Buffer address of the sent or received Metadata. */ unsigned char *buffer; - /** Time statmp of the frame following the metadata. + /** Timestamp (ms) of the frame following the metadata. */ long long timeStampMs; }; @@ -4069,7 +5051,7 @@ class IMetadataObserver - `uid`: ID of the user who sends the metadata. - `size`: The size of the sent or received metadata. - `buffer`: The sent or received metadata. - - `timeStampMs`: The timestamp of the metadata. + - `timeStampMs`: The timestamp (ms) of the metadata. The SDK triggers this callback after you successfully call the \ref agora::rtc::IRtcEngine::registerMediaMetadataObserver "registerMediaMetadataObserver" method. You need to specify the maximum size of the metadata in the return value of this callback. @@ -4095,11 +5077,70 @@ class IMetadataObserver virtual void onMetadataReceived(const Metadata &metadata) = 0; }; -/** IRtcEngine is the base interface class of the Agora SDK that provides the main Agora SDK methods invoked by your application. - -Enable the Agora SDK's communication functionality through the creation of an IRtcEngine object, then call the methods of this object. - */ -class IRtcEngine +/** Encryption mode. +*/ +enum ENCRYPTION_MODE +{ + /** 1: (Default) 128-bit AES encryption, XTS mode. + */ + AES_128_XTS = 1, + /** 2: 128-bit AES encryption, ECB mode. + */ + AES_128_ECB = 2, + /** 3: 256-bit AES encryption, XTS mode. + */ + AES_256_XTS = 3, + /** 4: 128-bit SM4 encryption, ECB mode. + */ + SM4_128_ECB = 4, + /** Enumerator boundary. + */ + MODE_END, +}; + +/** Configurations of built-in encryption schemas. */ +struct EncryptionConfig{ + /** + * Encryption mode. The default encryption mode is `AES_128_XTS`. See #ENCRYPTION_MODE. + */ + ENCRYPTION_MODE encryptionMode; + /** + * Encryption key in string type. + * + * @note If you do not set an encryption key or set it as NULL, you cannot use the built-in encryption, and the SDK returns #ERR_INVALID_ARGUMENT (-2). + */ + const char* encryptionKey; + + EncryptionConfig() { + encryptionMode = AES_128_XTS; + encryptionKey = nullptr; + } + + /// @cond + const char* getEncryptionString() const { + switch(encryptionMode) + { + case AES_128_XTS: + return "aes-128-xts"; + case AES_128_ECB: + return "aes-128-ecb"; + case AES_256_XTS: + return "aes-256-xts"; + case SM4_128_ECB: + return "sm4-128-ecb"; + default: + return "aes-128-xts"; + } + return "aes-128-xts"; + } + /// @endcond +}; + +/** IRtcEngine is the base interface class of the Agora SDK that provides the main Agora SDK methods invoked by your application. + +Enable the Agora SDK's communication functionality through the creation of an IRtcEngine object, then call the methods of this object. + */ +class IRtcEngine { protected: virtual ~IRtcEngine() {} @@ -4107,64 +5148,132 @@ class IRtcEngine /** Initializes the Agora service. * - * Ensure that you call the + * Unless otherwise specified, all the methods provided by the IRtcEngine class are executed asynchronously. Agora recommends calling these methods in the same thread. + * + * @note Ensure that you call the * \ref agora::rtc::IRtcEngine::createAgoraRtcEngine * "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize - * "initialize" methods before calling any other API. + * "initialize" methods before calling any other APIs. * * @param context Pointer to the RTC engine context. See RtcEngineContext. * * @return - * - 0: Success. + * - 0(ERR_OK): Success. * - < 0: Failure. - * - `ERR_INVALID_APP_ID (101)`: The app ID is invalid. Check if it is in the correct format. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): No `IRtcEngineEventHandler` object is specified. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Check whether `context` is properly set. + * - -22(ERR_RESOURCE_LIMITED): The resource is limited. The app uses too much of the system resource and fails to allocate any resources. + * - -101(ERR_INVALID_APP_ID): The App ID is invalid. */ virtual int initialize(const RtcEngineContext& context) = 0; /** Releases all IRtcEngine resources. - - @param sync - - true: (Synchronous call) The result returns after the IRtcEngine resources are released. The application should not call this method in the SDK generated callbacks. Otherwise, the SDK must wait for the callbacks to return to recover the associated IRtcEngine resources, resulting in a deadlock. The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to take additional time. - - false: (Asynchronous call) The result returns immediately, even when the IRtcEngine resources have not been released. The SDK releases all resources. - - @note Do not immediately uninstall the SDK's dynamic library after the call, or it may cause a crash due to the SDK clean-up thread not quitting. - */ - virtual void release(bool sync=false) = 0; - - /** Sets the channel profile of the Agora RtcEngine. - - The Agora RtcEngine differentiates channel profiles and applies optimization algorithms accordingly. - For example, it prioritizes smoothness and low latency for a video call, and prioritizes video quality for a video broadcast. - - @note - - To ensure the quality of real-time communication, we recommend that all users in a channel use the same channel profile. - - Call this method before calling \ref IRtcEngine::joinChannel "joinChannel" . You cannot set the channel profile once you have joined the channel. - - @param profile The channel profile of the Agora RtcEngine. See #CHANNEL_PROFILE_TYPE - @return - - 0: Success. - - < 0: Failure. + * + * Use this method for apps in which users occasionally make voice or video calls. When users do not make calls, you + * can free up resources for other operations. Once you call `release` to destroy the created `IRtcEngine` instance, + * you cannot use any method or callback in the SDK any more. If you want to use the real-time communication functions + * again, you must call \ref createAgoraRtcEngine "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize "initialize" + * to create a new `IRtcEngine` instance. + * + * @note If you want to create a new `IRtcEngine` instance after destroying the current one, ensure that you wait + * till the `release` method completes executing. + * + * @param sync + * - true: Synchronous call. Agora suggests calling this method in a sub-thread to avoid congestion in the main thread + * because the synchronous call and the app cannot move on to another task until the execution completes. + * Besides, you **cannot** call this method in any method or callback of the SDK. Otherwise, the SDK cannot release the + * resources occupied by the `IRtcEngine` instance until the callbacks return results, which may result in a deadlock. + * The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to + * take additional time. + * - false: Asynchronous call. Do not immediately uninstall the SDK's dynamic library after the call, or it may cause + * a crash due to the SDK clean-up thread not quitting. + */ + AGORA_CPP_API static void release (bool sync = false); + + /** Sets the channel profile of the Agora IRtcEngine. + * + * The Agora IRtcEngine differentiates channel profiles and applies optimization algorithms accordingly. + * For example, it prioritizes smoothness and low latency for a video call, and prioritizes video quality for the live interactive video streaming. + * + * @warning + * - To ensure the quality of real-time communication, we recommend that all users in a channel use the same channel profile. + * - Call this method before calling \ref IRtcEngine::joinChannel "joinChannel" . You cannot set the channel profile once you have joined the channel. + * - The default audio route and video encoding bitrate are different in different channel profiles. For details, see + * \ref IRtcEngine::setDefaultAudioRouteToSpeakerphone "setDefaultAudioRouteToSpeakerphone" and \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". + * + * @param profile The channel profile of the Agora IRtcEngine. See #CHANNEL_PROFILE_TYPE + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -2 (ERR_INVALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int setChannelProfile(CHANNEL_PROFILE_TYPE profile) = 0; - /** Sets the role of the user, such as a host or an audience (default), before joining a channel in a live broadcast. - - This method can be used to switch the user role in a live broadcast after the user joins a channel. - - In the Live Broadcast profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: - - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) - - @note - This method applies only to the Live-broadcast profile. - - @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. - @return - - 0: Success. - - < 0: Failure. + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in the live interactive streaming. + * + * This method can be used to switch the user role in the live interactive streaming after the user joins a channel. + * + * In the `LIVE_BROADCASTING` profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: + * - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" + * - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) + * + * @note + * This method applies only to the `LIVE_BROADCASTING` profile. + * + * @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; - + /// @cond + /** Sets the role of a user in a live interactive streaming. + * + * @since v3.2.0 + * + * You can call this method either before or after joining the channel to set the user role as audience or host. If + * you call this method to switch the user role after joining the channel, the SDK triggers the following callbacks: + * - The local client: \ref IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged". + * - The remote client: \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" + * or \ref IRtcEngineEventHandler::onUserOffline "onUserOffline". + * + * @note + * - This method applies to the `LIVE_BROADCASTING` profile only (when the `profile` parameter in + * \ref IRtcEngine::setChannelProfile "setChannelProfile" is set as `CHANNEL_PROFILE_LIVE_BROADCASTING`). + * - The difference between this method and \ref IRtcEngine::setClientRole(CLIENT_ROLE_TYPE) "setClientRole1" is that + * this method can set the user level in addition to the user role. + * - The user role determines the permissions that the SDK grants to a user, such as permission to send local + * streams, receive remote streams, and push streams to a CDN address. + * - The user level determines the level of services that a user can enjoy within the permissions of the user's + * role. For example, an audience can choose to receive remote streams with low latency or ultra low latency. Levels + * affect prices. + * + * **Example** + * ```cpp + * ClientRoleOptions options; + * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY; + * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_LOW_LATENCY; + * agoraEngine->setClientRole(role, options); + * ``` + * + * @param role The role of a user in a live interactive streaming. See #CLIENT_ROLE_TYPE. + * @param options The detailed options of a user, including user level. See ClientRoleOptions. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + */ + virtual int setClientRole(CLIENT_ROLE_TYPE role, const ClientRoleOptions& options) = 0; + /// @endcond /** Joins a channel with the user ID. Users in the same channel can talk to each other, and multiple users in the same channel can start a group chat. Users with different App IDs cannot call each other. @@ -4174,36 +5283,38 @@ class IRtcEngine A successful \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method call triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. When the connection between the client and Agora's server is interrupted due to poor network conditions, the SDK tries reconnecting to the server. When the local client successfully rejoins the channel, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRejoinChannelSuccess "onRejoinChannelSuccess" callback on the local client. @note A channel does not accept duplicate uids, such as two users with the same @p uid. If you set @p uid as 0, the system automatically assigns a @p uid. If you want to join a channel from different devices, ensure that each device has a different uid. @warning Ensure that the App ID used for creating the token is the same App ID used by the \ref IRtcEngine::initialize "initialize" method for initializing the RTC engine. Otherwise, the CDN live streaming may fail. - @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a Channel Key. + @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a token. - If the user uses a static App ID, *token* is optional and can be set as NULL. - - If the user uses a Channel Key, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. + - If the user uses a token, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. @param channelId Pointer to the unique channel name for the Agora RTC session in the string format smaller than 64 bytes. Supported characters: - - The 26 lowercase English letters: a to z - - The 26 uppercase English letters: A to Z - - The 10 numbers: 0 to 9 - - The space - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", "," + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @param info (Optional) Pointer to additional information about the channel. This parameter can be set to NULL or contain channel related information. Other users in the channel will not receive this message. @param uid (Optional) User ID. A 32-bit unsigned integer with a value ranging from 1 to 232-1. The @p uid must be unique. If a @p uid is not assigned (or set to 0), the SDK assigns and returns a @p uid in the \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. Your application must record and maintain the returned *uid* since the SDK does not do so. @return - - 0: Success. - - < 0: Failure: - - #ERR_INVALID_ARGUMENT (-2) - - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) + - 0(ERR_OK): Success. + - < 0: Failure. + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. + - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: + - You have created an IChannel object with the same channel name. + - You have joined and published a stream in a channel created by the IChannel object. */ virtual int joinChannel(const char* token, const char* channelId, const char* info, uid_t uid) = 0; /** Switches to a different channel. * - * This method allows the audience of a Live-broadcast channel to switch + * This method allows the audience of a `LIVE_BROADCASTING` channel to switch * to a different channel. * * After the user successfully switches to another channel, the @@ -4213,35 +5324,37 @@ class IRtcEngine * user has left the original channel and joined a new one. * * @note - * This method applies to the audience role in a Live-broadcast channel + * This method applies to the audience role in a `LIVE_BROADCASTING` channel * only. * * @param token The token generated at your server: * - For low-security requirements: You can use the temporary token * generated in Console. For details, see - * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-temporary-token). + * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platform=All%20Platforms#generate-a-token). * - For high-security requirements: Use the token generated at your * server. For details, see - * [Get a token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-token). + * [Get a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=All%20Platforms). * @param channelId Unique channel name for the AgoraRTC session in the * string format. The string length must be less than 64 bytes. Supported * character scopes are: - * - The 26 lowercase English letters: a to z. - * - The 26 uppercase English letters: A to Z. - * - The 10 numbers: 0 to 9. - * - The space. - * - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", - * ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". - - @return - - 0: Success. - - < 0: Failure. - - #ERR_INVALID_ARGUMENT (-2) - - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) + * - All lowercase English letters: a to z. + * - All uppercase English letters: A to Z. + * - All numeric characters: 0 to 9. + * - The space character. + * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -5(ERR_REFUSED): The request is rejected, probably because the user is not an audience. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + * - -102(ERR_INVALID_CHANNEL_NAME): The channel name is invalid. + * - -113(ERR_NOT_IN_CHANNEL): The user is not in the channel. */ virtual int switchChannel(const char* token, const char* channelId) = 0; - + /** Allows a user to leave a channel, such as hanging up or exiting a call. After joining a channel, the user must call the *leaveChannel* method to end the call before joining another channel. @@ -4252,18 +5365,21 @@ class IRtcEngine A successful \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method call triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a BROADCASTER in the Live Broadcast profile. + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the `COMMUNICATION` channel, or is a host in the `LIVE_BROADCASTING` profile. @note - If you call the \ref IRtcEngine::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int leaveChannel() = 0; - + /** Gets a new token when the current token expires after a period of time. The `token` expires after a period of time once the token schema is enabled when: @@ -4274,9 +5390,13 @@ class IRtcEngine The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. @param token Pointer to the new token. + @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int renewToken(const char* token) = 0; @@ -4311,11 +5431,11 @@ class IRtcEngine @param appId The App ID of your project. @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @return - 0: Success. @@ -4328,7 +5448,7 @@ class IRtcEngine After the user successfully joins the channel, the SDK triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. @@ -4337,29 +5457,29 @@ class IRtcEngine - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @return - 0: Success. - < 0: Failure. - #ERR_INVALID_ARGUMENT (-2) - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) + - #ERR_REFUSED (-5) */ virtual int joinChannelWithUserAccount(const char* token, const char* channelId, const char* userAccount) = 0; - + /** Gets the user information by passing in the user account. After a remote user joins the channel, the SDK gets the user ID and user account of the remote user, caches them @@ -4369,7 +5489,7 @@ class IRtcEngine remote user from the `userInfo` object by passing in the user account. @param userAccount The user account of the user. Ensure that you set this parameter. - @param[in/out] userInfo A userInfo object that identifies the user: + @param [in,out] userInfo A userInfo object that identifies the user: - Input: A userInfo object. - Output: A userInfo object that contains the user account and user ID of the user. @@ -4387,7 +5507,7 @@ class IRtcEngine from the `userInfo` object by passing in the user ID. @param uid The user ID of the remote user. Ensure that you set this parameter. - @param[in/out] userInfo A userInfo object that identifies the user: + @param[in,out] userInfo A userInfo object that identifies the user: - Input: A userInfo object. - Output: A userInfo object that contains the user account and user ID of the user. @@ -4410,7 +5530,7 @@ class IRtcEngine @note - After calling this method, always call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the application cannot run the next echo test. - - In the Live-broadcast profile, only the hosts can call this method. If the user switches from the Communication to Live-broadcast profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. + - In the `LIVE_BROADCASTING` profile, only the hosts can call this method. If the user switches from the `COMMUNICATION` to`LIVE_BROADCASTING` profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. @return - 0: Success. @@ -4427,7 +5547,7 @@ class IRtcEngine @note - Call this method before joining a channel. - After calling this method, call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the app cannot run the next echo test, or call the \ref IRtcEngine::joinChannel "joinChannel" method. - - In the Live-broadcast profile, only a host can call this method. + - In the `LIVE_BROADCASTING` profile, only a host can call this method. @param intervalInSeconds The time interval (s) between when you speak and when the recording plays back. @return @@ -4489,6 +5609,7 @@ class IRtcEngine Each video profile includes a set of parameters, such as the resolution, frame rate, and bitrate. If the camera device does not support the specified resolution, the SDK automatically chooses a suitable camera resolution, keeping the encoder resolution specified by the *setVideoProfile* method. @note + - You can call this method either before or after joining a channel. - If you do not need to set the video profile after joining the channel, call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. - Always set the video profile before calling the \ref IRtcEngine::joinChannel "joinChannel" or \ref IRtcEngine::startPreview "startPreview" method. @@ -4511,7 +5632,9 @@ class IRtcEngine The parameters specified in this method are the maximum values under ideal network conditions. If the video engine cannot render the video using the specified parameters due to poor network conditions, the parameters further down the list are considered until a successful configuration is found. - @note If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. + @note + - You can call this method either before or after joining a channel. + - If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. @param config Sets the local video encoder configuration. See VideoEncoderConfiguration. @return @@ -4521,7 +5644,7 @@ class IRtcEngine virtual int setVideoEncoderConfiguration(const VideoEncoderConfiguration& config) = 0; /** Sets the camera capture configuration. - For a video call or live broadcast, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: + For a video call or the live interactive video streaming, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to avoid such problems. - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to optimize CPU and RAM usage. @@ -4540,13 +5663,14 @@ class IRtcEngine /** Initializes the local video view. This method initializes the video view of a local stream on the local device. It affects only the video view that the local user sees, not the published local video stream. - + Call this method to bind the local video stream to a video view and to set the rendering and mirror modes of the video view. The binding is still valid after the user leaves the channel, which means that the window still displays. To unbind the view, set the *view* in VideoCanvas to NULL. - - @note - - Call this method before joining a channel. - - To update the rendering or mirror mode of the local video view during a call, use the \ref IRtcEngine::setLocalRenderMode "setLocalRenderMode" method. + + @note + - You can call this method either before or after joining a channel. + - During a call, you can call this method as many times as necessary to update the display mode of the local video view. + @param canvas Pointer to the local video view and settings. See VideoCanvas. @return - 0: Success. @@ -4589,17 +5713,19 @@ class IRtcEngine virtual int startPreview() = 0; /** Prioritizes a remote user's stream. - - Use this method with the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. If the fallback function is enabled for a subscribed stream, the SDK ensures the high-priority user gets the best possible stream quality. - - @note The Agora SDK supports setting @p userPriority as high for one user only. - - @param uid The ID of the remote user. - @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. - - @return - - 0: Success. - - < 0: Failure. + * + * The SDK ensures the high-priority user gets the best possible stream quality. + * + * @note + * - The Agora SDK supports setting @p userPriority as high for one user only. + * - Ensure that you call this method before joining a channel. + * + * @param uid The ID of the remote user. + * @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; @@ -4631,21 +5757,21 @@ class IRtcEngine /** Disables/Re-enables the local audio function. - The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. + The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. - This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to - receive remote audio streams without sending any audio stream to other users in the channel. + This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to + receive remote audio streams without sending any audio stream to other users in the channel. - The SDK triggers the \ref IRtcEngineEventHandler::onMicrophoneEnabled "onMicrophoneEnabled" callback once the local audio function is disabled or enabled. + Once the local audio function is disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalAudioStateChanged "onLocalAudioStateChanged" callback, + which reports `LOCAL_AUDIO_STREAM_STATE_STOPPED(0)` or `LOCAL_AUDIO_STREAM_STATE_RECORDING(1)`. @note - - Call this method after the \ref IRtcEngine::joinChannel "joinChannel" method. - This method is different from the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method: - - - \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio": Disables/Re-enables the local audio capturing and processing. + - \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio": Disables/Re-enables the local audio capturing and processing. If you disable or re-enable local audio recording using the `enableLocalAudio` method, the local user may hear a pause in the remote audio playback. - \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream": Sends/Stops sending the local audio streams. - + - You can call this method either before or after joining a channel. + @param enabled Sets whether to disable/re-enable the local audio function: - true: (Default) Re-enable the local audio function, that is, to start the local audio capturing device (for example, the microphone). - false: Disable the local audio function, that is, to stop local audio capturing. @@ -4668,15 +5794,17 @@ class IRtcEngine */ virtual int disableAudio() = 0; - /** Sets the audio parameters and application scenarios. + /** Sets the audio parameters and application scenarios. @note - - The *setAudioProfile* method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. - - In the Communication and Live-broadcast profiles, the bitrate may be different from your settings due to network self-adaptation. + - The `setAudioProfile` method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. + - In the `COMMUNICATION` and `LIVE_BROADCASTING` profiles, the bitrate may be different from your settings due to network self-adaptation. - In scenarios requiring high-quality audio, for example, a music teaching scenario, we recommend setting profile as AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) and scenario as AUDIO_SCENARIO_GAME_STREAMING (3). @param profile Sets the sample rate, bitrate, encoding mode, and the number of channels. See #AUDIO_PROFILE_TYPE. - @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. Under different audio scenarios, the device uses different volume tracks, i.e. either the in-call volume or the media volume. For details, see [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). + @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. + Under different audio scenarios, the device uses different volume types. For details, see + [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). @return - 0: Success. @@ -4686,9 +5814,10 @@ class IRtcEngine /** Stops/Resumes sending the local audio stream. A successful \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteAudio "onUserMuteAudio" callback on the remote client. - @note + + @note - When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. - - If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local audio according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. + - You can call this method either before or after joining a channel. If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local audio according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. @param mute Sets whether to send/stop sending the local audio stream: - true: Stops sending the local audio stream. @@ -4701,6 +5830,8 @@ class IRtcEngine virtual int muteLocalAudioStream(bool mute) = 0; /** Stops/Resumes receiving all remote users' audio streams. + @note You can call this method either before or after joining a channel. + @param mute Sets whether to receive/stop receiving all remote users' audio streams. - true: Stops receiving all remote users' audio streams. - false: (Default) Receives all remote users' audio streams. @@ -4709,9 +5840,16 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteAllRemoteAudioStreams(bool mute) = 0; + virtual int muteAllRemoteAudioStreams(bool mute) = 0; /** Stops/Resumes receiving all remote users' audio streams by default. + You can call this method either before or after joining a channel. If you call `setDefaultMuteAllRemoteAudioStreams (true)` after joining a channel, the remote audio streams of all subsequent users are not received. + + @note If you want to resume receiving the audio stream, call \ref agora::rtc::IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream (false)", + and specify the ID of the remote user whose audio stream you want to receive. + To receive the audio streams of multiple remote users, call `muteRemoteAudioStream (false)` as many times. + Calling `setDefaultMuteAllRemoteAudioStreams (false)` resumes receiving the audio streams of subsequent users only. + @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: - true: Stops receiving all remote users' audio streams by default. - false: (Default) Receives all remote users' audio streams by default. @@ -4720,12 +5858,12 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - + virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; + /** Adjusts the playback volume of a specified remote user. You can call this method as many times as necessary to adjust the playback volume of different remote users, or to repeatedly adjust the playback volume of the same remote user. - + @note - Call this method after joining a channel. - The playback volume here refers to the mixed volume of a specified remote user. @@ -4738,31 +5876,34 @@ class IRtcEngine @return - 0: Success. - - < 0: Failure. + - < 0: Failure. */ virtual int adjustUserPlaybackSignalVolume(unsigned int uid, int volume) = 0; - /** Stops/Resumes receiving a specified remote user's audio stream. + /** Stops/Resumes receiving a specified remote user's audio stream. - @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. + @note + - You can call this method either before or after joining a channel. If you call it before joining a channel, + you need to maintain the `uid` of the remote user on your app level. + - If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. - @param userId User ID of the specified remote user sending the audio. - @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: - - true: Stops receiving the specified remote user's audio stream. - - false: (Default) Receives the specified remote user's audio stream. + @param userId User ID of the specified remote user sending the audio. + @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: + - true: Stops receiving the specified remote user's audio stream. + - false: (Default) Receives the specified remote user's audio stream. - @return - - 0: Success. - - < 0: Failure. + @return + - 0: Success. + - < 0: Failure. - */ - virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; + */ + virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; /** Stops/Resumes sending the local video stream. A successful \ref agora::rtc::IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback on the remote client. - - @note + + @note - When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. - - If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local video according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. + - You can call this method either before or after joining a channel. If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local video according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. @param mute Sets whether to send/stop sending the local video stream: - true: Stop sending the local video stream. @@ -4772,7 +5913,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteLocalVideoStream(bool mute) = 0; + virtual int muteLocalVideoStream(bool mute) = 0; /** Enables/Disables the local video capture. This method disables or re-enables the local video capturer, and does not affect receiving the remote video stream. @@ -4780,8 +5921,10 @@ class IRtcEngine After you call the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method, the local video capturer is enabled by default. You can call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local video capturer. If you want to re-enable it, call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(true)". After the local video capturer is successfully disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableLocalVideo "onUserEnableLocalVideo" callback on the remote client. - - @note This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + + @note + - You can call this method either before or after joining a channel. + - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. @param enabled Sets whether to disable/re-enable the local video, including the capturer, renderer, and sender: - true: (Default) Re-enable the local video. @@ -4791,9 +5934,11 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int enableLocalVideo(bool enabled) = 0; + virtual int enableLocalVideo(bool enabled) = 0; /** Stops/Resumes receiving all video stream from a specified remote user. + @note You can call this method either before or after joining a channel. + @param mute Sets whether to receive/stop receiving all remote users' video streams: - true: Stop receiving all remote users' video streams. - false: (Default) Receive all remote users' video streams. @@ -4802,9 +5947,13 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteAllRemoteVideoStreams(bool mute) = 0; + virtual int muteAllRemoteVideoStreams(bool mute) = 0; /** Stops/Resumes receiving all remote users' video streams by default. + You can call this method either before or after joining a channel. If you call `setDefaultMuteAllRemoteVideoStreams (true)` after joining a channel, the remote video streams of all subsequent users are not received. + + @note If you want to resume receiving the video stream, call \ref agora::rtc::IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream (false)", and specify the ID of the remote user whose video stream you want to receive. To receive the video streams of multiple remote users, call `muteRemoteVideoStream (false)` as many times. Calling `setDefaultMuteAllRemoteVideoStreams (false)` resumes receiving the video streams of subsequent users only. + @param mute Sets whether to receive/stop receiving all remote users' video streams by default: - true: Stop receiving all remote users' video streams by default. - false: (Default) Receive all remote users' video streams by default. @@ -4813,10 +5962,13 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; + virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; /** Stops/Resumes receiving the video stream from a specified remote user. - @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. + @note + - You can call this method either before or after joining a channel. If you call it before joining a channel, you + need to maintain the `uid` of the remote user on your app level. + - If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. @param userId User ID of the specified remote user. @param mute Sets whether to stop/resume receiving the video stream from a specified remote user: @@ -4827,16 +5979,26 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; - /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. + virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; + /** Sets the stream type of the remote video. + + Under limited network conditions, if the publisher has not disabled the dual-stream mode using `enableDualStreamMode(false)`, + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). + + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. - This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. + The aspect ratio of the low-video stream is the same as the high-quality video stream. Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the SDK receives the high-stream video by default. - - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. - By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. + @note You can call this method either before or after joining a channel. If you call both + \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" and + \ref IRtcEngine::setRemoteDefaultVideoStreamType "setRemoteDefaultVideoStreamType", the SDK applies the settings in + the \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" method. @param userId ID of the remote user sending the video stream. @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -4844,13 +6006,25 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. + virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Sets the default stream type of remote videos. + + Under limited network conditions, if the publisher has not disabled the dual-stream mode using `enableDualStreamMode(false)`, + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). + + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. The aspect ratio of the low-video stream is the same as the high-quality video stream. + Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - - If the dual-stream mode is enabled by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the user receives the high-stream video by default. The @p setRemoteDefaultVideoStreamType method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. - - If the dual-stream mode is not enabled, the user receives the high-stream video by default. + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - The result after calling this method is returned in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. + @note You can call this method either before or after joining a channel. If you call both + \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" and + \ref IRtcEngine::setRemoteDefaultVideoStreamType "setRemoteDefaultVideoStreamType", the SDK applies the settings in + the \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" method. @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -4858,27 +6032,30 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; /** Enables the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at a set time interval to report on which users are speaking and the speakers' volume. Once this method is enabled, the SDK returns the volume indication in the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the set time interval, whether or not any user is speaking in the channel. + @note You can call this method either before or after joining a channel. + @param interval Sets the time interval between two consecutive volume indications: - ≤ 0: Disables the volume indication. - > 0: Time interval (ms) between two consecutive volume indications. We recommend setting @p interval > 200 ms. Do not set @p interval < 10 ms, or the *onAudioVolumeIndication* callback will not be triggered. @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. @param report_vad - + - true: Enable the voice activity detection of the local user. Once it is enabled, the `vad` parameter of the `onAudioVolumeIndication` callback reports the voice activity status of the local user. - false: (Default) Disable the voice activity detection of the local user. Once it is disabled, the `vad` parameter of the `onAudioVolumeIndication` callback does not report the voice activity status of the local user, except for the scenario where the engine automatically detects the voice activity of the local user. @return - 0: Success. - < 0: Failure. */ - virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; - /** **DEPRECATED** Starts an audio recording. - * Use \ref IRtcEngine::startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) "startAudioRecording"2 instead. + virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; + /** @deprecated Starts an audio recording. + + Use \ref IRtcEngine::startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) "startAudioRecording"2 instead. The SDK allows recording during a call. Supported formats: @@ -4898,33 +6075,33 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; /** Starts an audio recording on the client. - * - * The SDK allows recording during a call. After successfully calling this method, you can record the audio of all the users in the channel and get an audio recording file. + * + * The SDK allows recording during a call. After successfully calling this method, you can record the audio of all the users in the channel and get an audio recording file. * Supported formats of the recording file are as follows: * - .wav: Large file size with high fidelity. * - .aac: Small file size with low fidelity. - * + * * @note * - Ensure that the directory you use to save the recording file exists and is writable. * - This method is usually called after the `joinChannel` method. The recording automatically stops when you call the `leaveChannel` method. * - For better recording effects, set quality as #AUDIO_RECORDING_QUALITY_MEDIUM or #AUDIO_RECORDING_QUALITY_HIGH when `sampleRate` is 44.1 kHz or 48 kHz. - * - * @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8. + * + * @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8, such as c:/music/audio.aac. * @param sampleRate Sample rate (kHz) of the recording file. Supported values are as follows: * - 16 * - (Default) 32 * - 44.1 * - 48 * @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. - * + * * @return * - 0: Success. * - < 0: Failure. */ - virtual int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + virtual int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; /** Stops an audio recording on the client. You can call this method before calling the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method else, the recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. @@ -4933,7 +6110,7 @@ class IRtcEngine - 0: Success - < 0: Failure. */ - virtual int stopAudioRecording() = 0; + virtual int stopAudioRecording() = 0; /** Starts playing and mixing the music file. This method mixes the specified local audio file with the audio stream from the microphone, or replaces the microphone's audio stream with the specified local audio file. You can choose whether the other user can hear the local audio playback and specify the number of playback loops. This method also supports online music playback. @@ -4944,25 +6121,25 @@ class IRtcEngine When the audio mixing file playback finishes, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingStateChanged "onAudioMixingStateChanged" (STOPPED) callback on the local client. @note - - Call this method when you are in a channel. + - Call this method after joining a channel, otherwise issues may occur. - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - - @param filePath Pointer to the absolute path of the local or online audio file to mix. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). + - If you want to play an online music file, ensure that the time interval between calling this method is more than 100 ms, or the AUDIO_MIXING_ERROR_TOO_FREQUENT_CALL(702) error code occurs. + @param filePath Pointer to the absolute path (including the suffixes of the filename) of the local or online audio file to mix, for example, c:/music/audio.mp4. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MP4, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). @param loopback Sets which user can hear the audio mixing: - true: Only the local user can hear the audio mixing. - false: Both users can hear the audio mixing. @param replace Sets the audio mixing content: - - true: Only the specified audio file is published; the audio stream received by the microphone is not published. + - true: Only publish the specified audio file. The audio stream from the microphone is not published. - false: The local audio file is mixed with the audio stream from the microphone. @param cycle Sets the number of playback loops: - Positive integer: Number of playback loops. - - -1: Infinite playback loops. + - `-1`: Infinite playback loops. @return - 0: Success. - < 0: Failure. */ - virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; + virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; /** Stops playing and mixing the music file. Call this method when you are in a channel. @@ -4971,7 +6148,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int stopAudioMixing() = 0; + virtual int stopAudioMixing() = 0; /** Pauses playing and mixing the music file. Call this method when you are in a channel. @@ -4980,7 +6157,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int pauseAudioMixing() = 0; + virtual int pauseAudioMixing() = 0; /** Resumes playing and mixing the music file. Call this method when you are in a channel. @@ -4989,7 +6166,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int resumeAudioMixing() = 0; + virtual int resumeAudioMixing() = 0; /** **DEPRECATED** Agora does not recommend using this method. Sets the high-quality audio preferences. Call this method and set all parameters before joining a channel. @@ -5013,9 +6190,9 @@ class IRtcEngine virtual int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) = 0; /** Adjusts the volume during audio mixing. - Call this method when you are in a channel. - - @note Calling this method does not affect the volume of audio effect file playback invoked by the \ref agora::rtc::IRtcEngine::playEffect "playEffect" method. + @note + - Calling this method does not affect the volume of audio effect file playback invoked by the \ref agora::rtc::IRtcEngine::playEffect "playEffect" method. + - Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". @param volume Audio mixing volume. The value ranges between 0 and 100 (default). @@ -5023,10 +6200,10 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int adjustAudioMixingVolume(int volume) = 0; + virtual int adjustAudioMixingVolume(int volume) = 0; /** Adjusts the audio mixing volume for local playback. - @note Call this method when you are in a channel. + @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". @param volume Audio mixing volume for local playback. The value ranges between 0 and 100 (default). @@ -5048,7 +6225,7 @@ class IRtcEngine virtual int getAudioMixingPlayoutVolume() = 0; /** Adjusts the audio mixing volume for publishing (for remote users). - @note Call this method when you are in a channel. + @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". @param volume Audio mixing volume for publishing. The value ranges between 0 and 100 (default). @@ -5077,7 +6254,7 @@ class IRtcEngine - ≥ 0: The audio mixing duration, if this method call succeeds. - < 0: Failure. */ - virtual int getAudioMixingDuration() = 0; + virtual int getAudioMixingDuration() = 0; /** Retrieves the playback position (ms) of the music file. Call this method when you are in a channel. @@ -5086,37 +6263,63 @@ class IRtcEngine - ≥ 0: The current playback position of the audio mixing, if this method call succeeds. - < 0: Failure. */ - virtual int getAudioMixingCurrentPosition() = 0; + virtual int getAudioMixingCurrentPosition() = 0; /** Sets the playback position of the music file to a different starting position (the default plays from the beginning). + @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". + @param pos The playback starting position (ms) of the music file. @return - 0: Success. - < 0: Failure. */ - virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; + virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; + /** Sets the pitch of the local music file. + * @since v3.0.1 + * + * When a local music file is mixed with a local human voice, call this method to set the pitch of the local music file only. + * + * @note + * Call this method after calling `startAudioMixing`. + * + * @param pitch Sets the pitch of the local music file by chromatic scale. The default value is 0, + * which means keeping the original pitch. The value ranges from -12 to 12, and the pitch value between + * consecutive values is a chromatic value. The greater the absolute value of this parameter, the + * higher or lower the pitch of the local music file. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setAudioMixingPitch(int pitch) = 0; /** Retrieves the volume of the audio effects. The value ranges between 0.0 and 100.0. + @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". + @return - ≥ 0: Volume of the audio effects, if this method call succeeds. - < 0: Failure. */ - virtual int getEffectsVolume() = 0; + virtual int getEffectsVolume() = 0; /** Sets the volume of the audio effects. + @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". + @param volume Sets the volume of the audio effects. The value ranges between 0 and 100 (default). @return - 0: Success. - < 0: Failure. */ - virtual int setEffectsVolume(int volume) = 0; + virtual int setEffectsVolume(int volume) = 0; /** Sets the volume of a specified audio effect. + @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". + @param soundId ID of the audio effect. Each audio effect has a unique ID. @param volume Sets the volume of the specified audio effect. The value ranges between 0 and 100 (default). @@ -5124,8 +6327,33 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setVolumeOfEffect(int soundId, int volume) = 0; + virtual int setVolumeOfEffect(int soundId, int volume) = 0; +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** + * Enables/Disables face detection for the local user. + * + * @since v3.0.1 + * + * @note + * - Applies to Android and iOS only. + * - You can call this method either before or after joining a channel. + * + * Once face detection is enabled, the SDK triggers the \ref IRtcEngineEventHandler::onFacePositionChanged "onFacePositionChanged" callback + * to report the face information of the local user, which includes the following aspects: + * - The width and height of the local video. + * - The position of the human face in the local video. + * - The distance between the human face and the device screen. + * + * @param enable Determines whether to enable the face detection function for the local user: + * - true: Enable face detection. + * - false: (Default) Disable face detection. + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableFaceDetection(bool enable) = 0; +#endif /** Plays a specified local or online audio effect file. This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. @@ -5137,8 +6365,9 @@ class IRtcEngine @note - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. - Playing multiple online audio effect files simultaneously is not supported on macOS and Windows. + - Ensure that you call this method after joining a channel. - @param filePath The absolute path to the local audio effect file or the URL of the online audio effect file. + @param filePath Specifies the absolute path (including the suffixes of the filename) to the local audio effect file or the URL of the online audio effect file, for example, c:/music/audio.mp4. Supported audio formats: mp3, mp4, m4a, aac, 3gp, mkv and wav. @param loopCount Sets the number of times the audio effect loops: - 0: Play the audio effect once. - 1: Play the audio effect twice. @@ -5157,7 +6386,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) = 0; + virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) = 0; /** Stops playing a specified audio effect. @param soundId ID of the audio effect to stop playing. Each audio effect has a unique ID. @@ -5166,14 +6395,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int stopEffect(int soundId) = 0; + virtual int stopEffect(int soundId) = 0; /** Stops playing all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int stopAllEffects() = 0; + virtual int stopAllEffects() = 0; /** Preloads a specified audio effect file into the memory. @@ -5190,7 +6419,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int preloadEffect(int soundId, const char* filePath) = 0; + virtual int preloadEffect(int soundId, const char* filePath) = 0; /** Releases a specified preloaded audio effect from the memory. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -5198,7 +6427,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int unloadEffect(int soundId) = 0; + virtual int unloadEffect(int soundId) = 0; /** Pauses a specified audio effect. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -5206,14 +6435,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int pauseEffect(int soundId) = 0; + virtual int pauseEffect(int soundId) = 0; /** Pauses all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int pauseAllEffects() = 0; + virtual int pauseAllEffects() = 0; /** Resumes playing a specified audio effect. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -5221,14 +6450,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int resumeEffect(int soundId) = 0; + virtual int resumeEffect(int soundId) = 0; /** Resumes playing all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int resumeAllEffects() = 0; + virtual int resumeAllEffects() = 0; /** Enables/Disables stereo panning for remote users. Ensure that you call this method before joinChannel to enable stereo panning for remote users so that the local user can track the position of a remote user by calling \ref agora::rtc::IRtcEngine::setRemoteVoicePosition "setRemoteVoicePosition". @@ -5249,6 +6478,7 @@ class IRtcEngine @note - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + - Ensure that you call this method after joining a channel. @param uid The ID of the remote user. @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: @@ -5265,26 +6495,32 @@ class IRtcEngine /** Changes the voice pitch of the local speaker. + @note You can call this method either before or after joining a channel. + @param pitch Sets the voice pitch. The value ranges between 0.5 and 2.0. The lower the value, the lower the voice pitch. The default value is 1.0 (no change to the local voice pitch). @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVoicePitch(double pitch) = 0; + virtual int setLocalVoicePitch(double pitch) = 0; /** Sets the local voice equalization effect. - @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. + @note You can call this method either before or after joining a channel. + + @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 250, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. @param bandGain Sets the gain of each band in dB. The value ranges between -15 and 15. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; + virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; /** Sets the local voice reverberation. v2.4.0 adds the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, a more user-friendly method for setting the local voice reverberation. You can use this method to set the local reverberation effect, such as pop music, R&B, rock music, and hip-hop. + @note You can call this method either before or after joining a channel. + @param reverbKey Sets the reverberation key. See #AUDIO_REVERB_TYPE. @param value Sets the value of the reverberation key. @@ -5292,71 +6528,261 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; + virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; /** Sets the local voice changer option. - @note Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, because the method called later overrides the one called earlier. + @deprecated Deprecated from v3.2.0. Use \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" or + \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" instead. - @param voiceChanger Sets the local voice changer option. See #VOICE_CHANGER_PRESET. + This method can be used to set the local voice effect for users in a `COMMUNICATION` channel or hosts in a `LIVE_BROADCASTING` channel. + Voice changer options include the following voice effects: - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; - /** Sets the preset local voice reverberation effect. + - `VOICE_CHANGER_XXX`: Changes the local voice to an old man, a little boy, or the Hulk. Applies to the voice talk scenario. + - `VOICE_BEAUTY_XXX`: Beautifies the local voice by making it sound more vigorous, resounding, or adding spacial resonance. Applies to the voice talk and singing scenario. + - `GENERAL_VOICE_BEAUTY_XXX`: Adds gender-based beautification effect to the local voice. Applies to the voice talk scenario. + - For a male voice: Adds magnetism to the voice. + - For a female voice: Adds freshness or vitality to the voice. @note - - Do not use this method together with \ref agora::rtc::IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb". - - Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" method, because the method called later overrides the one called earlier. + - To achieve better voice effect quality, Agora recommends setting the profile parameter in \ref IRtcEngine::setAudioProfile "setAudioProfile" as #AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) or #AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO (5) + - This method works best with the human voice, and Agora does not recommend using it for audio containing music and a human voice. + - Do not use this method with \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" , because the method called later overrides the one called earlier. For detailed considerations, see the advanced guide *Voice Changer and Reverberation*. + - You can call this method either before or after joining a channel. - @param reverbPreset Sets the preset audio reverberation configuration. See #AUDIO_REVERB_PRESET. + @param voiceChanger Sets the local voice changer option. The default value is #VOICE_CHANGER_OFF, which means the original voice. See details in #VOICE_CHANGER_PRESET + Gender-based beatification effect works best only when assigned a proper gender: + - For male: #GENERAL_BEAUTY_VOICE_MALE_MAGNETIC + - For female: #GENERAL_BEAUTY_VOICE_FEMALE_FRESH or #GENERAL_BEAUTY_VOICE_FEMALE_VITALITY + Failure to do so can lead to voice distortion. @return - 0: Success. - - < 0: Failure. + - < 0: Failure. Check if the enumeration is properly set. + */ + virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; + /** Sets the local voice reverberation option, including the virtual stereo. + * + * @deprecated Deprecated from v3.2.0. Use \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" or + * \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" instead. + * + * This method sets the local voice reverberation for users in a `COMMUNICATION` channel or hosts in a `LIVE_BROADCASTING` channel. + * After successfully calling this method, all users in the channel can hear the voice with reverberation. + * + * @note + * - When calling this method with enumerations that begin with `AUDIO_REVERB_FX`, ensure that you set profile in `setAudioProfile` as + * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`; otherwise, this methods cannot set the corresponding voice reverberation option. + * - When calling this method with `AUDIO_VIRTUAL_STEREO`, Agora recommends setting the `profile` parameter in `setAudioProfile` as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. + * - This method works best with the human voice, and Agora does not recommend using it for audio containing music and a human voice. + * - Do not use this method with `setLocalVoiceChanger`, because the method called later overrides the one called earlier. + * For detailed considerations, see the advanced guide *Voice Changer and Reverberation*. + * - You can call this method either before or after joining a channel. + * + * @param reverbPreset The local voice reverberation option. The default value is `AUDIO_REVERB_OFF`, + * which means the original voice. See #AUDIO_REVERB_PRESET. + * To achieve better voice effects, Agora recommends the enumeration whose name begins with `AUDIO_REVERB_FX`. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) = 0; - - /** Specifies an SDK output log file. - - The log file records all SDK operations during runtime. If it does not exist, the SDK creates one. - - @note - - The default log file is located at: C:\Users\\AppData\Local\Agora\. - - Ensure that you call this method immediately after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method, otherwise the output log may not be complete. - - @param filePath File path of the log file. The string of the log file is in UTF-8. - - @return - - 0: Success. - - < 0: Failure. + /** Sets an SDK preset voice beautifier effect. + * + * @since v3.2.0 + * + * Call this method to set an SDK preset voice beautifier effect for the local user who sends an audio stream. After + * setting a voice beautifier effect, all users in the channel can hear the effect. + * + * You can set different voice beautifier effects for different scenarios. See *Set the Voice Beautifier and Audio Effects*. + * + * To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` and the `profile` parameter to + * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before calling this method. + * + * @note + * - You can call this method either before or after joining a channel. + * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" to `AUDIO_PROFILE_SPEECH_STANDARD(1)` + * or `AUDIO_PROFILE_IOT(6)`; otherwise, this method call fails. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - After calling this method, Agora recommends not calling the following methods, because they can override \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters": + * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" + * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * + * @param preset The options for SDK preset voice beautifier effects: #VOICE_BEAUTIFIER_PRESET. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setLogFile(const char* filePath) = 0; + virtual int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) = 0; + /** Sets an SDK preset audio effect. + * + * @since v3.2.0 + * + * Call this method to set an SDK preset audio effect for the local user who sends an audio stream. This audio effect + * does not change the gender characteristics of the original voice. After setting an audio effect, all users in the + * channel can hear the effect. + * + * You can set different audio effects for different scenarios. See *Set the Voice Beautifier and Audio Effects*. + * + * To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` before calling this method. + * + * @note + * - You can call this method either before or after joining a channel. + * - Do not set the profile `parameter` of `setAudioProfile` to `AUDIO_PROFILE_SPEECH_STANDARD(1)` or `AUDIO_PROFILE_IOT(6)`; + * otherwise, this method call fails. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - If you call this method and set the `preset` parameter to enumerators except `ROOM_ACOUSTICS_3D_VOICE` or `PITCH_CORRECTION`, + * do not call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters"; otherwise, `setAudioEffectParameters` + * overrides this method. + * - After calling this method, Agora recommends not calling the following methods, because they can override `setAudioEffectPreset`: + * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * + * @param preset The options for SDK preset audio effects. See #AUDIO_EFFECT_PRESET. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset) = 0; + /** Sets parameters for SDK preset audio effects. + * + * @since v3.2.0 + * + * Call this method to set the following parameters for the local user who send an audio stream: + * - 3D voice effect: Sets the cycle period of the 3D voice effect. + * - Pitch correction effect: Sets the basic mode and tonic pitch of the pitch correction effect. Different songs + * have different modes and tonic pitches. Agora recommends bounding this method with interface elements to enable + * users to adjust the pitch correction interactively. + * + * After setting parameters, all users in the channel can hear the relevant effect. + * + * You can call this method directly or after \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset". If you + * call this method after \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset", ensure that you set the preset + * parameter of `setAudioEffectPreset` to `ROOM_ACOUSTICS_3D_VOICE` or `PITCH_CORRECTION` and then call this method + * to set the same enumerator; otherwise, this method overrides `setAudioEffectPreset`. + * + * @note + * - You can call this method either before or after joining a channel. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` before calling this method. + * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" to `AUDIO_PROFILE_SPEECH_STANDARD(1)` or + * `AUDIO_PROFILE_IOT(6)`; otherwise, this method call fails. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - After calling this method, Agora recommends not calling the following methods, because they can override `setAudioEffectParameters`: + * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" + * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * + * @param preset The options for SDK preset audio effects: + * - 3D voice effect: `ROOM_ACOUSTICS_3D_VOICE`. + * - Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` + * or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator; otherwise, the enumerator setting does not take effect. + * - If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect. + * - Pitch correction effect: `PITCH_CORRECTION`. To achieve better audio effect quality, Agora recommends calling + * \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or + * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator. + * @param param1 + * - If you set `preset` to `ROOM_ACOUSTICS_3D_VOICE`, the `param1` sets the cycle period of the 3D voice effect. + * The value range is [1,60] and the unit is a second. The default value is 10 seconds, indicating that the voice moves + * around you every 10 seconds. + * - If you set `preset` to `PITCH_CORRECTION`, `param1` sets the basic mode of the pitch correction effect: + * - `1`: (Default) Natural major scale. + * - `2`: Natural minor scale. + * - `3`: Japanese pentatonic scale. + * @param param2 + * - If you set `preset` to `ROOM_ACOUSTICS_3D_VOICE`, you do not need to set `param2`. + * - If you set `preset` to `PITCH_CORRECTION`, `param2` sets the tonic pitch of the pitch correction effect: + * - `1`: A + * - `2`: A# + * - `3`: B + * - `4`: (Default) C + * - `5`: C# + * - `6`: D + * - `7`: D# + * - `8`: E + * - `9`: F + * - `10`: F# + * - `11`: G + * - `12`: G# + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2) = 0; + /** Sets the log files that the SDK outputs. + * + * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with a default size of 1024 KB. + * These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is full, the SDK deletes the log file with the earliest + * modification time among the other four, renames `agorasdk.log` to the name of the deleted log file, and create a new `agorasdk.log` to record latest logs. + * + * @note Ensure that you call this method immediately after calling \ref agora::rtc::IRtcEngine::initialize "initialize" , otherwise the output logs may not be complete. + * + * @see \ref IRtcEngine::setLogFileSize "setLogFileSize" + * @see \ref IRtcEngine::setLogFilter "setLogFilter" + * + * @param filePath The absolute path of log files. The default file path is `C: \Users\\AppData\Local\Agora\\agorasdk.log`. + * Ensure that the directory for the log files exists and is writable. You can use this parameter to rename the log files. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setLogFile(const char* filePath) = 0; /** Sets the output log level of the SDK. You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. + @see \ref IRtcEngine::setLogFile "setLogFile" + @see \ref IRtcEngine::setLogFileSize "setLogFileSize" + @param filter Sets the log filter level. See #LOG_FILTER_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setLogFilter(unsigned int filter) = 0; - /** Sets the log file size (KB). - - The SDK has two log files, each with a default size of 512 KB. If you set @p fileSizeInBytes as 1024 KB, the SDK outputs log files with a total maximum size of 2 MB. If the total size of the log files exceed the set value, the new output log files overwrite the old output log files. - - @param fileSizeInKBytes The SDK log file size (KB). - @return - - 0: Success. - - <0: Failure. + virtual int setLogFilter(unsigned int filter) = 0; + /** Sets the size of a log file that the SDK outputs. + * + * + * @note If you want to set the log file size, ensure that you call + * this method before \ref IRtcEngine::setLogFile "setLogFile", or the logs are cleared. + * + * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with a default size of 1024 KB. + * These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is full, the SDK deletes the log file with the earliest + * modification time among the other four, renames `agorasdk.log` to the name of the deleted log file, and create a new `agorasdk.log` to record latest logs. + * + * @see \ref IRtcEngine::setLogFile "setLogFile" + * @see \ref IRtcEngine::setLogFilter "setLogFilter" + * + * @param fileSizeInKBytes The size (KB) of a log file. The default value is 1024 KB. If you set `fileSizeInKByte` to 1024 KB, + * the SDK outputs at most 5 MB log files; if you set it to less than 1024 KB, the maximum size of a log file is still 1024 KB. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; - /** + /** @deprecated This method is deprecated, use the \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode"2 method instead. Sets the local video display mode. @@ -5367,23 +6793,26 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; + virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; /** Updates the display mode of the local video view. + @since v3.0.0 + After initializing the local video view, you can call this method to update its rendering and mirror modes. It affects only the video view that the local user sees, not the published local video stream. - + @note - Ensure that you have called the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view before calling this method. + - During a call, you can call this method as many times as necessary to update the display mode of the local video view. @param renderMode The rendering mode of the local video view. See #RENDER_MODE_TYPE. - @param mirrorMode - - The mirror mode of the local video view. See #VIDEO_MIRROR_MODE_TYPE. + @param mirrorMode + - The mirror mode of the local video view. See #VIDEO_MIRROR_MODE_TYPE. - **Note**: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. @return - 0: Success. - < 0: Failure. */ virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** + /** @deprecated This method is deprecated, use the \ref IRtcEngine::setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setRemoteRenderMode"2 method instead. Sets the video display mode of a specified remote user. @@ -5395,9 +6824,10 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; /** Updates the display mode of the video view of a remote user. + @since v3.0.0 After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. This method affects only the video view that the local user sees. @note @@ -5406,40 +6836,44 @@ class IRtcEngine @param userId The ID of the remote user. @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. - @param mirrorMode + @param mirrorMode - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. - **Note**: The SDK disables the mirror mode by default. - + @return - 0: Success. - < 0: Failure. */ virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** - @deprecated This method is deprecated, use the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" or \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" method instead. - Sets the local video mirror mode. - You must call this method before calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, otherwise the mirror mode will not work. + Sets the local video mirror mode. - @note The SDK enables the mirror mode by default. + @warning Call this method after calling the \ref agora::rtc::IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view. @param mirrorMode Sets the local video mirror mode. See #VIDEO_MIRROR_MODE_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** Sets the stream mode to the single-stream (default) or dual-stream mode. (Live broadcast only.) + virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** Sets the stream mode to the single-stream (default) or dual-stream mode. (`LIVE_BROADCASTING` only.) If the dual-stream mode is enabled, the receiver can choose to receive the high stream (high-resolution and high-bitrate video stream), or the low stream (low-resolution and low-bitrate video stream). + @note You can call this method either before or after joining a channel. + @param enabled Sets the stream mode: - true: Dual-stream mode. - - false: (Default) Single-stream mode. + - false: Single-stream mode. */ - virtual int enableDualStreamMode(bool enabled) = 0; - /** Sets the external audio source. Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + virtual int enableDualStreamMode(bool enabled) = 0; + /** Sets the external audio source. + + @note Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" + and \ref IRtcEngine::startPreview "startPreview". @param enabled Sets whether to enable/disable the external audio source: - true: Enables the external audio source. @@ -5448,12 +6882,12 @@ class IRtcEngine @param channels Sets the number of audio channels of the external audio source: - 1: Mono. - 2: Stereo. - + @return - 0: Success. - < 0: Failure. */ - virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; + virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; /** Sets the external audio sink. * This method applies to scenarios where you want to use external audio * data for playback. After enabling the external audio sink, you can call @@ -5461,9 +6895,10 @@ class IRtcEngine * it, and play it with the audio effects that you want. * * @note - * Once you enable the external audio sink, the app will not retrieve any + * - Once you enable the external audio sink, the app will not retrieve any * audio data from the * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + * - Ensure that you call this method before joining a channel. * * @param enabled * - true: Enables the external audio sink. @@ -5479,8 +6914,9 @@ class IRtcEngine * - < 0: Failure. */ virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels) = 0; - /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. - + /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. + + @note Ensure that you call this method before joining a channel. @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onRecordAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param channel Sets the number of audio channels (@p channels) returned in the *onRecordAudioFrame* callback: @@ -5490,78 +6926,88 @@ class IRtcEngine @param samplesPerCall Sets the number of samples returned in the *onRecordAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. - @note The SDK triggers the `onRecordAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). + @note The SDK triggers the `onRecordAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). @return - 0: Success. - < 0: Failure. */ - virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; /** Sets the audio playback format for the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. - - + + @note Ensure that you call this method before joining a channel. + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onPlaybackAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param channel Sets the number of channels (@p channels) returned in the *onPlaybackAudioFrame* callback: - 1: Mono - 2: Stereo @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onPlaybackAudioFrame* callback. @param samplesPerCall Sets the number of samples returned in the *onPlaybackAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. - + @note The SDK triggers the `onPlaybackAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). - + @return - 0: Success. - < 0: Failure. */ - virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; /** Sets the mixed audio format for the \ref agora::media::IAudioFrameObserver::onMixedAudioFrame "onMixedAudioFrame" callback. - - + + @note Ensure that you call this method before joining a channel. + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onMixedAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param samplesPerCall Sets the number of samples (`samples`) returned in the *onMixedAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. - + @note The SDK triggers the `onMixedAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channels`). - + @return - 0: Success. - < 0: Failure. */ - virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; + virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; /** Adjusts the recording volume. - @param volume Recording volume. The value ranges between 0 and 400: + @note You can call this method either before or after joining a channel. + + @param volume Recording volume. To avoid echoes and + improve call quality, Agora recommends setting the value of volume between + 0 and 100. If you need to set the value higher than 100, contact + support@agora.io first. - 0: Mute. - 100: Original volume. - - 400: (Maximum) Four times the original volume with signal clipping protection. + @return - 0: Success. - < 0: Failure. */ - virtual int adjustRecordingSignalVolume(int volume) = 0; + virtual int adjustRecordingSignalVolume(int volume) = 0; /** Adjusts the playback volume of all remote users. - - @note + + @note - This method adjusts the playback volume that is the mixed volume of all remote users. + - You can call this method either before or after joining a channel. - (Since v2.3.2) To mute the local audio playback, call both the `adjustPlaybackSignalVolume` and \ref IRtcEngine::adjustAudioMixingVolume "adjustAudioMixingVolume" methods and set the volume as `0`. - @param volume The playback volume of all remote users. The value ranges from 0 to 400: + @param volume The playback volume of all remote users. To avoid echoes and + improve call quality, Agora recommends setting the value of volume between + 0 and 100. If you need to set the value higher than 100, contact + support@agora.io first. - 0: Mute. - 100: Original volume. - - 400: (Maximum) Four times the original volume with signal clipping protection. @return - 0: Success. - < 0: Failure. */ - virtual int adjustPlaybackSignalVolume(int volume) = 0; + virtual int adjustPlaybackSignalVolume(int volume) = 0; - /** + /** @deprecated This method is deprecated. As of v3.0.0, the Native SDK automatically enables interoperability with the Web SDK, so you no longer need to call this method. Enables interoperability with the Agora Web SDK. - @note - - This method applies only to the Live-broadcast profile. In the Communication profile, interoperability with the Agora Web SDK is enabled by default. + @note + - This method applies only to the `LIVE_BROADCASTING` profile. In the `COMMUNICATION` profile, interoperability with the Agora Web SDK is enabled by default. - If the channel has Web SDK users, ensure that you call this method, or the video of the Native user will be a black screen for the Web user. @param enabled Sets whether to enable/disable interoperability with the Agora Web SDK: @@ -5572,9 +7018,9 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int enableWebSdkInteroperability(bool enabled) = 0; + virtual int enableWebSdkInteroperability(bool enabled) = 0; //only for live broadcast - /** **DEPRECATED** Sets the preferences for the high-quality video. (Live broadcast only). + /** **DEPRECATED** Sets the preferences for the high-quality video. (`LIVE_BROADCASTING` only). This method is deprecated as of v2.4.0. @@ -5587,20 +7033,22 @@ class IRtcEngine - < 0: Failure. */ virtual int setVideoQualityParameters(bool preferFrameRateOverImageQuality) = 0; - /** Sets the fallback option for the locally published video stream based on the network conditions. + /** Sets the fallback option for the published video stream based on the network conditions. If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK will: - Disable the upstream video but enable audio only when the network conditions deteriorate and cannot support both video and audio. - Re-enable the video when the network conditions improve. - - When the locally published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. - @note Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the locally published video stream falls back to audio only. + When the published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. - @param option Sets the fallback option for the locally published video stream: - - #STREAM_FALLBACK_OPTION_DISABLED (0): (Default) No fallback behavior for the locally published video stream when the uplink network condition is poor. The stream quality is not guaranteed. - - #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2): The locally published video stream falls back to audio only when the uplink network condition is poor. + @note + - Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the published video stream falls back to audio only. + - Ensure that you call this method before joining a channel. + + @param option Sets the fallback option for the published video stream: + - #STREAM_FALLBACK_OPTION_DISABLED (0): (Default) No fallback behavior for the published video stream when the uplink network condition is poor. The stream quality is not guaranteed. + - #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2): The published video stream falls back to audio only when the uplink network condition is poor. @return - 0: Success. @@ -5615,6 +7063,8 @@ class IRtcEngine When the remotely subscribed video stream falls back to audio only or when the audio-only stream switches back to the video stream, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRemoteSubscribeFallbackToAudioOnly "onRemoteSubscribeFallbackToAudioOnly" callback. + @note Ensure that you call this method before joining a channel. + @param option Sets the fallback option for the remotely subscribed video stream. See #STREAM_FALLBACK_OPTIONS. @return - 0: Success. @@ -5623,54 +7073,62 @@ class IRtcEngine virtual int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) - /** Switches between front and rear cameras. + /** Switches between front and rear cameras. - @note This method is for Android and iOS only. + @note + - This method is for Android and iOS only. + - Ensure that you call this method after the camera starts, for example, by + calling \ref IRtcEngine::startPreview "startPreview" or \ref IRtcEngine::joinChannel "joinChannel". @return - 0: Success. - < 0: Failure. */ virtual int switchCamera() = 0; + /// @cond /** Switches between front and rear cameras. - @note This method is for Android and iOS only, and it is private. - + @note This method is for Android and iOS only. + @note This method is private. + @param direction Sets the camera to be used: - CAMERA_DIRECTION.CAMERA_REAR: Use the rear camera. - CAMERA_DIRECTION.CAMERA_FRONT: Use the front camera. - + @return - 0: Success. - < 0: Failure. */ virtual int switchCamera(CAMERA_DIRECTION direction) = 0; + /// @endcond /** Sets the default audio playback route. This method sets whether the received audio is routed to the earpiece or speakerphone by default before joining a channel. If a user does not call this method, the audio is routed to the earpiece by default. If you need to change the default audio route after joining a channel, call the \ref IRtcEngine::setEnableSpeakerphone "setEnableSpeakerphone" method. - The default setting for each mode: - - Voice: Earpiece. - - Video: Speakerphone. If a user who is in the Communication profile calls the \ref IRtcEngine::disableVideo "disableVideo" method or if the user calls the \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" and \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the default audio route switches back to the earpiece automatically. - - Live Broadcast: Speakerphone. - - Gaming Voice: Speakerphone. + The default setting for each profile: + - `COMMUNICATION`: In a voice call, the default audio route is the earpiece. In a video call, the default audio route is the speakerphone. If a user who is in the `COMMUNICATION` profile calls + the \ref IRtcEngine.disableVideo "disableVideo" method or if the user calls + the \ref IRtcEngine.muteLocalVideoStream "muteLocalVideoStream" and + \ref IRtcEngine.muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the + default audio route switches back to the earpiece automatically. + - `LIVE_BROADCASTING`: Speakerphone. @note - This method is for Android and iOS only. - - This method only works in audio mode. + - This method is applicable only to the `COMMUNICATION` profile. + - For iOS, this method only works in a voice call. - Call this method before calling the \ref IRtcEngine::joinChannel "joinChannel" method. - - Regardless of whether the audio is routed to the speakerphone or earpiece by default, once a headset is plugged in or Bluetooth device is connected, the default audio route changes. The default audio route switches to the earpiece once removing the headset or disconnecting the Bluetooth device. @param defaultToSpeaker Sets the default audio route: - - true: Speakerphone. - - false: (Default) Earpiece. + - true: Route the audio to the speakerphone. If the playback device connects to the earpiece or Bluetooth, the audio cannot be routed to the speakerphone. + - false: (Default) Route the audio to the earpiece. If a headset is plugged in, the audio is routed to the headset. @return - 0: Success. - < 0: Failure. */ - virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; + virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; /** Enables/Disables the audio playback route to the speakerphone. This method sets whether the audio is routed to the speakerphone or earpiece. @@ -5684,38 +7142,48 @@ class IRtcEngine - This method does not take effect if a headset is used. @param speakerOn Sets whether to route the audio to the speakerphone or earpiece: - - true: Route the audio to the speakerphone. - - false: Route the audio to the earpiece. + - true: Route the audio to the speakerphone. If the playback device connects to the earpiece or Bluetooth, the audio cannot be routed to the speakerphone. + - false: Route the audio to the earpiece. If a headset is plugged in, the audio is routed to the headset. @return - 0: Success. - < 0: Failure. */ - virtual int setEnableSpeakerphone(bool speakerOn) = 0; + virtual int setEnableSpeakerphone(bool speakerOn) = 0; /** Enables in-ear monitoring (for Android and iOS only). - @param enabled Sets whether to enable/disable in-ear monitoring: - - true: Enable. - - false: (Default) Disable. - + * + * @note + * - Users must use wired earphones to hear their own voices. + * - You can call this method either before or after joining a channel. + * + * @param enabled Determines whether to enable in-ear monitoring. + * - true: Enable. + * - false: (Default) Disable. + * * @return - - 0: Success. - - < 0: Failure. + * - 0: Success. + * - < 0: Failure. */ virtual int enableInEarMonitoring(bool enabled) = 0; /** Sets the volume of the in-ear monitor. - - @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). - - @note This method is for Android and iOS only. - - @return - - 0: Success. - - < 0: Failure. + * + * @note + * - This method is for Android and iOS only. + * - Users must use wired earphones to hear their own voices. + * - You can call this method either before or after joining a channel. + * + * @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setInEarMonitoringVolume(int volume) = 0; + virtual int setInEarMonitoringVolume(int volume) = 0; /** Checks whether the speakerphone is enabled. - @note This method is for Android and iOS only. + @note + - This method is for Android and iOS only. + - You can call this method either before or after joining a channel. @return - 0: Success. @@ -5734,6 +7202,7 @@ class IRtcEngine @note - This method is for iOS only. - This method restricts the SDK’s manipulation of the audio session. Any operation to the audio session relies solely on the app, other apps, or third-party components. + - You can call this method either before or after joining a channel. @param restriction The operational restriction (bit mask) of the SDK on the audio session. See #AUDIO_SESSION_OPERATION_RESTRICTION. @@ -5749,6 +7218,8 @@ class IRtcEngine If you enable loopback recording, the output of the sound card is mixed into the audio stream sent to the other end. + @note You can call this method either before or after joining a channel. + @param enabled Sets whether to enable/disable loopback recording. - true: Enable loopback recording. - false: (Default) Disable loopback recording. @@ -5763,56 +7234,186 @@ class IRtcEngine #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) /** Shares the whole or part of a screen by specifying the display ID. - - @note This method is for macOS only. - - @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. - @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. - @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. - - - @return - - 0: Success. - - < 0: Failure: - - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call \ref agora::rtc::IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. - - #ERR_INVALID_ARGUMENT: the argument is invalid. + * + * @note + * - This method is for macOS only. + * - Ensure that you call this method after joining a channel. + * + * @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. + * @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + * @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + * + * + * @return + * - 0: Success. + * - < 0: Failure: + * - #ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being + * shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. + * - #ERR_INVALID_ARGUMENT: the argument is invalid. */ virtual int startScreenCaptureByDisplayId(unsigned int displayId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; #endif #if defined(_WIN32) /** Shares the whole or part of a screen by specifying the screen rect. - - @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see [Share the Screen](https://docs.agora.io/en/Video/screensharing_windows?platform=Windows). - @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. - @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. - - @return - - 0: Success. - - < 0: Failure: - - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call \ref agora::rtc::IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. - - ERR_INVALID_ARGUMENT: the argument is invalid. + * + * @note + * - Ensure that you call this method after joining a channel. + * - Applies to the Windows platform only. + * + * @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see the advanced guide *Share Screen*. + * @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + * @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + * + * @return + * - 0: Success. + * - < 0: Failure: + * - #ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being + * shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. + * - #ERR_INVALID_ARGUMENT : the argument is invalid. */ virtual int startScreenCaptureByScreenRect(const Rectangle& screenRect, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; #endif /** Shares the whole or part of a window by specifying the window ID. - - @param windowId The ID of the window to be shared. For information on how to get the windowId, see [Share the Screen](https://docs.agora.io/en/Video/screensharing_windows?platform=Windows). - @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. - @param captureParams Window sharing encoding parameters. See ScreenCaptureParameters. - - @return - - 0: Success. - - < 0: Failure: - - ERR_INVALID_STATE: the window sharing state is invalid, probably because another screen or window is being shared. Call \ref agora::rtc::IRtcEngine::stopScreenCapture "stopScreenCapture" to stop sharing the current window. - - #ERR_INVALID_ARGUMENT: the argument is invalid. + * + * @note + * - Ensure that you call this method after joining a channel. + * - Applies to the macOS and Windows platforms only. + * + * Since v3.0.0, this method supports window sharing of UWP (Universal Windows Platform) applications. + * + * Agora tests the mainstream UWP applications by using the lastest SDK, see details as follows: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
OS versionSoftwareSoftware nameWhether support
win10Chrome76.0.3809.100No
Office Word18.1903.1152.0Yes
Office ExcelNo
Office PPTYes
WPS Word11.1.0.9145Yes
WPS Excel
WPS PPT
Media Player (come with the system)AllYes
win8ChromeAllYes
Office WordAllYes
Office Excel
Office PPT
WPS Word11.1.0.9098Yes
WPS Excel
WPS PPT
Media Player(come with the system)AllYes
win7Chrome73.0.3683.103No
Office WordAllYes
Office Excel
Office PPT
WPS Word11.1.0.9098No
WPS Excel
WPS PPT11.1.0.9098Yes
Media Player(come with the system)AllNo
+ * @param windowId The ID of the window to be shared. For information on how to get the windowId, see the advanced guide *Share Screen*. + * @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. + * @param captureParams Window sharing encoding parameters. See ScreenCaptureParameters. + * + * @return + * - 0: Success. + * - < 0: Failure: + * - #ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being + * shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. + * - #ERR_INVALID_ARGUMENT: the argument is invalid. */ virtual int startScreenCaptureByWindowId(view_t windowId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; /** Sets the content hint for screen sharing. - A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. + A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. + + @note You can call this method either before or after you start screen sharing. @param contentHint Sets the content hint for screen sharing. See VideoContentHint. @@ -5894,6 +7495,25 @@ class IRtcEngine - < 0: Failure. */ virtual int updateScreenCaptureRegion(const Rect *rect) = 0; + +#endif + +#if defined(_WIN32) + /** Sets a custom video source. + * + * During real-time communication, the Agora SDK enables the default video input device, that is, the built-in camera to + * capture video. If you need a custom video source, implement the IVideoSource class first, and call this method to add + * the custom video source to the SDK. + * + * @note You can call this method either before or after joining a channel. + * + * @param source The custom video source. See IVideoSource. + * + * @return + * - true: The custom video source is added to the SDK. + * - false: The custom video source is not added to the SDK. + */ + virtual bool setVideoSource(IVideoSource *source) = 0; #endif /** Retrieves the current call ID. @@ -5902,6 +7522,8 @@ class IRtcEngine The \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods require the @p callId parameter retrieved from the *getCallId* method during a call. @p callId is passed as an argument into the \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods after the call ends. + @note Ensure that you call this method after joining a channel. + @param callId Pointer to the current call ID. @return @@ -5912,6 +7534,8 @@ class IRtcEngine /** Allows a user to rate a call after the call ends. + @note Ensure that you call this method after joining a channel. + @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. @param rating Rating of the call. The value is between 1 (lowest score) and 5 (highest score). If you set a value out of this range, the #ERR_INVALID_ARGUMENT (2) error returns. @param description (Optional) Pointer to the description of the rating, with a string length of less than 800 bytes. @@ -5924,6 +7548,8 @@ class IRtcEngine /** Allows a user to complain about the call quality after a call ends. + @note Ensure that you call this method after joining a channel. + @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. @param description (Optional) Pointer to the description of the complaint, with a string length of less than 800 bytes. @@ -5982,7 +7608,7 @@ class IRtcEngine @note - This method consumes extra network traffic and may affect communication quality. We do not recommend calling this method together with enableLastmileTest. - Do not call other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" and \ref IRtcEngineEventHandler::onLastmileProbeResult "onLastmileProbeResult" callbacks. Otherwise, the callbacks may be interrupted. - - In the Live-broadcast profile, a host should not call this method after joining a channel. + - In the `LIVE_BROADCASTING` profile, a host should not call this method after joining a channel. @param config Sets the configurations of the last-mile network probe test. See LastmileProbeConfig. @@ -5998,12 +7624,14 @@ class IRtcEngine /** Retrieves the warning or error description. @param code Warning code or error code returned in the \ref agora::rtc::IRtcEngineEventHandler::onWarning "onWarning" or \ref agora::rtc::IRtcEngineEventHandler::onError "onError" callback. - + @return #WARN_CODE_TYPE or #ERROR_CODE_TYPE. */ virtual const char* getErrorDescription(int code) = 0; - /** Enables built-in encryption with an encryption password before users join a channel. + /** **DEPRECATED** Enables built-in encryption with an encryption password before users join a channel. + + Deprecated as of v3.1.0. Use the \ref agora::rtc::IRtcEngine::enableEncryption "enableEncryption" instead. All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. @@ -6021,7 +7649,9 @@ class IRtcEngine */ virtual int setEncryptionSecret(const char* secret) = 0; - /** Sets the built-in encryption mode. + /** **DEPRECATED** Sets the built-in encryption mode. + + @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IRtcEngine::enableEncryption "enableEncryption" instead. The Agora SDK supports built-in encryption, which is set to the @p aes-128-xts mode by default. Call this method to use other encryption modes. @@ -6043,14 +7673,41 @@ class IRtcEngine */ virtual int setEncryptionMode(const char* encryptionMode) = 0; + /** Enables/Disables the built-in encryption. + * + * @since v3.1.0 + * + * In scenarios requiring high security, Agora recommends calling this method to enable the built-in encryption before joining a channel. + * + * All users in the same channel must use the same encryption mode and encryption key. Once all users leave the channel, the encryption key of this channel is automatically cleared. + * + * @note + * - If you enable the built-in encryption, you cannot use the RTMP streaming function. + * - Agora supports four encryption modes. If you choose an encryption mode (excepting `SM4_128_ECB` mode), you need to add an external encryption library when integrating the Android and iOS SDK. See the advanced guide *Channel Encryption*. + * + * @param enabled Whether to enable the built-in encryption: + * - true: Enable the built-in encryption. + * - false: Disable the built-in encryption. + * @param config Configurations of built-in encryption schemas. See EncryptionConfig. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - -2(ERR_INVALID_ARGUMENT): An invalid parameter is used. Set the parameter with a valid value. + * - -4(ERR_NOT_SUPPORTED): The encryption mode is incorrect or the SDK fails to load the external encryption library. Check the enumeration or reload the external encryption library. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Initialize the `IRtcEngine` instance before calling this method. + */ + virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; + /** Registers a packet observer. The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. - + @note - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. + - Call this method before joining a channel. @param observer Pointer to the registered packet observer. See IPacketObserver. @@ -6064,9 +7721,11 @@ class IRtcEngine Each user can create up to five data streams during the lifecycle of the IRtcEngine. - @note Set both the @p reliable and @p ordered parameters to true or false. Do not set one as true and the other as false. + @note + - Set both the @p reliable and @p ordered parameters to true or false. Do not set one as true and the other as false. + - Ensure that you call this method after joining a channel. - @param streamId Pointer to the ID of the created data stream. + @param[out] streamId Pointer to the ID of the created data stream. @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, an error is reported to the application. - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for any delay or missing data stream. @@ -6075,7 +7734,7 @@ class IRtcEngine - false: The recipients do not receive the data stream in the sent order. @return - - Returns 0: Success. + - 0: Success. - < 0: Failure. */ virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; @@ -6087,11 +7746,12 @@ class IRtcEngine - Each client can send up to 6 kB of data per second. - Each user can have up to five data streams simultaneously. - A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. - - A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. - @note This method applies only to the Communication profile or to the hosts in the Live-broadcast profile. If an audience in the Live-broadcast profile calls this method, the audience may be switched to a host. + A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the + \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the + \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client. + @note This method applies only to the `COMMUNICATION` profile or to the hosts in the `LIVE_BROADCASTING` profile. If an audience in the `LIVE_BROADCASTING` profile calls this method, the audience may be switched to a host. @param streamId ID of the sent data stream, returned in the \ref IRtcEngine::createDataStream "createDataStream" method. @param data Pointer to the sent data. @param length Length of the sent data. @@ -6109,9 +7769,9 @@ class IRtcEngine The \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of adding a local stream to the CDN. @note - Ensure that the user joins the channel before calling this method. - - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. - This method adds only one stream RTMP URL address each time it is called. - - This method applies to Live Broadcast only. + - This method applies to `LIVE_BROADCASTING` only. @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. The RTMP URL address must not contain special characters, such as Chinese language characters. @param transcodingEnabled Sets whether transcoding is enabled/disabled: @@ -6134,7 +7794,7 @@ class IRtcEngine @note - This method removes only one RTMP URL address each time it is called. - The RTMP URL address must not contain special characters, such as Chinese language characters. - - This method applies to Live Broadcast only. + - This method applies to `LIVE_BROADCASTING` only. @param url The RTMP URL address to be removed. The maximum length of this parameter is 1024 bytes. @@ -6145,14 +7805,15 @@ class IRtcEngine virtual int removePublishStreamUrl(const char *url) = 0; /** Sets the video layout and audio settings for CDN live. (CDN live only.) - + The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you call the `setLiveTranscoding` method to update the transcoding setting. - + @note - - This method applies to Live Broadcast only. - - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - This method applies to `LIVE_BROADCASTING` only. + - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. - If you call the `setLiveTranscoding` method to update the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - + - Ensure that you call this method after joining a channel. + @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. @return @@ -6173,8 +7834,8 @@ class IRtcEngine @note - The URL descriptions are different for the local video and CDN live streams: - - In a local video stream, @p url in RtcImage refers to the absolute path of the added watermark image file in the local video stream. - - In a CDN live stream, @p url in RtcImage refers to the URL address of the added watermark image in the CDN live broadcast. + - In a local video stream, `url` in RtcImage refers to the absolute path of the added watermark image file in the local video stream. + - In a CDN live stream, `url` in RtcImage refers to the URL address of the added watermark image in the CDN live streaming. - The source file of the watermark image must be in the PNG file format. If the width and height of the PNG file differ from your settings in this method, the PNG file will be cropped to conform to your settings. - The Agora SDK supports adding only one watermark image onto a local video or CDN live stream. The newly added watermark image replaces the previous one. @@ -6186,7 +7847,7 @@ class IRtcEngine /** Adds a watermark image to the local video. - This method adds a PNG watermark image to the local video in a live broadcast. Once the watermark image is added, all the audience in the channel (CDN audience included), + This method adds a PNG watermark image to the local video in the live streaming. Once the watermark image is added, all the audience in the channel (CDN audience included), and the recording device can see and capture it. Agora supports adding only one watermark image onto the local video, and the newly watermark image replaces the previous one. The watermark position depends on the settings in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method: @@ -6196,12 +7857,12 @@ class IRtcEngine @note - Ensure that you have called the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method to enable the video module before calling this method. - - If you only want to add a watermark image to the local video for the audience in the CDN live broadcast channel to see and capture, you can call this method or the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. + - If you only want to add a watermark image to the local video for the audience in the CDN live streaming channel to see and capture, you can call this method or the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. - This method supports adding a watermark image in the PNG file format only. Supported pixel formats of the PNG image are RGBA, RGB, Palette, Gray, and Alpha_gray. - If the dimensions of the PNG image differ from your settings in this method, the image will be cropped or zoomed to conform to your settings. - If you have enabled the local video preview by calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, you can use the `visibleInPreview` member in the WatermarkOptions class to set whether or not the watermark is visible in preview. - - If you have mirrored the local video by calling the \ref agora::rtc::IRtcEngine::setupLocalVideo "setupLocalVideo" or \ref agora::rtc::IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" method, the watermark image in preview is also mirrored. - + - If you have enabled the mirror mode for the local video, the watermark on the local video is also mirrored. To avoid mirroring the watermark, Agora recommends that you do not use the mirror and watermark functions for the local video at the same time. You can implement the watermark function in your application layer. + @param watermarkUrl The local file path of the watermark image to be added. This method supports adding a watermark image from the local absolute or relative file path. @param options Pointer to the watermark's options to be added. See WatermarkOptions for more infomation. @@ -6220,19 +7881,17 @@ class IRtcEngine virtual int clearVideoWatermarks() = 0; /** Enables/Disables image enhancement and sets the options. - - @note - - Call this method after calling the enableVideo method. - - Currently this method does not apply for macOS. - - @param enabled Sets whether or not to enable image enhancement: - - true: enables image enhancement. - - false: disables image enhancement. - @param options Sets the image enhancement option. See BeautyOptions. + * + * @note Call this method after calling the \ref IRtcEngine::enableVideo "enableVideo" method. + * + * @param enabled Sets whether or not to enable image enhancement: + * - true: enables image enhancement. + * - false: disables image enhancement. + * @param options Sets the image enhancement option. See BeautyOptions. */ virtual int setBeautyEffectOptions(bool enabled, BeautyOptions options) = 0; - /** Adds a voice or video stream URL address to a live broadcast. + /** Adds a voice or video stream URL address to the live streaming. The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. @@ -6244,12 +7903,15 @@ class IRtcEngine - \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. @note - - Ensure that you enable the RTMP Converter service before using this function. See [Prerequisites](https://docs.agora.io/en/Interactive%20Broadcast/cdn_streaming_windows?platform=Windows#prerequisites). + - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. - This method applies to the Native SDK v2.4.1 and later. + - This method applies to the `LIVE_BROADCASTING` profile only. + - You can inject only one media stream into the channel at the same time. + - Ensure that you call this method after joining a channel. - @param url Pointer to the URL address to be added to the ongoing live broadcast. Valid protocols are RTMP, HLS, and FLV. - - Supported FLV audio codec type: AAC. - - Supported FLV video codec type: H264 (AVC). + @param url Pointer to the URL address to be added to the ongoing streaming. Valid protocols are RTMP, HLS, and HTTP-FLV. + - Supported audio codec type: AAC. + - Supported video codec type: H264 (AVC). @param config Pointer to the InjectStreamConfig object that contains the configuration of the added voice or video stream. @return @@ -6257,7 +7919,7 @@ class IRtcEngine - < 0: Failure. - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. - #ERR_NOT_READY (3): The user is not in the channel. - - #ERR_NOT_SUPPORTED (4): The channel profile is not live broadcast. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to live broadcast before calling this method. + - #ERR_NOT_SUPPORTED (4): The channel profile is not `LIVE_BROADCASTING`. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to `LIVE_BROADCASTING` before calling this method. - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IRtcEngine object is initialized before calling this method. */ virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; @@ -6275,7 +7937,7 @@ class IRtcEngine * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent * "onChannelMediaRelayEvent" callback returns - * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the broadcaster starts + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the host starts * sending data to the destination channel. * - If the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged @@ -6285,8 +7947,8 @@ class IRtcEngine * * @note * - Call this method after the \ref joinChannel() "joinChannel" method. - * - This method takes effect only when you are a broadcaster in a - * Live-broadcast channel. + * - This method takes effect only when you are a host in a + * `LIVE_BROADCASTING` channel. * - After a successful method call, if you want to call this method * again, ensure that you call the * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the @@ -6301,7 +7963,7 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Updates the channels for media stream relay. After a successful * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if * you want to relay the media stream to more channels, or leave the @@ -6325,16 +7987,16 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Stops the media stream relay. * - * Once the relay stops, the broadcaster quits all the destination + * Once the relay stops, the host quits all the destination * channels. * * After a successful method call, the SDK triggers the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged * "onChannelMediaRelayStateChanged" callback. If the callback returns - * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the broadcaster successfully + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the host successfully * stops the relay. * * @note @@ -6350,15 +8012,15 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int stopChannelMediaRelay() = 0; + virtual int stopChannelMediaRelay() = 0; - /** Removes the voice or video stream URL address from a live broadcast. + /** Removes the voice or video stream URL address from the live streaming. - This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live broadcast. + This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live streaming. @note If this method is called successfully, the SDK triggers the \ref IRtcEngineEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. - @param url Pointer to the URL address of the added stream to be removed. + @param url Pointer to the URL address of the injected stream to be removed. @return - 0: Success. @@ -6367,20 +8029,87 @@ class IRtcEngine virtual int removeInjectStreamUrl(const char* url) = 0; virtual bool registerEventHandler(IRtcEngineEventHandler *eventHandler) = 0; virtual bool unregisterEventHandler(IRtcEngineEventHandler *eventHandler) = 0; + /** Agora supports reporting and analyzing customized messages. + * + * @since v3.1.0 + * + * This function is in the beta stage with a free trial. The ability provided in its beta test version is reporting a maximum of 10 message pieces within 6 seconds, with each message piece not exceeding 256 bytes and each string not exceeding 100 bytes. + * To try out this function, contact [support@agora.io](mailto:support@agora.io) and discuss the format of customized messages with us. + */ + virtual int sendCustomReportMessage(const char *id, const char* category, const char* event, const char* label, int value) = 0; /** Gets the current connection state of the SDK. + @note You can call this method either before or after joining a channel. + @return #CONNECTION_STATE_TYPE. */ virtual CONNECTION_STATE_TYPE getConnectionState() = 0; + /// @cond + /** Enables/Disables the super-resolution algorithm for a remote user's video stream. + * + * @since v3.2.0 + * + * The algorithm effectively improves the resolution of the specified remote user's video stream. When the original + * resolution of the remote video stream is a × b pixels, you can receive and render the stream at a higher + * resolution (2a × 2b pixels) by enabling the algorithm. + * + * After calling this method, the SDK triggers the + * \ref IRtcEngineEventHandler::onUserSuperResolutionEnabled "onUserSuperResolutionEnabled" callback to report + * whether you have successfully enabled the super-resolution algorithm. + * + * @warning The super-resolution algorithm requires extra system resources. + * To balance the visual experience and system usage, the SDK poses the following restrictions: + * - The algorithm can only be used for a single user at a time. + * - On the Android platform, the original resolution of the remote video must not exceed 640 × 360 pixels. + * - On the iOS platform, the original resolution of the remote video must not exceed 640 × 480 pixels. + * If you exceed these limitations, the SDK triggers the \ref IRtcEngineEventHandler::onWarning "onWarning" + * callback with the corresponding warning codes: + * - #WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION (1610): The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. + * - #WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION (1611): Another user is already using the super-resolution algorithm. + * - #WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED (1612): The device does not support the super-resolution algorithm. + * + * @note + * - This method applies to Android and iOS only. + * - Requirements for the user's device: + * - Android: The following devices are known to support the method: + * - VIVO: V1821A, NEX S, 1914A, 1916A, and 1824BA + * - OPPO: PCCM00 + * - OnePlus: A6000 + * - Xiaomi: Mi 8, Mi 9, MIX3, and Redmi K20 Pro + * - SAMSUNG: SM-G9600, SM-G9650, SM-N9600, SM-G9708, SM-G960U, and SM-G9750 + * - HUAWEI: SEA-AL00, ELE-AL00, VOG-AL00, YAL-AL10, HMA-AL00, and EVR-AN00 + * - iOS: This method is supported on devices running iOS 12.0 or later. The following + * device models are known to support the method: + * - iPhone XR + * - iPhone XS + * - iPhone XS Max + * - iPhone 11 + * - iPhone 11 Pro + * - iPhone 11 Pro Max + * - iPad Pro 11-inch (3rd Generation) + * - iPad Pro 12.9-inch (3rd Generation) + * - iPad Air 3 (3rd Generation) + * + * @param userId The ID of the remote user. + * @param enable Whether to enable the super-resolution algorithm: + * - true: Enable the super-resolution algorithm. + * - false: Disable the super-resolution algorithm. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableRemoteSuperResolution(uid_t userId, bool enable) = 0; + /// @endcond /** Registers the metadata observer. Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. - This method enables you to add synchronized metadata in the video stream for more diversified live broadcast interactions, such as sending shopping links, digital coupons, and online quizzes. + This method enables you to add synchronized metadata in the video stream for more diversified live interactive streaming, such as sending shopping links, digital coupons, and online quizzes. @note - Call this method before the joinChannel method. - - This method applies to the Live-broadcast channel profile. + - This method applies to the `LIVE_BROADCASTING` channel profile. @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. @@ -6407,6 +8136,7 @@ class IRtcEngine class IRtcEngineParameter { public: + virtual ~IRtcEngineParameter () {} /** * Releases all IRtcEngineParameter resources. */ @@ -6574,7 +8304,7 @@ class IRtcEngineParameter */ virtual int setProfile(const char* profile, bool merge) = 0; - virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; + virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; }; class AAudioDeviceManager : public agora::util::AutoPtr @@ -6582,7 +8312,7 @@ class AAudioDeviceManager : public agora::util::AutoPtr public: AAudioDeviceManager(IRtcEngine* engine) { - queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); + queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); } }; @@ -6591,7 +8321,7 @@ class AVideoDeviceManager : public agora::util::AutoPtr public: AVideoDeviceManager(IRtcEngine* engine) { - queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); + queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); } }; @@ -6620,39 +8350,39 @@ class RtcEngineParameters RtcEngineParameters(IRtcEngine* engine) :m_parameter(engine){} - + int enableLocalVideo(bool enabled) { return setParameters("{\"rtc.video.capture\":%s,\"che.video.local.capture\":%s,\"che.video.local.render\":%s,\"che.video.local.send\":%s}", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false"); } - + int muteLocalVideoStream(bool mute) { return setParameters("{\"rtc.video.mute_me\":%s,\"che.video.local.send\":%s}", mute ? "true" : "false", mute ? "false" : "true"); } - + int muteAllRemoteVideoStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.video.mute_peers", mute) : -ERR_NOT_INITIALIZED; } - + int setDefaultMuteAllRemoteVideoStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.video.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; } - + int muteRemoteVideoStream(uid_t uid, bool mute) { return setObject("rtc.video.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute ? "true" : "false"); } - + int setPlaybackDeviceVolume(int volume) {// [0,255] return m_parameter ? m_parameter->setInt("che.audio.output.volume", volume) : -ERR_NOT_INITIALIZED; } - + int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) { return startAudioRecording(filePath, 32000, quality); } @@ -6669,12 +8399,12 @@ class RtcEngineParameters return setObject("che.audio.start_recording", "{\"filePath\":\"%s\",\"sampleRate\":%d,\"quality\":%d}", filePath, sampleRate, quality); } - + int stopAudioRecording() { return m_parameter ? m_parameter->setBool("che.audio.stop_recording", true) : -ERR_NOT_INITIALIZED; } - + int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) @@ -6691,22 +8421,22 @@ class RtcEngineParameters cycle); } - + int stopAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.stop_file_as_playout", true) : -ERR_NOT_INITIALIZED; } - + int pauseAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", true) : -ERR_NOT_INITIALIZED; } - + int resumeAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", false) : -ERR_NOT_INITIALIZED; } - + int adjustAudioMixingVolume(int volume) { int ret = adjustAudioMixingPlayoutVolume(volume); if (ret == 0) { @@ -6715,12 +8445,12 @@ class RtcEngineParameters return ret; } - + int adjustAudioMixingPlayoutVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; } - + int getAudioMixingPlayoutVolume() { int volume = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; @@ -6729,12 +8459,12 @@ class RtcEngineParameters return r; } - + int adjustAudioMixingPublishVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; } - + int getAudioMixingPublishVolume() { int volume = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; @@ -6743,7 +8473,7 @@ class RtcEngineParameters return r; } - + int getAudioMixingDuration() { int duration = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_mixing_file_length_ms", duration) : -ERR_NOT_INITIALIZED; @@ -6752,7 +8482,7 @@ class RtcEngineParameters return r; } - + int getAudioMixingCurrentPosition() { if (!m_parameter) return -ERR_NOT_INITIALIZED; int pos = 0; @@ -6761,12 +8491,21 @@ class RtcEngineParameters r = pos; return r; } - + int setAudioMixingPosition(int pos /*in ms*/) { return m_parameter ? m_parameter->setInt("che.audio.mixing.file.position", pos) : -ERR_NOT_INITIALIZED; } - + int setAudioMixingPitch(int pitch) { + if (!m_parameter) { + return -ERR_NOT_INITIALIZED; + } + if (pitch > 12 || pitch < -12) { + return -ERR_INVALID_ARGUMENT; + } + return m_parameter->setInt("che.audio.set_playout_file_pitch_semitones", pitch); + } + int getEffectsVolume() { if (!m_parameter) return -ERR_NOT_INITIALIZED; int volume = 0; @@ -6776,12 +8515,12 @@ class RtcEngineParameters return r; } - + int setEffectsVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.game_set_effects_volume", volume) : -ERR_NOT_INITIALIZED; } - + int setVolumeOfEffect(int soundId, int volume) { return setObject( "che.audio.game_adjust_effect_volume", @@ -6789,7 +8528,7 @@ class RtcEngineParameters soundId, volume); } - + int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) { #if defined(_WIN32) util::AString path; @@ -6804,19 +8543,19 @@ class RtcEngineParameters soundId, filePath, loopCount, pitch, pan, gain, publish); } - + int stopEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_stop_effect", soundId) : -ERR_NOT_INITIALIZED; } - + int stopAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_stop_all_effects", true) : -ERR_NOT_INITIALIZED; } - + int preloadEffect(int soundId, char* filePath) { return setObject( "che.audio.game_preload_effect", @@ -6824,61 +8563,61 @@ class RtcEngineParameters soundId, filePath); } - + int unloadEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_unload_effect", soundId) : -ERR_NOT_INITIALIZED; } - + int pauseEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_pause_effect", soundId) : -ERR_NOT_INITIALIZED; } - + int pauseAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_pause_all_effects", true) : -ERR_NOT_INITIALIZED; } - + int resumeEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_resume_effect", soundId) : -ERR_NOT_INITIALIZED; } - + int resumeAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_resume_all_effects", true) : -ERR_NOT_INITIALIZED; } - + int enableSoundPositionIndication(bool enabled) { return m_parameter ? m_parameter->setBool( "che.audio.enable_sound_position", enabled) : -ERR_NOT_INITIALIZED; } - + int setRemoteVoicePosition(uid_t uid, double pan, double gain) { return setObject("che.audio.game_place_sound_position", "{\"uid\":%u,\"pan\":%lf,\"gain\":%lf}", uid, pan, gain); } - + int setLocalVoicePitch(double pitch) { return m_parameter ? m_parameter->setInt( "che.audio.morph.pitch_shift", static_cast(pitch * 100)) : -ERR_NOT_INITIALIZED; } - + int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) { return setObject( "che.audio.morph.equalization", "{\"index\":%d,\"gain\":%d}", static_cast(bandFrequency), bandGain); } - + int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) { return setObject( "che.audio.morph.reverb", @@ -6886,33 +8625,196 @@ class RtcEngineParameters static_cast(reverbKey), value); } - + int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) { - return m_parameter ? m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)) : -ERR_NOT_INITIALIZED; + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(voiceChanger == 0x00000000) { + return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)); + } + else if(voiceChanger > 0x00000000 && voiceChanger < 0x00100000) { + return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)); + } + else if(voiceChanger > 0x00100000 && voiceChanger < 0x00200000) { + return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger - 0x00100000 + 6)); + } + else if(voiceChanger > 0x00200000 && voiceChanger < 0x00300000) { + return m_parameter->setInt("che.audio.morph.beauty_voice", static_cast(voiceChanger - 0x00200000)); + } + else { + return -ERR_INVALID_ARGUMENT; + } } - + int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) { - return m_parameter ? m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)) : -ERR_NOT_INITIALIZED; + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(reverbPreset == 0x00000000) { + return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)); + } + else if(reverbPreset > 0x00000000 && reverbPreset < 0x00100000) { + return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset + 8)); + } + else if(reverbPreset > 0x00100000 && reverbPreset < 0x00200000) { + return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset - 0x00100000)); + } + else if(reverbPreset > 0x00200000 && reverbPreset < 0x00200002) { + return m_parameter->setInt("che.audio.morph.virtual_stereo", static_cast(reverbPreset - 0x00200000)); + } + else if (reverbPreset > (AUDIO_REVERB_PRESET) 0x00300000 && reverbPreset < (AUDIO_REVERB_PRESET) 0x00300002) + return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", 1, 4); + else if (reverbPreset > (AUDIO_REVERB_PRESET) 0x00400000 && reverbPreset < (AUDIO_REVERB_PRESET) 0x00400002) + return m_parameter->setInt("che.audio.morph.threedim_voice", 10); + else { + return -ERR_INVALID_ARGUMENT; + } + } + + int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset){ + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == AUDIO_EFFECT_OFF) { + return m_parameter->setInt("che.audio.morph.voice_changer", 0); + } + if(preset == ROOM_ACOUSTICS_KTV){ + return m_parameter->setInt("che.audio.morph.reverb_preset", 1); + } + if(preset == ROOM_ACOUSTICS_VOCAL_CONCERT) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 2); + } + if(preset == ROOM_ACOUSTICS_STUDIO) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 5); + } + if(preset == ROOM_ACOUSTICS_PHONOGRAPH) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 8); + } + if(preset == ROOM_ACOUSTICS_VIRTUAL_STEREO) { + return m_parameter->setInt("che.audio.morph.virtual_stereo", 1); + } + if(preset == ROOM_ACOUSTICS_SPACIAL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 15); + } + if(preset == ROOM_ACOUSTICS_ETHEREAL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 5); + } + if(preset == ROOM_ACOUSTICS_3D_VOICE) { + return m_parameter->setInt("che.audio.morph.threedim_voice", 10); + } + if(preset == VOICE_CHANGER_EFFECT_UNCLE) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 3); + } + if(preset == VOICE_CHANGER_EFFECT_OLDMAN) { + return m_parameter->setInt("che.audio.morph.voice_changer", 1); + } + if(preset == VOICE_CHANGER_EFFECT_BOY) { + return m_parameter->setInt("che.audio.morph.voice_changer", 2); + } + if(preset == VOICE_CHANGER_EFFECT_SISTER) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 4); + } + if(preset == VOICE_CHANGER_EFFECT_GIRL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 3); + } + if(preset == VOICE_CHANGER_EFFECT_PIGKING) { + return m_parameter->setInt("che.audio.morph.voice_changer", 4); + } + if(preset == VOICE_CHANGER_EFFECT_HULK) { + return m_parameter->setInt("che.audio.morph.voice_changer", 6); + } + if(preset == STYLE_TRANSFORMATION_RNB) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 7); + } + if(preset == STYLE_TRANSFORMATION_POPULAR) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 6); + } + if(preset == PITCH_CORRECTION) { + return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", 1, 4); + } + return -ERR_INVALID_ARGUMENT; + } + + int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) { + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == VOICE_BEAUTIFIER_OFF) { + return m_parameter->setInt("che.audio.morph.voice_changer", 0); + } + if(preset == CHAT_BEAUTIFIER_MAGNETIC) { + return m_parameter->setInt("che.audio.morph.beauty_voice", 1); + } + if(preset == CHAT_BEAUTIFIER_FRESH) { + return m_parameter->setInt("che.audio.morph.beauty_voice", 2); + } + if(preset == CHAT_BEAUTIFIER_VITALITY) { + return m_parameter->setInt("che.audio.morph.beauty_voice", 3); + } + /*if(preset == SINGING_BEAUTIFICATION_MAN) { + return m_parameter->setInt("che.audio.morph.beauty_sing", 1); + } + if(preset == SINGING_BEAUTIFICATION_WOMAN) { + return m_parameter->setInt("che.audio.morph.beauty_sing", 2); + }*/ + if(preset == TIMBRE_TRANSFORMATION_VIGOROUS) { + return m_parameter->setInt("che.audio.morph.voice_changer", 7); + } + if(preset == TIMBRE_TRANSFORMATION_DEEP) { + return m_parameter->setInt("che.audio.morph.voice_changer", 8); + } + if(preset == TIMBRE_TRANSFORMATION_MELLOW) { + return m_parameter->setInt("che.audio.morph.voice_changer", 9); + } + if(preset == TIMBRE_TRANSFORMATION_FALSETTO) { + return m_parameter->setInt("che.audio.morph.voice_changer", 10); + } + if(preset == TIMBRE_TRANSFORMATION_FULL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 11); + } + if(preset == TIMBRE_TRANSFORMATION_CLEAR) { + return m_parameter->setInt("che.audio.morph.voice_changer", 12); + } + if(preset == TIMBRE_TRANSFORMATION_RESOUNDING) { + return m_parameter->setInt("che.audio.morph.voice_changer", 13); + } + if(preset == TIMBRE_TRANSFORMATION_RINGING) { + return m_parameter->setInt("che.audio.morph.voice_changer", 14); + } + return -ERR_INVALID_ARGUMENT; + } + + int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2){ + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == PITCH_CORRECTION){ + return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", param1, param2); + } + if(preset == ROOM_ACOUSTICS_3D_VOICE){ + return m_parameter->setInt("che.audio.morph.threedim_voice", param1); + } + return -ERR_INVALID_ARGUMENT; } + /** **DEPRECATED** Use \ref IRtcEngine::disableAudio "disableAudio" instead. Disables the audio function in the channel. - + @return + - 0: Success. + - < 0: Failure. + */ int pauseAudio() { return m_parameter ? m_parameter->setBool("che.pause.audio", true) : -ERR_NOT_INITIALIZED; } - + int resumeAudio() { return m_parameter ? m_parameter->setBool("che.pause.audio", false) : -ERR_NOT_INITIALIZED; } - + int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) { return setObject("che.audio.codec.hq", "{\"fullband\":%s,\"stereo\":%s,\"fullBitrate\":%s}", fullband ? "true" : "false", stereo ? "true" : "false", fullBitrate ? "true" : "false"); } - + int adjustRecordingSignalVolume(int volume) {//[0, 400]: e.g. 50~0.5x 100~1x 400~4x if (volume < 0) volume = 0; @@ -6921,7 +8823,7 @@ class RtcEngineParameters return m_parameter ? m_parameter->setInt("che.audio.record.signal.volume", volume) : -ERR_NOT_INITIALIZED; } - + int adjustPlaybackSignalVolume(int volume) {//[0, 400] if (volume < 0) volume = 0; @@ -6930,35 +8832,35 @@ class RtcEngineParameters return m_parameter ? m_parameter->setInt("che.audio.playout.signal.volume", volume) : -ERR_NOT_INITIALIZED; } - + int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) { // in ms: <= 0: disable, > 0: enable, interval in ms if (interval < 0) interval = 0; return setObject("che.audio.volume_indication", "{\"interval\":%d,\"smooth\":%d,\"vad\":%d}", interval, smooth, report_vad); } - + int muteLocalAudioStream(bool mute) { return setParameters("{\"rtc.audio.mute_me\":%s,\"che.audio.mute_me\":%s}", mute ? "true" : "false", mute ? "true" : "false"); } // mute/unmute all peers. unmute will clear all muted peers specified mutePeer() interface - + int muteRemoteAudioStream(uid_t uid, bool mute) { return setObject("rtc.audio.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute?"true":"false"); } - + int muteAllRemoteAudioStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.audio.mute_peers", mute) : -ERR_NOT_INITIALIZED; } - + int setDefaultMuteAllRemoteAudioStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.audio.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; } - + int setExternalAudioSource(bool enabled, int sampleRate, int channels) { if (enabled) return setParameters("{\"che.audio.external_capture\":true,\"che.audio.external_capture.push\":true,\"che.audio.set_capture_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE); @@ -6966,7 +8868,7 @@ class RtcEngineParameters return setParameters("{\"che.audio.external_capture\":false,\"che.audio.external_capture.push\":false}"); } - + int setExternalAudioSink(bool enabled, int sampleRate, int channels) { if (enabled) return setParameters("{\"che.audio.external_render\":true,\"che.audio.external_render.pull\":true,\"che.audio.set_render_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_ONLY); @@ -6974,7 +8876,7 @@ class RtcEngineParameters return setParameters("{\"che.audio.external_render\":false,\"che.audio.external_render.pull\":false}"); } - + int setLogFile(const char* filePath) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) @@ -6987,73 +8889,73 @@ class RtcEngineParameters return m_parameter->setString("rtc.log_file", filePath); } - + int setLogFilter(unsigned int filter) { return m_parameter ? m_parameter->setUInt("rtc.log_filter", filter&LOG_FILTER_MASK) : -ERR_NOT_INITIALIZED; } - + int setLogFileSize(unsigned int fileSizeInKBytes) { return m_parameter ? m_parameter->setUInt("rtc.log_size", fileSizeInKBytes) : -ERR_NOT_INITIALIZED; } - + int setLocalRenderMode(RENDER_MODE_TYPE renderMode) { return setRemoteRenderMode(0, renderMode); } - + int setRemoteRenderMode(uid_t uid, RENDER_MODE_TYPE renderMode) { - return setObject("che.video.render_mode", "{\"uid\":%u,\"renderMode\":%d}", uid, renderMode); + return setParameters("{\"che.video.render_mode\":[{\"uid\":%u,\"renderMode\":%d}]}", uid, renderMode); } - + int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) { if (!m_parameter) return -ERR_NOT_INITIALIZED; return m_parameter->setInt("che.video.camera_capture_mode", (int)config.preference); } - + int enableDualStreamMode(bool enabled) { return setParameters("{\"rtc.dual_stream_mode\":%s,\"che.video.enableLowBitRateStream\":%d}", enabled ? "true" : "false", enabled ? 1 : 0); } - + int setRemoteVideoStreamType(uid_t uid, REMOTE_VIDEO_STREAM_TYPE streamType) { return setParameters("{\"rtc.video.set_remote_video_stream\":{\"uid\":%u,\"stream\":%d}, \"che.video.setstream\":{\"uid\":%u,\"stream\":%d}}", uid, streamType, uid, streamType); // return setObject("rtc.video.set_remote_video_stream", "{\"uid\":%u,\"stream\":%d}", uid, streamType); } - + int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) { return m_parameter ? m_parameter->setInt("rtc.video.set_remote_default_video_stream_type", streamType) : -ERR_NOT_INITIALIZED; } - + int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { return setObject("che.audio.set_capture_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); } - + int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { return setObject("che.audio.set_render_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); } - + int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) { return setObject("che.audio.set_mixed_raw_audio_format", "{\"sampleRate\":%d,\"samplesPerCall\":%d}", sampleRate, samplesPerCall); } - + int enableWebSdkInteroperability(bool enabled) {//enable interoperability with zero-plugin web sdk return setParameters("{\"rtc.video.web_h264_interop_enable\":%s,\"che.video.web_h264_interop_enable\":%s}", enabled ? "true" : "false", enabled ? "true" : "false"); } //only for live broadcast - + int setVideoQualityParameters(bool preferFrameRateOverImageQuality) { return setParameters("{\"rtc.video.prefer_frame_rate\":%s,\"che.video.prefer_frame_rate\":%s}", preferFrameRateOverImageQuality ? "true" : "false", preferFrameRateOverImageQuality ? "true" : "false"); } - + int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) { if (!m_parameter) return -ERR_NOT_INITIALIZED; const char *value; @@ -7073,18 +8975,18 @@ class RtcEngineParameters return m_parameter->setString("che.video.localViewMirrorSetting", value); } - + int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) { return m_parameter ? m_parameter->setInt("rtc.local_publish_fallback_option", option) : -ERR_NOT_INITIALIZED; } - + int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) { return m_parameter ? m_parameter->setInt("rtc.remote_subscribe_fallback_option", option) : -ERR_NOT_INITIALIZED; } #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) || defined(_WIN32) - + int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) { if (!deviceName) { return setParameters("{\"che.audio.loopback.recording\":%s}", enabled ? "true" : "false"); @@ -7095,7 +8997,7 @@ class RtcEngineParameters } #endif - + int setInEarMonitoringVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.headset.monitoring.parameter", volume) : -ERR_NOT_INITIALIZED; } @@ -7140,9 +9042,11 @@ class RtcEngineParameters //////////////////////////////////////////////////////// /** Creates the IRtcEngine object and returns the pointer. - * + * + * @note The Agora RTC Native SDK supports creating only one `IRtcEngine` object for an app for now. + * * @return Pointer to the IRtcEngine object. - */ + */ AGORA_API agora::rtc::IRtcEngine* AGORA_CALL createAgoraRtcEngine(); //////////////////////////////////////////////////////// diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h index a607ed3..299158c 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h @@ -25,11 +25,12 @@ class IAgoraService { protected: virtual ~IAgoraService(){} + public: - virtual void release() = 0; + AGORA_CPP_API static void release (); /** Initializes the engine. - + @param context RtcEngine context. @return - 0: Success. @@ -50,7 +51,7 @@ class IAgoraService } // namespace agora /** Gets the SDK version number. - + @param build Build number of the Agora SDK. @return - 0: Success. diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java index a04de3a..9c5e31b 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java @@ -52,6 +52,16 @@ public int getBufferType() { return MediaIO.BufferType.BYTE_ARRAY.intValue(); } + @Override + public int getCaptureType() { + return 0; + } + + @Override + public int getContentHint() { + return 0; + } + public IVideoFrameConsumer getFrameConsumer () { return this.mVideoFrameConsumer; } diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle index 2300317..822e31b 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle @@ -15,7 +15,7 @@ android { } } ndk { - abiFilters "armeabi-v7a", "arm64-v8a" // DO NOT MODIFY THIS LINE, IT'S UPDATED BY BUILD MACHINE AUTOMATICALLY. + abiFilters "armeabi-v7a" // DO NOT MODIFY THIS LINE, IT'S UPDATED BY BUILD MACHINE AUTOMATICALLY. } } @@ -46,10 +46,11 @@ android { dependencies { implementation fileTree(include: ['*.jar'], dir: 'libs') - // implementation(name: 'RtcChannelPublishHelper', ext: 'aar') - api project(':RtcChannelPublishHelper') - implementation 'io.agora.rtc:full-sdk:3.0.1' - implementation files('lib/AgoraMediaPlayer.jar') - // implementation 'io.agora:agoraplayer:1.2.1' + implementation(name: 'RtcChannelPublishHelper', ext: 'aar') + // api project(':RtcChannelPublishHelper') + implementation 'io.agora.rtc:full-sdk:3.2.0' + //implementation files('lib/AgoraMediaPlayer.jar') + //implementation files('lib/agora-rtc-sdk.jar') + implementation 'io.agora:agoraplayer:1.2.2' implementation 'com.android.support:support-v4:26.0.0' } diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar new file mode 100644 index 0000000000000000000000000000000000000000..f861254be657e34aea350eccdb8d4dac935721ed GIT binary patch literal 186216 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 - aab8b8f5a8cd4469a63042fcfafe7063 + diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/build.gradle index 125281d..3a26a2b 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/build.gradle @@ -2,9 +2,12 @@ buildscript { repositories { google() + //maven() jcenter() - maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } + + maven { url 'https://maven.aliyun.com/repository/public/' } } + dependencies { classpath 'com.android.tools.build:gradle:4.0.1' } @@ -13,7 +16,9 @@ buildscript { allprojects { repositories { google() + //maven() jcenter() - maven { url 'http://maven.aliyun.com/nexus/content/groups/public/' } + // maven() + maven { url 'https://maven.aliyun.com/repository/public/' } } } From 78d7f8f3177a96fc94ad1acc447158e5797b4324 Mon Sep 17 00:00:00 2001 From: TongJiangyong <1246376353@qq.com> Date: Wed, 20 Jan 2021 14:13:34 +0800 Subject: [PATCH 3/7] remove useless code --- .../src/main/cpp/agora_plugin_rtc.cpp | 9 ++++----- .../src/main/java/io/agora/RtcChannelPublishHelper.java | 3 ++- 2 files changed, 6 insertions(+), 6 deletions(-) diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp index 2254297..4699472 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp @@ -148,7 +148,7 @@ class AgoraAudioFrameObserver : public agora::media::IAudioFrameObserver { return true; } - //XLOGI("tjy onRecordAudioFrame got audio frame %f,%f",audio_sonSum,audio_voiceSum); + XLOGI("tjy onRecordAudioFrame got audio frame %f,%f",audio_sonSum,audio_voiceSum); char *data = (char *) malloc(sizeof(short) * bytes); recordMux.lock(); agoraAudioBuf->Pop(data, (int)bytes); @@ -191,7 +191,6 @@ class AgoraAudioFrameObserver : public agora::media::IAudioFrameObserver { } virtual bool onPlaybackAudioFrame(AudioFrame &audioFrame) override { - //XLOGI("tjy onPlaybackAudioFrame");playBackBuf if (!enable_local_playout_volume){ return true; } @@ -199,8 +198,8 @@ class AgoraAudioFrameObserver : public agora::media::IAudioFrameObserver { if (playBackBuf->mAvailSamples < bytes) { return true; } - XLOGI("tjy onPlaybackAudioFrame want bytes: %d,%d,%d,%d,%d available bytes: %d", - audioFrame.bytesPerSample,audioFrame.channels,audioFrame.samples,audioFrame.samplesPerSec,bytes,agoraAudioBuf->mAvailSamples); + //XLOGI("tjy onPlaybackAudioFrame want bytes: %d,%d,%d,%d,%d available bytes: %d", + // audioFrame.bytesPerSample,audioFrame.channels,audioFrame.samples,audioFrame.samplesPerSec,bytes,agoraAudioBuf->mAvailSamples); char *data = (char *) malloc(sizeof(short) * bytes); playoutMux.lock(); @@ -352,7 +351,7 @@ Java_io_agora_RtcChannelPublishHelper_adjustPublishVoiceVolume(JNIEnv *env, jobj extern "C" JNIEXPORT void JNICALL Java_io_agora_RtcChannelPublishHelper_nativeEnablePushAudioToRtc(JNIEnv *env, jobject instance,jboolean enable) { - XLOGI("TJY nativeEnablePushAudioToRtc %d",enable); + XLOGI("TJY nativeEnablePushAudioToRtc %d %p",enable,rtcEngine); s_audioFrameObserver.enable_push_playout_volume = enable; if(!enable) { destroyAudioBuffer(); diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java index 895019e..6256292 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java @@ -234,10 +234,11 @@ public void enableLocalPlayoutVolume(boolean enable) { this.agoraMediaPlayerKit.unregisterAudioFrameObserver(this); mRtcEngine.setParameters("{\"che.audio.enable.aec\":false}"); } + enablePushAudioToRtc = true; nativeEnableLocalPlayoutVolume(enable); } - private int adjustPublishLocalVoiceVolume(int volume) { + public int adjustPublishLocalVoiceVolume(int volume) { if (mRtcEngine == null || this.agoraMediaPlayerKit == null) { return ERROR_CODE; } From 52d0ef4ce12142de76a51b76462aac4573d616d6 Mon Sep 17 00:00:00 2001 From: John <1246376353@qq.com> Date: Fri, 16 Apr 2021 11:49:54 +0800 Subject: [PATCH 4/7] Update ExtendAudioFrameObserver.cpp --- .../RtcChannelHelperPlugin/utils/ExtendAudioFrameObserver.cpp | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MediaPlayer/samples/win/AgoraPlayer_Quickstart/RtcChannelHelperPlugin/utils/ExtendAudioFrameObserver.cpp b/MediaPlayer/samples/win/AgoraPlayer_Quickstart/RtcChannelHelperPlugin/utils/ExtendAudioFrameObserver.cpp index 216f16a..fdab3df 100644 --- a/MediaPlayer/samples/win/AgoraPlayer_Quickstart/RtcChannelHelperPlugin/utils/ExtendAudioFrameObserver.cpp +++ b/MediaPlayer/samples/win/AgoraPlayer_Quickstart/RtcChannelHelperPlugin/utils/ExtendAudioFrameObserver.cpp @@ -51,7 +51,7 @@ bool CExtendAudioFrameObserver::onRecordAudioFrame(AudioFrame& audioFrame){ audioBuf[i] = -32768; } else { - audioBuf[i] += tmp; + audioBuf[i] = tmp; } } memcpy(audioFrame.buffer, audioBuf, bytes); From effeadffcb4777b92f6ba1662ea913816a211227 Mon Sep 17 00:00:00 2001 From: tangnianji Date: Wed, 21 Apr 2021 10:46:55 +0800 Subject: [PATCH 5/7] add unregisterAudioFrameObserver method --- .../RtcChannelPublishHelper/build.gradle | 2 +- .../src/main/cpp/agora_plugin_rtc.cpp | 17 +- .../src/main/cpp/include/AgoraBase.h | 281 +- .../src/main/cpp/include/IAgoraMediaEngine.h | 786 +-- .../src/main/cpp/include/IAgoraRtcChannel.h | 1364 +---- .../src/main/cpp/include/IAgoraRtcEngine.h | 5135 +++++++---------- .../src/main/cpp/include/IAgoraService.h | 7 +- .../main/java/io/agora/MediaVideoSource.java | 3 +- .../io/agora/RtcChannelPublishHelper.java | 4 + .../AgoraPlayer_Quickstart/app/build.gradle | 2 +- .../app/lib/RtcChannelPublishHelper.aar | Bin 186216 -> 89087 bytes .../io/agora/mediaplayer/PlayerFragment.java | 3 +- .../app/src/main/res/values/strings.xml | 2 +- 13 files changed, 2413 insertions(+), 5193 deletions(-) diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle index eb57206..3b39106 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle @@ -56,7 +56,7 @@ dependencies { //dependencies { compile fileTree(dir:'../../../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} //provided files('../../../../build/android/arm/android/lib/agora-rtc-sdk/agora-rtc-sdk.jar') compile 'com.android.support:support-v4:23.2.0' - implementation 'io.agora.rtc:full-sdk:3.2.0' + implementation 'io.agora.rtc:full-sdk:2.9.0.107' //dependencies { compile fileTree(dir:'../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} //implementation 'net.butterflytv.utils:rtmp-client:0.2.6' //implementation 'net.butterflytv.utils:rtmp-client:3.1.0' diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp index 4699472..66490c1 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/agora_plugin_rtc.cpp @@ -269,9 +269,12 @@ loadAgoraRtcEnginePlugin(agora::rtc::IRtcEngine *engine) { void __attribute__((visibility("default"))) unloadAgoraRtcEnginePlugin(agora::rtc::IRtcEngine *engine) { XLOGI("TJY unloadAgoraRtcEnginePlugin--------- "); + if(mediaEngine_){ + mediaEngine_->registerAudioFrameObserver(nullptr); + } is_init_new_agora_rtc_ = false; rtcEngine = nullptr; - + mediaEngine_ = nullptr; } } @@ -392,3 +395,15 @@ Java_io_agora_RtcChannelPublishHelper_nativeRelease(JNIEnv *env, jobject instanc is_init_new_agora_rtc_ = false; } } + +extern "C" +JNIEXPORT void JNICALL +Java_io_agora_RtcChannelPublishHelper_nativeUnregisterAudioFrameObserver(JNIEnv *env, jobject instance){ + XLOGI("TJY nativeUnregisterAudioFrameObserver"); + if(mediaEngine_){ + mediaEngine_->registerAudioFrameObserver(nullptr); + } + if (is_init_new_agora_rtc_) { + is_init_new_agora_rtc_ = false; + } +} diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h index ecb0c5a..56c4997 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h @@ -18,23 +18,18 @@ #define AGORA_CALL __cdecl #if defined(AGORARTC_EXPORT) #define AGORA_API extern "C" __declspec(dllexport) -#define AGORA_CPP_API __declspec(dllexport) #else #define AGORA_API extern "C" __declspec(dllimport) -#define AGORA_CPP_API __declspec(dllimport) #endif #elif defined(__APPLE__) #include #define AGORA_API __attribute__((visibility("default"))) extern "C" -#define AGORA_CPP_API __attribute__((visibility("default"))) #define AGORA_CALL #elif defined(__ANDROID__) || defined(__linux__) #define AGORA_API extern "C" __attribute__((visibility("default"))) -#define AGORA_CPP_API __attribute__((visibility("default"))) #define AGORA_CALL #else #define AGORA_API extern "C" -#define AGORA_CPP_API #define AGORA_CALL #endif @@ -135,7 +130,7 @@ enum WARN_CODE_TYPE */ WARN_LOOKUP_CHANNEL_TIMEOUT = 104, /** **DEPRECATED** 105: The server rejects the request to look up the channel. The server cannot process this request or the request is illegal. - + Deprecated as of v2.4.1. Use CONNECTION_CHANGED_REJECTED_BY_SERVER(10) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ WARN_LOOKUP_CHANNEL_REJECTED = 105, @@ -150,7 +145,7 @@ enum WARN_CODE_TYPE /** 111: A timeout occurs when switching to the live video. */ WARN_SWITCH_LIVE_VIDEO_TIMEOUT = 111, - /** 118: A timeout occurs when setting the client role in the live interactive streaming profile. + /** 118: A timeout occurs when setting the client role in the live broadcast profile. */ WARN_SET_CLIENT_ROLE_TIMEOUT = 118, /** 121: The ticket to open the channel is invalid. @@ -159,103 +154,93 @@ enum WARN_CODE_TYPE /** 122: Try connecting to another server. */ WARN_OPEN_CHANNEL_TRY_NEXT_VOS = 122, - /** 131: The channel connection cannot be recovered. - */ WARN_CHANNEL_CONNECTION_UNRECOVERABLE = 131, - /** 132: The IP address has changed. - */ WARN_CHANNEL_CONNECTION_IP_CHANGED = 132, - /** 133: The port has changed. - */ WARN_CHANNEL_CONNECTION_PORT_CHANGED = 133, - /** 134: The socket error occurs, try to rejoin channel. - */ - WARN_CHANNEL_SOCKET_ERROR = 134, /** 701: An error occurs in opening the audio mixing file. */ WARN_AUDIO_MIXING_OPEN_ERROR = 701, - /** 1014: Audio Device Module: A warning occurs in the playback device. + /** 1014: Audio Device Module: a warning occurs in the playback device. */ WARN_ADM_RUNTIME_PLAYOUT_WARNING = 1014, /** 1016: Audio Device Module: a warning occurs in the recording device. */ WARN_ADM_RUNTIME_RECORDING_WARNING = 1016, - /** 1019: Audio Device Module: no valid audio data is recorded. + /** 1019: Audio Device Module: no valid audio data is collected. */ WARN_ADM_RECORD_AUDIO_SILENCE = 1019, - /** 1020: Audio device module: The audio playback frequency is abnormal, which may cause audio freezes. This abnormality is caused by high CPU usage. Agora recommends stopping other apps. + /** 1020: Audio Device Module: the playback device fails. */ WARN_ADM_PLAYOUT_MALFUNCTION = 1020, - /** 1021: Audio device module: the audio recording frequency is abnormal, which may cause audio freezes. This abnormality is caused by high CPU usage. Agora recommends stopping other apps. + /** 1021: Audio Device Module: the recording device fails. */ WARN_ADM_RECORD_MALFUNCTION = 1021, - /** 1025: The audio playback or recording is interrupted by system events (such as a phone call). + + /** 1025: Call is interrupted by system events such as phone call or siri (iOS) etc. */ WARN_ADM_CALL_INTERRUPTION = 1025, - /** 1029: During a call, the audio session category should be set to - * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. - * If the audio session category is set to other values, this warning code - * is triggered and RtcEngine will forcefully set it back to + + /** 1029: During a call, the audio session category should be set to + * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. + * If the audio session category is set to other values, this warning code + * is triggered and RtcEngine will forcefully set it back to * AVAudioSessionCategoryPlayAndRecord. */ WARN_ADM_IOS_CATEGORY_NOT_PLAYANDRECORD = 1029, - /** 1031: Audio Device Module: The recorded audio voice is too low. + /** + */ + WARN_ADM_IOS_SAMPLERATE_CHANGE = 1030, + /** 1031: Audio Device Module: the recorded audio voice is too low. */ WARN_ADM_RECORD_AUDIO_LOWLEVEL = 1031, - /** 1032: Audio Device Module: The playback audio voice is too low. + /** 1032: Audio Device Module: the playback audio voice is too low. */ WARN_ADM_PLAYOUT_AUDIO_LOWLEVEL = 1032, - /** 1033: Audio device module: The audio recording device is occupied. - */ + /** + */ WARN_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, - /** 1040: Audio device module: An exception occurs with the audio drive. - * Solutions: + /** 1040: Audio device module: An exception occurs with the audio drive. + * Solutions: * - Disable or re-enable the audio device. * - Re-enable your device. * - Update the sound card drive. */ WARN_ADM_WINDOWS_NO_DATA_READY_EVENT = 1040, - /** 1042: Audio device module: The audio recording device is different from the audio playback device, - * which may cause echoes problem. Agora recommends using the same audio device to record and playback - * audio. - */ - WARN_ADM_INCONSISTENT_AUDIO_DEVICE = 1042, - /** 1051: (Communication profile only) Audio processing module: A howling sound is detected when recording the audio data. + /** 1051: Audio Device Module: howling is detected. */ WARN_APM_HOWLING = 1051, - /** 1052: Audio Device Module: The device is in the glitch state. + /** 1052: Audio Device Module: the device is in the glitch state. */ WARN_ADM_GLITCH_STATE = 1052, - /** 1053: Audio Processing Module: A residual echo is detected, which may be caused by the belated scheduling of system threads or the signal overflow. + /** 1053: Audio Device Module: the underlying audio settings have changed. */ - WARN_APM_RESIDUAL_ECHO = 1053, - /// @cond + WARN_ADM_IMPROPER_SETTINGS = 1053, + /** + */ WARN_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, - /// @endcond - /** 1323: Audio device module: No available playback device. + /** 1323: Audio device module: No available playback device. * Solution: Plug in the audio device. */ WARN_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, - /** Audio device module: The capture device is released improperly. - * Solutions: + /** Audio device module: The capture device is released improperly. + * Solutions: * - Disable or re-enable the audio device. * - Re-enable your device. * - Update the sound card drive. */ WARN_ADM_WIN_CORE_IMPROPER_CAPTURE_RELEASE = 1324, - /** 1610: The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. + /** 1610: Super-resolution warning: the original video dimensions of the remote user exceed 640 × 480. */ WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION = 1610, - /** 1611: Another user is already using the super-resolution algorithm. + /** 1611: Super-resolution warning: another user is using super resolution. */ WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION = 1611, - /** 1612: The device does not support the super-resolution algorithm. + /** 1612: The device is not supported. */ WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED = 1612, - /// @cond + WARN_RTM_LOGIN_TIMEOUT = 2005, WARN_RTM_KEEP_ALIVE_TIMEOUT = 2009 - /// @endcond }; /** Error code. @@ -282,7 +267,7 @@ enum ERROR_CODE_TYPE /** 4: The SDK does not support this function. */ ERR_NOT_SUPPORTED = 4, - /** 5: The request is rejected. + /** 5: The request is rejected. This is for internal SDK use only, and it does not return to the application through any method or callback. */ ERR_REFUSED = 5, /** 6: The buffer size is not big enough to store the returned data. @@ -291,7 +276,7 @@ enum ERROR_CODE_TYPE /** 7: The SDK is not initialized before calling this method. */ ERR_NOT_INITIALIZED = 7, - /** 9: No permission exists. Check if the user has granted access to the audio or video device. + /** 9: No permission exists. This is for internal SDK use only, and it does not return to the application through any method or callback. */ ERR_NO_PERMISSION = 9, /** 10: An API method timeout occurs. Some API methods require the SDK to return the execution result, and this error occurs if the request takes too long (more than 10 seconds) for the SDK to process. @@ -312,15 +297,7 @@ enum ERROR_CODE_TYPE /** 15: No network buffers are available. This is for internal SDK internal use only, and it does not return to the application through any method or callback. */ ERR_NET_NOBUFS = 15, - /** 17: The request to join the channel is rejected. - * - * - This error usually occurs when the user is already in the channel, and still calls the method to join the - * channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". - * - This error usually occurs when the user tries to join a channel - * during \ref agora::rtc::IRtcEngine::startEchoTest "startEchoTest". Once you - * call \ref agora::rtc::IRtcEngine::startEchoTest "startEchoTest", you need to - * call \ref agora::rtc::IRtcEngine::stopEchoTest "stopEchoTest" before joining a channel. - * - The user tries to join the channel with a token that is expired. + /** 17: The request to join the channel is rejected. This error usually occurs when the user is already in the channel, and still calls the method to join the channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". */ ERR_JOIN_CHANNEL_REJECTED = 17, /** 18: The request to leave the channel is rejected. @@ -349,22 +326,19 @@ enum ERROR_CODE_TYPE /** 102: The specified channel name is invalid. Please try to rejoin the channel with a valid channel name. */ ERR_INVALID_CHANNEL_NAME = 102, - /** 103: Fails to get server resources in the specified region. Please try to specify another region when calling \ref agora::rtc::IRtcEngine::initialize "initialize". - */ - ERR_NO_SERVER_RESOURCES = 103, /** **DEPRECATED** 109: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. - + The token expired due to one of the following reasons: - - - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within 24 hours after the Token is generated. If the user does not access the Agora service after 24 hours, this Token is no longer valid. + + - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within five minutes after the Token is generated. If the user does not access the Agora service after five minutes, this Token is no longer valid. - Call Expiration Timestamp expired: The timestamp is the exact time when a user can no longer use the Agora service (for example, when a user is forced to leave an ongoing call). When a value is set for the Call Expiration Timestamp, it does not mean that the token will expire, but that the user will be banned from the channel. */ ERR_TOKEN_EXPIRED = 109, /** **DEPRECATED** 110: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_INVALID_TOKEN(8) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. - + The token is invalid due to one of the following reasons: - - - The App Certificate for the project is enabled in Console, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token. + + - The App Certificate for the project is enabled in Dashboard, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token. - The uid is mandatory, and users must set the same uid as the one set in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. */ ERR_INVALID_TOKEN = 110, @@ -374,7 +348,7 @@ enum ERROR_CODE_TYPE /** 112: The internet connection is lost. This applies to the Agora Web SDK only. */ ERR_CONNECTION_LOST = 112, // only used in web sdk - /** 113: The user is not in the channel when calling the method. + /** 113: The user is not in the channel when calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" or \ref agora::rtc::IRtcEngine::getUserInfoByUserAccount "getUserInfoByUserAccount" method. */ ERR_NOT_IN_CHANNEL = 113, /** 114: The size of the sent data is over 1024 bytes when the user calls the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. @@ -395,7 +369,7 @@ enum ERROR_CODE_TYPE /** 120: Decryption fails. The user may have used a different encryption password to join the channel. Check your settings or try rejoining the channel. */ ERR_DECRYPTION_FAILED = 120, - /** 123: The user is banned by the server. This error occurs when the user is kicked off the channel from the server. + /** 123: The client is banned by the server. */ ERR_CLIENT_IS_BANNED_BY_SERVER = 123, /** 124: Incorrect watermark file parameter. @@ -442,38 +416,104 @@ enum ERROR_CODE_TYPE ERR_PUBLISH_STREAM_FORMAT_NOT_SUPPORTED = 156, //signaling: 400~600 + /** + */ ERR_LOGOUT_OTHER = 400, // + /** 401: The user logged out. + */ ERR_LOGOUT_USER = 401, // logout by user + /** 402: Network failure. + */ ERR_LOGOUT_NET = 402, // network failure + /** 403: Logged in another device. + */ ERR_LOGOUT_KICKED = 403, // login in other device + /** + */ ERR_LOGOUT_PACKET = 404, // + /** 405: The token expired. + */ ERR_LOGOUT_TOKEN_EXPIRED = 405, // token expired + /** + */ ERR_LOGOUT_OLDVERSION = 406, // + /** + */ ERR_LOGOUT_TOKEN_WRONG = 407, + /** + */ ERR_LOGOUT_ALREADY_LOGOUT = 408, + /** + */ ERR_LOGIN_OTHER = 420, + /** + */ ERR_LOGIN_NET = 421, + /** + */ ERR_LOGIN_FAILED = 422, + /** + */ ERR_LOGIN_CANCELED = 423, + /** + */ ERR_LOGIN_TOKEN_EXPIRED = 424, + /** + */ ERR_LOGIN_OLD_VERSION = 425, + /** + */ ERR_LOGIN_TOKEN_WRONG = 426, + /** + */ ERR_LOGIN_TOKEN_KICKED = 427, + /** + */ ERR_LOGIN_ALREADY_LOGIN = 428, + /** + */ ERR_JOIN_CHANNEL_OTHER = 440, + /** + */ ERR_SEND_MESSAGE_OTHER = 440, + /** + */ ERR_SEND_MESSAGE_TIMEOUT = 441, + /** + */ ERR_QUERY_USERNUM_OTHER = 450, + /** + */ ERR_QUERY_USERNUM_TIMEOUT = 451, + /** + */ ERR_QUERY_USERNUM_BYUSER = 452, + /** + */ ERR_LEAVE_CHANNEL_OTHER = 460, + /** + */ ERR_LEAVE_CHANNEL_KICKED = 461, + /** + */ ERR_LEAVE_CHANNEL_BYUSER = 462, + /** + */ ERR_LEAVE_CHANNEL_LOGOUT = 463, + /** + */ ERR_LEAVE_CHANNEL_DISCONNECTED = 464, + /** + */ ERR_INVITE_OTHER = 470, + /** + */ ERR_INVITE_REINVITE = 471, + /** + */ ERR_INVITE_NET = 472, + /** + */ ERR_INVITE_PEER_OFFLINE = 473, ERR_INVITE_TIMEOUT = 474, ERR_INVITE_CANT_RECV = 475, @@ -487,7 +527,7 @@ enum ERROR_CODE_TYPE */ ERR_START_CALL = 1002, /** **DEPRECATED** 1003: Fails to start the camera. - + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ ERR_START_CAMERA = 1003, @@ -530,11 +570,11 @@ enum ERROR_CODE_TYPE /** 1018: Audio Device Module: Fails to record. */ ERR_ADM_RECORD_AUDIO_FAILED = 1018, - /** 1022: Audio Device Module: An error occurs in initializing the + /** 1022: Audio Device Module: An error occurs in initializing the * loopback device. */ ERR_ADM_INIT_LOOPBACK = 1022, - /** 1023: Audio Device Module: An error occurs in starting the loopback + /** 1023: Audio Device Module: An error occurs in starting the loopback * device. */ ERR_ADM_START_LOOPBACK = 1023, @@ -542,37 +582,37 @@ enum ERROR_CODE_TYPE * recording permission is granted. */ ERR_ADM_NO_PERMISSION = 1027, - /** 1033: Audio device module: The device is occupied. + /** 1033: Audio device module: The device is occupied. */ ERR_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, /** 1101: Audio device module: A fatal exception occurs. */ ERR_ADM_ANDROID_JNI_JAVA_RESOURCE = 1101, - /** 1108: Audio device module: The recording frequency is lower than 50. - * 0 indicates that the recording is not yet started. We recommend + /** 1108: Audio device module: The recording frequency is lower than 50. + * 0 indicates that the recording is not yet started. We recommend * checking your recording permission. */ ERR_ADM_ANDROID_JNI_NO_RECORD_FREQUENCY = 1108, - /** 1109: The playback frequency is lower than 50. 0 indicates that the - * playback is not yet started. We recommend checking if you have created - * too many AudioTrack instances. + /** 1109: The playback frequency is lower than 50. 0 indicates that the + * playback is not yet started. We recommend checking if you have created + * too many AudioTrack instances. */ ERR_ADM_ANDROID_JNI_NO_PLAYBACK_FREQUENCY = 1109, - /** 1111: Audio device module: AudioRecord fails to start up. A ROM system - * error occurs. We recommend the following options to debug: + /** 1111: Audio device module: AudioRecord fails to start up. A ROM system + * error occurs. We recommend the following options to debug: * - Restart your App. - * - Restart your cellphone. + * - Restart your cellphone. * - Check your recording permission. */ ERR_ADM_ANDROID_JNI_JAVA_START_RECORD = 1111, - /** 1112: Audio device module: AudioTrack fails to start up. A ROM system - * error occurs. We recommend the following options to debug: + /** 1112: Audio device module: AudioTrack fails to start up. A ROM system + * error occurs. We recommend the following options to debug: * - Restart your App. - * - Restart your cellphone. + * - Restart your cellphone. * - Check your playback permission. */ ERR_ADM_ANDROID_JNI_JAVA_START_PLAYBACK = 1112, - /** 1115: Audio device module: AudioRecord returns error. The SDK will + /** 1115: Audio device module: AudioRecord returns error. The SDK will * automatically restart AudioRecord. */ ERR_ADM_ANDROID_JNI_JAVA_RECORD_ERROR = 1115, /** **DEPRECATED** */ @@ -585,109 +625,107 @@ enum ERROR_CODE_TYPE ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_PLAYER = 1157, /** **DEPRECATED** */ ERR_ADM_ANDROID_OPENSL_START_PLAYER_THREAD = 1160, - /** 1201: Audio device module: The current device does not support audio + /** 1201: Audio device module: The current device does not support audio * input, possibly because you have mistakenly configured the audio session - * category, or because some other app is occupying the input device. We + * category, or because some other app is occupying the input device. We * recommend terminating all background apps and re-joining the channel. */ ERR_ADM_IOS_INPUT_NOT_AVAILABLE = 1201, /** 1206: Audio device module: Cannot activate the Audio Session.*/ ERR_ADM_IOS_ACTIVATE_SESSION_FAIL = 1206, - /** 1210: Audio device module: Fails to initialize the audio device, + /** 1210: Audio device module: Fails to initialize the audio device, * normally because the audio device parameters are wrongly set.*/ ERR_ADM_IOS_VPIO_INIT_FAIL = 1210, - /** 1213: Audio device module: Fails to re-initialize the audio device, + /** 1213: Audio device module: Fails to re-initialize the audio device, * normally because the audio device parameters are wrongly set.*/ ERR_ADM_IOS_VPIO_REINIT_FAIL = 1213, - /** 1214: Fails to re-start up the Audio Unit, possibly because the audio + /** 1214: Fails to re-start up the Audio Unit, possibly because the audio * session category is not compatible with the settings of the Audio Unit. */ ERR_ADM_IOS_VPIO_RESTART_FAIL = 1214, - ERR_ADM_IOS_SET_RENDER_CALLBACK_FAIL = 1219, - /** **DEPRECATED** */ ERR_ADM_IOS_SESSION_SAMPLERATR_ZERO = 1221, - /** 1301: Audio device module: An audio driver abnormality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1301: Audio device module: An audio driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system.*/ ERR_ADM_WIN_CORE_INIT = 1301, - /** 1303: Audio device module: A recording driver abnormality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1303: Audio device module: A recording driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_INIT_RECORDING = 1303, - /** 1306: Audio device module: A playout driver abnormality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1306: Audio device module: A playout driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_INIT_PLAYOUT = 1306, - /** 1307: Audio device module: No audio device is available. Solutions: + /** 1307: Audio device module: No audio device is available. Solutions: * Plug in a proper audio device. */ ERR_ADM_WIN_CORE_INIT_PLAYOUT_NULL = 1307, - /** 1309: Audio device module: An audio driver abnormality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1309: Audio device module: An audio driver abnomality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_START_RECORDING = 1309, - /** 1311: Audio device module: Insufficient system memory or poor device + /** 1311: Audio device module: Insufficient system memory or poor device * performance. Solutions: Reboot the system or replace the device. */ ERR_ADM_WIN_CORE_CREATE_REC_THREAD = 1311, - /** 1314: Audio device module: An audio driver abnormality occurs. + /** 1314: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver.*/ ERR_ADM_WIN_CORE_CAPTURE_NOT_STARTUP = 1314, - /** 1319: Audio device module: Insufficient system memory or poor device + /** 1319: Audio device module: Insufficient system memory or poor device * performance. Solutions: Reboot the system or replace the device. */ ERR_ADM_WIN_CORE_CREATE_RENDER_THREAD = 1319, - /** 1320: Audio device module: An audio driver abnormality occurs. + /** 1320: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Replace the device. */ ERR_ADM_WIN_CORE_RENDER_NOT_STARTUP = 1320, - /** 1322: Audio device module: No audio sampling device is available. + /** 1322: Audio device module: No audio sampling device is available. * Solutions: Plug in a proper recording device. */ ERR_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, - /** 1323: Audio device module: No audio playout device is available. + /** 1323: Audio device module: No audio playout device is available. * Solutions: Plug in a proper playback device.*/ ERR_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, - /** 1351: Audio device module: An audio driver abnormality or a + /** 1351: Audio device module: An audio driver abnormality or a * compatibility issue occurs. Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT = 1351, - /** 1353: Audio device module: An audio driver abnormality occurs. + /** 1353: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_RECORDING = 1353, - /** 1354: Audio device module: An audio driver abnormality occurs. + /** 1354: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_MICROPHONE = 1354, - /** 1355: Audio device module: An audio driver abnormality occurs. + /** 1355: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_PLAYOUT = 1355, - /** 1356: Audio device module: An audio driver abnormality occurs. + /** 1356: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_SPEAKER = 1356, - /** 1357: Audio device module: An audio driver abnormality occurs. + /** 1357: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_START_RECORDING = 1357, - /** 1358: Audio device module: An audio driver abnormality occurs. + /** 1358: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. @@ -701,13 +739,14 @@ enum ERROR_CODE_TYPE ERR_ADM_NO_PLAYOUT_DEVICE = 1360, // VDM error code starts from 1500 + /** 1500: Video Device Module: There is no camera device. + */ + ERR_VDM_CAMERA_NO_DEVICE = 1500, /** 1501: Video Device Module: The camera is unauthorized. */ ERR_VDM_CAMERA_NOT_AUTHORIZED = 1501, - - // VDM error code starts from 1500 /** **DEPRECATED** 1502: Video Device Module: The camera in use. - + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ ERR_VDM_WIN_DEVICE_IN_USE = 1502, @@ -746,9 +785,7 @@ enum LOG_FILTER_TYPE LOG_FILTER_ERROR = 0x000c, /** 0x0008: Outputs CRITICAL level log information. */ LOG_FILTER_CRITICAL = 0x0008, - /// @cond LOG_FILTER_MASK = 0x80f, - /// @endcond }; } // namespace agora diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h index e44fb6c..45cca10 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h @@ -1,394 +1,90 @@ #ifndef AGORA_MEDIA_ENGINE_H #define AGORA_MEDIA_ENGINE_H +#if defined _WIN32 || defined __CYGWIN__ +typedef __int64 int64_t; +typedef unsigned __int64 uint64_t; +typedef __int32 int32_t; +typedef unsigned __int32 uint32_t; +#else #include +#endif + +namespace agora +{ +namespace media +{ -namespace agora { -namespace media { -/** **DEPRECATED** Type of audio device. - */ enum MEDIA_SOURCE_TYPE { - /** Audio playback device. - */ - AUDIO_PLAYOUT_SOURCE = 0, - /** Microphone. - */ - AUDIO_RECORDING_SOURCE = 1, + AUDIO_PLAYOUT_SOURCE = 0, + AUDIO_RECORDING_SOURCE = 1, }; -/** - * The IAudioFrameObserver class. - */ -class IAudioFrameObserver { - public: - /** The frame type. */ +class IAudioFrameObserver +{ +public: enum AUDIO_FRAME_TYPE { - /** 0: PCM16. */ - FRAME_TYPE_PCM16 = 0, // PCM 16bit little endian + FRAME_TYPE_PCM16 = 0, //PCM 16bit little endian }; - /** Definition of AudioFrame */ struct AudioFrame { - /** The type of the audio frame. See #AUDIO_FRAME_TYPE - */ AUDIO_FRAME_TYPE type; - /** The number of samples per channel in the audio frame. - */ - int samples; //number of samples for each channel in this frame - /**The number of bytes per audio sample, which is usually 16-bit (2-byte). - */ + int samples; //number of samples in this frame int bytesPerSample; //number of bytes per sample: 2 for PCM16 - /** The number of audio channels. - - 1: Mono - - 2: Stereo (the data is interleaved) - */ int channels; //number of channels (data are interleaved if stereo) - /** The sample rate. - */ int samplesPerSec; //sampling rate - /** The data buffer of the audio frame. When the audio frame uses a stereo channel, the data buffer is interleaved. - The size of the data buffer is as follows: `buffer` = `samples` × `channels` × `bytesPerSample`. - */ void* buffer; //data buffer - /** The timestamp (ms) of the external audio frame. You can use this parameter for the following purposes: - - Restore the order of the captured audio frame. - - Synchronize audio and video frames in video-related scenarios, including where external video sources are used. - */ int64_t renderTimeMs; - /** Reserved parameter. - */ int avsync_type; }; - - public: - /** Retrieves the recorded audio frame. - - @param audioFrame Pointer to AudioFrame. - @return - - true: Valid buffer in AudioFrame, and the recorded audio frame is sent out. - - false: Invalid buffer in AudioFrame, and the recorded audio frame is discarded. - */ +public: virtual bool onRecordAudioFrame(AudioFrame& audioFrame) = 0; - /** Retrieves the audio playback frame for getting the audio. - - @param audioFrame Pointer to AudioFrame. - @return - - true: Valid buffer in AudioFrame, and the audio playback frame is sent out. - - false: Invalid buffer in AudioFrame, and the audio playback frame is discarded. - */ virtual bool onPlaybackAudioFrame(AudioFrame& audioFrame) = 0; - /** Retrieves the mixed recorded and playback audio frame. - - - @note This callback only returns the single-channel data. - - @param audioFrame Pointer to AudioFrame. - @return - - true: Valid buffer in AudioFrame and the mixed recorded and playback audio frame is sent out. - - false: Invalid buffer in AudioFrame and the mixed recorded and playback audio frame is discarded. - */ virtual bool onMixedAudioFrame(AudioFrame& audioFrame) = 0; - /** Retrieves the audio frame of a specified user before mixing. - - The SDK triggers this callback if isMultipleChannelFrameWanted returns false. - - @param uid The user ID - @param audioFrame Pointer to AudioFrame. - @return - - true: Valid buffer in AudioFrame, and the mixed recorded and playback audio frame is sent out. - - false: Invalid buffer in AudioFrame, and the mixed recorded and playback audio frame is discarded. - */ - virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, - AudioFrame& audioFrame) = 0; - /** Determines whether to receive audio data from multiple channels. - - @since v3.0.1 - - After you register the audio frame observer, the SDK triggers this callback every time it captures an audio frame. - - In the multi-channel scenario, if you want to get audio data from multiple channels, - set the return value of this callback as true. After that, the SDK triggers the - \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixingEx "onPlaybackAudioFrameBeforeMixingEx" callback to send you the before-mixing - audio data from various channels. You can also get the channel ID of each audio frame. - - @note - - Once you set the return value of this callback as true, the SDK triggers - only the \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixingEx "onPlaybackAudioFrameBeforeMixingEx" callback - to send the before-mixing audio frame. \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixing "onPlaybackAudioFrameBeforeMixing" is not triggered. - In the multi-channel scenario, Agora recommends setting the return value as true. - - If you set the return value of this callback as false, the SDK triggers only the `onPlaybackAudioFrameBeforeMixing` callback to send the audio data. - @return - - `true`: Receive audio data from multiple channels. - - `false`: Do not receive audio data from multiple channels. - */ + virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, AudioFrame& audioFrame) = 0; virtual bool isMultipleChannelFrameWanted() { return false; } - - /** Gets the before-mixing playback audio frame from multiple channels. - - After you successfully register the audio frame observer, if you set the return - value of \ref IAudioFrameObserver::isMultipleChannelFrameWanted "isMultipleChannelFrameWanted" as true, the SDK triggers this callback each - time it receives a before-mixing audio frame from any of the channel. - - @param channelId The channel ID of this audio frame. - @param uid The ID of the user sending this audio frame. - @param audioFrame The pointer to AudioFrame. - @return - - `true`: The data in AudioFrame is valid, and send this audio frame. - - `false`: The data in AudioFrame in invalid, and do not send this audio frame. - */ virtual bool onPlaybackAudioFrameBeforeMixingEx(const char *channelId, unsigned int uid, AudioFrame& audioFrame) { return true; } - }; -/** - * The IVideoFrameObserver class. - */ -class IVideoFrameObserver { - public: - /** The video frame type. */ +class IVideoFrameObserver +{ +public: enum VIDEO_FRAME_TYPE { - /** - * 0: YUV420 - */ - FRAME_TYPE_YUV420 = 0, // YUV 420 format - /** - * 1: YUV422 - */ - FRAME_TYPE_YUV422 = 1, // YUV 422 format - /** - * 2: RGBA - */ + FRAME_TYPE_YUV420 = 0, //YUV 420 format FRAME_TYPE_RGBA = 2, // RGBA format }; - /** - * The frame position of the video observer. - */ enum VIDEO_OBSERVER_POSITION { - /** - * 1: The post-capturer position, which corresponds to the video data in the onCaptureVideoFrame callback. - */ POSITION_POST_CAPTURER = 1 << 0, - /** - * 2: The pre-renderer position, which corresponds to the video data in the onRenderVideoFrame callback. - */ POSITION_PRE_RENDERER = 1 << 1, - /** - * 4: The pre-encoder position, which corresponds to the video data in the onPreEncodeVideoFrame callback. - */ POSITION_PRE_ENCODER = 1 << 2, }; - /** Video frame information. The video data format is YUV420. The buffer provides a pointer to a pointer. The interface cannot modify the pointer of the buffer, but can modify the content of the buffer only. - */ struct VideoFrame { VIDEO_FRAME_TYPE type; - /** Video pixel width. - */ int width; //width of video frame - /** Video pixel height. - */ int height; //height of video frame - /** Line span of the Y buffer within the YUV data. - */ int yStride; //stride of Y data buffer - /** Line span of the U buffer within the YUV data. - */ int uStride; //stride of U data buffer - /** Line span of the V buffer within the YUV data. - */ int vStride; //stride of V data buffer - /** Pointer to the Y buffer pointer within the YUV data. - */ void* yBuffer; //Y data buffer - /** Pointer to the U buffer pointer within the YUV data. - */ void* uBuffer; //U data buffer - /** Pointer to the V buffer pointer within the YUV data. - */ void* vBuffer; //V data buffer - /** Set the rotation of this frame before rendering the video. Supports 0, 90, 180, 270 degrees clockwise. - */ int rotation; // rotation of this frame (0, 90, 180, 270) - /** The timestamp (ms) of the external audio frame. It is mandatory. You can use this parameter for the following purposes: - - Restore the order of the captured audio frame. - - Synchronize audio and video frames in video-related scenarios, including scenarios where external video sources are used. - @note This timestamp is for rendering the video stream, and not for capturing the video stream. - */ int64_t renderTimeMs; int avsync_type; }; - - public: - /** Occurs each time the SDK receives a video frame captured by the local camera. - * - * After you successfully register the video frame observer, the SDK triggers this callback each time a video frame is received. In this callback, - * you can get the video data captured by the local camera. You can then pre-process the data according to your scenarios. - * - * After pre-processing, you can send the processed video data back to the SDK by setting the `videoFrame` parameter in this callback. - * - * @note - * - This callback does not support sending processed RGBA video data back to the SDK. - * - The video data that this callback gets has not been pre-processed, without the watermark, the cropped content, the rotation, and the image enhancement. - * - * @param videoFrame Pointer to VideoFrame. - * @return Whether or not to ignore the current video frame if the pre-processing fails: - * - true: Do not ignore. - * - false: Ignore the current video frame, and do not send it back to the SDK. - */ +public: virtual bool onCaptureVideoFrame(VideoFrame& videoFrame) = 0; - /** @since v3.0.0 - * - * Occurs each time the SDK receives a video frame before encoding. - * - * After you successfully register the video frame observer, the SDK triggers this callback each time when it receives a video frame. In this callback, you can get the video data before encoding. You can then process the data according to your particular scenarios. - * - * After processing, you can send the processed video data back to the SDK by setting the `VideoFrame` parameter in this callback. - * - * @note - * - As of v3.0.1, if you want to receive this callback, you also need to set `POSITION_PRE_ENCODE(1 << 2)` as a frame position in the \ref getObservedFramePosition "getObservedFramePosition" callback. - * - The video data that this callback gets has been pre-processed, with its content cropped, rotated, and the image enhanced. - * - This callback does not support sending processed RGBA video data back to the SDK. - * - * @param videoFrame A pointer to VideoFrame - * @return Whether to ignore the current video frame if the processing fails: - * - true: Do not ignore the current video frame. - * - false: Ignore the current video frame, and do not send it back to the SDK. - */ virtual bool onPreEncodeVideoFrame(VideoFrame& videoFrame) { return true; } - /** Occurs each time the SDK receives a video frame sent by the remote user. - * - * After you successfully register the video frame observer and isMultipleChannelFrameWanted return false, the SDK triggers this callback each time a video frame is received. - * In this callback, you can get the video data sent by the remote user. You can then post-process the data according to your scenarios. - * - * After post-processing, you can send the processed data back to the SDK by setting the `videoFrame` parameter in this callback. - * - * @note - * This callback does not support sending processed RGBA video data back to the SDK. - * - * @param uid ID of the remote user who sends the current video frame. - * @param videoFrame Pointer to VideoFrame. - * @return Whether or not to ignore the current video frame if the post-processing fails: - * - true: Do not ignore. - * - false: Ignore the current video frame, and do not send it back to the SDK. - */ virtual bool onRenderVideoFrame(unsigned int uid, VideoFrame& videoFrame) = 0; - /** Occurs each time the SDK receives a video frame and prompts you to set the video format. - * - * YUV420 is the default video format. If you want to receive other video formats, register this callback in the IVideoFrameObserver class. - * - * After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. - * You need to set your preferred video data in the return value of this callback. - * - * @return Sets the video format: #VIDEO_FRAME_TYPE - * - #FRAME_TYPE_YUV420 (0): (Default) YUV420. - * - #FRAME_TYPE_RGBA (2): RGBA - */ - virtual VIDEO_FRAME_TYPE getVideoFormatPreference() { return FRAME_TYPE_YUV420; } - /** Occurs each time the SDK receives a video frame and prompts you whether or not to rotate the captured video according to the rotation member in the VideoFrame class. - * - * The SDK does not rotate the captured video by default. If you want to rotate the captured video according to the rotation member in the VideoFrame class, register this callback in the IVideoFrameObserver class. - * - * After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. You need to set whether or not to rotate the video frame in the return value of this callback. - * - * @note - * This callback applies to RGBA video data only. - * - * @return Sets whether or not to rotate the captured video: - * - true: Rotate. - * - false: （Default) Do not rotate. - */ virtual bool getRotationApplied() { return false; } - /** Occurs each time the SDK receives a video frame and prompts you whether or not to mirror the captured video. - * - * The SDK does not mirror the captured video by default. Register this callback in the IVideoFrameObserver class if you want to mirror the captured video. - * - * After you successfully register the video frame observer, the SDK triggers this callback each time a video frame is received. - * You need to set whether or not to mirror the captured video in the return value of this callback. - * - * @note - * This callback applies to RGBA video data only. - * - * @return Sets whether or not to mirror the captured video: - * - true: Mirror. - * - false: (Default) Do not mirror. - */ - virtual bool getMirrorApplied() { return false; } - /** @since v3.0.0 - - Sets whether to output the acquired video frame smoothly. - - If you want the video frames acquired from \ref IVideoFrameObserver::onRenderVideoFrame "onRenderVideoFrame" to be more evenly spaced, you can register the `getSmoothRenderingEnabled` callback in the `IVideoFrameObserver` class and set its return value as `true`. - - @note - - Register this callback before joining a channel. - - This callback applies to scenarios where the acquired video frame is self-rendered after being processed, not to scenarios where the video frame is sent back to the SDK after being processed. - - @return Set whether or not to smooth the video frames: - - true: Smooth the video frame. - - false: (Default) Do not smooth. - */ - virtual bool getSmoothRenderingEnabled(){ return false; } - /** - * Sets the frame position for the video observer. - * @since v3.0.1 - * - * After you successfully register the video observer, the SDK triggers this callback each time it receives a video frame. You can determine which position to observe by setting the return value. - * The SDK provides 3 positions for observer. Each position corresponds to a callback function: - * - `POSITION_POST_CAPTURER(1 << 0)`: The position after capturing the video data, which corresponds to the \ref onCaptureVideoFrame "onCaptureVideoFrame" callback. - * - `POSITION_PRE_RENDERER(1 << 1)`: The position before receiving the remote video data, which corresponds to the \ref onRenderVideoFrame "onRenderVideoFrame" callback. - * - `POSITION_PRE_ENCODER(1 << 2)`: The position before encoding the video data, which corresponds to the \ref onPreEncodeVideoFrame "onPreEncodeVideoFrame" callback. - * - * @note - * - Use '|' (the OR operator) to observe multiple frame positions. - * - This callback observes `POSITION_POST_CAPTURER(1 << 0)` and `POSITION_PRE_RENDERER(1 << 1)` by default. - * - To conserve the system consumption, you can reduce the number of frame positions that you want to observe. - * - * @return A bit mask that controls the frame position of the video observer: #VIDEO_OBSERVER_POSITION. - * - */ - virtual uint32_t getObservedFramePosition() { return static_cast(POSITION_POST_CAPTURER | POSITION_PRE_RENDERER); } - - /** Determines whether to receive video data from multiple channels. - - After you register the video frame observer, the SDK triggers this callback - every time it captures a video frame. - - In the multi-channel scenario, if you want to get video data from multiple channels, - set the return value of this callback as true. After that, the SDK triggers the - \ref IVideoFrameObserver::onRenderVideoFrameEx "onRenderVideoFrameEx" callback to send you - the video data from various channels. You can also get the channel ID of each video frame. - - @note - - Once you set the return value of this callback as true, the SDK triggers only the `onRenderVideoFrameEx` callback to - send the video frame. \ref IVideoFrameObserver::onRenderVideoFrame "onRenderVideoFrame" will not be triggered. In the multi-channel scenario, Agora recommends setting the return value as true. - - If you set the return value of this callback as false, the SDK triggers only the `onRenderVideoFrame` callback to send the video data. - @return - - `true`: Receive video data from multiple channels. - - `false`: Do not receive video data from multiple channels. - */ + virtual uint32_t getObservedFramePosition() { return POSITION_POST_CAPTURER | POSITION_PRE_RENDERER; } virtual bool isMultipleChannelFrameWanted() { return false; } - - /** Gets the video frame from multiple channels. - - After you successfully register the video frame observer, if you set the return value of - \ref IVideoFrameObserver::isMultipleChannelFrameWanted "isMultipleChannelFrameWanted" as true, the SDK triggers this callback each time it receives a video frame - from any of the channel. - - You can process the video data retrieved from this callback according to your scenario, and send the - processed data back to the SDK using the `videoFrame` parameter in this callback. - - @note This callback does not support sending RGBA video data back to the SDK. - - @param channelId The channel ID of this video frame. - @param uid The ID of the user sending this video frame. - @param videoFrame The pointer to VideoFrame. - @return Whether to send this video frame to the SDK if post-processing fails: - - `true`: Send this video frame. - - `false`: Do not send this video frame. - */ virtual bool onRenderVideoFrameEx(const char *channelId, unsigned int uid, VideoFrame& videoFrame) { return true; } + virtual VIDEO_FRAME_TYPE getVideoFormatPreference() { return FRAME_TYPE_YUV420; } }; -class IVideoFrame { - public: +class IVideoFrame +{ +public: enum PLANE_TYPE { Y_PLANE = 0, U_PLANE = 1, @@ -413,342 +109,190 @@ class IVideoFrame { VIDEO_TYPE_NV12 = 14, VIDEO_TYPE_BGRA = 15, VIDEO_TYPE_RGBA = 16, - VIDEO_TYPE_I422 = 17, }; virtual void release() = 0; virtual const unsigned char* buffer(PLANE_TYPE type) const = 0; - /** Copies the frame. - - If the required size is larger than the allocated size, new buffers of the adequate size will be allocated. - - @param dest_frame Address of the returned destination frame. See IVideoFrame. - @return - - 0: Success. - - -1: Failure. - */ + // Copy frame: If required size is bigger than allocated one, new buffers of + // adequate size will be allocated. + // Return value: 0 on success ,-1 on error. virtual int copyFrame(IVideoFrame** dest_frame) const = 0; - /** Converts the frame. - - @note The source and destination frames have equal heights. - - @param dst_video_type Type of the output video. - @param dst_sample_size Required only for the parsing of M-JPEG. - @param dst_frame Pointer to a destination frame. See IVideoFrame. - @return - - 0: Success. - - < 0: Failure. - */ - virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, - unsigned char* dst_frame) const = 0; - /** Retrieves the specified component in the YUV space. - @param type Component type: #PLANE_TYPE - */ + // Convert frame + // Input: + // - src_frame : Reference to a source frame. + // - dst_video_type : Type of output video. + // - dst_sample_size : Required only for the parsing of MJPG. + // - dst_frame : Pointer to a destination frame. + // Return value: 0 if OK, < 0 otherwise. + // It is assumed that source and destination have equal height. + virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, unsigned char* dst_frame) const = 0; + + // Get allocated size per plane. virtual int allocated_size(PLANE_TYPE type) const = 0; - /** Retrieves the stride of the specified component in the YUV space. - @param type Component type: #PLANE_TYPE - */ + // Get allocated stride per plane. virtual int stride(PLANE_TYPE type) const = 0; - /** Retrieves the width of the frame. - */ + + // Get frame width. virtual int width() const = 0; - /** Retrieves the height of the frame. - */ + + // Get frame height. virtual int height() const = 0; - /** Retrieves the timestamp (ms) of the frame. - */ + + // Get frame timestamp (90kHz). virtual unsigned int timestamp() const = 0; - /** Retrieves the render time (ms). - */ + + // Get render time in milliseconds. virtual int64_t render_time_ms() const = 0; - /** Checks if a plane is of zero size. - @return - - true: The plane is of zero size. - - false: The plane is not of zero size. - */ + // Return true if underlying plane buffers are of zero size, false if not. virtual bool IsZeroSize() const = 0; - - virtual VIDEO_TYPE GetVideoType() const = 0; }; -/** **DEPRECATED** */ -class IExternalVideoRenderCallback { - public: - /** Occurs when the video view size has changed. - */ + +class IExternalVideoRenderCallback +{ +public: virtual void onViewSizeChanged(int width, int height) = 0; - /** Occurs when the video view is destroyed. - */ virtual void onViewDestroyed() = 0; }; -/** **DEPRECATED** */ -struct ExternalVideoRenerContext { + +struct ExternalVideoRenerContext +{ IExternalVideoRenderCallback* renderCallback; - /** Video display window. - */ void* view; - /** Video display mode: \ref agora::rtc::RENDER_MODE_TYPE "RENDER_MODE_TYPE" */ int renderMode; - /** The image layer location. - - - 0: (Default) The image is at the bottom of the stack - - 100: The image is at the top of the stack. - - @note If the value is set to below 0 or above 100, the #ERR_INVALID_ARGUMENT error occurs. - */ int zOrder; - /** Video layout distance from the left. - */ float left; - /** Video layout distance from the top. - */ float top; - /** Video layout distance from the right. - */ float right; - /** Video layout distance from the bottom. - */ float bottom; }; -class IExternalVideoRender { - public: +class IExternalVideoRender +{ +public: virtual void release() = 0; virtual int initialize() = 0; - virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, - bool mirrored) = 0; + virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, bool mirrored) = 0; }; -class IExternalVideoRenderFactory { - public: - virtual IExternalVideoRender* createRenderInstance( - const ExternalVideoRenerContext& context) = 0; +class IExternalVideoRenderFactory +{ +public: + virtual IExternalVideoRender* createRenderInstance(const ExternalVideoRenerContext& context) = 0; }; -/** The external video frame. - */ struct ExternalVideoFrame { - /** The video buffer type. - */ - enum VIDEO_BUFFER_TYPE - { - /** 1: The video buffer in the format of raw data. - */ - VIDEO_BUFFER_RAW_DATA = 1, - }; - - /** The video pixel format. - * - * @note The SDK does not support the alpha channel, and discards any alpha value passed to the SDK. - */ - enum VIDEO_PIXEL_FORMAT - { - /** 0: The video pixel format is unknown. - */ - VIDEO_PIXEL_UNKNOWN = 0, - /** 1: The video pixel format is I420. - */ - VIDEO_PIXEL_I420 = 1, - /** 2: The video pixel format is BGRA. - */ - VIDEO_PIXEL_BGRA = 2, - /** 3: The video pixel format is NV21. - */ - VIDEO_PIXEL_NV21 = 3, - /** 4: The video pixel format is RGBA. - */ - VIDEO_PIXEL_RGBA = 4, - /** 5: The video pixel format is IMC2. - */ - VIDEO_PIXEL_IMC2 = 5, - /** 7: The video pixel format is ARGB. - */ - VIDEO_PIXEL_ARGB = 7, - /** 8: The video pixel format is NV12. - */ - VIDEO_PIXEL_NV12 = 8, - /** 16: The video pixel format is I422. - */ - VIDEO_PIXEL_I422 = 16, - }; + enum VIDEO_BUFFER_TYPE + { + VIDEO_BUFFER_RAW_DATA = 1, + }; - /** The buffer type. See #VIDEO_BUFFER_TYPE - */ - VIDEO_BUFFER_TYPE type; - /** The pixel format. See #VIDEO_PIXEL_FORMAT - */ - VIDEO_PIXEL_FORMAT format; - /** The video buffer. - */ - void* buffer; - /** Line spacing of the incoming video frame, which must be in pixels instead of bytes. For textures, it is the width of the texture. - */ - int stride; - /** Height of the incoming video frame. - */ - int height; - /** [Raw data related parameter] The number of pixels trimmed from the left. The default value is 0. - */ - int cropLeft; - /** [Raw data related parameter] The number of pixels trimmed from the top. The default value is 0. - */ - int cropTop; - /** [Raw data related parameter] The number of pixels trimmed from the right. The default value is 0. - */ - int cropRight; - /** [Raw data related parameter] The number of pixels trimmed from the bottom. The default value is 0. - */ - int cropBottom; - /** [Raw data related parameter] The clockwise rotation of the video frame. You can set the rotation angle as 0, 90, 180, or 270. The default value is 0. - */ - int rotation; - /** Timestamp (ms) of the incoming video frame. An incorrect timestamp results in frame loss or unsynchronized audio and video. - */ - long long timestamp; + enum VIDEO_PIXEL_FORMAT + { + VIDEO_PIXEL_UNKNOWN = 0, + VIDEO_PIXEL_I420 = 1, + VIDEO_PIXEL_BGRA = 2, + VIDEO_PIXEL_NV12 = 8, + }; - ExternalVideoFrame() - :cropLeft(0) - ,cropTop(0) - ,cropRight(0) - ,cropBottom(0) - ,rotation(0) - {} + VIDEO_BUFFER_TYPE type; + VIDEO_PIXEL_FORMAT format; + void* buffer; + int stride; + int height; + int cropLeft; + int cropTop; + int cropRight; + int cropBottom; + int rotation; + long long timestamp; }; -class IMediaEngine { - public: - virtual ~IMediaEngine () {}; - virtual void release() = 0; - /** Registers an audio frame observer object. +enum CODEC_VIDEO_FRAME_TYPE { + CODEC_VIDEO_FRAME_TYPE_BLANK_FRAME = 0, + CODEC_VIDEO_FRAME_TYPE_KEY_FRAME = 3, + CODEC_VIDEO_FRAME_TYPE_DELTA_FRAME = 4, + CODEC_VIDEO_FRAME_TYPE_B_FRAME = 5, + CODEC_VIDEO_FRAME_TYPE_UNKNOW +}; - This method is used to register an audio frame observer object (register a callback). This method is required to register callbacks when the engine is required to provide an \ref IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" or \ref IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. +enum VIDEO_ORIENTATION { + VIDEO_ORIENTATION_0 = 0, + VIDEO_ORIENTATION_90 = 90, + VIDEO_ORIENTATION_180 = 180, + VIDEO_ORIENTATION_270 = 270 +}; - @note Ensure that you call this method before joining a channel. +/** Video codec types */ +enum VIDEO_CODEC_TYPE { + /** Standard VP8 */ + VIDEO_CODEC_VP8 = 1, + /** Standard H264 */ + VIDEO_CODEC_H264 = 2, + /** Enhanced VP8 */ + VIDEO_CODEC_EVP = 3, + /** Enhanced H264 */ + VIDEO_CODEC_E264 = 4, +}; - @param observer Audio frame observer object instance. See IAudioFrameObserver. Set the value as NULL to release the - audio observer object. Agora recommends calling `registerAudioFrameObserver(NULL)` after receiving the \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback. +/** * The struct of EncodedVideoFrameInfo. */ +struct EncodedVideoFrameInfo { + EncodedVideoFrameInfo() : codecType(VIDEO_CODEC_H264), + width(0), + height(0), + frameType(CODEC_VIDEO_FRAME_TYPE_BLANK_FRAME), + rotation(VIDEO_ORIENTATION_0), + renderTimeMs(0) {} + /** + * The video codec: #VIDEO_CODEC_TYPE. + */ + VIDEO_CODEC_TYPE codecType; + /** * The width (px) of the video. */ + int width; + /** * The height (px) of the video. */ + int height; + /** * The frame type of the encoded video frame: #VIDEO_FRAME_TYPE. */ + CODEC_VIDEO_FRAME_TYPE frameType; + /** * The rotation information of the encoded video frame: #VIDEO_ORIENTATION. */ + VIDEO_ORIENTATION rotation; + /** * The timestamp for rendering the video. */ + int64_t renderTimeMs; +}; + +class IVideoEncodedImageReceiver { +public: + /** + * Occurs each time the SDK receives an encoded video image. + * @param imageBuffer The pointer to the video image buffer. + * @param length The data length of the video image. + * @param videoEncodedFrameInfo The information of the encoded video frame: EncodedVideoFrameInfo. + * + */ + virtual bool OnEncodedVideoImageReceived(const uint8_t* imageBuffer, unsigned int length, const EncodedVideoFrameInfo& videoEncodedFrameInfo) = 0; + + virtual ~IVideoEncodedImageReceiver() {} +}; - @return - - 0: Success. - - < 0: Failure. - */ +class IMediaEngine { +public: + virtual void release() = 0; virtual int registerAudioFrameObserver(IAudioFrameObserver* observer) = 0; - /** Registers a video frame observer object. - * - * You need to implement the IVideoFrameObserver class in this method, and register callbacks according to your scenarios. - * - * After you successfully register the video frame observer, the SDK triggers the registered callbacks each time a video frame is received. - * - * @note - * - When handling the video data returned in the callbacks, pay attention to the changes in the `width` and `height` parameters, - * which may be adapted under the following circumstances: - * - When the network condition deteriorates, the video resolution decreases incrementally. - * - If the user adjusts the video profile, the resolution of the video returned in the callbacks also changes. - * - Ensure that you call this method before joining a channel. - * @param observer Video frame observer object instance. If NULL is passed in, the registration is canceled. - * @return - * - 0: Success. - * - < 0: Failure. - */ virtual int registerVideoFrameObserver(IVideoFrameObserver* observer) = 0; - /** **DEPRECATED** */ virtual int registerVideoRenderFactory(IExternalVideoRenderFactory* factory) = 0; - /** **DEPRECATED** Use \ref agora::media::IMediaEngine::pushAudioFrame(IAudioFrameObserver::AudioFrame* frame) "pushAudioFrame(IAudioFrameObserver::AudioFrame* frame)" instead. - - Pushes the external audio frame. - - @param type Type of audio capture device: #MEDIA_SOURCE_TYPE. - @param frame Audio frame pointer: \ref IAudioFrameObserver::AudioFrame "AudioFrame". - @param wrap Whether to use the placeholder. We recommend setting the default value. - - true: Use. - - false: (Default) Not use. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, - IAudioFrameObserver::AudioFrame* frame, - bool wrap) = 0; - /** Pushes the external audio frame. - - @param frame Pointer to the audio frame: \ref IAudioFrameObserver::AudioFrame "AudioFrame". - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0; - /** Pulls the remote audio data. - * - * Before calling this method, call the - * \ref agora::rtc::IRtcEngine::setExternalAudioSink - * "setExternalAudioSink(enabled: true)" method to enable and set the - * external audio sink. - * - * After a successful method call, the app pulls the decoded and mixed - * audio data for playback. - * - * @note - * - Once you call the \ref agora::media::IMediaEngine::pullAudioFrame - * "pullAudioFrame" method successfully, the app will not retrieve any audio - * data from the - * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame - * "onPlaybackAudioFrame" callback. - * - The difference between the - * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame - * "onPlaybackAudioFrame" callback and the - * \ref agora::media::IMediaEngine::pullAudioFrame "pullAudioFrame" method is as - * follows: - * - `onPlaybackAudioFrame`: The SDK sends the audio data to the app through this callback. - * Any delay in processing the audio frames may result in audio jitter. - * - `pullAudioFrame`: The app pulls the remote audio data. After setting the - * audio data parameters, the SDK adjusts the frame buffer and avoids - * problems caused by jitter in the external audio playback. - * - * @param frame Pointers to the audio frame. - * See: \ref IAudioFrameObserver::AudioFrame "AudioFrame". - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0; - /** Configures the external video source. - - @note Ensure that you call this method before joining a channel. - - @param enable Sets whether to use the external video source: - - true: Use the external video source. - - false: (Default) Do not use the external video source. - - @param useTexture Sets whether to use texture as an input: - - true: Use texture as an input. - - false: (Default) Do not use texture as an input. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; - /** Pushes the video frame using the \ref ExternalVideoFrame "ExternalVideoFrame" and passes the video frame to the Agora SDK. - - @param frame Video frame to be pushed. See \ref ExternalVideoFrame "ExternalVideoFrame". - - @note In the `COMMUNICATION` profile, this method does not support video frames in the Texture format. + virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, IAudioFrameObserver::AudioFrame *frame, bool wrap) = 0; + virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; + virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; - @return - - 0: Success. - - < 0: Failure. - */ - virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; + virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; + virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; + virtual int registerVideoEncodedImageReceiver(IVideoEncodedImageReceiver*receiver) = 0; }; -} // namespace media +} //media -} // namespace agora +} //agora -#endif // AGORA_MEDIA_ENGINE_H +#endif //AGORA_MEDIA_ENGINE_H diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h index f354183..e7c7f4c 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h @@ -10,260 +10,104 @@ namespace agora { namespace rtc { -/** The channel media options. */ -struct ChannelMediaOptions { - /** Determines whether to subscribe to audio streams when the user joins the channel: - - true: (Default) Subscribe. - - false: Do not subscribe. - This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method. After joining the channel, - you can call the `muteAllRemoteAudioStreams` method to set whether to subscribe to audio streams in the channel. - */ +struct ChannelMediaOptions { bool autoSubscribeAudio; - /** Determines whether to subscribe to video streams when the user joins the channel: - - true: (Default) Subscribe. - - false: Do not subscribe. - - This member serves a similar function to the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method. After joining the channel, - you can call the `muteAllRemoteVideoStreams` method to set whether to subscribe to video streams in the channel. - */ bool autoSubscribeVideo; ChannelMediaOptions() : autoSubscribeAudio(true) , autoSubscribeVideo(true) {} }; -/** The IChannel class. */ + class IChannel; -/** The IChannelEventHandler class. */ class IChannelEventHandler { public: virtual ~IChannelEventHandler() {} - /** Reports the warning code of `IChannel`. - - @param rtcChannel IChannel - @param warn The warning code: #WARN_CODE_TYPE - @param msg The warning message. - - */ + virtual void onChannelWarning(IChannel *rtcChannel, int warn, const char* msg) { (void)rtcChannel; (void)warn; (void)msg; } - /** Reports the error code of `IChannel`. - - @param rtcChannel IChannel - @param err The error code: #ERROR_CODE_TYPE - @param msg The error message. - */ + virtual void onChannelError(IChannel *rtcChannel, int err, const char* msg) { (void)rtcChannel; (void)err; (void)msg; } - /** Occurs when a user joins a channel. - - This callback notifies the application that a user joins a specified channel. - - @param rtcChannel IChannel - @param uid The user ID. If the `uid` is not specified in the \ref IChannel::joinChannel "joinChannel" method, the server automatically assigns a `uid`. - - @param elapsed Time elapsed (ms) from the local user calling \ref IChannel::joinChannel "joinChannel" until this callback is triggered. - */ + virtual void onJoinChannelSuccess(IChannel *rtcChannel, uid_t uid, int elapsed) { (void)rtcChannel; (void)uid; (void)elapsed; } - /** Occurs when a user rejoins the channel after being disconnected due to network problems. - - @param rtcChannel IChannel - @param uid The user ID. - @param elapsed Time elapsed (ms) from the local user starting to reconnect until this callback is triggered. - - */ + virtual void onRejoinChannelSuccess(IChannel *rtcChannel, uid_t uid, int elapsed) { (void)rtcChannel; (void)uid; (void)elapsed; } - /** Occurs when a user leaves the channel. - - This callback notifies the application that a user leaves the channel when the application calls the \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method. - - The application retrieves information, such as the call duration and statistics. - - @param rtcChannel IChannel - @param stats The call statistics: RtcStats. - */ + virtual void onLeaveChannel(IChannel *rtcChannel, const RtcStats& stats) { (void)rtcChannel; (void)stats; } - /** Occurs when the user role switches in the live interactive streaming. For example, from a host to an audience or vice versa. - - This callback notifies the application of a user role switch when the application calls the \ref IChannel::setClientRole "setClientRole" method. - - The SDK triggers this callback when the local user switches the user role by calling the \ref IChannel::setClientRole "setClientRole" method after joining the channel. - - @param rtcChannel IChannel - @param oldRole Role that the user switches from: #CLIENT_ROLE_TYPE. - @param newRole Role that the user switches to: #CLIENT_ROLE_TYPE. - */ + virtual void onClientRoleChanged(IChannel *rtcChannel, CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { (void)rtcChannel; (void)oldRole; (void)newRole; } - /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) joins the channel. - - - `COMMUNICATION` profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. - - `LIVE_BROADCASTING` profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. - - The SDK triggers this callback under one of the following circumstances: - - A remote user/host joins the channel by calling the \ref agora::rtc::IChannel::joinChannel "joinChannel" method. - - A remote user switches the user role to the host by calling the \ref agora::rtc::IChannel::setClientRole "setClientRole" method after joining the channel. - - A remote user/host rejoins the channel after a network interruption. - - The host injects an online media stream into the channel by calling the \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method. - - @note In the `LIVE_BROADCASTING` profile: - - The host receives this callback when another host joins the channel. - - The audience in the channel receives this callback when a new host joins the channel. - - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. - - @param rtcChannel IChannel - @param uid User ID of the user or host joining the channel. - @param elapsed Time delay (ms) from the local user calling the \ref IChannel::joinChannel "joinChannel" method until the SDK triggers this callback. - */ + virtual void onUserJoined(IChannel *rtcChannel, uid_t uid, int elapsed) { (void)rtcChannel; (void)uid; (void)elapsed; } - /** Occurs when a remote user ( `COMMUNICATION`)/host (`LIVE_BROADCASTING`) leaves the channel. - - Reasons why the user is offline: - - - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. - - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using the Agora RTM SDK for more reliable offline detection. - - @param rtcChannel IChannel - @param uid User ID of the user leaving the channel or going offline. - @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. - */ + virtual void onUserOffline(IChannel *rtcChannel, uid_t uid, USER_OFFLINE_REASON_TYPE reason) { (void)rtcChannel; (void)uid; (void)reason; } - /** Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted. - - The SDK triggers this callback when it cannot connect to the server 10 seconds after calling the \ref IChannel::joinChannel "joinChannel" method, whether or not it is in the channel. - - This callback is different from \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted": - - - The SDK triggers the `onConnectionInterrupted` callback when it loses connection with the server for more than four seconds after it successfully joins the channel. - - The SDK triggers the `onConnectionLost` callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. - - If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. - - @param rtcChannel IChannel - */ + virtual void onConnectionLost(IChannel *rtcChannel) { (void)rtcChannel; } - /** Occurs when the token expires. - - After a token is specified by calling the \ref IChannel::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. - - Once you receive this callback, generate a new token on your app server, and call - \ref agora::rtc::IChannel::renewToken "renewToken" to pass the new token to the SDK. - - @param rtcChannel IChannel - */ + virtual void onRequestToken(IChannel *rtcChannel) { (void)rtcChannel; } - /** Occurs when the token expires in 30 seconds. - - The user becomes offline if the token used in the \ref IChannel::joinChannel "joinChannel" method expires. The SDK triggers this callback 30 seconds before the token expires to remind the application to get a new token. Upon receiving this callback, generate a new token on the server and call the \ref IChannel::renewToken "renewToken" method to pass the new token to the SDK. - - @param rtcChannel IChannel - @param token Token that expires in 30 seconds. - */ + virtual void onTokenPrivilegeWillExpire(IChannel *rtcChannel, const char* token) { (void)rtcChannel; (void)token; } - /** Reports the statistics of the current call. - - The SDK triggers this callback once every two seconds after the user joins the channel. - - @param rtcChannel IChannel - @param stats Statistics of the RtcEngine: RtcStats. - */ + virtual void onRtcStats(IChannel *rtcChannel, const RtcStats& stats) { (void)rtcChannel; (void)stats; } - /** Reports the last mile network quality of each user in the channel once every two seconds. - - Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. - - @param rtcChannel IChannel - @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. - @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 * 480 and a frame rate of 15 fps in the `LIVE_BROADCASTING` profile, but may be inadequate for resolutions higher than 1280 * 720. See #QUALITY_TYPE. - @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. - */ + virtual void onNetworkQuality(IChannel *rtcChannel, uid_t uid, int txQuality, int rxQuality) { (void)rtcChannel; (void)uid; (void)txQuality; (void)rxQuality; } - /** Reports the statistics of the video stream from each remote user/host. - * - * The SDK triggers this callback once every two seconds for each remote - * user/host. If a channel includes multiple remote users, the SDK - * triggers this callback as many times. - * - * @param rtcChannel IChannel - * @param stats Statistics of the remote video stream. See - * RemoteVideoStats. - */ + virtual void onRemoteVideoStats(IChannel *rtcChannel, const RemoteVideoStats& stats) { (void)rtcChannel; (void)stats; } - /** Reports the statistics of the audio stream from each remote user/host. - - This callback replaces the \ref agora::rtc::IRtcEngineEventHandler::onAudioQuality "onAudioQuality" callback. - - The SDK triggers this callback once every two seconds for each remote user/host. If a channel includes multiple remote users, the SDK triggers this callback as many times. - - @param rtcChannel IChannel - @param stats The statistics of the received remote audio streams. See RemoteAudioStats. - */ + virtual void onRemoteAudioStats(IChannel *rtcChannel, const RemoteAudioStats& stats) { (void)rtcChannel; (void)stats; } - /** Occurs when the remote audio state changes. - - This callback indicates the state change of the remote audio stream. - @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. - - @param rtcChannel IChannel - @param uid ID of the remote user whose audio state changes. - @param state State of the remote audio. See #REMOTE_AUDIO_STATE. - @param reason The reason of the remote audio state change. - See #REMOTE_AUDIO_STATE_REASON. - @param elapsed Time elapsed (ms) from the local user calling the - \ref IChannel::joinChannel "joinChannel" method until the SDK - triggers this callback. - */ + virtual void onRemoteAudioStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { (void)rtcChannel; (void)uid; @@ -272,55 +116,21 @@ class IChannelEventHandler (void)elapsed; } - /** Occurs when the audio publishing state changes. - * - * @since v3.1.0 - * - * This callback indicates the publishing state change of the local audio stream. - * - * @param rtcChannel IChannel - * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onAudioPublishStateChanged(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + virtual void onAudioPublishStateChange(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - /** Occurs when the video publishing state changes. - * - * @since v3.1.0 - * - * This callback indicates the publishing state change of the local video stream. - * - * @param rtcChannel IChannel - * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onVideoPublishStateChanged(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + virtual void onVideoPublishStateChange(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - /** Occurs when the audio subscribing state changes. - * - * @since v3.1.0 - * - * This callback indicates the subscribing state change of a remote audio stream. - * - * @param rtcChannel IChannel - * @param uid The ID of the remote user. - * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onAudioSubscribeStateChanged(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + virtual void onAudioSubscribeStateChange(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)uid; (void)oldState; @@ -328,74 +138,39 @@ class IChannelEventHandler (void)elapseSinceLastState; } - /** Occurs when the audio subscribing state changes. - * - * @since v3.1.0 - * - * This callback indicates the subscribing state change of a remote video stream. - * - * @param rtcChannel IChannel - * @param uid The ID of the remote user. - * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onVideoSubscribeStateChanged(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + virtual void onVideoSubscribeStateChange(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)uid; (void)oldState; (void)newState; (void)elapseSinceLastState; } - /// @cond - /** Reports whether the super-resolution algorithm is enabled. - * - * @since v3.2.0 - * - * After calling \ref IRtcChannel::enableRemoteSuperResolution "enableRemoteSuperResolution", the SDK triggers this - * callback to report whether the super-resolution algorithm is successfully enabled. If not successfully enabled, - * you can use reason for troubleshooting. - * - * @param rtcChannel IChannel - * @param uid The ID of the remote user. - * @param enabled Whether the super-resolution algorithm is successfully enabled: - * - true: The super-resolution algorithm is successfully enabled. - * - false: The super-resolution algorithm is not successfully enabled. - * @param reason The reason why the super-resolution algorithm is not successfully enabled. See #SUPER_RESOLUTION_STATE_REASON. - */ - virtual void onUserSuperResolutionEnabled(IChannel *rtcChannel, uid_t uid, bool enabled, SUPER_RESOLUTION_STATE_REASON reason) { + + virtual void onActiveSpeaker(IChannel *rtcChannel, uid_t uid) { (void)rtcChannel; (void)uid; - (void)enabled; - (void)reason; } - /// @endcond - - /** Occurs when the most active speaker is detected. - - After a successful call of \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication", - the SDK continuously detects which remote user has the loudest volume. During the current period, the remote user, - who is detected as the loudest for the most times, is the most active user. - - When the number of user is no less than two and an active speaker exists, the SDK triggers this callback and reports the `uid` of the most active speaker. - - If the most active speaker is always the same user, the SDK triggers this callback only once. - - If the most active speaker changes to another user, the SDK triggers this callback again and reports the `uid` of the new active speaker. - - @param rtcChannel IChannel - @param uid The user ID of the most active speaker. - */ - virtual void onActiveSpeaker(IChannel *rtcChannel, uid_t uid) { + + virtual void onFirstRemoteVideoFrame(IChannel *rtcChannel, uid_t uid, int width, int height, int elapsed) { (void)rtcChannel; (void)uid; + (void)width; + (void)height; + (void)elapsed; } - /** Occurs when the video size or rotation of a specified user changes. - - @param rtcChannel IChannel - @param uid User ID of the remote user or local user (0) whose video size or rotation changes. - @param width New width (pixels) of the video. - @param height New height (pixels) of the video. - @param rotation New rotation of the video [0 to 360). - */ + + virtual void onUserMuteAudio(IChannel *rtcChannel, uid_t uid, bool muted) { + (void)rtcChannel; + (void)uid; + (void)muted; + } + + virtual void onFirstRemoteAudioDecoded(IChannel *rtcChannel, uid_t uid, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)elapsed; + } + virtual void onVideoSizeChanged(IChannel *rtcChannel, uid_t uid, int width, int height, int rotation) { (void)rtcChannel; (void)uid; @@ -403,19 +178,7 @@ class IChannelEventHandler (void)height; (void)rotation; } - /** Occurs when the remote video state changes. - - @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. - - @param rtcChannel IChannel - @param uid ID of the remote user whose video state changes. - @param state State of the remote video. See #REMOTE_VIDEO_STATE. - @param reason The reason of the remote video state change. See - #REMOTE_VIDEO_STATE_REASON. - @param elapsed Time elapsed (ms) from the local user calling the - \ref agora::rtc::IChannel::joinChannel "joinChannel" method until the - SDK triggers this callback. - */ + virtual void onRemoteVideoStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { (void)rtcChannel; (void)uid; @@ -423,16 +186,7 @@ class IChannelEventHandler (void)reason; (void)elapsed; } - /** Occurs when the local user receives the data stream from the remote user within five seconds. - - The SDK triggers this callback when the local user receives the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. - - @param rtcChannel IChannel - @param uid User ID of the remote user sending the message. - @param streamId Stream ID. - @param data The data received by the local user. - @param length Length of the data in bytes. - */ + virtual void onStreamMessage(IChannel *rtcChannel, uid_t uid, int streamId, const char* data, size_t length) { (void)rtcChannel; (void)uid; @@ -440,17 +194,7 @@ class IChannelEventHandler (void)data; (void)length; } - /** Occurs when the local user does not receive the data stream from the remote user within five seconds. - - The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. - - @param rtcChannel IChannel - @param uid User ID of the remote user sending the message. - @param streamId Stream ID. - @param code Error code: #ERROR_CODE_TYPE. - @param missed Number of lost messages. - @param cached Number of incoming cached messages when the data stream is interrupted. - */ + virtual void onStreamMessageError(IChannel *rtcChannel, uid_t uid, int streamId, int code, int missed, int cached) { (void)rtcChannel; (void)uid; @@ -459,132 +203,59 @@ class IChannelEventHandler (void)missed; (void)cached; } - /** Occurs when the state of the media stream relay changes. - * - * The SDK returns the state of the current media relay with any error - * message. - * @param rtcChannel IChannel - * @param state The state code in #CHANNEL_MEDIA_RELAY_STATE. - * @param code The error code in #CHANNEL_MEDIA_RELAY_ERROR. - */ + virtual void onChannelMediaRelayStateChanged(IChannel *rtcChannel, CHANNEL_MEDIA_RELAY_STATE state,CHANNEL_MEDIA_RELAY_ERROR code) { (void)rtcChannel; (void)state; (void)code; } - /** Reports events during the media stream relay. - * @param rtcChannel IChannel - * @param code The event code in #CHANNEL_MEDIA_RELAY_EVENT. - */ + virtual void onChannelMediaRelayEvent(IChannel *rtcChannel, CHANNEL_MEDIA_RELAY_EVENT code) { (void)rtcChannel; (void)code; } - /** - Occurs when the state of the RTMP streaming changes. - - The SDK triggers this callback to report the result of the local user calling the \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" or \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method. - - This callback indicates the state of the RTMP streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. - - @param rtcChannel IChannel - @param url The RTMP URL address. - @param state The RTMP streaming state. See: #RTMP_STREAM_PUBLISH_STATE. - @param errCode The detailed error information for streaming. See: #RTMP_STREAM_PUBLISH_ERROR. - */ + + virtual void onFirstRemoteAudioFrame(IChannel *rtcChannel, uid_t uid, int elapsed) { + (void)rtcChannel; + (void)uid; + (void)elapsed; + } + virtual void onRtmpStreamingStateChanged(IChannel *rtcChannel, const char *url, RTMP_STREAM_PUBLISH_STATE state, RTMP_STREAM_PUBLISH_ERROR errCode) { (void)rtcChannel; (void) url; (RTMP_STREAM_PUBLISH_STATE) state; (RTMP_STREAM_PUBLISH_ERROR) errCode; } - - /** Reports events during the RTMP streaming. - * - * @since v3.1.0 - * - * @param rtcChannel IChannel - * @param url The RTMP streaming URL. - * @param eventCode The event code. See #RTMP_STREAMING_EVENT - */ - virtual void onRtmpStreamingEvent(IChannel *rtcChannel, const char* url, RTMP_STREAMING_EVENT eventCode) { - (void) rtcChannel; - (void) url; - (RTMP_STREAMING_EVENT) eventCode; + + virtual void onStreamPublished(IChannel *rtcChannel, const char *url, int error) { + (void)rtcChannel; + (void)url; + (void)error; } - - /** Occurs when the publisher's transcoding is updated. - - When the `LiveTranscoding` class in the \ref agora::rtc::IChannel::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. - - @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - - @param rtcChannel IChannel - */ + + virtual void onStreamUnpublished(IChannel *rtcChannel, const char *url) { + (void)rtcChannel; + (void)url; + } + virtual void onTranscodingUpdated(IChannel *rtcChannel) { (void)rtcChannel; } - /** Occurs when a voice or video stream URL address is added to the live interactive streaming. - - @param rtcChannel IChannel - @param url The URL address of the externally injected stream. - @param uid User ID. - @param status State of the externally injected stream: #INJECT_STREAM_STATUS. - */ + virtual void onStreamInjectedStatus(IChannel *rtcChannel, const char* url, uid_t uid, int status) { (void)rtcChannel; (void)url; (void)uid; (void)status; } - /** Occurs when the published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. - - If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. - - @param rtcChannel IChannel - @param isFallbackOrRecover Whether the published stream falls back to audio-only or switches back to the video: - - true: The published stream falls back to audio-only due to poor network conditions. - - false: The published stream switches back to the video after the network conditions improve. - */ - virtual void onLocalPublishFallbackToAudioOnly(IChannel *rtcChannel, bool isFallbackOrRecover) { - (void)rtcChannel; - (void)isFallbackOrRecover; - } - /** Occurs when the remote media stream falls back to audio-only stream - * due to poor network conditions or switches back to the video stream - * after the network conditions improve. - * - * If you call - * \ref IRtcEngine::setRemoteSubscribeFallbackOption - * "setRemoteSubscribeFallbackOption" and set - * @p option as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this - * callback when the remote media stream falls back to audio-only mode due - * to poor uplink conditions, or when the remote media stream switches - * back to the video after the uplink network condition improves. - * - * @note Once the remote media stream switches to the low stream due to - * poor network conditions, you can monitor the stream switch between a - * high and low stream in the RemoteVideoStats callback. - * @param rtcChannel IChannel - * @param uid ID of the remote user sending the stream. - * @param isFallbackOrRecover Whether the remotely subscribed media stream - * falls back to audio-only or switches back to the video: - * - true: The remotely subscribed media stream falls back to audio-only - * due to poor network conditions. - * - false: The remotely subscribed media stream switches back to the - * video stream after the network conditions improved. - */ + virtual void onRemoteSubscribeFallbackToAudioOnly(IChannel *rtcChannel, uid_t uid, bool isFallbackOrRecover) { (void)rtcChannel; (void)uid; (void)isFallbackOrRecover; } - /** Occurs when the connection state between the SDK and the server changes. - - @param rtcChannel IChannel - @param state See #CONNECTION_STATE_TYPE. - @param reason See #CONNECTION_CHANGED_REASON_TYPE. - */ + virtual void onConnectionStateChanged(IChannel *rtcChannel, CONNECTION_STATE_TYPE state, CONNECTION_CHANGED_REASON_TYPE reason) { @@ -594,923 +265,110 @@ class IChannelEventHandler } }; -/** The IChannel class. */ class IChannel { public: virtual ~IChannel() {} - /** Releases all IChannel resources. - - @return - - 0: Success. - - < 0: Failure. - - `ERR_NOT_INITIALIZED (7)`: The SDK is not initialized before calling this method. - */ + virtual int release() = 0; - /** Sets the channel event handler. - - After setting the channel event handler, you can listen for channel events and receive the statistics of the corresponding `IChannel` object. - - @param channelEh The event handler of the `IChannel` object. For details, see IChannelEventHandler. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setChannelEventHandler(IChannelEventHandler *channelEh) = 0; - /** Joins the channel with a user ID. - This method differs from the `joinChannel` method in the `IRtcEngine` class in the following aspects: - - | IChannel::joinChannel | IRtcEngine::joinChannel | - |------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------| - | Does not contain the `channelId` parameter, because `channelId` is specified when creating the `IChannel` object. | Contains the `channelId` parameter, which specifies the channel to join. | - | Contains the `options` parameter, which decides whether to subscribe to all streams before joining the channel. | Does not contain the `options` parameter. By default, users subscribe to all streams when joining the channel. | - | Users can join multiple channels simultaneously by creating multiple `IChannel` objects and calling the `joinChannel` method of each object. | Users can join only one channel. | - | By default, the SDK does not publish any stream after the user joins the channel. You need to call the publish method to do that. | By default, the SDK publishes streams once the user joins the channel. | - - @note - - If you are already in a channel, you cannot rejoin it with the same `uid`. - - We recommend using different UIDs for different channels. - - If you want to join the same channel from different devices, ensure that the UIDs in all devices are different. - - Ensure that the app ID you use to generate the token is the same with the app ID used when creating the `IRtcEngine` object. - - @param token The token for authentication: - - In situations not requiring high security: You can use the temporary token generated at Console. For details, see [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platform=All%20Platforms#generate-a-token). - - In situations requiring high security: Set it as the token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=All%20Platforms). - @param info (Optional) Additional information about the channel. This parameter can be set as null. Other users in the channel do not receive this information. - @param uid The user ID. A 32-bit unsigned integer with a value ranging from 1 to (232-1). This parameter must be unique. If `uid` is not assigned (or set as `0`), the SDK assigns a `uid` and reports it in the \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. The app must maintain this user ID. - @param options The channel media options: \ref agora::rtc::ChannelMediaOptions::ChannelMediaOptions "ChannelMediaOptions" - - @return - - 0(ERR_OK): Success. - - < 0: Failure. - - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. - - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: - - You have created an IChannel object with the same channel name. - - You have joined and published a stream in a channel created by the IChannel object. - */ virtual int joinChannel(const char* token, const char* info, uid_t uid, const ChannelMediaOptions& options) = 0; - /** Joins the channel with a user account. - - After the user successfully joins the channel, the SDK triggers the following callbacks: - - - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . - - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. - - @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. - If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. - - @param token The token generated at your server: - - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). - - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). - @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". - @param options The channel media options: \ref agora::rtc::ChannelMediaOptions::ChannelMediaOptions “ChannelMediaOptions”. - @return - - 0: Success. - - < 0: Failure. - - #ERR_INVALID_ARGUMENT (-2) - - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) - */ virtual int joinChannelWithUserAccount(const char* token, const char* userAccount, const ChannelMediaOptions& options) = 0; - /** Allows a user to leave a channel, such as hanging up or exiting a call. - - After joining a channel, the user must call the *leaveChannel* method to end the call before joining another channel. - - This method returns 0 if the user leaves the channel and releases all resources related to the call. - - This method call is asynchronous, and the user has not left the channel when the method call returns. Once the user leaves the channel, the SDK triggers the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback. - - A successful \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method call triggers the following callbacks: - - The local client: \ref agora::rtc::IChannelEventHandler::onLeaveChannel "onLeaveChannel" - - The remote client: \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a host in the `LIVE_BROADCASTING` profile. - - @note - - If you call the \ref IChannel::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. - - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IChannel::removePublishStreamUrl "removePublishStreamUrl" method. - - @return - - 0(ERR_OK): Success. - - < 0: Failure. - - -1(ERR_FAILED): A general error occurs (no specified reason). - - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. - */ + virtual int leaveChannel() = 0; - - /** Publishes the local stream to the channel. - - You must keep the following restrictions in mind when calling this method. Otherwise, the SDK returns the #ERR_REFUSED (5): - - This method publishes one stream only to the channel corresponding to the current `IChannel` object. - - In the live interactive streaming channel, only a host can call this method. To switch the client role, call \ref agora::rtc::IChannel::setClientRole "setClientRole" of the current `IChannel` object. - - You can publish a stream to only one channel at a time. For details on joining multiple channels, see the advanced guide *Join Multiple Channels*. - - @return - - 0: Success. - - < 0: Failure. - - #ERR_REFUSED (5): The method call is refused. + + /** Allows this connection to upload stream. This method will unpublish the current publishing connection if there exists. */ virtual int publish() = 0; - - /** Stops publishing a stream to the channel. - - If you call this method in a channel where you are not publishing streams, the SDK returns #ERR_REFUSED (5). - - @return - - 0: Success. - - < 0: Failure. - - #ERR_REFUSED (5): The method call is refused. + + /** Stops publishing stream. */ virtual int unpublish() = 0; - - /** Gets the channel ID of the current `IChannel` object. - - @return - - The channel ID of the current `IChannel` object, if the method call succeeds. - - The empty string "", if the method call fails. + + /** Gets the channel ID of IChannel. + + @return Channel ID of IChannel. */ virtual const char *channelId() = 0; - /** Retrieves the current call ID. - - When a user joins a channel on a client, a `callId` is generated to identify the call from the client. - Feedback methods, such as \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain", must be called after the call ends to submit feedback to the SDK. - - The `rate` and `complain` methods require the `callId` parameter retrieved from the `getCallId` method during a call. `callId` is passed as an argument into the `rate` and `complain` methods after the call ends. - - @note Ensure that you call this method after joining a channel. - - @param callId The current call ID. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int getCallId(agora::util::AString& callId) = 0; - /** Gets a new token when the current token expires after a period of time. - - The `token` expires after a period of time once the token schema is enabled when: - - - The SDK triggers the \ref IChannelEventHandler::onTokenPrivilegeWillExpire "onTokenPrivilegeWillExpire" callback, or - - The \ref IChannelEventHandler::onConnectionStateChanged "onConnectionStateChanged" reports CONNECTION_CHANGED_TOKEN_EXPIRED(9). - The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. - - @param token Pointer to the new token. - - @return - - 0(ERR_OK): Success. - - < 0: Failure. - - -1(ERR_FAILED): A general error occurs (no specified reason). - - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. - */ virtual int renewToken(const char* token) = 0; - /** Enables built-in encryption with an encryption password before users join a channel. - - @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IChannel::enableEncryption "enableEncryption" instead. - - All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. - - If an encryption password is not specified, the encryption functionality will be disabled. - - @note - - Do not use this method for CDN live streaming. - - For optimal transmission, ensure that the encrypted data size does not exceed the original data size + 16 bytes. 16 bytes is the maximum padding size for AES encryption. - - @param secret Pointer to the encryption password. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setEncryptionSecret(const char* secret) = 0; - /** Sets the built-in encryption mode. - - @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IChannel::enableEncryption "enableEncryption" instead. - - The Agora SDK supports built-in encryption, which is set to the `aes-128-xts` mode by default. Call this method to use other encryption modes. - - All users in the same channel must use the same encryption mode and password. - - Refer to the information related to the AES encryption algorithm on the differences between the encryption modes. - - @note Call the \ref IChannel::setEncryptionSecret "setEncryptionSecret" method to enable the built-in encryption function before calling this method. - - @param encryptionMode The set encryption mode: - - "aes-128-xts": (Default) 128-bit AES encryption, XTS mode. - - "aes-128-ecb": 128-bit AES encryption, ECB mode. - - "aes-256-xts": 256-bit AES encryption, XTS mode. - - "": When encryptionMode is set as NULL, the encryption mode is set as "aes-128-xts" by default. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setEncryptionMode(const char* encryptionMode) = 0; - /** Enables/Disables the built-in encryption. - * - * @since v3.1.0 - * - * In scenarios requiring high security, Agora recommends calling this method to enable the built-in encryption before joining a channel. - * - * All users in the same channel must use the same encryption mode and encryption key. Once all users leave the channel, the encryption key of this channel is automatically cleared. - * - * @note - * - If you enable the built-in encryption, you cannot use the RTMP streaming function. - * - Agora supports four encryption modes. If you choose an encryption mode (excepting `SM4_128_ECB` mode), you need to add an external encryption library when integrating the Android and iOS SDK. See the advanced guide *Channel Encryption*. - * - * @param enabled Whether to enable the built-in encryption: - * - true: Enable the built-in encryption. - * - false: Disable the built-in encryption. - * @param config Configurations of built-in encryption schemas. See EncryptionConfig. - * - * @return - * - 0: Success. - * - < 0: Failure. - * - -2(ERR_INVALID_ARGUMENT): An invalid parameter is used. Set the parameter with a valid value. - * - -4(ERR_NOT_SUPPORTED): The encryption mode is incorrect or the SDK fails to load the external encryption library. Check the enumeration or reload the external encryption library. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Initialize the `IRtcEngine` instance before calling this method. - */ - virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; - /** Registers a packet observer. - - The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. - - @note - - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. - - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. - - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. - - Call this method before joining a channel. - @param observer The registered packet observer. See IPacketObserver. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int registerPacketObserver(IPacketObserver* observer) = 0; - /** Registers the metadata observer. - - Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. - This method enables you to add synchronized metadata in the video stream for more diversified interactive live streaming, such as sending shopping links, digital coupons, and online quizzes. - - @note - - Call this method before the joinChannel method. - - This method applies to the `LIVE_BROADCASTING` channel profile. - - @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. - @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; - /** Sets the role of the user, such as a host or an audience (default), before joining a channel in the interactive live streaming. - - This method can be used to switch the user role in the interactive live streaming after the user joins a channel. - - In the `LIVE_BROADCASTING` profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IChannel::setClientRole "setClientRole" method call triggers the following callbacks: - - The local client: \ref agora::rtc::IChannelEventHandler::onClientRoleChanged "onClientRoleChanged" - - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) - - @note - This method applies only to the `LIVE_BROADCASTING` profile. - - @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; - /// @cond - /** Sets the role of a user in a live interactive streaming. - * - * @since v3.2.0 - * - * You can call this method either before or after joining the channel to set the user role as audience or host. If - * you call this method to switch the user role after joining the channel, the SDK triggers the following callbacks: - * - The local client: \ref IRtcChannelEventHandler::onClientRoleChanged "onClientRoleChanged". - * - The remote client: \ref IRtcChannelEventHandler::onUserJoined "onUserJoined" - * or \ref IRtcChannelEventHandler::onUserOffline "onUserOffline". - * - * @note - * - This method applies to the `LIVE_BROADCASTING` profile only (when the `profile` parameter in - * \ref IRtcChannel::setChannelProfile "setChannelProfile" is set as `CHANNEL_PROFILE_LIVE_BROADCASTING`). - * - The difference between this method and \ref IRtcChannel::setClientRole(CLIENT_ROLE_TYPE) "setClientRole1" is that - * this method can set the user level in addition to the user role. - * - The user role determines the permissions that the SDK grants to a user, such as permission to send local - * streams, receive remote streams, and push streams to a CDN address. - * - The user level determines the level of services that a user can enjoy within the permissions of the user's - * role. For example, an audience can choose to receive remote streams with low latency or ultra low latency. Levels - * affect prices. - * - * **Example** - * ```cpp - * ClientRoleOptions options; - * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY; - * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_LOW_LATENCY; - * agoraChannel->setClientRole(role, options); - * ``` - * - * @param role The role of a user in a live interactive streaming. See #CLIENT_ROLE_TYPE. - * @param options The detailed options of a user, including user level. See ClientRoleOptions. - * - * @return - * - 0(ERR_OK): Success. - * - < 0: Failure. - * - -1(ERR_FAILED): A general error occurs (no specified reason). - * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. - */ - virtual int setClientRole(CLIENT_ROLE_TYPE role, const ClientRoleOptions& options) = 0; - /// @endcond - /** Prioritizes a remote user's stream. - * - * The SDK ensures the high-priority user gets the best possible stream quality. - * - * @note - * - The Agora SDK supports setting `serPriority` as high for one user only. - * - Ensure that you call this method before joining a channel. - * - * @param uid The ID of the remote user. - * @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ + virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; - /** Sets the sound position and gain of a remote user. - - When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the - local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, - such as Battle Royale games. - - @note - - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. - - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. - - Ensure that you call this method after joining a channel. - - @param uid The ID of the remote user. - @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: - - 0.0: the remote sound comes from the front. - - -1.0: the remote sound comes from the left. - - 1.0: the remote sound comes from the right. - @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). - The smaller the value, the less the gain. - @return - - 0: Success. - - < 0: Failure. - */ virtual int setRemoteVoicePosition(uid_t uid, double pan, double gain) = 0; - /** Updates the display mode of the video view of a remote user. - - After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. - This method affects only the video view that the local user sees. - - @note - - Call this method after calling the \ref agora::rtc::IRtcEngine::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view. - - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. - - @param userId The ID of the remote user. - @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. - @param mirrorMode - - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. - - **Note**: The SDK disables the mirror mode by default. - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** Sets whether to receive all remote audio streams by default. - - You can call this method either before or after joining a channel. If you call `setDefaultMuteAllRemoteAudioStreams (true)` after joining a channel, the remote audio streams of all subsequent users are not received. - - @note If you want to resume receiving the audio stream, call \ref agora::rtc::IChannel::muteRemoteAudioStream "muteRemoteAudioStream (false)", - and specify the ID of the remote user whose audio stream you want to receive. - To receive the audio streams of multiple remote users, call `muteRemoteAudioStream (false)` as many times. - Calling `setDefaultMuteAllRemoteAudioStreams (false)` resumes receiving the audio streams of subsequent users only. + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; - @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: - - true: Stops receiving all remote users' audio streams by default. - - false: (Default) Receives all remote users' audio streams by default. - - @return - - 0: Success. - - < 0: Failure. - */ virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - /** Sets whether to receive all remote video streams by default. - - You can call this method either before or after joining a channel. If you - call `setDefaultMuteAllRemoteVideoStreams (true)` after joining a channel, - the remote video streams of all subsequent users are not received. - - @note If you want to resume receiving the video stream, call - \ref agora::rtc::IChannel::muteRemoteVideoStream "muteRemoteVideoStream (false)", - and specify the ID of the remote user whose video stream you want to receive. - To receive the video streams of multiple remote users, call `muteRemoteVideoStream (false)` - as many times. Calling `setDefaultMuteAllRemoteVideoStreams (false)` resumes - receiving the video streams of subsequent users only. - - @param mute Sets whether to receive/stop receiving all remote users' video streams by default: - - true: Stop receiving all remote users' video streams by default. - - false: (Default) Receive all remote users' video streams by default. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; - /** Stops/Resumes receiving all remote users' audio streams. - - @param mute Sets whether to receive/stop receiving all remote users' audio streams. - - true: Stops receiving all remote users' audio streams. - - false: (Default) Receives all remote users' audio streams. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int muteAllRemoteAudioStreams(bool mute) = 0; - /** Adjust the playback volume of the specified remote user. - - After joining a channel, call \ref agora::rtc::IRtcEngine::adjustPlaybackSignalVolume "adjustPlaybackSignalVolume" to adjust the playback volume of different remote users, - or adjust multiple times for one remote user. - - @note - - Call this method after joining a channel. - - This method adjusts the playback volume, which is the mixed volume for the specified remote user. - - This method can only adjust the playback volume of one specified remote user at a time. If you want to adjust the playback volume of several remote users, - call the method multiple times, once for each remote user. - - @param userId The user ID, which should be the same as the `uid` of \ref agora::rtc::IChannel::joinChannel "joinChannel" - @param volume The playback volume of the voice. The value ranges from 0 to 100: - - 0: Mute. - - 100: Original volume. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int adjustUserPlaybackSignalVolume(uid_t userId, int volume) = 0; - /** Stops/Resumes receiving a specified remote user's audio stream. - - @note - - You can call this method either before or after joining a channel. If you call it before joining a channel, - you need to maintain the `uid` of the remote user on your app level. - - If you called the \ref agora::rtc::IChannel::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set `mute` as `true` to stop - receiving all remote users' audio streams, call the `muteAllRemoteAudioStreams` method and set `mute` as `false` before calling this method. - The `muteAllRemoteAudioStreams` method sets all remote audio streams, while the `muteRemoteAudioStream` method sets a specified remote audio stream. - - @param userId The user ID of the specified remote user sending the audio. - @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: - - true: Stops receiving the specified remote user's audio stream. - - false: (Default) Receives the specified remote user's audio stream. - - @return - - 0: Success. - - < 0: Failure. - - */ + virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; - /** Stops/Resumes receiving all video stream from a specified remote user. - - @note You can call this method either before or after joining a channel. - - @param mute Sets whether to receive/stop receiving all remote users' video streams: - - true: Stop receiving all remote users' video streams. - - false: (Default) Receive all remote users' video streams. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int muteAllRemoteVideoStreams(bool mute) = 0; - /** Stops/Resumes receiving the video stream from a specified remote user. - - @note - - You can call this method either before or after joining a channel. If you call it before joining a channel, you - need to maintain the `uid` of the remote user on your app level. - - If you called the \ref agora::rtc::IChannel::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and - set `mute` as `true` to stop receiving all remote video streams, call the `muteAllRemoteVideoStreams` method and - set `mute` as `false` before calling this method. - - @param userId The user ID of the specified remote user. - @param mute Sets whether to stop/resume receiving the video stream from a specified remote user: - - true: Stop receiving the specified remote user's video stream. - - false: (Default) Receive the specified remote user's video stream. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; - /** Sets the stream type of the remote video. - - Under limited network conditions, if the publisher has not disabled the dual-stream mode using - \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" (false), - the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or - the low-video stream (the low resolution, and low bitrate video stream). - - By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. - This method allows the app to adjust the corresponding video stream type based on the size of the video window to - reduce the bandwidth and resources. - - The aspect ratio of the low-video stream is the same as the high-quality video stream. Once the resolution of the high-quality video - stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - - @param userId The ID of the remote user sending the video stream. - @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Sets the default stream type of remote videos. - - Under limited network conditions, if the publisher has not disabled the dual-stream mode using - \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" (false), - the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or - the low-video stream (the low resolution, and low bitrate video stream). - - By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. - This method allows the app to adjust the corresponding video stream type based on the size of the video window to - reduce the bandwidth and resources. The aspect ratio of the low-video stream is the same as the high-quality video stream. - Once the resolution of the high-quality video - stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - - @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Creates a data stream. - - Each user can create up to five data streams during the lifecycle of the IChannel. - @note - - Set both the `reliable` and `ordered` parameters to `true` or `false`. Do not set one as `true` and the other as `false`. - - Ensure that you call this method after joining a channel. - - @param[out] streamId The ID of the created data stream. - @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: - - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, - an error is reported to the application. - - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for - any delay or missing data stream. - @param ordered Sets whether or not the recipients receive the data stream in the sent order: - - true: The recipients receive the data stream in the sent order. - - false: The recipients do not receive the data stream in the sent order. - - @return - - Returns 0: Success. - - < 0: Failure. - */ virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; - /** Sends data stream messages to all users in a channel. - - The SDK has the following restrictions on this method: - - Up to 30 packets can be sent per second in a channel with each packet having a maximum size of 1 kB. - - Each client can send up to 6 kB of data per second. - - Each user can have up to five data streams simultaneously. - - A successful \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers - the \ref agora::rtc::IChannelEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. - - A failed \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers - the \ref agora::rtc::IChannelEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. - - @note - - This method applies only to the `COMMUNICATION` profile or to the hosts in the `LIVE_BROADCASTING` profile. If an audience in the `LIVE_BROADCASTING` profile calls this method, the audience may be switched to a host. - - Ensure that you have created the data stream using \ref agora::rtc::IChannel::createDataStream "createDataStream" before calling this method. - - @param streamId The ID of the sent data stream, returned in the \ref IChannel::createDataStream "createDataStream" method. - @param data The sent data. - @param length The length of the sent data. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int sendStreamMessage(int streamId, const char* data, size_t length) = 0; - /** Publishes the local stream to a specified CDN live RTMP address. (CDN live only.) - - The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback. - - The \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" method call triggers - the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client - to report the state of adding a local stream to the CDN. - - @note - - Ensure that the user joins the channel before calling this method. - - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*. - - This method adds only one stream RTMP URL address each time it is called. - - @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. The RTMP URL address must not contain special characters, such as Chinese language characters. - @param transcodingEnabled Sets whether transcoding is enabled/disabled: - - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. If you set this parameter as `true`, ensure that you call the \ref IChannel::setLiveTranscoding "setLiveTranscoding" method before this method. - - false: Disable transcoding. - - @return - - 0: Success. - - < 0: Failure. - - #ERR_INVALID_ARGUMENT (2): The RTMP URL address is NULL or has a string length of 0. - - #ERR_NOT_INITIALIZED (7): You have not initialized `IChannel` when publishing the stream. - */ + virtual int addPublishStreamUrl(const char *url, bool transcodingEnabled) = 0; - /** Removes an RTMP stream from the CDN. - - This method removes the RTMP URL address (added by the \ref IChannel::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. - The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamUnpublished "onStreamUnpublished" callback. - - The \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method call triggers - the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP stream from the CDN. - - @note - - This method removes only one RTMP URL address each time it is called. - - The RTMP URL address must not contain special characters, such as Chinese language characters. - - @param url The RTMP URL address to be removed. The maximum length of this parameter is 1024 bytes. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int removePublishStreamUrl(const char *url) = 0; - /** Sets the video layout and audio settings for CDN live. (CDN live only.) - - The SDK triggers the \ref agora::rtc::IChannelEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you - call the `setLiveTranscoding` method to update the transcoding setting. - - @note - - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*.. - - If you call the `setLiveTranscoding` method to set the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - - Ensure that you call this method after joining a channel. - - @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; - /** Adds a voice or video stream URL address to the interactive live streaming. - - The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. - If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. - This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. - - The \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: - - The local client: - - \ref agora::rtc::IChannelEventHandler::onStreamInjectedStatus "onStreamInjectedStatus" , with the state of the injecting the online stream. - - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. - - The remote client: - - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. - - @note - - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*. - - This method applies to the Native SDK v2.4.1 and later. - - This method applies to the `LIVE_BROADCASTING` profile only. - - You can inject only one media stream into the channel at the same time. - - Ensure that you call this method after joining a channel. - - @param url The URL address to be added to the ongoing live streaming. Valid protocols are RTMP, HLS, and HTTP-FLV. - - Supported audio codec type: AAC. - - Supported video codec type: H264 (AVC). - @param config The InjectStreamConfig object that contains the configuration of the added voice or video stream. - - @return - - 0: Success. - - < 0: Failure. - - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. - - #ERR_NOT_READY (3): The user is not in the channel. - - #ERR_NOT_SUPPORTED (4): The channel profile is not `LIVE_BROADCASTING`. Call the \ref IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to `LIVE_BROADCASTING` before calling this method. - - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IChannel object is initialized before calling this method. - */ + virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; - /** Removes the voice or video stream URL address from a live streaming. - - This method removes the URL address (added by the \ref IChannel::addInjectStreamUrl "addInjectStreamUrl" method) from the live streaming. - - @note If this method is called successfully, the SDK triggers the \ref IChannelEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. - - @param url Pointer to the URL address of the added stream to be removed. - - @return - - 0: Success. - - < 0: Failure. - */ + virtual int removeInjectStreamUrl(const char* url) = 0; - /** Starts to relay media streams across channels. - * - * After a successful method call, the SDK triggers the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged - * "onChannelMediaRelayStateChanged" and - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent - * "onChannelMediaRelayEvent" callbacks, and these callbacks return the - * state and events of the media stream relay. - * - If the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged - * "onChannelMediaRelayStateChanged" callback returns - * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent - * "onChannelMediaRelayEvent" callback returns - * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the host starts - * sending data to the destination channel. - * - If the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged - * "onChannelMediaRelayStateChanged" callback returns - * #RELAY_STATE_FAILURE (3), an exception occurs during the media stream - * relay. - * - * @note - * - Call this method after the \ref joinChannel() "joinChannel" method. - * - This method takes effect only when you are a host in a - * `LIVE_BROADCASTING` channel. - * - After a successful method call, if you want to call this method - * again, ensure that you call the - * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the - * current relay. - * - Contact sales-us@agora.io before implementing this function. - * - We do not support string user accounts in this API. - * - * @param configuration The configuration of the media stream relay: - * ChannelMediaRelayConfiguration. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ + virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; - /** Updates the channels for media stream relay. - * - * After a successful - * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if - * you want to relay the media stream to more channels, or leave the - * current relay channel, you can call the - * \ref updateChannelMediaRelay() "updateChannelMediaRelay" method. - * - * After a successful method call, the SDK triggers the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent - * "onChannelMediaRelayEvent" callback with the - * #RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL (7) state code. - * - * @note - * Call this method after the - * \ref startChannelMediaRelay() "startChannelMediaRelay" method to update - * the destination channel. - * - * @param configuration The media stream relay configuration: - * ChannelMediaRelayConfiguration. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ + virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; - /** Stops the media stream relay. - * - * Once the relay stops, the host quits all the destination - * channels. - * - * After a successful method call, the SDK triggers the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged - * "onChannelMediaRelayStateChanged" callback. If the callback returns - * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the host successfully - * stops the relay. - * - * @note - * If the method call fails, the SDK triggers the - * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged - * "onChannelMediaRelayStateChanged" callback with the - * #RELAY_ERROR_SERVER_NO_RESPONSE (2) or - * #RELAY_ERROR_SERVER_CONNECTION_LOST (8) state code. You can leave the - * channel by calling the \ref leaveChannel() "leaveChannel" method, and - * the media stream relay automatically stops. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ + virtual int stopChannelMediaRelay() = 0; - /** Gets the current connection state of the SDK. - - @note You can call this method either before or after joining a channel. - - @return #CONNECTION_STATE_TYPE. - */ + virtual CONNECTION_STATE_TYPE getConnectionState() = 0; - /// @cond - /** Enables/Disables the super-resolution algorithm for a remote user's video stream. - * - * @since v3.2.0 - * - * The algorithm effectively improves the resolution of the specified remote user's video stream. When the original - * resolution of the remote video stream is a × b pixels, you can receive and render the stream at a higher - * resolution (2a × 2b pixels) by enabling the algorithm. - * - * After calling this method, the SDK triggers the - * \ref IRtcChannelEventHandler::onUserSuperResolutionEnabled "onUserSuperResolutionEnabled" callback to report - * whether you have successfully enabled the super-resolution algorithm. - * - * @warning The super-resolution algorithm requires extra system resources. - * To balance the visual experience and system usage, the SDK poses the following restrictions: - * - The algorithm can only be used for a single user at a time. - * - On the Android platform, the original resolution of the remote video must not exceed 640 × 360 pixels. - * - On the iOS platform, the original resolution of the remote video must not exceed 640 × 480 pixels. - * If you exceed these limitations, the SDK triggers the \ref IRtcChannelEventHandler::onWarning "onWarning" - * callback with the corresponding warning codes: - * - #WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION (1610): The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. - * - #WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION (1611): Another user is already using the super-resolution algorithm. - * - #WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED (1612): The device does not support the super-resolution algorithm. - * - * @note - * - This method applies to Android and iOS only. - * - Requirements for the user's device: - * - Android: The following devices are known to support the method: - * - VIVO: V1821A, NEX S, 1914A, 1916A, and 1824BA - * - OPPO: PCCM00 - * - OnePlus: A6000 - * - Xiaomi: Mi 8, Mi 9, MIX3, and Redmi K20 Pro - * - SAMSUNG: SM-G9600, SM-G9650, SM-N9600, SM-G9708, SM-G960U, and SM-G9750 - * - HUAWEI: SEA-AL00, ELE-AL00, VOG-AL00, YAL-AL10, HMA-AL00, and EVR-AN00 - * - iOS: This method is supported on devices running iOS 12.0 or later. The following - * device models are known to support the method: - * - iPhone XR - * - iPhone XS - * - iPhone XS Max - * - iPhone 11 - * - iPhone 11 Pro - * - iPhone 11 Pro Max - * - iPad Pro 11-inch (3rd Generation) - * - iPad Pro 12.9-inch (3rd Generation) - * - iPad Air 3 (3rd Generation) - * - * @param userId The ID of the remote user. - * @param enable Whether to enable the super-resolution algorithm: - * - true: Enable the super-resolution algorithm. - * - false: Disable the super-resolution algorithm. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int enableRemoteSuperResolution(uid_t userId, bool enable) = 0; - /// @endcond }; -/** @since v3.0.0 - The IRtcEngine2 class. */ class IRtcEngine2 : public IRtcEngine { public: - - /** Creates and gets an `IChannel` object. - - To join more than one channel, call this method multiple times to create as many `IChannel` objects as needed, and - call the \ref agora::rtc::IChannel::joinChannel "joinChannel" method of each created `IChannel` object. - - After joining multiple channels, you can simultaneously subscribe to streams of all the channels, but publish a stream in only one channel at one time. - @param channelId The unique channel name for an Agora RTC session. It must be in the string format and not exceed 64 bytes in length. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". - - @note - - This parameter does not have a default value. You must set it. - - Do not set it as the empty string "". Otherwise, the SDK returns #ERR_REFUSED (5). - - @return - - The `IChannel` object, if the method call succeeds. - - An empty pointer NULL, if the method call fails. - - `ERR_REFUSED(5)`, if you set channelId as the empty string "". + + /** Gets a the *IChannel* object. + + @param channelId Channel ID of the RTC connection. + @return Pointer to the *IChannel* object. If the connection hasn't been created, NULL will be returned. */ virtual IChannel* createChannel(const char *channelId) = 0; - + }; @@ -1518,4 +376,4 @@ class IRtcEngine2 : public IRtcEngine } -#endif +#endif /* IAgoraRtcChannel_h */ diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h index ab6b753..0f75da2 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h @@ -12,10 +12,7 @@ #define AGORA_RTC_ENGINE_H #include "AgoraBase.h" #include "IAgoraService.h" - -#if defined(_WIN32) -#include "IAgoraMediaEngine.h" -#endif +#include "IAgoraLog.h" namespace agora { namespace rtc { @@ -37,7 +34,7 @@ enum MAX_USER_ACCOUNT_LENGTH_TYPE */ MAX_USER_ACCOUNT_LENGTH = 256 }; -/** Maximum length of channel ID. +/** Maximum length of channel id. */ enum MAX_CHANNEL_ID_LENGTH_TYPE { @@ -149,17 +146,16 @@ enum MEDIA_ENGINE_EVENT_CODE_TYPE /** The states of the local user's audio mixing file. */ enum AUDIO_MIXING_STATE_TYPE{ - /** 710: The audio mixing file is playing after the method call of - * \ref IRtcEngine::startAudioMixing "startAudioMixing" or \ref IRtcEngine::resumeAudioMixing "resumeAudioMixing" succeeds. - */ + /** 710: The audio mixing file is playing. + */ AUDIO_MIXING_STATE_PLAYING = 710, - /** 711: The audio mixing file pauses playing after the method call of \ref IRtcEngine::pauseAudioMixing "pauseAudioMixing" succeeds. + /** 711: The audio mixing file pauses playing. */ AUDIO_MIXING_STATE_PAUSED = 711, - /** 713: The audio mixing file stops playing after the method call of \ref IRtcEngine::stopAudioMixing "stopAudioMixing" succeeds. + /** 713: The audio mixing file stops playing. */ AUDIO_MIXING_STATE_STOPPED = 713, - /** 714: An exception occurs during the playback of the audio mixing file. See the `errorCode` for details. + /** 714: An exception occurs when playing the audio mixing file. See #AUDIO_MIXING_ERROR_TYPE. */ AUDIO_MIXING_STATE_FAILED = 714, }; @@ -181,6 +177,16 @@ enum AUDIO_MIXING_ERROR_TYPE{ AUDIO_MIXING_ERROR_OK = 0, }; +enum XLA_EXP_NET_POOR_REASON { + XLA_EXP_NET_REMOTE_POOR = 1, + XLA_EXP_NET_GATWAYRTT_POOR = 2, + XLA_EXP_NET_WANRTT_POOR = 4, + XLA_EXP_NET_VOSRTT_POOR = 8, + XLA_EXP_NET_LINKSPEED_POOR = 16, + XLA_EXP_NET_RSSI_POOR = 32, + XLA_EXP_NET_WIFI_BLUETOOTH_COEXIST = 64, +}; + /** Media device states. */ enum MEDIA_DEVICE_STATE_TYPE @@ -227,50 +233,33 @@ enum MEDIA_DEVICE_TYPE */ enum LOCAL_VIDEO_STREAM_STATE { - /** 0: Initial state */ + /** Initial state */ LOCAL_VIDEO_STREAM_STATE_STOPPED = 0, - /** 1: The local video capturing device starts successfully. - * - * The SDK also reports this state when you share a maximized window by calling \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId". - */ + /** The capturer starts successfully. */ LOCAL_VIDEO_STREAM_STATE_CAPTURING = 1, - /** 2: The first video frame is successfully encoded. */ + /** The first video frame is successfully encoded. */ LOCAL_VIDEO_STREAM_STATE_ENCODING = 2, - /** 3: The local video fails to start. */ + /** The local video fails to start. */ LOCAL_VIDEO_STREAM_STATE_FAILED = 3 }; /** Local video state error codes */ enum LOCAL_VIDEO_STREAM_ERROR { - /** 0: The local video is normal. */ + /** The local video is normal. */ LOCAL_VIDEO_STREAM_ERROR_OK = 0, - /** 1: No specified reason for the local video failure. */ + /** No specified reason for the local video failure. */ LOCAL_VIDEO_STREAM_ERROR_FAILURE = 1, - /** 2: No permission to use the local video capturing device. */ + /** No permission to use the local video device. */ LOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSION = 2, - /** 3: The local video capturing device is in use. */ + /** The local video capturer is in use. */ LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY = 3, - /** 4: The local video capture fails. Check whether the capturing device is working properly. */ + /** The local video capture fails. Check whether the capturer is working properly. */ LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE = 4, - /** 5: The local video encoding fails. */ + /** The local video encoding fails. */ LOCAL_VIDEO_STREAM_ERROR_ENCODE_FAILURE = 5, - /** 11: The shared window is minimized when you call \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" to share a window. - */ - LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_MINIMIZED = 11, - /** 12: The error code indicates that a window shared by the window ID has been closed, or a full-screen window - * shared by the window ID has exited full-screen mode. - * After exiting full-screen mode, remote users cannot see the shared window. To prevent remote users from seeing a - * black screen, Agora recommends that you immediately stop screen sharing. - * - * Common scenarios for reporting this error code: - * - When the local user closes the shared window, the SDK reports this error code. - * - The local user shows some slides in full-screen mode first, and then shares the windows of the slides. After - * the user exits full-screen mode, the SDK reports this error code. - * - The local user watches web video or reads web document in full-screen mode first, and then shares the window of - * the web video or document. After the user exits full-screen mode, the SDK reports this error code. - */ - LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_CLOSED = 12, + /** No camera device. */ + LOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUND = 6, }; /** Local audio state types. @@ -313,7 +302,13 @@ enum LOCAL_AUDIO_STREAM_ERROR LOCAL_AUDIO_STREAM_ERROR_RECORD_FAILURE = 4, /** 5: The local audio encoding fails. */ - LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE = 5 + LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE = 5, + /** 6: No recording audio device. + */ + LOCAL_AUDIO_STREAM_ERROR_NO_RECORDING_DEVICE = 6, + /** 7: No playout audio device. + */ + LOCAL_AUDIO_STREAM_ERROR_NO_PLAYOUT_DEVICE = 7 }; /** Audio recording qualities. @@ -371,17 +366,12 @@ enum RENDER_MODE_TYPE /** **DEPRECATED** 3: This mode is deprecated. */ RENDER_MODE_ADAPTIVE = 3, - /** - 4: The fill mode. In this mode, the SDK stretches or zooms the video to fill the display window. - */ - RENDER_MODE_FILL = 4, }; /** Video mirror modes. */ enum VIDEO_MIRROR_MODE_TYPE { - /** 0: (Default) The SDK enables the mirror mode. - */ + /** 0: The default mirror mode is determined by the SDK. */ VIDEO_MIRROR_MODE_AUTO = 0,//determined by SDK /** 1: Enable mirror mode. */ VIDEO_MIRROR_MODE_ENABLED = 1,//enabled mirror @@ -392,159 +382,159 @@ enum VIDEO_MIRROR_MODE_TYPE /** **DEPRECATED** Video profiles. */ enum VIDEO_PROFILE_TYPE { - /** 0: 160 * 120, frame rate 15 fps, bitrate 65 Kbps. */ + /** 0: 160 × 120, frame rate 15 fps, bitrate 65 Kbps. */ VIDEO_PROFILE_LANDSCAPE_120P = 0, - /** 2: 120 * 120, frame rate 15 fps, bitrate 50 Kbps. */ + /** 2: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ VIDEO_PROFILE_LANDSCAPE_120P_3 = 2, - /** 10: 320*180, frame rate 15 fps, bitrate 140 Kbps. */ + /** 10: 320×180, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P = 10, - /** 12: 180 * 180, frame rate 15 fps, bitrate 100 Kbps. */ + /** 12: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P_3 = 12, - /** 13: 240 * 180, frame rate 15 fps, bitrate 120 Kbps. */ + /** 13: 240 × 180, frame rate 15 fps, bitrate 120 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P_4 = 13, - /** 20: 320 * 240, frame rate 15 fps, bitrate 200 Kbps. */ + /** 20: 320 × 240, frame rate 15 fps, bitrate 200 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P = 20, - /** 22: 240 * 240, frame rate 15 fps, bitrate 140 Kbps. */ + /** 22: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P_3 = 22, - /** 23: 424 * 240, frame rate 15 fps, bitrate 220 Kbps. */ + /** 23: 424 × 240, frame rate 15 fps, bitrate 220 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P_4 = 23, - /** 30: 640 * 360, frame rate 15 fps, bitrate 400 Kbps. */ + /** 30: 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P = 30, - /** 32: 360 * 360, frame rate 15 fps, bitrate 260 Kbps. */ + /** 32: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_3 = 32, - /** 33: 640 * 360, frame rate 30 fps, bitrate 600 Kbps. */ + /** 33: 640 × 360, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_4 = 33, - /** 35: 360 * 360, frame rate 30 fps, bitrate 400 Kbps. */ + /** 35: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_6 = 35, - /** 36: 480 * 360, frame rate 15 fps, bitrate 320 Kbps. */ + /** 36: 480 × 360, frame rate 15 fps, bitrate 320 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_7 = 36, - /** 37: 480 * 360, frame rate 30 fps, bitrate 490 Kbps. */ + /** 37: 480 × 360, frame rate 30 fps, bitrate 490 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_8 = 37, - /** 38: 640 * 360, frame rate 15 fps, bitrate 800 Kbps. - @note `LIVE_BROADCASTING` profile only. + /** 38: 640 × 360, frame rate 15 fps, bitrate 800 Kbps. + @note Live broadcast profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_9 = 38, - /** 39: 640 * 360, frame rate 24 fps, bitrate 800 Kbps. - @note `LIVE_BROADCASTING` profile only. + /** 39: 640 × 360, frame rate 24 fps, bitrate 800 Kbps. + @note Live broadcast profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_10 = 39, - /** 100: 640 * 360, frame rate 24 fps, bitrate 1000 Kbps. - @note `LIVE_BROADCASTING` profile only. + /** 100: 640 × 360, frame rate 24 fps, bitrate 1000 Kbps. + @note Live broadcast profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_11 = 100, - /** 40: 640 * 480, frame rate 15 fps, bitrate 500 Kbps. */ + /** 40: 640 × 480, frame rate 15 fps, bitrate 500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P = 40, - /** 42: 480 * 480, frame rate 15 fps, bitrate 400 Kbps. */ + /** 42: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_3 = 42, - /** 43: 640 * 480, frame rate 30 fps, bitrate 750 Kbps. */ + /** 43: 640 × 480, frame rate 30 fps, bitrate 750 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_4 = 43, - /** 45: 480 * 480, frame rate 30 fps, bitrate 600 Kbps. */ + /** 45: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_6 = 45, - /** 47: 848 * 480, frame rate 15 fps, bitrate 610 Kbps. */ + /** 47: 848 × 480, frame rate 15 fps, bitrate 610 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_8 = 47, - /** 48: 848 * 480, frame rate 30 fps, bitrate 930 Kbps. */ + /** 48: 848 × 480, frame rate 30 fps, bitrate 930 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_9 = 48, - /** 49: 640 * 480, frame rate 10 fps, bitrate 400 Kbps. */ + /** 49: 640 × 480, frame rate 10 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_10 = 49, - /** 50: 1280 * 720, frame rate 15 fps, bitrate 1130 Kbps. */ + /** 50: 1280 × 720, frame rate 15 fps, bitrate 1130 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P = 50, - /** 52: 1280 * 720, frame rate 30 fps, bitrate 1710 Kbps. */ + /** 52: 1280 × 720, frame rate 30 fps, bitrate 1710 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_3 = 52, - /** 54: 960 * 720, frame rate 15 fps, bitrate 910 Kbps. */ + /** 54: 960 × 720, frame rate 15 fps, bitrate 910 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_5 = 54, - /** 55: 960 * 720, frame rate 30 fps, bitrate 1380 Kbps. */ + /** 55: 960 × 720, frame rate 30 fps, bitrate 1380 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_6 = 55, - /** 60: 1920 * 1080, frame rate 15 fps, bitrate 2080 Kbps. */ + /** 60: 1920 × 1080, frame rate 15 fps, bitrate 2080 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P = 60, - /** 62: 1920 * 1080, frame rate 30 fps, bitrate 3150 Kbps. */ + /** 62: 1920 × 1080, frame rate 30 fps, bitrate 3150 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P_3 = 62, - /** 64: 1920 * 1080, frame rate 60 fps, bitrate 4780 Kbps. */ + /** 64: 1920 × 1080, frame rate 60 fps, bitrate 4780 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P_5 = 64, - /** 66: 2560 * 1440, frame rate 30 fps, bitrate 4850 Kbps. */ + /** 66: 2560 × 1440, frame rate 30 fps, bitrate 4850 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1440P = 66, - /** 67: 2560 * 1440, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 67: 2560 × 1440, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1440P_2 = 67, - /** 70: 3840 * 2160, frame rate 30 fps, bitrate 6500 Kbps. */ + /** 70: 3840 × 2160, frame rate 30 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_4K = 70, - /** 72: 3840 * 2160, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 72: 3840 × 2160, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_4K_3 = 72, - /** 1000: 120 * 160, frame rate 15 fps, bitrate 65 Kbps. */ + /** 1000: 120 × 160, frame rate 15 fps, bitrate 65 Kbps. */ VIDEO_PROFILE_PORTRAIT_120P = 1000, - /** 1002: 120 * 120, frame rate 15 fps, bitrate 50 Kbps. */ + /** 1002: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ VIDEO_PROFILE_PORTRAIT_120P_3 = 1002, - /** 1010: 180 * 320, frame rate 15 fps, bitrate 140 Kbps. */ + /** 1010: 180 × 320, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P = 1010, - /** 1012: 180 * 180, frame rate 15 fps, bitrate 100 Kbps. */ + /** 1012: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P_3 = 1012, - /** 1013: 180 * 240, frame rate 15 fps, bitrate 120 Kbps. */ + /** 1013: 180 × 240, frame rate 15 fps, bitrate 120 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P_4 = 1013, - /** 1020: 240 * 320, frame rate 15 fps, bitrate 200 Kbps. */ + /** 1020: 240 × 320, frame rate 15 fps, bitrate 200 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P = 1020, - /** 1022: 240 * 240, frame rate 15 fps, bitrate 140 Kbps. */ + /** 1022: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P_3 = 1022, - /** 1023: 240 * 424, frame rate 15 fps, bitrate 220 Kbps. */ + /** 1023: 240 × 424, frame rate 15 fps, bitrate 220 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P_4 = 1023, - /** 1030: 360 * 640, frame rate 15 fps, bitrate 400 Kbps. */ + /** 1030: 360 × 640, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P = 1030, - /** 1032: 360 * 360, frame rate 15 fps, bitrate 260 Kbps. */ + /** 1032: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_3 = 1032, - /** 1033: 360 * 640, frame rate 30 fps, bitrate 600 Kbps. */ + /** 1033: 360 × 640, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_4 = 1033, - /** 1035: 360 * 360, frame rate 30 fps, bitrate 400 Kbps. */ + /** 1035: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_6 = 1035, - /** 1036: 360 * 480, frame rate 15 fps, bitrate 320 Kbps. */ + /** 1036: 360 × 480, frame rate 15 fps, bitrate 320 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_7 = 1036, - /** 1037: 360 * 480, frame rate 30 fps, bitrate 490 Kbps. */ + /** 1037: 360 × 480, frame rate 30 fps, bitrate 490 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_8 = 1037, - /** 1038: 360 * 640, frame rate 15 fps, bitrate 800 Kbps. - @note `LIVE_BROADCASTING` profile only. + /** 1038: 360 × 640, frame rate 15 fps, bitrate 800 Kbps. + @note Live broadcast profile only. */ VIDEO_PROFILE_PORTRAIT_360P_9 = 1038, - /** 1039: 360 * 640, frame rate 24 fps, bitrate 800 Kbps. - @note `LIVE_BROADCASTING` profile only. + /** 1039: 360 × 640, frame rate 24 fps, bitrate 800 Kbps. + @note Live broadcast profile only. */ VIDEO_PROFILE_PORTRAIT_360P_10 = 1039, - /** 1100: 360 * 640, frame rate 24 fps, bitrate 1000 Kbps. - @note `LIVE_BROADCASTING` profile only. + /** 1100: 360 × 640, frame rate 24 fps, bitrate 1000 Kbps. + @note Live broadcast profile only. */ VIDEO_PROFILE_PORTRAIT_360P_11 = 1100, - /** 1040: 480 * 640, frame rate 15 fps, bitrate 500 Kbps. */ + /** 1040: 480 × 640, frame rate 15 fps, bitrate 500 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P = 1040, - /** 1042: 480 * 480, frame rate 15 fps, bitrate 400 Kbps. */ + /** 1042: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_3 = 1042, - /** 1043: 480 * 640, frame rate 30 fps, bitrate 750 Kbps. */ + /** 1043: 480 × 640, frame rate 30 fps, bitrate 750 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_4 = 1043, - /** 1045: 480 * 480, frame rate 30 fps, bitrate 600 Kbps. */ + /** 1045: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_6 = 1045, - /** 1047: 480 * 848, frame rate 15 fps, bitrate 610 Kbps. */ + /** 1047: 480 × 848, frame rate 15 fps, bitrate 610 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_8 = 1047, - /** 1048: 480 * 848, frame rate 30 fps, bitrate 930 Kbps. */ + /** 1048: 480 × 848, frame rate 30 fps, bitrate 930 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_9 = 1048, - /** 1049: 480 * 640, frame rate 10 fps, bitrate 400 Kbps. */ + /** 1049: 480 × 640, frame rate 10 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_10 = 1049, - /** 1050: 720 * 1280, frame rate 15 fps, bitrate 1130 Kbps. */ + /** 1050: 720 × 1280, frame rate 15 fps, bitrate 1130 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P = 1050, - /** 1052: 720 * 1280, frame rate 30 fps, bitrate 1710 Kbps. */ + /** 1052: 720 × 1280, frame rate 30 fps, bitrate 1710 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_3 = 1052, - /** 1054: 720 * 960, frame rate 15 fps, bitrate 910 Kbps. */ + /** 1054: 720 × 960, frame rate 15 fps, bitrate 910 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_5 = 1054, - /** 1055: 720 * 960, frame rate 30 fps, bitrate 1380 Kbps. */ + /** 1055: 720 × 960, frame rate 30 fps, bitrate 1380 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_6 = 1055, - /** 1060: 1080 * 1920, frame rate 15 fps, bitrate 2080 Kbps. */ + /** 1060: 1080 × 1920, frame rate 15 fps, bitrate 2080 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P = 1060, - /** 1062: 1080 * 1920, frame rate 30 fps, bitrate 3150 Kbps. */ + /** 1062: 1080 × 1920, frame rate 30 fps, bitrate 3150 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P_3 = 1062, - /** 1064: 1080 * 1920, frame rate 60 fps, bitrate 4780 Kbps. */ + /** 1064: 1080 × 1920, frame rate 60 fps, bitrate 4780 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P_5 = 1064, - /** 1066: 1440 * 2560, frame rate 30 fps, bitrate 4850 Kbps. */ + /** 1066: 1440 × 2560, frame rate 30 fps, bitrate 4850 Kbps. */ VIDEO_PROFILE_PORTRAIT_1440P = 1066, - /** 1067: 1440 * 2560, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 1067: 1440 × 2560, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_1440P_2 = 1067, - /** 1070: 2160 * 3840, frame rate 30 fps, bitrate 6500 Kbps. */ + /** 1070: 2160 × 3840, frame rate 30 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_4K = 1070, - /** 1072: 2160 * 3840, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 1072: 2160 × 3840, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_4K_3 = 1072, - /** Default 640 * 360, frame rate 15 fps, bitrate 400 Kbps. */ + /** Default 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_DEFAULT = VIDEO_PROFILE_LANDSCAPE_360P, }; @@ -553,36 +543,35 @@ enum VIDEO_PROFILE_TYPE Sets the sample rate, bitrate, encoding mode, and the number of channels:*/ enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music codec { - /** - 0: Default audio profile: - - For the interactive streaming profile: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 64 Kbps. - - For the `COMMUNICATION` profile: - - Windows: A sample rate of 16 KHz, music encoding, mono, and a bitrate of up to 16 Kbps. - - Android/macOS/iOS: A sample rate of 32 KHz, music encoding, mono, and a bitrate of up to 18 Kbps. - */ + /** + 0: Default audio profile. + + - In the Communication profile, the default value is #AUDIO_PROFILE_SPEECH_STANDARD; + - In the Live-broadcast profile, the default value is #AUDIO_PROFILE_MUSIC_STANDARD. + */ AUDIO_PROFILE_DEFAULT = 0, // use default settings /** - 1: A sample rate of 32 KHz, audio encoding, mono, and a bitrate of up to 18 Kbps. + 1: A sample rate of 32 kHz, audio encoding, mono, and a bitrate of up to 18 Kbps. */ AUDIO_PROFILE_SPEECH_STANDARD = 1, // 32Khz, 18Kbps, mono, speech /** - 2: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 64 Kbps. + 2: A sample rate of 48 kHz, music encoding, mono, and a bitrate of up to 48 Kbps. */ AUDIO_PROFILE_MUSIC_STANDARD = 2, // 48Khz, 48Kbps, mono, music /** - 3: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 80 Kbps. + 3: A sample rate of 48 kHz, music encoding, stereo, and a bitrate of up to 56 Kbps. */ AUDIO_PROFILE_MUSIC_STANDARD_STEREO = 3, // 48Khz, 56Kbps, stereo, music /** - 4: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 96 Kbps. + 4: A sample rate of 48 kHz, music encoding, mono, and a bitrate of up to 128 Kbps. */ AUDIO_PROFILE_MUSIC_HIGH_QUALITY = 4, // 48Khz, 128Kbps, mono, music /** - 5: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 128 Kbps. + 5: A sample rate of 48 kHz, music encoding, stereo, and a bitrate of up to 192 Kbps. */ AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO = 5, // 48Khz, 192Kbps, stereo, music /** - 6: A sample rate of 16 KHz, audio encoding, mono, and Acoustic Echo Cancellation (AES) enabled. + 6: A sample rate of 16 kHz, audio encoding, mono, and Acoustic Echo Cancellation (AES) enabled. */ AUDIO_PROFILE_IOT = 6, AUDIO_PROFILE_NUM = 7, @@ -592,91 +581,55 @@ enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music code */ enum AUDIO_SCENARIO_TYPE // set a suitable scenario for your app type { - /** 0: Default audio scenario. */ + /** 0: Default. */ AUDIO_SCENARIO_DEFAULT = 0, - /** 1: Entertainment scenario where users need to frequently switch the user role. */ + /** 1: Entertainment scenario, supporting voice during gameplay. */ AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT = 1, - /** 2: Education scenario where users want smoothness and stability. */ + /** 2: Education scenario, prioritizing smoothness and stability. */ AUDIO_SCENARIO_EDUCATION = 2, - /** 3: High-quality audio chatroom scenario where hosts mainly play music. */ + /** 3: Live gaming scenario, enabling the gaming audio effects in the speaker mode in a live broadcast scenario. Choose this scenario for high-fidelity music playback. */ AUDIO_SCENARIO_GAME_STREAMING = 3, - /** 4: Showroom scenario where a single host wants high-quality audio. */ + /** 4: Showroom scenario, optimizing the audio quality with external professional equipment. */ AUDIO_SCENARIO_SHOWROOM = 4, - /** 5: Gaming scenario for group chat that only contains the human voice. */ + /** 5: Gaming scenario. */ AUDIO_SCENARIO_CHATROOM_GAMING = 5, - /** 6: IoT (Internet of Things) scenario where users use IoT devices with low power consumption. */ + /** 6: Applicable to the IoT scenario. */ AUDIO_SCENARIO_IOT = 6, - /** 8: Meeting scenario that mainly contains the human voice. - * - * @since v3.2.0 - */ - AUDIO_SCENARIO_MEETING = 8, - /** The number of elements in the enumeration. - */ - AUDIO_SCENARIO_NUM = 9, + AUDIO_SCENARIO_NUM = 7, }; - /** The channel profile. + /** Channel profiles. */ enum CHANNEL_PROFILE_TYPE { - /** (Default) Communication. This profile applies to scenarios such as an audio call or video call, - * where all users can publish and subscribe to streams. - */ - CHANNEL_PROFILE_COMMUNICATION = 0, - /** Live streaming. In this profile, uses have roles, namely, host and audience (default). - * A host both publishes and subscribes to streams, while an audience subscribes to streams only. - * This profile applies to scenarios such as a chat room or interactive video streaming. - */ - CHANNEL_PROFILE_LIVE_BROADCASTING = 1, - /** 2: Gaming. This profile uses a codec with a lower bitrate and consumes less power. Applies to the gaming scenario, where all game players can talk freely. - * - * @note Agora does not recommend using this setting. - */ + /** 0: Communication. + + This is used in one-on-one calls or group calls, where all users in the channel can talk freely. + */ + CHANNEL_PROFILE_COMMUNICATION = 0, + /** 1: Live Broadcast. + + Host and audience roles that can be set by calling the \ref IRtcEngine::setClientRole "setClientRole" method. The host sends and receives voice, while the audience receives voice only with the sending function disabled. + */ + CHANNEL_PROFILE_LIVE_BROADCASTING = 1, + /** 2: Gaming. + + @note This profile applies to the Agora Gaming SDK only. + + Any user in the channel can talk freely. This mode uses the codec with low-power consumption and low bitrate by default. + */ CHANNEL_PROFILE_GAME = 2, }; -/// @cond -/** The role of a user in a live interactive streaming. */ + +/** Client roles in a live broadcast. */ enum CLIENT_ROLE_TYPE { - /** 1: Host. A host can both send and receive streams. */ + /** 1: Host */ CLIENT_ROLE_BROADCASTER = 1, - /** 2: (Default) Audience. An `audience` member can only receive streams. */ + /** 2: Audience */ CLIENT_ROLE_AUDIENCE = 2, }; -/** The latency level of an audience member in a live interactive streaming. - * - * @note Takes effect only when the user role is `CLIENT_ROLE_BROADCASTER`. - */ -enum AUDIENCE_LATENCY_LEVEL_TYPE -{ - /** 1: Low latency. */ - AUDIENCE_LATENCY_LEVEL_LOW_LATENCY = 1, - /** 2: (Default) Ultra low latency. */ - AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY = 2, -}; -/// @cond -/** The reason why the super-resolution algorithm is not successfully enabled. - */ -enum SUPER_RESOLUTION_STATE_REASON -{ - /** 0: The super-resolution algorithm is successfully enabled. - */ - SR_STATE_REASON_SUCCESS = 0, - /** 1: The origin resolution of the remote video is beyond the range where - * the super-resolution algorithm can be applied. - */ - SR_STATE_REASON_STREAM_OVER_LIMITATION = 1, - /** 2: Another user is already using the super-resolution algorithm. - */ - SR_STATE_REASON_USER_COUNT_OVER_LIMITATION = 2, - /** 3: The device does not support the super-resolution algorithm. - */ - SR_STATE_REASON_DEVICE_NOT_SUPPORTED = 3, -}; -/// @endcond - /** Reasons for a user being offline. */ enum USER_OFFLINE_REASON_TYPE { @@ -684,7 +637,7 @@ enum USER_OFFLINE_REASON_TYPE USER_OFFLINE_QUIT = 0, /** 1: The SDK times out and the user drops offline because no data packet is received within a certain period of time. If the user quits the call and the message is not passed to the SDK (due to an unreliable channel), the SDK assumes the user dropped offline. */ USER_OFFLINE_DROPPED = 1, - /** 2: (`LIVE_BROADCASTING` only.) The client role switched from the host to the audience. */ + /** 2: (Live broadcast only.) The client role switched from the host to the audience. */ USER_OFFLINE_BECOME_AUDIENCE = 2, }; /** @@ -741,15 +694,7 @@ enum RTMP_STREAM_PUBLISH_ERROR RTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTED = 10, }; -/** Events during the RTMP streaming. */ -enum RTMP_STREAMING_EVENT -{ - /** An error occurs when you add a background image or a watermark image to the RTMP stream. - */ - RTMP_STREAMING_EVENT_FAILED_LOAD_IMAGE = 1, -}; - -/** States of importing an external video stream in the live interactive streaming. */ +/** States of importing an external video stream in a live broadcast. */ enum INJECT_STREAM_STATUS { /** 0: The external video stream imported successfully. */ @@ -784,9 +729,8 @@ enum REMOTE_VIDEO_STREAM_TYPE REMOTE_VIDEO_STREAM_LOW = 1, }; -/** The use mode of the audio data in the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" or \ref media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. - */ - enum RAW_AUDIO_FRAME_OP_MODE_TYPE +/** Use modes of the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. */ +enum RAW_AUDIO_FRAME_OP_MODE_TYPE { /** 0: Read-only mode: Users only read the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data without modifying anything. For example, when users acquire the data with the Agora SDK, then push the RTMP streams. */ RAW_AUDIO_FRAME_OP_MODE_READ_ONLY = 0, @@ -813,7 +757,7 @@ enum VIDEO_CODEC_PROFILE_TYPE VIDEO_CODEC_PROFILE_BASELINE = 66, /** 77: Main video codec profile. Generally used in mainstream electronics such as MP4 players, portable video players, PSP, and iPads. */ VIDEO_CODEC_PROFILE_MAIN = 77, - /** 100: (Default) High video codec profile. Generally used in high-resolution live streaming or television. */ + /** 100: (Default) High video codec profile. Generally used in high-resolution broadcasts or television. */ VIDEO_CODEC_PROFILE_HIGH = 100, }; @@ -829,11 +773,11 @@ enum VIDEO_CODEC_TYPE { VIDEO_CODEC_E264 = 4, }; -/** Video Codec types for publishing streams. */ -enum VIDEO_CODEC_TYPE_FOR_STREAM +/** Video Codec types. */ +enum VIDEO_CODEC_TRANSCODING_TYPE { - VIDEO_CODEC_H264_FOR_STREAM = 1, - VIDEO_CODEC_H265_FOR_STREAM = 2, + VIDEO_CODEC_H264_TRANSCODING = 1, + VIDEO_CODEC_H265_TRANSCODING = 2, }; /** Audio equalization band frequencies. */ @@ -876,410 +820,101 @@ enum AUDIO_REVERB_TYPE AUDIO_REVERB_STRENGTH = 4, // ([0,100]), the strength of the reverberation }; -/** - * @deprecated Deprecated from v3.2.0. - * - * Local voice changer options. - */ +/** Local voice changer options. */ enum VOICE_CHANGER_PRESET { - /** - * The original voice (no local voice change). - */ - VOICE_CHANGER_OFF = 0x00000000, //Turn off the voice changer - /** - * The voice of an old man. - */ - VOICE_CHANGER_OLDMAN = 0x00000001, - /** - * The voice of a little boy. - */ - VOICE_CHANGER_BABYBOY = 0x00000002, - /** - * The voice of a little girl. - */ - VOICE_CHANGER_BABYGIRL = 0x00000003, - /** - * The voice of Zhu Bajie, a character in Journey to the West who has a voice like that of a growling bear. - */ - VOICE_CHANGER_ZHUBAJIE = 0x00000004, - /** - * The ethereal voice. - */ - VOICE_CHANGER_ETHEREAL = 0x00000005, - /** - * The voice of Hulk. - */ - VOICE_CHANGER_HULK = 0x00000006, - /** - * A more vigorous voice. - */ - VOICE_BEAUTY_VIGOROUS = 0x00100001,//7, - /** - * A deeper voice. - */ - VOICE_BEAUTY_DEEP = 0x00100002, - /** - * A mellower voice. - */ - VOICE_BEAUTY_MELLOW = 0x00100003, - /** - * Falsetto. - */ - VOICE_BEAUTY_FALSETTO = 0x00100004, - /** - * A fuller voice. - */ - VOICE_BEAUTY_FULL = 0x00100005, - /** - * A clearer voice. - */ - VOICE_BEAUTY_CLEAR = 0x00100006, - /** - * A more resounding voice. - */ - VOICE_BEAUTY_RESOUNDING = 0x00100007, - /** - * A more ringing voice. - */ - VOICE_BEAUTY_RINGING = 0x00100008, - /** - * A more spatially resonant voice. - */ - VOICE_BEAUTY_SPACIAL = 0x00100009, - /** - * (For male only) A more magnetic voice. Do not use it when the speaker is a female; otherwise, voice distortion occurs. - */ - GENERAL_BEAUTY_VOICE_MALE_MAGNETIC = 0x00200001, - /** - * (For female only) A fresher voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs. - */ - GENERAL_BEAUTY_VOICE_FEMALE_FRESH = 0x00200002, - /** - * (For female only) A more vital voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs. - */ - GENERAL_BEAUTY_VOICE_FEMALE_VITALITY = 0x00200003 - + /** 0: The original voice (no local voice change). + */ + VOICE_CHANGER_OFF = 0, //Turn off the voice changer + /** 1: An old man's voice. + */ + VOICE_CHANGER_OLDMAN = 1, + /** 2: A little boy's voice. + */ + VOICE_CHANGER_BABYBOY = 2, + /** 3: A little girl's voice. + */ + VOICE_CHANGER_BABYGIRL = 3, + /** 4: The voice of a growling bear. + */ + VOICE_CHANGER_ZHUBAJIE = 4, + /** 5: Ethereal vocal effects. + */ + VOICE_CHANGER_ETHEREAL = 5, + /** 6: Hulk's voice. + */ + VOICE_CHANGER_HULK = 6 }; -/** @deprecated Deprecated from v3.2.0. - * - * Local voice reverberation presets. - */ +/** Local voice reverberation presets. */ enum AUDIO_REVERB_PRESET { - /** - * Turn off local voice reverberation, that is, to use the original voice. - */ - AUDIO_REVERB_OFF = 0x00000000, // Turn off audio reverb - /** - * The reverberation style typical of a KTV venue (enhanced). - */ - AUDIO_REVERB_FX_KTV = 0x00100001, - /** - * The reverberation style typical of a concert hall (enhanced). - */ - AUDIO_REVERB_FX_VOCAL_CONCERT = 0x00100002, - /** - * The reverberation style typical of an uncle's voice. - */ - AUDIO_REVERB_FX_UNCLE = 0x00100003, - /** - * The reverberation style typical of a little sister's voice. - */ - AUDIO_REVERB_FX_SISTER = 0x00100004, - /** - * The reverberation style typical of a recording studio (enhanced). - */ - AUDIO_REVERB_FX_STUDIO = 0x00100005, - /** - * The reverberation style typical of popular music (enhanced). - */ - AUDIO_REVERB_FX_POPULAR = 0x00100006, - /** - * The reverberation style typical of R&B music (enhanced). - */ - AUDIO_REVERB_FX_RNB = 0x00100007, - /** - * The reverberation style typical of the vintage phonograph. - */ - AUDIO_REVERB_FX_PHONOGRAPH = 0x00100008, - /** - * The reverberation style typical of popular music. - */ - AUDIO_REVERB_POPULAR = 0x00000001, - /** - * The reverberation style typical of R&B music. - */ - AUDIO_REVERB_RNB = 0x00000002, - /** - * The reverberation style typical of rock music. - */ - AUDIO_REVERB_ROCK = 0x00000003, - /** - * The reverberation style typical of hip-hop music. - */ - AUDIO_REVERB_HIPHOP = 0x00000004, - /** - * The reverberation style typical of a concert hall. - */ - AUDIO_REVERB_VOCAL_CONCERT = 0x00000005, - /** - * The reverberation style typical of a KTV venue. - */ - AUDIO_REVERB_KTV = 0x00000006, - /** - * The reverberation style typical of a recording studio. - */ - AUDIO_REVERB_STUDIO = 0x00000007, - /** - * The reverberation of the virtual stereo. The virtual stereo is an effect that renders the monophonic - * audio as the stereo audio, so that all users in the channel can hear the stereo voice effect. - * To achieve better virtual stereo reverberation, Agora recommends setting `profile` in `setAudioProfile` - * as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. - */ - AUDIO_VIRTUAL_STEREO = 0x00200001, - /** 1: Electronic Voice.*/ - AUDIO_ELECTRONIC_VOICE = 0x00300001, - /** 1: 3D Voice.*/ - AUDIO_THREEDIM_VOICE = 0x00400001 -}; -/** The options for SDK preset voice beautifier effects. - */ -enum VOICE_BEAUTIFIER_PRESET -{ - /** Turn off voice beautifier effects and use the original voice. - */ - VOICE_BEAUTIFIER_OFF = 0x00000000, - /** A more magnetic voice. - * - * @note Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may experience vocal distortion. - */ - CHAT_BEAUTIFIER_MAGNETIC = 0x01010100, - /** A fresher voice. - * - * @note Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion. - */ - CHAT_BEAUTIFIER_FRESH = 0x01010200, - /** A more vital voice. - * - * @note Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion. - */ - CHAT_BEAUTIFIER_VITALITY = 0x01010300, - /** A more vigorous voice. - */ - TIMBRE_TRANSFORMATION_VIGOROUS = 0x01030100, - /** A deeper voice. - */ - TIMBRE_TRANSFORMATION_DEEP = 0x01030200, - /** A mellower voice. - */ - TIMBRE_TRANSFORMATION_MELLOW = 0x01030300, - /** A falsetto voice. - */ - TIMBRE_TRANSFORMATION_FALSETTO = 0x01030400, - /** A falsetto voice. - */ - TIMBRE_TRANSFORMATION_FULL = 0x01030500, - /** A clearer voice. - */ - TIMBRE_TRANSFORMATION_CLEAR = 0x01030600, - /** A more resounding voice. - */ - TIMBRE_TRANSFORMATION_RESOUNDING = 0x01030700, - /** A more ringing voice. - */ - TIMBRE_TRANSFORMATION_RINGING = 0x01030800 -}; -/** The options for SDK preset audio effects. - */ -enum AUDIO_EFFECT_PRESET -{ - /** Turn off audio effects and use the original voice. - */ - AUDIO_EFFECT_OFF = 0x00000000, - /** An audio effect typical of a KTV venue. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` - * before setting this enumerator. - */ - ROOM_ACOUSTICS_KTV = 0x02010100, - /** An audio effect typical of a concert hall. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` - * before setting this enumerator. - */ - ROOM_ACOUSTICS_VOCAL_CONCERT = 0x02010200, - /** An audio effect typical of a recording studio. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` - * before setting this enumerator. - */ - ROOM_ACOUSTICS_STUDIO = 0x02010300, - /** An audio effect typical of a vintage phonograph. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` - * before setting this enumerator. - */ - ROOM_ACOUSTICS_PHONOGRAPH = 0x02010400, - /** A virtual stereo effect that renders monophonic audio as stereo audio. - * - * @note Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to - * `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this - * enumerator; otherwise, the enumerator setting does not take effect. - */ - ROOM_ACOUSTICS_VIRTUAL_STEREO = 0x02010500, - /** A more spatial audio effect. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` - * before setting this enumerator. - */ - ROOM_ACOUSTICS_SPACIAL = 0x02010600, - /** A more ethereal audio effect. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` - * before setting this enumerator. - */ - ROOM_ACOUSTICS_ETHEREAL = 0x02010700, - /** A 3D voice effect that makes the voice appear to be moving around the user. The default cycle period of the 3D - * voice effect is 10 seconds. To change the cycle period, call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" - * after this method. - * - * @note - * - Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` - * or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator; otherwise, the enumerator setting does not take effect. - * - If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect. - */ - ROOM_ACOUSTICS_3D_VOICE = 0x02010800, - /** The voice of an uncle. - * - * @note - * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. - * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - VOICE_CHANGER_EFFECT_UNCLE = 0x02020100, - /** The voice of an old man. - * - * @note - * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. - * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting - * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting - * this enumerator. - */ - VOICE_CHANGER_EFFECT_OLDMAN = 0x02020200, - /** The voice of a boy. - * - * @note - * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. - * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting - * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - VOICE_CHANGER_EFFECT_BOY = 0x02020300, - /** The voice of a young woman. - * - * @note - * - Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect. - * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting - * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - VOICE_CHANGER_EFFECT_SISTER = 0x02020400, - /** The voice of a girl. - * - * @note - * - Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect. - * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting - * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - VOICE_CHANGER_EFFECT_GIRL = 0x02020500, - /** The voice of Pig King, a character in Journey to the West who has a voice like a growling bear. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - VOICE_CHANGER_EFFECT_PIGKING = 0x02020600, - /** The voice of Hulk. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - VOICE_CHANGER_EFFECT_HULK = 0x02020700, - /** An audio effect typical of R&B music. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - STYLE_TRANSFORMATION_RNB = 0x02030100, - /** An audio effect typical of popular music. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - STYLE_TRANSFORMATION_POPULAR = 0x02030200, - /** A pitch correction effect that corrects the user's pitch based on the pitch of the natural C major scale. - * To change the basic mode and tonic pitch, call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" after this method. - * - * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before - * setting this enumerator. - */ - PITCH_CORRECTION = 0x02040100 + /** 0: The original voice (no local voice reverberation). + */ + AUDIO_REVERB_OFF = 0, // Turn off audio reverb + /** 1: Pop music. + */ + AUDIO_REVERB_POPULAR = 1, + /** 2: R&B. + */ + AUDIO_REVERB_RNB = 2, + /** 3: Rock music. + */ + AUDIO_REVERB_ROCK = 3, + /** 4: Hip-hop. + */ + AUDIO_REVERB_HIPHOP = 4, + /** 5: Pop concert. + */ + AUDIO_REVERB_VOCAL_CONCERT = 5, + /** 6: Karaoke. + */ + AUDIO_REVERB_KTV = 6, + /** 7: Recording studio. + */ + AUDIO_REVERB_STUDIO = 7 }; /** Audio codec profile types. The default value is LC_ACC. */ enum AUDIO_CODEC_PROFILE_TYPE { /** 0: LC-AAC, which is the low-complexity audio codec type. */ - AUDIO_CODEC_PROFILE_LC_AAC = 0, + AUDIO_CODEC_PROFILE_LC_AAC = 0, /** 1: HE-AAC, which is the high-efficiency audio codec type. */ - AUDIO_CODEC_PROFILE_HE_AAC = 1, + AUDIO_CODEC_PROFILE_HE_AAC = 1, }; /** Remote audio states. */ enum REMOTE_AUDIO_STATE { - /** 0: The remote audio is in the default state, probably due to - * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), - * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or - * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). - */ - REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream - /** 1: The first remote audio packet is received. - */ - REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received - /** 2: The remote audio stream is decoded and plays normally, probably - * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), - * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or - * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). - */ - REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends - /** 3: The remote audio is frozen, probably due to - * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). - */ - REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue - /** 4: The remote audio fails to start, probably due to - * #REMOTE_AUDIO_REASON_INTERNAL (0). - */ - REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed + /** 0: The remote audio is in the default state, probably due to + * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), + * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or + * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). + */ + REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream + /** 1: The first remote audio packet is received. + */ + REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received + /** 2: The remote audio stream is decoded and plays normally, probably + * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), + * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or + * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). + */ + REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends + /** 3: The remote audio is frozen, probably due to + * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). + */ + REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue + /** 4: The remote audio fails to start, probably due to + * #REMOTE_AUDIO_REASON_INTERNAL (0). + */ + REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed }; /** Remote audio state reasons. */ enum REMOTE_AUDIO_STATE_REASON { - /** 0: The SDK reports this reason when the audio state changes. + /** 0: Internal reasons. */ REMOTE_AUDIO_REASON_INTERNAL = 0, /** 1: Network congestion. @@ -1342,48 +977,18 @@ enum REMOTE_VIDEO_STATE { */ REMOTE_VIDEO_STATE_FAILED = 4 }; -/** The publishing state. - */ + enum STREAM_PUBLISH_STATE { - /** 0: The initial publishing state after joining the channel. - */ PUB_STATE_IDLE = 0, - /** 1: Fails to publish the local stream. Possible reasons: - * - The local user calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" or \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" to stop sending local streams. - * - The local user calls \ref IRtcEngine::disableAudio "disableAudio" or \ref IRtcEngine::disableVideo "disableVideo" to disable the entire audio or video module. - * - The local user calls \ref IRtcEngine::enableLocalAudio "enableLocalAudio(false)" or \ref IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local audio sampling or video capturing. - * - The role of the local user is `AUDIENCE`. - */ PUB_STATE_NO_PUBLISHED = 1, - /** 2: Publishing. - */ PUB_STATE_PUBLISHING = 2, - /** 3: Publishes successfully. - */ PUB_STATE_PUBLISHED = 3 }; -/** The subscribing state. - */ + enum STREAM_SUBSCRIBE_STATE { - /** 0: The initial subscribing state after joining the channel. - */ SUB_STATE_IDLE = 0, - /** 1: Fails to subscribe to the remote stream. Possible reasons: - * - The remote user: - * - Calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" or \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" to stop sending local streams. - * - Calls \ref IRtcEngine::disableAudio "disableAudio" or \ref IRtcEngine::disableVideo "disableVideo" to disable the entire audio or video modules. - * - Calls \ref IRtcEngine::enableLocalAudio "enableLocalAudio(false)" or \ref IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local audio sampling or video capturing. - * - The role of the remote user is `AUDIENCE`. - * - The local user calls the following methods to stop receiving remote streams: - * - Calls \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream(true)", \ref IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams(true)", or \ref IRtcEngine::setDefaultMuteAllRemoteAudioStreams "setDefaultMuteAllRemoteAudioStreams(true)" to stop receiving remote audio streams. - * - Calls \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream(true)", \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams(true)", or \ref IRtcEngine::setDefaultMuteAllRemoteVideoStreams "setDefaultMuteAllRemoteVideoStreams(true)" to stop receiving remote video streams. - */ SUB_STATE_NO_SUBSCRIBED = 1, - /** 2: Subscribing. - */ SUB_STATE_SUBSCRIBING = 2, - /** 3: Subscribes to and receives the remote stream successfully. - */ SUB_STATE_SUBSCRIBED = 3 }; @@ -1416,9 +1021,9 @@ enum XLA_REMOTE_AUDIO_FROZEN_TYPE { XLA_REMOTE_AUDIO_FROZEN_TYPE_MAX = 2, }; -/** The reason for the remote video state change. */ +/** The reason of the remote video state change. */ enum REMOTE_VIDEO_STATE_REASON { - /** 0: The SDK reports this reason when the video state changes. + /** 0: Internal reasons. */ REMOTE_VIDEO_STATE_REASON_INTERNAL = 0, @@ -1450,11 +1055,11 @@ enum REMOTE_VIDEO_STATE_REASON { */ REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE = 7, - /** 8: The remote audio-and-video stream falls back to the audio-only stream due to poor network conditions. + /** 8: The remote media stream falls back to the audio-only stream due to poor network conditions. */ REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK = 8, - /** 9: The remote audio-only stream switches back to the audio-and-video stream after the network conditions improve. + /** 9: The remote media stream switches back to the video stream after the network conditions improve. */ REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY = 9 @@ -1519,7 +1124,7 @@ enum STREAM_FALLBACK_OPTIONS STREAM_FALLBACK_OPTION_DISABLED = 0, /** 1: Under poor downlink network conditions, the remote video stream, to which you subscribe, falls back to the low-stream (low resolution and low bitrate) video. You can set this option only in the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. Nothing happens when you set this in the \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" method. */ STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW = 1, - /** 2: Under poor uplink network conditions, the published video stream falls back to audio only. + /** 2: Under poor uplink network conditions, the locally published video stream falls back to audio only. Under poor downlink network conditions, the remote video stream, to which you subscribe, first falls back to the low-stream (low resolution and low bitrate) video; and then to an audio-only stream if the network conditions worsen.*/ STREAM_FALLBACK_OPTION_AUDIO_ONLY = 2, @@ -1532,7 +1137,7 @@ enum STREAM_FALLBACK_OPTIONS /** 0: (Default) self-adapts the camera output parameters to the system performance and network conditions to balance CPU consumption and video preview quality. */ CAPTURER_OUTPUT_PREFERENCE_AUTO = 0, - /** 1: Prioritizes the system performance. The SDK chooses the dimension and frame rate of the local camera capture closest to those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". + /** 2: Prioritizes the system performance. The SDK chooses the dimension and frame rate of the local camera capture closest to those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1, /** 2: Prioritizes the local preview quality. The SDK chooses higher camera output parameters to improve the local video preview quality. This option requires extra CPU and RAM usage for video pre-processing. @@ -1611,19 +1216,13 @@ enum CONNECTION_CHANGED_REASON_TYPE CONNECTION_CHANGED_INVALID_CHANNEL_NAME = 7, /** 8: The connection failed since token is not valid, possibly because: - - The App Certificate for the project is enabled in Console, but you do not use Token when joining the channel. If you enable the App Certificate, you must use a token to join the channel. + - The App Certificate for the project is enabled in Dashboard, but you do not use Token when joining the channel. If you enable the App Certificate, you must use a token to join the channel. - The uid that you specify in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method is different from the uid that you pass for generating the token. */ CONNECTION_CHANGED_INVALID_TOKEN = 8, /** 9: The connection failed since token is expired. */ CONNECTION_CHANGED_TOKEN_EXPIRED = 9, - /** 10: The connection is rejected by server. This error usually occurs in the following situations: - * - When the user is already in the channel, and still calls the method to join the channel, for example, - * \ref IRtcEngine::joinChannel "joinChannel". - * - When the user tries to join a channel during \ref IRtcEngine::startEchoTest "startEchoTest". Once you - * call \ref IRtcEngine::startEchoTest "startEchoTest", you need to call \ref IRtcEngine::stopEchoTest "stopEchoTest" before joining a channel. - * - */ + /** 10: The connection is rejected by server. */ CONNECTION_CHANGED_REJECTED_BY_SERVER = 10, /** 11: The connection changed to reconnecting since SDK has set a proxy server. */ CONNECTION_CHANGED_SETTING_PROXY_SERVER = 11, @@ -1652,6 +1251,8 @@ enum NETWORK_TYPE NETWORK_TYPE_MOBILE_3G = 4, /** 5: The network type is mobile 4G. */ NETWORK_TYPE_MOBILE_4G = 5, + /** 6: The network type is mobile 5G. */ + NETWORK_TYPE_MOBILE_5G = 6, }; /** States of the last-mile network probe test. */ @@ -1685,19 +1286,7 @@ enum AUDIO_ROUTE_TYPE { AUDIO_ROUTE_LOUDSPEAKER = 4, /** Bluetooth headset. */ - AUDIO_ROUTE_BLUETOOTH = 5, - /** USB peripheral (macOS only). - */ - AUDIO_ROUTE_USB = 6, - /** HDMI peripheral (macOS only). - */ - AUDIO_ROUTE_HDMI = 7, - /** DisplayPort peripheral (macOS only). - */ - AUDIO_ROUTE_DISPLAYPORT = 8, - /** Apple AirPlay (macOS only). - */ - AUDIO_ROUTE_AIRPLAY = 9, + AUDIO_ROUTE_BLUETOOTH = 5 }; #if (defined(__APPLE__) && TARGET_OS_IOS) @@ -1716,22 +1305,13 @@ enum AUDIO_SESSION_OPERATION_RESTRICTION { }; #endif -#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) -enum CAMERA_DIRECTION { - /** The rear camera. */ - CAMERA_REAR = 0, - /** The front camera. */ - CAMERA_FRONT = 1, -}; -#endif - /** The uplink or downlink last-mile network probe test result. */ struct LastmileProbeOneWayResult { /** The packet loss rate (%). */ unsigned int packetLossRate; /** The network jitter (ms). */ unsigned int jitter; - /* The estimated available bandwidth (bps). */ + /* The estimated available bandwidth (Kbps). */ unsigned int availableBandwidth; }; @@ -1749,7 +1329,7 @@ struct LastmileProbeResult{ /** Configurations of the last-mile network probe test. */ struct LastmileProbeConfig { - /** Sets whether or not to test the uplink network. Some users, for example, the audience in a `LIVE_BROADCASTING` channel, do not need such a test: + /** Sets whether or not to test the uplink network. Some users, for example, the audience in a Live-broadcast channel, do not need such a test: - true: test. - false: do not test. */ bool probeUplink; @@ -1757,9 +1337,9 @@ struct LastmileProbeConfig { - true: test. - false: do not test. */ bool probeDownlink; - /** The expected maximum sending bitrate (bps) of the local user. The value ranges between 100000 and 5000000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ + /** The expected maximum sending bitrate (Kbps) of the local user. The value ranges between 100 and 5000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ unsigned int expectedUplinkBitrate; - /** The expected maximum receiving bitrate (bps) of the local user. The value ranges between 100000 and 5000000. */ + /** The expected maximum receiving bitrate (Kbps) of the local user. The value ranges between 100 and 5000. */ unsigned int expectedDownlinkBitrate; }; @@ -1769,55 +1349,38 @@ struct LastmileProbeConfig { */ struct AudioVolumeInfo { - /** - User ID of the speaker. The uid of the local user is 0. - */ + /** + User ID of the speaker. The uid of the local user is 0. The user ID may come from different RtcConnection. + */ uid_t uid; - /** The volume of the speaker. The volume ranges between 0 (lowest volume) and 255 (highest volume). - */ + /** The volume of the speaker. The volume ranges between 0 (lowest volume) and 255 (highest volume). + */ unsigned int volume; - /** Voice activity status of the local user. - * - 0: The local user is not speaking. - * - 1: The local user is speaking. - * - * @note - * - The `vad` parameter cannot report the voice activity status of the remote users. In the remote users' callback, `vad` = 0. - * - Ensure that you set `report_vad`(true) in the \ref agora::rtc::IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method to enable the voice activity detection of the local user. - */ + /** Whether current signal contains human voice. + */ unsigned int vad; /** The channel ID, which indicates which channel the speaker is in. */ const char * channelId; }; -/// @cond -/** The detailed options of a user. - */ -struct ClientRoleOptions -{ - /** The latency level of an audience member in a live interactive streaming. See #AUDIENCE_LATENCY_LEVEL_TYPE. - */ - AUDIENCE_LATENCY_LEVEL_TYPE audienceLatencyLevel; - ClientRoleOptions() - : audienceLatencyLevel(AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY) {} -}; -/// @endcond + /** Statistics of the channel. */ struct RtcStats { - /** - * Call duration of the local user in seconds, represented by an aggregate value. - */ + /** + Call duration (s), represented by an aggregate value. + */ unsigned int duration; /** - * Total number of bytes transmitted, represented by an aggregate value. + Total number of bytes transmitted, represented by an aggregate value. */ unsigned int txBytes; /** - * Total number of bytes received, represented by an aggregate value. + Total number of bytes received, represented by an aggregate value. */ unsigned int rxBytes; - /** Total number of audio bytes sent (bytes), represented + /** Total number of audio bytes sent (bytes), represented * by an aggregate value. */ unsigned int txAudioBytes; @@ -1835,80 +1398,73 @@ struct RtcStats unsigned int rxVideoBytes; /** - * Transmission bitrate (Kbps), represented by an instantaneous value. + Transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txKBitRate; /** - * Receive bitrate (Kbps), represented by an instantaneous value. + Receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxKBitRate; /** - * Audio receive bitrate (Kbps), represented by an instantaneous value. + Audio receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxAudioKBitRate; /** - * Audio transmission bitrate (Kbps), represented by an instantaneous value. + Audio transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txAudioKBitRate; /** - * Video receive bitrate (Kbps), represented by an instantaneous value. + Video receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxVideoKBitRate; /** - * Video transmission bitrate (Kbps), represented by an instantaneous value. + Video transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txVideoKBitRate; /** Client-server latency (ms) */ unsigned short lastmileDelay; /** The packet loss rate (%) from the local client to Agora's edge server, - * before using the anti-packet-loss method. + * before network countermeasures. */ unsigned short txPacketLossRate; /** The packet loss rate (%) from Agora's edge server to the local client, - * before using the anti-packet-loss method. + * before network countermeasures. */ unsigned short rxPacketLossRate; /** Number of users in the channel. - * - * - `COMMUNICATION` profile: The number of users in the channel. - * - `LIVE_BROADCASTING` profile: - * - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. - * - If the user is a host: The number of users in the channel = The number of hosts in the channel. + + - Communication profile: The number of users in the channel. + - Live broadcast profile: + + - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. + - If the user is a host: The number of users in the channel = The number of hosts in the channel. */ unsigned int userCount; /** - * Application CPU usage (%). + Application CPU usage (%). */ double cpuAppUsage; /** System CPU usage (%). - - In the multi-kernel environment, this member represents the average CPU usage. - The value **=** 100 **-** System Idle Progress in Task Manager (%). */ double cpuTotalUsage; - /** The round-trip time delay from the client to the local router. + /** gateway Rtt */ int gatewayRtt; /** - * The memory usage ratio of the app (%). - * - * @note This value is for reference only. Due to system limitations, you may not get the value of this member. + Application memory usage (%). */ double memoryAppUsageRatio; /** - * The memory usage ratio of the system (%). - * - * @note This value is for reference only. Due to system limitations, you may not get the value of this member. + System memory usage (%). */ double memoryTotalUsageRatio; /** - * The memory usage of the app (KB). - * - * @note This value is for reference only. Due to system limitations, you may not get the value of this member. + Application memory size (KB). */ int memoryAppUsageInKbytes; + RtcStats() : duration(0) , txBytes(0) @@ -1946,7 +1502,7 @@ enum QUALITY_ADAPT_INDICATION { ADAPT_DOWN_BANDWIDTH = 2, }; -/** The error code in CHANNEL_MEDIA_RELAY_ERROR. */ + enum CHANNEL_MEDIA_RELAY_ERROR { /** 0: The state is normal. */ @@ -1954,31 +1510,25 @@ enum CHANNEL_MEDIA_RELAY_ERROR { /** 1: An error occurs in the server response. */ RELAY_ERROR_SERVER_ERROR_RESPONSE = 1, - /** 2: No server response. - * - * You can call the + /** 2: No server response. You can call the * \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method to * leave the channel. - * - * This error can also occur if your project has not enabled co-host token - * authentication. Contact support@agora.io to enable the co-host token - * authentication service before starting a channel media relay. */ RELAY_ERROR_SERVER_NO_RESPONSE = 2, /** 3: The SDK fails to access the service, probably due to limited * resources of the server. */ RELAY_ERROR_NO_RESOURCE_AVAILABLE = 3, - /** 4: Fails to send the relay request. + /** 4: The server fails to join the source channel. */ RELAY_ERROR_FAILED_JOIN_SRC = 4, - /** 5: Fails to accept the relay request. + /** 5: The server fails to join the destination channel. */ RELAY_ERROR_FAILED_JOIN_DEST = 5, - /** 6: The server fails to receive the media stream. + /** 6: The server fails to receive the data from the source channel. */ RELAY_ERROR_FAILED_PACKET_RECEIVED_FROM_SRC = 6, - /** 7: The server fails to send the media stream. + /** 7: The source channel fails to transmit data. */ RELAY_ERROR_FAILED_PACKET_SENT_TO_DEST = 7, /** 8: The SDK disconnects from the server due to poor network @@ -1997,7 +1547,6 @@ enum CHANNEL_MEDIA_RELAY_ERROR { RELAY_ERROR_DEST_TOKEN_EXPIRED = 11, }; -/** The event code in CHANNEL_MEDIA_RELAY_EVENT. */ enum CHANNEL_MEDIA_RELAY_EVENT { /** 0: The user disconnects from the server due to poor network * connections. @@ -2039,11 +1588,8 @@ enum CHANNEL_MEDIA_RELAY_EVENT { RELAY_EVENT_VIDEO_PROFILE_UPDATE = 11, }; -/** The state code in CHANNEL_MEDIA_RELAY_STATE. */ enum CHANNEL_MEDIA_RELAY_STATE { - /** 0: The initial state. After you successfully stop the channel media - * relay by calling \ref IRtcEngine::stopChannelMediaRelay "stopChannelMediaRelay", - * the \ref IRtcEngineEventHandler::onChannelMediaRelayStateChanged "onChannelMediaRelayStateChanged" callback returns this state. + /** 0: The SDK is initializing. */ RELAY_STATE_IDLE = 0, /** 1: The SDK tries to relay the media stream to the destination channel. @@ -2063,11 +1609,11 @@ enum CHANNEL_MEDIA_RELAY_STATE { struct LocalVideoStats { /** Bitrate (Kbps) sent in the reported interval, which does not include - * the bitrate of the retransmission video after packet loss. + * the bitrate of the re-transmission video after packet loss. */ int sentBitrate; /** Frame rate (fps) sent in the reported interval, which does not include - * the frame rate of the retransmission video after packet loss. + * the frame rate of the re-transmission video after packet loss. */ int sentFrameRate; /** The encoder output frame rate (fps) of the local video. @@ -2096,7 +1642,7 @@ struct LocalVideoStats /** The height of the encoding frame (px). */ int encodedFrameHeight; - /** The value of the sent frames, represented by an aggregate value. + /** The value of the sent frame rate, represented by an aggregate value. */ int encodedFrameCount; /** The codec type of the local video: @@ -2104,73 +1650,71 @@ struct LocalVideoStats * - VIDEO_CODEC_H264 = 2: (Default) H.264. */ VIDEO_CODEC_TYPE codecType; - /** The video packet loss rate (%) from the local client to the Agora edge server before applying the anti-packet loss strategies. - */ + + /** The packet loss rate (%) from the local client to Agora's edge server, + * before network countermeasures. + */ unsigned short txPacketLossRate; /** The capture frame rate (fps) of the local video. */ int captureFrameRate; + /** The PSNR point to show the quality of video, nomal level is in [20,40]. + */ + int videoQualityPoint; }; /** Statistics of the remote video stream. */ struct RemoteVideoStats { -/** + /** User ID of the remote user sending the video streams. */ -uid_t uid; -/** **DEPRECATED** Time delay (ms). - * - * In scenarios where audio and video is synchronized, you can use the value of - * `networkTransportDelay` and `jitterBufferDelay` in `RemoteAudioStats` to know the delay statistics of the remote video. - */ -int delay; -/** Width (pixels) of the video stream. + uid_t uid; + /** **DEPRECATED** Time delay (ms). */ -int width; + int delay; /** + Width (pixels) of the video stream. + */ + int width; + /** Height (pixels) of the video stream. */ -int height; -/** + int height; + /** Bitrate (Kbps) received since the last count. */ -int receivedBitrate; -/** The decoder output frame rate (fps) of the remote video. - */ -int decoderOutputFrameRate; -/** The render output frame rate (fps) of the remote video. - */ -int rendererOutputFrameRate; -/** Packet loss rate (%) of the remote video stream after using the anti-packet-loss method. - */ -int packetLossRate; -/** The type of the remote video stream: #REMOTE_VIDEO_STREAM_TYPE - */ -REMOTE_VIDEO_STREAM_TYPE rxStreamType; -/** - The total freeze time (ms) of the remote video stream after the remote user joins the channel. - In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when - the time interval between two adjacent renderable video frames is more than 500 ms. - */ -int totalFrozenTime; -/** - The total video freeze time as a percentage (%) of the total time when the video is available. - */ -int frozenRate; -/** - The total time (ms) when the remote user in the Communication profile or the remote - broadcaster in the Live-broadcast profile neither stops sending the video stream nor - disables the video module after joining the channel. - - @since v3.0.1 -*/ -int totalActiveTime; -/** - * The total publish duration (ms) of the remote video stream. - */ -int publishDuration; + int receivedBitrate; + /** The decoder output frame rate (fps) of the remote video. + */ + int decoderOutputFrameRate; + /** The render output frame rate (fps) of the remote video. + */ + int rendererOutputFrameRate; + /** Packet loss rate (%) of the remote video stream after network + * countermeasures. + */ + int packetLossRate; + REMOTE_VIDEO_STREAM_TYPE rxStreamType; + /** + The total freeze time (ms) of the remote video stream after the remote user joins the channel. + In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when + the time interval between two adjacent renderable video frames is more than 500 ms. + */ + int totalFrozenTime; + /** + The total video freeze time as a percentage (%) of the total time when the video is available. + */ + int frozenRate; + /** + * The total active time (ms) of the remote video stream after the remote user joins the channel. + */ + int totalActiveTime; + /** + * The total active time (ms) of the remote video stream after the remote user publish the video stream. + */ + int publishDuration; }; /** Audio statistics of the local user */ @@ -2185,7 +1729,8 @@ struct LocalAudioStats /** The average sending bitrate (Kbps). */ int sentBitrate; - /** The audio packet loss rate (%) from the local client to the Agora edge server before applying the anti-packet loss strategies. + /** The packet loss rate (%) from the local client to Agora's edge server, + * before network countermeasures. */ unsigned short txPacketLossRate; }; @@ -2206,7 +1751,7 @@ struct RemoteAudioStats /** Network delay (ms) from the receiver to the jitter buffer. */ int jitterBufferDelay; - /** The audio frame loss rate in the reported interval. + /** Packet loss rate in the reported interval. */ int audioLossRate; /** The number of channels. @@ -2220,16 +1765,17 @@ struct RemoteAudioStats * reported interval. */ int receivedBitrate; /** The total freeze time (ms) of the remote audio stream after the remote user joins the channel. In a session, audio freeze occurs when the audio frame loss rate reaches 4%. + * Agora uses 2 seconds as an audio piece unit to calculate the audio freeze time. The total audio freeze time = The audio freeze number × 2 seconds */ int totalFrozenTime; /** The total audio freeze time as a percentage (%) of the total time when the audio is available. */ int frozenRate; - /** The total time (ms) when the remote user in the `COMMUNICATION` profile or the remote host in - the `LIVE_BROADCASTING` profile neither stops sending the audio stream nor disables the audio module after joining the channel. + /** + * The total active time (ms) of the remote audio stream after the remote user joins the channel. */ int totalActiveTime; /** - * The total publish duration (ms) of the remote audio stream. + * The total active time (ms) of the remote audio stream after the remote user publish the audio stream. */ int publishDuration; }; @@ -2252,17 +1798,17 @@ struct VideoDimensions { /** (Recommended) The standard bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. - In this mode, the bitrates differ between the live interactive streaming and communication profiles: + In this mode, the bitrates differ between the live broadcast and communication profiles: - - `COMMUNICATION` profile: The video bitrate is the same as the base bitrate. - - `LIVE_BROADCASTING` profile: The video bitrate is twice the base bitrate. + - Communication profile: The video bitrate is the same as the base bitrate. + - Live broadcast profile: The video bitrate is twice the base bitrate. */ const int STANDARD_BITRATE = 0; /** The compatible bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. - The bitrate remains the same regardless of the channel profile. If you choose this mode in the `LIVE_BROADCASTING` profile, the video frame rate may be lower than the set value. + The bitrate remains the same regardless of the channel profile. If you choose this mode in the Live-broadcast profile, the video frame rate may be lower than the set value. */ const int COMPATIBLE_BITRATE = -1; @@ -2289,51 +1835,48 @@ struct VideoEncoderConfiguration { Choose one of the following options: - #STANDARD_BITRATE: (Recommended) The standard bitrate. - - the `COMMUNICATION` profile: the encoding bitrate equals the base bitrate. - - the `LIVE_BROADCASTING` profile: the encoding bitrate is twice the base bitrate. + - The Communication profile: the encoding bitrate equals the base bitrate. + - The Live-broadcast profile: the encoding bitrate is twice the base bitrate. - #COMPATIBLE_BITRATE: The compatible bitrate: the bitrate stays the same regardless of the profile. - the `COMMUNICATION` profile prioritizes smoothness, while the `LIVE_BROADCASTING` profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. - - The following table lists the recommended video encoder configurations, where the base bitrate applies to the `COMMUNICATION` profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. + The Communication profile prioritizes smoothness, while the Live-broadcast profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. - @note - In the following table, **Base Bitrate** applies to the `COMMUNICATION` profile, and **Live Bitrate** applies to the `LIVE_BROADCASTING` profile. + The following table lists the recommended video encoder configurations, where the base bitrate applies to the Communication profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. - | Resolution | Frame Rate (fps) | Base Bitrate (Kbps) | Live Bitrate (Kbps) | + | Resolution | Frame Rate (fps) | Base Bitrate (Kbps, for Communication) | Live Bitrate (Kbps, for Live Broadcast)| |------------------------|------------------|----------------------------------------|----------------------------------------| - | 160 * 120 | 15 | 65 | 130 | - | 120 * 120 | 15 | 50 | 100 | - | 320 * 180 | 15 | 140 | 280 | - | 180 * 180 | 15 | 100 | 200 | - | 240 * 180 | 15 | 120 | 240 | - | 320 * 240 | 15 | 200 | 400 | - | 240 * 240 | 15 | 140 | 280 | - | 424 * 240 | 15 | 220 | 440 | - | 640 * 360 | 15 | 400 | 800 | - | 360 * 360 | 15 | 260 | 520 | - | 640 * 360 | 30 | 600 | 1200 | - | 360 * 360 | 30 | 400 | 800 | - | 480 * 360 | 15 | 320 | 640 | - | 480 * 360 | 30 | 490 | 980 | - | 640 * 480 | 15 | 500 | 1000 | - | 480 * 480 | 15 | 400 | 800 | - | 640 * 480 | 30 | 750 | 1500 | - | 480 * 480 | 30 | 600 | 1200 | - | 848 * 480 | 15 | 610 | 1220 | - | 848 * 480 | 30 | 930 | 1860 | - | 640 * 480 | 10 | 400 | 800 | - | 1280 * 720 | 15 | 1130 | 2260 | - | 1280 * 720 | 30 | 1710 | 3420 | - | 960 * 720 | 15 | 910 | 1820 | - | 960 * 720 | 30 | 1380 | 2760 | - | 1920 * 1080 | 15 | 2080 | 4160 | - | 1920 * 1080 | 30 | 3150 | 6300 | - | 1920 * 1080 | 60 | 4780 | 6500 | - | 2560 * 1440 | 30 | 4850 | 6500 | - | 2560 * 1440 | 60 | 6500 | 6500 | - | 3840 * 2160 | 30 | 6500 | 6500 | - | 3840 * 2160 | 60 | 6500 | 6500 | + | 160 × 120 | 15 | 65 | 130 | + | 120 × 120 | 15 | 50 | 100 | + | 320 × 180 | 15 | 140 | 280 | + | 180 × 180 | 15 | 100 | 200 | + | 240 × 180 | 15 | 120 | 240 | + | 320 × 240 | 15 | 200 | 400 | + | 240 × 240 | 15 | 140 | 280 | + | 424 × 240 | 15 | 220 | 440 | + | 640 × 360 | 15 | 400 | 800 | + | 360 × 360 | 15 | 260 | 520 | + | 640 × 360 | 30 | 600 | 1200 | + | 360 × 360 | 30 | 400 | 800 | + | 480 × 360 | 15 | 320 | 640 | + | 480 × 360 | 30 | 490 | 980 | + | 640 × 480 | 15 | 500 | 1000 | + | 480 × 480 | 15 | 400 | 800 | + | 640 × 480 | 30 | 750 | 1500 | + | 480 × 480 | 30 | 600 | 1200 | + | 848 × 480 | 15 | 610 | 1220 | + | 848 × 480 | 30 | 930 | 1860 | + | 640 × 480 | 10 | 400 | 800 | + | 1280 × 720 | 15 | 1130 | 2260 | + | 1280 × 720 | 30 | 1710 | 3420 | + | 960 × 720 | 15 | 910 | 1820 | + | 960 × 720 | 30 | 1380 | 2760 | + | 1920 × 1080 | 15 | 2080 | 4160 | + | 1920 × 1080 | 30 | 3150 | 6300 | + | 1920 × 1080 | 60 | 4780 | 6500 | + | 2560 × 1440 | 30 | 4850 | 6500 | + | 2560 × 1440 | 60 | 6500 | 6500 | + | 3840 × 2160 | 30 | 6500 | 6500 | + | 3840 × 2160 | 60 | 6500 | 6500 | */ int bitrate; @@ -2341,13 +1884,13 @@ struct VideoEncoderConfiguration { The SDK automatically adjusts the encoding bitrate to adapt to the network conditions. Using a value greater than the default value forces the video encoder to output high-quality images but may cause more packet loss and hence sacrifice the smoothness of the video transmission. That said, unless you have special requirements for image quality, Agora does not recommend changing this value. - @note This parameter applies only to the `LIVE_BROADCASTING` profile. + @note This parameter applies only to the Live-broadcast profile. */ int minBitrate; /** The video orientation mode of the video: #ORIENTATION_MODE. */ ORIENTATION_MODE orientationMode; - /** The video encoding degradation preference under limited bandwidth: #DEGRADATION_PREFERENCE. + /** the video encoding degradation preference under limited bandwidth: #DEGRADATION_PREFERENCE. */ DEGRADATION_PREFERENCE degradationPreference; /** Sets the mirror mode of the published local video stream. It only affects the video that the remote user sees. See #VIDEO_MIRROR_MODE_TYPE @@ -2355,7 +1898,6 @@ struct VideoEncoderConfiguration { @note: The SDK disables the mirror mode by default. */ VIDEO_MIRROR_MODE_TYPE mirrorMode; - VideoEncoderConfiguration( const VideoDimensions& d, FRAME_RATE f, int b, ORIENTATION_MODE m, VIDEO_MIRROR_MODE_TYPE mr = VIDEO_MIRROR_MODE_AUTO) @@ -2383,37 +1925,37 @@ struct VideoEncoderConfiguration { {} }; -/** The video and audio properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. +/** The video properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. */ typedef struct TranscodingUser { /** User ID of the user displaying the video in the CDN live. */ uid_t uid; -/** Horizontal position (pixel) of the video frame relative to the top left corner. +/** Horizontal position from the top left corner of the video frame. */ int x; - /** Vertical position (pixel) of the video frame relative to the top left corner. + /** Vertical position from the top left corner of the video frame. */ int y; - /** Width (pixel) of the video frame. The default value is 360. + /** Width of the video frame. The default value is 360. */ int width; - /** Height (pixel) of the video frame. The default value is 640. + /** Height of the video frame. The default value is 640. */ int height; - /** The layer index of the video frame. An integer. The value range is [0, 100]. + /** Layer position of the video frame. The value ranges between 0 and 100. - - 0: (Default) Bottom layer. - - 100: Top layer. + - 0: (Default) Lowest + - 100: Highest @note - If zOrder is beyond this range, the SDK reports #ERR_INVALID_ARGUMENT. - As of v2.3, the SDK supports zOrder = 0. */ int zOrder; - /** The transparency level of the user's video. The value ranges between 0 and 1.0: + /** Transparency of the video frame in CDN live. The value ranges between 0 and 1.0: - 0: Completely transparent - 1.0: (Default) Opaque @@ -2421,12 +1963,12 @@ typedef struct TranscodingUser { double alpha; /** The audio channel of the sound. The default value is 0: - - 0: (Default) Supports dual channels at most, depending on the upstream of the host. - - 1: The audio stream of the host uses the FL audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. - - 2: The audio stream of the host uses the FC audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. - - 3: The audio stream of the host uses the FR audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. - - 4: The audio stream of the host uses the BL audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. - - 5: The audio stream of the host uses the BR audio channel. If the upstream of the host uses multiple audio channels, these channels are mixed into mono first. + - 0: (Default) Supports dual channels at most, depending on the upstream of the broadcaster. + - 1: The audio stream of the broadcaster uses the FL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 2: The audio stream of the broadcaster uses the FC audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 3: The audio stream of the broadcaster uses the FR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 4: The audio stream of the broadcaster uses the BL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 5: The audio stream of the broadcaster uses the BR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. @note If your setting is not 0, you may need a specialized player. */ @@ -2456,61 +1998,35 @@ typedef struct RtcImage { width(0), height(0) {} - /** HTTP/HTTPS URL address of the image on the live video. The maximum length of this parameter is 1024 bytes. */ + /** HTTP/HTTPS URL address of the image on the broadcasting video. The maximum length of this parameter is 1024 bytes. */ const char* url; - /** Horizontal position of the image from the upper left of the live video. */ + /** Horizontal position of the image from the upper left of the broadcasting video. */ int x; - /** Vertical position of the image from the upper left of the live video. */ + /** Vertical position of the image from the upper left of the broadcasting video. */ int y; - /** Width of the image on the live video. */ + /** Width of the image on the broadcasting video. */ int width; - /** Height of the image on the live video. */ + /** Height of the image on the broadcasting video. */ int height; } RtcImage; -/// @cond -/** The configuration for advanced features of the RTMP streaming with transcoding. - */ -typedef struct LiveStreamAdvancedFeature { - LiveStreamAdvancedFeature() : featureName(NULL) , opened(false) { - } - /** The advanced feature for high-quality video with a lower bitrate. */ - const char* LBHQ = "lbhq"; - /** The advanced feature for the optimized video encoder. */ - const char* VEO = "veo"; - - /** The name of the advanced feature. It contains LBHQ and VEO. - */ - const char* featureName; - - /** Whether to enable the advanced feature: - * - true: Enable the advanced feature. - * - false: (Default) Disable the advanced feature. - */ - bool opened; -} LiveStreamAdvancedFeature; -/// @endcond /** A struct for managing CDN live audio/video transcoding settings. */ typedef struct LiveTranscoding { - /** The width of the video in pixels. The default value is 360. - * - When pushing video streams to the CDN, ensure that `width` is at least 64; otherwise, the Agora server adjusts the value to 64. - * - When pushing audio streams to the CDN, set `width` and `height` as 0. - */ + /** Width of the video. The default value is 360. The minimum value of width × height is 16 × 16. + */ int width; - /** The height of the video in pixels. The default value is 640. - * - When pushing video streams to the CDN, ensure that `height` is at least 64; otherwise, the Agora server adjusts the value to 64. - * - When pushing audio streams to the CDN, set `width` and `height` as 0. + /** Height of the video. The default value is 640. The minimum value of width × height is 16 × 16. */ int height; /** Bitrate of the CDN live output video stream. The default value is 400 Kbps. - Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. + Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. */ int videoBitrate; - /** Frame rate of the output video stream set for the CDN live streaming. The default value is 15 fps, and the value range is (0,30]. + /** Frame rate of the output video stream set for the CDN live broadcast. The default value is 15 fps. - @note The Agora server adjusts any value over 30 to 30. + @note Agora adjusts all values over 30 to 30. */ int videoFramerate; @@ -2526,17 +2042,17 @@ typedef struct LiveTranscoding { int videoGop; /** Self-defined video codec profile: #VIDEO_CODEC_PROFILE_TYPE. - @note If you set this parameter to other values, Agora adjusts it to the default value of 100. + @note If you set this parameter to other values, Agora adjusts it to the default value of 100. */ VIDEO_CODEC_PROFILE_TYPE videoCodecProfile; - /** The background color in RGB hex value. Value only. Do not include a preceeding #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). + /** The background color in RGB hex value. Value only, do not include a #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). */ unsigned int backgroundColor; /** video codec type */ - VIDEO_CODEC_TYPE_FOR_STREAM videoCodecType; + VIDEO_CODEC_TRANSCODING_TYPE videoCodecType; - /** The number of users in the live interactive streaming. + /** The number of users in the live broadcast. */ unsigned int userCount; /** TranscodingUser @@ -2544,16 +2060,16 @@ typedef struct LiveTranscoding { TranscodingUser *transcodingUsers; /** Reserved property. Extra user-defined information to send SEI for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 Bytes. - For more information on SEI frame, see [SEI-related questions](https://docs.agora.io/en/faq/sei). + For more information on SEI frame, see [SEI-related questions](https://docs.agora.io/cn/Agora%20Platform/live_related_faq?platform=%E7%9B%B4%E6%92%AD%E7%9B%B8%E5%85%B3#sei). */ const char *transcodingExtraInfo; - /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or HTTP-FLV metadata. + /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or FLV metadata. */ const char *metadata; /** The watermark image added to the CDN live publishing stream. - Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. + Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. */ RtcImage* watermark; /** The background image added to the CDN live publishing stream. @@ -2567,29 +2083,21 @@ typedef struct LiveTranscoding { /** Bitrate of the CDN live audio output stream. The default value is 48 Kbps, and the highest value is 128. */ int audioBitrate; - /** The numbder of audio channels for the CDN live stream. Agora recommends choosing 1 (mono), or 2 (stereo) audio channels. Special players are required if you choose option 3, 4, or 5: + /** Agora's self-defined audio-channel types. We recommend choosing option 1 or 2. A special player is required if you choose option 3, 4, or 5: - - 1: (Default) Mono. - - 2: Stereo. - - 3: Three audio channels. - - 4: Four audio channels. - - 5: Five audio channels. + - 1: (Default) Mono + - 2: Two-channel stereo + - 3: Three-channel stereo + - 4: Four-channel stereo + - 5: Five-channel stereo */ int audioChannels; /** Self-defined audio codec profile: #AUDIO_CODEC_PROFILE_TYPE. */ AUDIO_CODEC_PROFILE_TYPE audioCodecProfile; - /// @cond - /** Advanced features of the RTMP streaming with transcoding. See LiveStreamAdvancedFeature. - * - * @since v3.1.0 - */ - LiveStreamAdvancedFeature* advancedFeatures; - /** The number of enabled advanced features. The default value is 0. */ - unsigned int advancedFeatureCount; - /// @endcond + LiveTranscoding() : width(360) , height(640) @@ -2599,7 +2107,7 @@ typedef struct LiveTranscoding { , videoGop(30) , videoCodecProfile(VIDEO_CODEC_PROFILE_HIGH) , backgroundColor(0x000000) - , videoCodecType(VIDEO_CODEC_H264_FOR_STREAM) + , videoCodecType(VIDEO_CODEC_H264_TRANSCODING) , userCount(0) , transcodingUsers(NULL) , transcodingExtraInfo(NULL) @@ -2610,8 +2118,6 @@ typedef struct LiveTranscoding { , audioBitrate(48) , audioChannels(1) , audioCodecProfile(AUDIO_CODEC_PROFILE_LC_AAC) - , advancedFeatures(NULL) - , advancedFeatureCount(0) {} } LiveTranscoding; @@ -2619,46 +2125,41 @@ typedef struct LiveTranscoding { */ struct CameraCapturerConfiguration{ - /** Camera capturer preference settings. See: #CAPTURER_OUTPUT_PREFERENCE. */ + /** Camera capturer preference settings.See: #CAPTURER_OUTPUT_PREFERENCE. */ CAPTURER_OUTPUT_PREFERENCE preference; - #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) - /** Camera direction settings (for Android/iOS only). See: #CAMERA_DIRECTION. */ - CAMERA_DIRECTION cameraDirection; - #endif }; -/** Configuration of the injected media stream. +/** Configuration of the imported live broadcast voice or video stream. */ struct InjectStreamConfig { - /** Width of the injected stream in the live interactive streaming. The default value is 0 (same width as the original stream). + /** Width of the added stream in the live broadcast. The default value is 0 (same width as the original stream). */ int width; - /** Height of the injected stream in the live interactive streaming. The default value is 0 (same height as the original stream). + /** Height of the added stream in the live broadcast. The default value is 0 (same height as the original stream). */ int height; - /** Video GOP (in frames) of the injected stream in the live interactive streaming. The default value is 30 fps. + /** Video GOP of the added stream in the live broadcast in frames. The default value is 30 fps. */ int videoGop; - /** Video frame rate of the injected stream in the live interactive streaming. The default value is 15 fps. + /** Video frame rate of the added stream in the live broadcast. The default value is 15 fps. */ int videoFramerate; - /** Video bitrate of the injected stream in the live interactive streaming. The default value is 400 Kbps. + /** Video bitrate of the added stream in the live broadcast. The default value is 400 Kbps. @note The setting of the video bitrate is closely linked to the resolution. If the video bitrate you set is beyond a reasonable range, the SDK sets it within a reasonable range. */ int videoBitrate; - /** Audio-sample rate of the injected stream in the live interactive streaming: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. + /** Audio-sample rate of the added stream in the live broadcast: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. @note We recommend setting the default value. */ AUDIO_SAMPLE_RATE_TYPE audioSampleRate; - /** Audio bitrate of the injected stream in the live interactive streaming. The default value is 48. + /** Audio bitrate of the added stream in the live broadcast. The default value is 48. @note We recommend setting the default value. */ int audioBitrate; - /** Audio channels in the live interactive streaming. - + /** Audio channels in the live broadcast. - 1: (Default) Mono - 2: Two-channel stereo @@ -2682,45 +2183,50 @@ struct InjectStreamConfig { /** The definition of ChannelMediaInfo. */ struct ChannelMediaInfo { - /** The channel name. + /** The channel name. The default value is NULL, which means that the SDK + * applies the current channel name. */ - const char* channelName; - /** The token that enables the user to join the channel. + const char* channelName; + /** The token that enables the user to join the channel. The default value + * is NULL, which means that the SDK applies the current token. */ - const char* token; + const char* token; /** The user ID. + * + * @note + * String user accounts are not supported in media stream relay. */ - uid_t uid; + uid_t uid; }; /** The definition of ChannelMediaRelayConfiguration. */ struct ChannelMediaRelayConfiguration { - /** Pointer to the information of the source channel: ChannelMediaInfo. It contains the following members: - * - `channelName`: The name of the source channel. The default value is `NULL`, which means the SDK applies the name of the current channel. - * - `uid`: The unique ID to identify the relay stream in the source channel. The default value is 0, which means the SDK generates a random UID. You must set it as 0. - * - `token`: The token for joining the source channel. It is generated with the `channelName` and `uid` you set in `srcInfo`. - * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. - * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`, and the `uid` must be set as 0. - */ - ChannelMediaInfo *srcInfo; - /** Pointer to the information of the destination channel: ChannelMediaInfo. It contains the following members: - * - `channelName`: The name of the destination channel. - * - `uid`: The unique ID to identify the relay stream in the destination channel. The value ranges from 0 to (232-1). - * To avoid UID conflicts, this `uid` must be different from any other UIDs in the destination channel. The default - * value is 0, which means the SDK generates a random UID. Do not set this parameter as the `uid` of the host in - * the destination channel, and ensure that this `uid` is different from any other `uid` in the channel. - * - `token`: The token for joining the destination channel. It is generated with the `channelName` and `uid` you set in `destInfos`. - * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. - * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`. - */ - ChannelMediaInfo *destInfos; + /** Pointer to the source channel: ChannelMediaInfo. + * + * @note + * - `uid`: ID of the user whose media stream you want to relay. We + * recommend setting it as 0, which means that the SDK relays the media + * stream of the current broadcaster. + * - If you do not use a token, we recommend using the default values of + * the parameters in ChannelMediaInfo. + * - If you use a token, set uid as 0, and ensure that the token is + * generated with the uid set as 0. + */ + ChannelMediaInfo *srcInfo; + /** Pointer to the destination channel: ChannelMediaInfo. If you want to + * relay the media stream to multiple channels, define as many + * ChannelMediaInfo structs (at most four). + * + * @note `uid`: ID of the user who is in the source channel. + */ + ChannelMediaInfo *destInfos; /** The number of destination channels. The default value is 0, and the * value range is [0,4). Ensure that the value of this parameter * corresponds to the number of ChannelMediaInfo structs you define in * `destInfos`. */ - int destCount; + int destCount; ChannelMediaRelayConfiguration() : srcInfo(nullptr) @@ -2735,10 +2241,10 @@ enum RTMP_STREAM_LIFE_CYCLE_TYPE { /** Bind to the channel lifecycle. If all hosts leave the channel, the CDN live streaming stops after 30 seconds. */ - RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, + RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, /** Bind to the owner of the RTMP stream. If the owner leaves the channel, the CDN live streaming stops immediately. */ - RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, + RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, }; /** Content hints for screen sharing. @@ -2756,8 +2262,8 @@ enum VideoContentHint CONTENT_HINT_DETAILS }; -/** The relative location of the region to the screen or window. - */ + /** The relative location of the region to the screen or window. + */ struct Rectangle { /** The horizontal offset from the top-left corner. @@ -2796,119 +2302,63 @@ typedef struct Rect { Rect(int t, int l, int b, int r): top(t), left(l), bottom(b), right(r) {} } Rect; -/** The options of the watermark image to be added. */ -typedef struct WatermarkOptions { - /** Sets whether or not the watermark image is visible in the local video preview: - * - true: (Default) The watermark image is visible in preview. - * - false: The watermark image is not visible in preview. - */ - bool visibleInPreview; - /** - * The watermark position in the landscape mode. See Rectangle. - * For detailed information on the landscape mode, see the advanced guide *Video Rotation*. - */ - Rectangle positionInLandscapeMode; - /** - * The watermark position in the portrait mode. See Rectangle. - * For detailed information on the portrait mode, see the advanced guide *Video Rotation*. - */ - Rectangle positionInPortraitMode; - - WatermarkOptions() - : visibleInPreview(true) - , positionInLandscapeMode(0, 0, 0, 0) - , positionInPortraitMode(0, 0, 0, 0) - {} -} WatermarkOptions; - /** Screen sharing encoding parameters. */ struct ScreenCaptureParameters { - /** The maximum encoding dimensions of the shared region in terms of width * height. + /** The maximum encoding dimensions of the shared region in terms of width × height. - The default value is 1920 * 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. + The default value is 1920 × 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. - If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: + If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: - - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 * 1000, the SDK uses 1000 * 1000 for encoding. - - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 * 1500, the SDK uses the maximum value under 1920 * 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 * 1080. + - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 × 1000, the SDK uses 1000 × 1000 for encoding. + - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 × 1500, the SDK uses the maximum value under 1920 × 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 × 1080. */ VideoDimensions dimensions; /** The frame rate (fps) of the shared region. - The default value is 5. We do not recommend setting this to a value greater than 15. + The default value is 5. We do not recommend setting this to a value greater than 15. */ int frameRate; /** The bitrate (Kbps) of the shared region. - The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). + The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). */ int bitrate; /** Sets whether or not to capture the mouse for screen sharing: - - true: (Default) Capture the mouse. - - false: Do not capture the mouse. + - true: (Default) Capture the mouse. + - false: Do not capture the mouse. */ bool captureMouseCursor; - /** Whether to bring the window to the front when calling \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" to share the window: - * - true: Bring the window to the front. - * - false: (Default) Do not bring the window to the front. - */ - bool windowFocus; - /** A list of IDs of windows to be blocked. - * - * When calling \ref IRtcEngine::startScreenCaptureByScreenRect "startScreenCaptureByScreenRect" to start screen sharing, you can use this parameter to block the specified windows. - * When calling \ref IRtcEngine::updateScreenCaptureParameters "updateScreenCaptureParameters" to update the configuration for screen sharing, you can use this parameter to dynamically block the specified windows during screen sharing. - */ - view_t* excludeWindowList; - /** The number of windows to be blocked. - */ - int excludeWindowCount; - ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true), windowFocus(false), excludeWindowList(NULL), excludeWindowCount(0) {} - ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c, bool focus, view_t *ex = NULL, int cnt = 0) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c), windowFocus(focus), excludeWindowList(ex), excludeWindowCount(cnt) {} - ScreenCaptureParameters(int width, int height, int f, int b, bool c, bool focus, view_t *ex = NULL, int cnt = 0) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c), windowFocus(focus), excludeWindowList(ex), excludeWindowCount(cnt) {} + ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true) {} + ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c) {} + ScreenCaptureParameters(int width, int height, int f, int b, bool c) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c) {} }; /** Video display settings of the VideoCanvas class. */ struct VideoCanvas { - /** Video display window (view). - */ + /** Video display window (view). + */ view_t view; - /** The rendering mode of the video view. See #RENDER_MODE_TYPE - */ + /** Video display mode: #RENDER_MODE_TYPE. + */ int renderMode; - /** The unique channel name for the AgoraRTC session in the string format. The string length must be less than 64 bytes. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". - - @note - - The default value is the empty string "". Use the default value if the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IRtcEngine class. The `VideoCanvas` struct defines the video canvas of the user in the channel. - - If the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IChannel class, set this parameter as the `channelId` of the `IChannel` object. The `VideoCanvas` struct defines the video canvas of the user in the channel with the specified channel ID. + /** Channel ID of the User ID. If NULL, it means the default channelId joined. */ char channelId[MAX_CHANNEL_ID_LENGTH]; - /** The user ID. */ uid_t uid; void *priv; // private data (underlying video engine denotes it) - /** The mirror mode of the video view. See VIDEO_MIRROR_MODE_TYPE - @note - - For the mirror mode of the local video view: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. - - For the mirror mode of the remote video view: The SDK disables the mirror mode by default. - */ - VIDEO_MIRROR_MODE_TYPE mirrorMode; VideoCanvas() : view(NULL) , renderMode(RENDER_MODE_HIDDEN) , uid(0) , priv(NULL) - , mirrorMode(VIDEO_MIRROR_MODE_AUTO) { channelId[0] = '\0'; } @@ -2917,38 +2367,19 @@ struct VideoCanvas , renderMode(m) , uid(u) , priv(NULL) - , mirrorMode(VIDEO_MIRROR_MODE_AUTO) { channelId[0] = '\0'; } VideoCanvas(view_t v, int m, const char *ch, uid_t u) - : view(v) - , renderMode(m) - , uid(u) - , priv(NULL) - , mirrorMode(VIDEO_MIRROR_MODE_AUTO) - { - strncpy(channelId, ch, MAX_CHANNEL_ID_LENGTH); - channelId[MAX_CHANNEL_ID_LENGTH - 1] = '\0'; - } - VideoCanvas(view_t v, int rm, uid_t u, VIDEO_MIRROR_MODE_TYPE mm) - : view(v) - , renderMode(rm) - , uid(u) - , priv(NULL) - , mirrorMode(mm) - { - channelId[0] = '\0'; - } - VideoCanvas(view_t v, int rm, const char *ch, uid_t u, VIDEO_MIRROR_MODE_TYPE mm) - : view(v) - , renderMode(rm) - , uid(u) - , priv(NULL) - , mirrorMode(mm) + : view(v) + , renderMode(m) + , uid(u) + , priv(NULL) { - strncpy(channelId, ch, MAX_CHANNEL_ID_LENGTH); - channelId[MAX_CHANNEL_ID_LENGTH - 1] = '\0'; + if (strlen(ch) >= MAX_CHANNEL_ID_LENGTH) + return; + memcpy(channelId, ch, strlen(ch)); + channelId[strlen(ch)] = '\0'; } }; @@ -2995,17 +2426,8 @@ BeautyOptions() lighteningContrastLevel(LIGHTENING_CONTRAST_NORMAL) {} }; -/** - * The UserInfo struct. - */ struct UserInfo { - /** - * The user ID. - */ uid_t uid; - /** - * The user account. - */ char userAccount[MAX_USER_ACCOUNT_LENGTH]; UserInfo() : uid(0) { @@ -3013,52 +2435,6 @@ struct UserInfo { } }; -/** - * Regions for connetion. - */ -enum AREA_CODE { - /** - * Mainland China. - */ - AREA_CODE_CN = 0x00000001, - /** - * North America. - */ - AREA_CODE_NA = 0x00000002, - /** - * Europe. - */ - AREA_CODE_EU = 0x00000004, - /** - * Asia, excluding Mainland China. - */ - AREA_CODE_AS = 0x00000008, - /** - * Japan. - */ - AREA_CODE_JP = 0x00000010, - /** - * India. - */ - AREA_CODE_IN = 0x00000020, - /** - * (Default) Global. - */ - AREA_CODE_GLOB = 0xFFFFFFFF -}; - -enum ENCRYPTION_CONFIG { - /** - * - 1: Force set master key and mode; - * - 0: Not force set, checking whether encryption plugin exists - */ - ENCRYPTION_FORCE_SETTING = (1 << 0), - /** - * - 1: Force not encrypting packet; - * - 0: Not force encrypting; - */ - ENCRYPTION_FORCE_DISABLE_PACKET = (1 << 1) -}; /** Definition of IPacketObserver. */ class IPacketObserver @@ -3066,162 +2442,48 @@ class IPacketObserver public: /** Definition of Packet. */ - struct Packet - { + struct Packet + { /** Buffer address of the sent or received data. - * @note Agora recommends that the value of buffer is more than 2048 bytes, otherwise, you may meet undefined behaviors such as a crash. */ - const unsigned char* buffer; + const unsigned char* buffer; /** Buffer size of the sent or received data. */ - unsigned int size; - }; - /** Occurs when the local user sends an audio packet. + unsigned int size; + }; + /** Occurs when the local user sends an audio packet. @param packet The sent audio packet. See Packet. @return - true: The audio packet is sent successfully. - false: The audio packet is discarded. */ - virtual bool onSendAudioPacket(Packet& packet) = 0; - /** Occurs when the local user sends a video packet. + virtual bool onSendAudioPacket(Packet& packet) = 0; + /** Occurs when the local user sends a video packet. @param packet The sent video packet. See Packet. @return - true: The video packet is sent successfully. - false: The video packet is discarded. */ - virtual bool onSendVideoPacket(Packet& packet) = 0; - /** Occurs when the local user receives an audio packet. + virtual bool onSendVideoPacket(Packet& packet) = 0; + /** Occurs when the local user receives an audio packet. @param packet The received audio packet. See Packet. @return - true: The audio packet is received successfully. - false: The audio packet is discarded. - */ - virtual bool onReceiveAudioPacket(Packet& packet) = 0; - /** Occurs when the local user receives a video packet. + */ + virtual bool onReceiveAudioPacket(Packet& packet) = 0; + /** Occurs when the local user receives a video packet. @param packet The received video packet. See Packet. @return - true: The video packet is received successfully. - false: The video packet is discarded. - */ - virtual bool onReceiveVideoPacket(Packet& packet) = 0; -}; - - -#if defined(_WIN32) -/** The capture type of the custom video source. - */ -enum VIDEO_CAPTURE_TYPE { - /** Unknown type. - */ - VIDEO_CAPTURE_UNKNOWN, - /** (Default) Video captured by the camera. - */ - VIDEO_CAPTURE_CAMERA, - /** Video for screen sharing. - */ - VIDEO_CAPTURE_SCREEN, -}; - -/** The IVideoFrameConsumer class. The SDK uses it to receive the video frame that you capture. - */ -class IVideoFrameConsumer { -public: - /** Receives the raw video frame. - * - * @note Ensure that the video frame type that you specify in this method is the same as that in the \ref agora::rtc::IVideoSource::getBufferType "getBufferType" callback. - * - * @param buffer The video buffer. - * @param frameType The video frame type. See \ref agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT "VIDEO_PIXEL_FORMAT". - * @param width The width (px) of the video frame. - * @param height The height (px) of the video frame. - * @param rotation The angle (degree) at which the video frame rotates clockwise. If you set the rotation angle, the - * SDK rotates the video frame after receiving it. You can set the rotation angle as `0`, `90`, `180`, and `270`. - * @param timestamp The Unix timestamp (ms) of the video frame. You must set a timestamp for each video frame. - */ - virtual void consumeRawVideoFrame(const unsigned char *buffer, agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT frameType, int width, int height, int rotation, long timestamp) = 0; -}; - -/** The IVideoSource class. You can use it to customize the video source. - */ -class IVideoSource { -public: - /** Notification for initializing the custom video source. - * - * The SDK triggers this callback to remind you to initialize the custom video source. After receiving this callback, - * you can do some preparation, such as enabling the camera, and then use the return value to tell the SDK whether the - * custom video source is prepared. - * - * @param consumer An IVideoFrameConsumer object that the SDK passes to you. You need to reserve this object and use it - * to send the video frame to the SDK once the custom video source is started. See IVideoFrameConsumer. - * - * @return - * - true: The custom video source is initialized. - * - false: The custom video source is not ready or fails to initialize. The SDK stops and reports the error. - */ - virtual bool onInitialize(IVideoFrameConsumer *consumer) = 0; - - /** Notification for disabling the custom video source. - * - * The SDK triggers this callback to remind you to disable the custom video source device. This callback tells you - * that the SDK is about to release the IVideoFrameConsumer object. Ensure that you no longer use IVideoFrameConsumer - * after receiving this callback. - */ - virtual void onDispose() = 0; - - /** Notification for starting the custom video source. - * - * The SDK triggers this callback to remind you to start the custom video source for capturing video. The SDK uses - * IVideoFrameConsumer to receive the video frame that you capture after the video source is started. You must use - * the return value to tell the SDK whether the custom video source is started. - * - * @return - * - true: The custom video source is started. - * - false: The custom video source fails to start. The SDK stops and reports the error. - */ - virtual bool onStart() = 0; - - /** Notification for stopping capturing video. - * - * The SDK triggers this callback to remind you to stop capturing video. This callback tells you that the SDK is about - * to stop using IVideoFrameConsumer to receive the video frame that you capture. - */ - virtual void onStop() = 0; - - /** Gets the video frame type. - * - * Before you initialize the custom video source, the SDK triggers this callback to query the video frame type. You - * must specify the video frame type in the return value and then pass it to the SDK. - * - * @note Ensure that the video frame type that you specify in this callback is the same as that in the \ref agora::rtc::IVideoFrameConsumer::consumeRawVideoFrame "consumeRawVideoFrame" method. - * - * @return \ref agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT "VIDEO_PIXEL_FORMAT" - */ - virtual agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT getBufferType() = 0; - /** Gets the capture type of the custom video source. - * - * Before you initialize the custom video source, the SDK triggers this callback to query the capture type of the video source. - * You must specify the capture type in the return value and then pass it to the SDK. The SDK enables the corresponding video - * processing algorithm according to the capture type after receiving the video frame. - * - * @return #VIDEO_CAPTURE_TYPE - */ - virtual VIDEO_CAPTURE_TYPE getVideoCaptureType() = 0; - /** Gets the content hint of the custom video source. - * - * If you specify the custom video source as a screen-sharing video, the SDK triggers this callback to query the - * content hint of the video source before you initialize the video source. You must specify the content hint in the - * return value and then pass it to the SDK. The SDK enables the corresponding video processing algorithm according - * to the content hint after receiving the video frame. - * - * @return \ref agora::rtc::VideoContentHint "VideoContentHint" - */ - virtual VideoContentHint getVideoContentHint() = 0; + */ + virtual bool onReceiveVideoPacket(Packet& packet) = 0; }; -#endif /** The SDK uses the IRtcEngineEventHandler interface class to send callbacks to the application. The application inherits the methods of this interface class to retrieve these callbacks. @@ -3258,7 +2520,7 @@ class IRtcEngineEventHandler (void)msg; } - /** Occurs when a user joins a channel. + /** Occurs when a user joins a specified channel. This callback notifies the application that a user joins a specified channel when the application calls the \ref IRtcEngine::joinChannel "joinChannel" method. @@ -3302,7 +2564,7 @@ class IRtcEngineEventHandler (void)stats; } - /** Occurs when the user role switches in the live interactive streaming. For example, from a host to an audience or vice versa. + /** Occurs when the user role switches in a live broadcast. For example, from a host to an audience or vice versa. This callback notifies the application of a user role switch when the application calls the \ref IRtcEngine::setClientRole "setClientRole" method. @@ -3313,10 +2575,10 @@ class IRtcEngineEventHandler virtual void onClientRoleChanged(CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { } - /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) joins the channel. + /** Occurs when a user or host joins the channel. - - `COMMUNICATION` profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. - - `LIVE_BROADCASTING` profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + - Communication profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - Live-broadcast profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. The SDK triggers this callback under one of the following circumstances: - A remote user/host joins the channel by calling the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. @@ -3324,7 +2586,7 @@ class IRtcEngineEventHandler - A remote user/host rejoins the channel after a network interruption. - The host injects an online media stream into the channel by calling the \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method. - @note In the `LIVE_BROADCASTING` profile: + @note In the Live-broadcast profile: - The host receives this callback when another host joins the channel. - The audience in the channel receives this callback when a new host joins the channel. - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. @@ -3337,12 +2599,12 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) leaves the channel. + /** Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel. Reasons why the user is offline: - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. - - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using the Agora RTM SDK for more reliable offline detection. + - Drop offline: When no data packet of the user or host is received for a certain period of time (20 seconds for the Communication profile, and more for the Live-broadcast profile), the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using a signaling system for more reliable offline detection. @param uid User ID of the user leaving the channel or going offline. @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. @@ -3384,7 +2646,7 @@ class IRtcEngineEventHandler - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. - If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. + For both callbacks, the SDK tries to reconnect to the server until the application calls the \ref IRtcEngine::leaveChannel "leaveChannel" method. */ virtual void onConnectionInterrupted() {} @@ -3398,7 +2660,7 @@ class IRtcEngineEventHandler - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. - If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. + For both callbacks, the SDK tries to reconnect to the server until the application calls the \ref IRtcEngine::leaveChannel "leaveChannel" method. */ virtual void onConnectionLost() {} @@ -3423,12 +2685,9 @@ class IRtcEngineEventHandler /** Occurs when the token expires. - After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses - connection with the Agora server due to network issues, the token may expire after a certain period of time and a - new token may be required to reconnect to the server. + After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. - Once you receive this callback, generate a new token on your app server, and call - \ref agora::rtc::IRtcEngine::renewToken "renewToken" to pass the new token to the SDK. + This callback notifies the application to generate a new token. Call the \ref IRtcEngine::renewToken "renewToken" method to renew the token. */ virtual void onRequestToken() { } @@ -3461,11 +2720,10 @@ class IRtcEngineEventHandler (void)lost; } - /** Reports the statistics of the current call. - - The SDK triggers this callback once every two seconds after the user joins the channel. - - @param stats Statistics of the IRtcEngine: RtcStats. + /** Reports the statistics of the current call session once every two + * seconds. + * + * @param stats Pointer to the RTC engine statistics: RtcStats. */ virtual void onRtcStats(const RtcStats& stats) { (void)stats; @@ -3476,7 +2734,7 @@ class IRtcEngineEventHandler Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. - @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 * 480 and a frame rate of 15 fps in the `LIVE_BROADCASTING` profile, but may be inadequate for resolutions higher than 1280 * 720. See #QUALITY_TYPE. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 × 480 and a frame rate of 15 fps in the Live-broadcast profile, but may be inadequate for resolutions higher than 1280 × 720. See #QUALITY_TYPE. @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. */ virtual void onNetworkQuality(uid_t uid, int txQuality, int rxQuality) { @@ -3485,22 +2743,21 @@ class IRtcEngineEventHandler (void)rxQuality; } - /** Reports the statistics of the local video stream. + /** Reports the statistics of the local video streams. * * The SDK triggers this callback once every two seconds for each * user/host. If there are multiple users/hosts in the channel, the SDK * triggers this callback as many times. * * @note - * If you have called the - * \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" - * method, the \ref onLocalVideoStats() "onLocalVideoStats" callback - * reports the statistics of the high-video + * If you have called the \ref agora::rtc::IRtcEngine::enableDualStream + * "enableDualStream" method, the \ref onLocalVideoStats() + * "onLocalVideoStats" callback reports the statistics of the high-video * stream (high bitrate, and high-resolution video stream). * * @param stats Statistics of the local video stream. See LocalVideoStats. */ - virtual void onLocalVideoStats(const LocalVideoStats& stats) { + virtual void onLocalVideoStats(const LocalVideoStats& stats) { (void)stats; } @@ -3541,6 +2798,7 @@ class IRtcEngineEventHandler } /** Occurs when the local audio state changes. + * * This callback indicates the state change of the local audio stream, * including the state of the audio recording and encoding, and allows * you to troubleshoot issues when exceptions occur. @@ -3559,17 +2817,16 @@ class IRtcEngineEventHandler } /** Occurs when the remote audio state changes. - - This callback indicates the state change of the remote audio stream. - @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. - - @param uid ID of the remote user whose audio state changes. - @param state State of the remote audio. See #REMOTE_AUDIO_STATE. - @param reason The reason of the remote audio state change. - See #REMOTE_AUDIO_STATE_REASON. - @param elapsed Time elapsed (ms) from the local user calling the - \ref IRtcEngine::joinChannel "joinChannel" method until the SDK - triggers this callback. + * + * This callback indicates the state change of the remote audio stream. + * + * @param uid ID of the remote user whose audio state changes. + * @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + * @param reason The reason of the remote audio state change. + * See #REMOTE_AUDIO_STATE_REASON. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK + * triggers this callback. */ virtual void onRemoteAudioStateChanged(uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { (void)uid; @@ -3578,55 +2835,21 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when the audio publishing state changes. - * - * @since v3.1.0 - * - * This callback indicates the publishing state change of the local audio stream. - * - * @param channel The channel name. - * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onAudioPublishStateChanged(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + virtual void onAudioPublishStateChange(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)channel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - /** Occurs when the video publishing state changes. - * - * @since v3.1.0 - * - * This callback indicates the publishing state change of the local video stream. - * - * @param channel The channel name. - * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onVideoPublishStateChanged(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + virtual void onVideoPublishStateChange(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)channel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - /** Occurs when the audio subscribing state changes. - * - * @since v3.1.0 - * - * This callback indicates the subscribing state change of a remote audio stream. - * - * @param channel The channel name. - * @param uid The ID of the remote user. - * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onAudioSubscribeStateChanged(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + virtual void onAudioSubscribeStateChange(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)channel; (void)uid; (void)oldState; @@ -3634,19 +2857,7 @@ class IRtcEngineEventHandler (void)elapseSinceLastState; } - /** Occurs when the audio subscribing state changes. - * - * @since v3.1.0 - * - * This callback indicates the subscribing state change of a remote video stream. - * - * @param channel The channel name. - * @param uid The ID of the remote user. - * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. - * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. - */ - virtual void onVideoSubscribeStateChanged(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + virtual void onVideoSubscribeStateChange(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)channel; (void)uid; (void)oldState; @@ -3654,40 +2865,27 @@ class IRtcEngineEventHandler (void)elapseSinceLastState; } - /** Reports which users are speaking, the speakers' volume and whether the local user is speaking. + /** Reports which users are speaking and the speakers' volume. + + This callback reports the ID and volume of the loudest speakers at the moment in the channel. - This callback reports the IDs and volumes of the loudest speakers (at most 3 users) at the moment in the channel, and whether the local user is speaking. + This callback is disabled by default and can be enabled by the \ref IRtcEngine::enableAudioVolumeIndication "enableAudioVolumeIndication" method. - By default, this callback is disabled. You can enable it by calling the \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication" method. - Once enabled, this callback is triggered at the set interval, regardless of whether a user speaks or not. + The local user has a dedicated *onAudioVolumeIndication* callback; all remote speakers share a separate *onAudioVolumeIndication* callback. + - For the local user's callback, the @p speakers array has @p uid = 0 and @p volume = @p totalVolume. @p speakerNumber = 1 whether or not the local user speaks. + - For the remote speakers' callback, the @p speakers array includes the user ID and volume of the loudest speakers in the channel. - The SDK triggers two independent `onAudioVolumeIndication` callbacks at one time, which separately report the volume information of the local user and all the remote speakers. - For more information, see the detailed parameter descriptions. + The audio volume returned in this callback includes the voice volume and audio-mixing volume of the remote user. @note - - To enable the voice activity detection of the local user, ensure that you set `report_vad`(true) in the `enableAudioVolumeIndication` method. - Calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method affects the SDK's behavior: - If the local user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method, the SDK stops triggering the local user's callback. - - 20 seconds after a remote speaker calls the *muteLocalAudioStream* method, the remote speakers' callback excludes this remote user's information; 20 seconds after all remote users call the *muteLocalAudioStream* method, the SDK stops triggering the remote speakers' callback. + - 15 seconds after a remote speaker calls the *muteLocalAudioStream* method, the remote speakers' callback excludes this remote user's information; 15 seconds after all remote users call the *muteLocalAudioStream* method, the SDK stops triggering the remote speakers' callback. - An empty @p speakers array in the *onAudioVolumeIndication* callback suggests that no remote user is speaking at the moment. - @param speakers A pointer to AudioVolumeInfo: - - In the local user's callback, this struct contains the following members: - - `uid` = 0, - - `volume` = `totalVolume`, which reports the sum of the voice volume and audio-mixing volume of the local user, and - - `vad`, which reports the voice activity status of the local user. - - In the remote speakers' callback, this array contains the following members: - - `uid` of the remote speaker, - - `volume`, which reports the sum of the voice volume and audio-mixing volume of each remote speaker, and - - `vad` = 0. - - An empty speakers array in the callback indicates that no remote user is speaking at the moment. - @param speakerNumber Total number of speakers. The value range is [0, 3]. - - In the local user’s callback, `speakerNumber` = 1, regardless of whether the local user speaks or not. - - In the remote speakers' callback, the callback reports the IDs and volumes of the three loudest speakers when there are more than three remote users in the channel, and `speakerNumber` = 3. + @param speakers A pointer to AudioVolumeInfo, a struct containing each speaker's user ID and volume information. + @param speakerNumber Total number of speakers. @param totalVolume Total volume after audio mixing. The value ranges between 0 (lowest volume) and 255 (highest volume). - - In the local user’s callback, `totalVolume` is the sum of the voice volume and audio-mixing volume of the local user. - - In the remote speakers' callback, `totalVolume` is the sum of the voice volume and audio-mixing volume of all the remote speakers. */ virtual void onAudioVolumeIndication(const AudioVolumeInfo* speakers, unsigned int speakerNumber, int totalVolume) { (void)speakers; @@ -3695,17 +2893,15 @@ class IRtcEngineEventHandler (void)totalVolume; } - /** Occurs when the most active speaker is detected. + /** Reports which user is the loudest speaker. - After a successful call of \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication", - the SDK continuously detects which remote user has the loudest volume. During the current period, the remote user, - who is detected as the loudest for the most times, is the most active user. + If the user enables the audio volume indication by calling the \ref IRtcEngine::enableAudioVolumeIndication "enableAudioVolumeIndication" method, this callback returns the @p uid of the active speaker detected by the audio volume detection module of the SDK. - When the number of user is no less than two and an active speaker exists, the SDK triggers this callback and reports the `uid` of the most active speaker. - - If the most active speaker is always the same user, the SDK triggers this callback only once. - - If the most active speaker changes to another user, the SDK triggers this callback again and reports the `uid` of the new active speaker. + @note + - To receive this callback, you need to call the \ref IRtcEngine::enableAudioVolumeIndication "enableAudioVolumeIndication" method. + - This callback returns the user ID of the user with the highest voice volume during a period of time, instead of at the moment. - @param uid The user ID of the most active speaker. + @param uid User ID of the active speaker. A @p uid of 0 represents the local user. */ virtual void onActiveSpeaker(uid_t uid) { (void)uid; @@ -3715,14 +2911,14 @@ class IRtcEngineEventHandler The application can use this callback to change the configuration of the view (for example, displaying other pictures in the view) after the video stops playing. - Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_STOPPED(0) in the \ref agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_STOPPED(0) in the agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. */ virtual void onVideoStopped() {} - /** Occurs when the first local video frame is displayed/rendered on the local video view. + /** Occurs when the engine receives and renders the first local video frame on the video window. - @param width Width (px) of the first local video frame. - @param height Height (px) of the first local video frame. + @param width Width (pixels) of the first local video frame. + @param height Height (pixels) of the first local video frame. @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. If you call the \ref IRtcEngine::startPreview "startPreview" method before calling the *joinChannel* method, then @p elapsed is the time elapsed from calling the *startPreview* method until the SDK triggers this callback. */ @@ -3732,25 +2928,9 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when the first video frame is published. - * - * @since v3.1.0 - * - * The SDK triggers this callback under one of the following circumstances: - * - The local client enables the video module and calls \ref IRtcEngine::joinChannel "joinChannel" successfully. - * - The local client calls \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" and \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(false)" in sequence. - * - The local client calls \ref IRtcEngine::disableVideo "disableVideo" and \ref IRtcEngine::enableVideo "enableVideo" in sequence. - * - * @param elapsed The time elapsed (ms) from the local client calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. - */ - virtual void onFirstLocalVideoFramePublished(int elapsed) { - (void)elapsed; - } - /** Occurs when the first remote video frame is received and decoded. * - * @deprecated v2.9.0 - * + * @deprecated * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -3774,8 +2954,8 @@ class IRtcEngineEventHandler * The application can configure the user view settings in this callback. * * @param uid User ID of the remote user sending the video stream. - * @param width Width (px) of the video stream. - * @param height Height (px) of the video stream. + * @param width Width (pixels) of the video stream. + * @param height Height (pixels) of the video stream. * @param elapsed Time elapsed (ms) from the local user calling the * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK * triggers this callback. @@ -3788,12 +2968,13 @@ class IRtcEngineEventHandler } /** Occurs when the first remote video frame is rendered. - The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. - @param uid User ID of the remote user sending the video stream. - @param width Width (px) of the video frame. - @param height Height (px) of the video stream. - @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. + + @param uid User ID of the remote user sending the video stream. + @param width Width (pixels) of the video frame. + @param height Height (pixels) of the video stream. + @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. */ virtual void onFirstRemoteVideoFrame(uid_t uid, int width, int height, int elapsed) { (void)uid; @@ -3802,13 +2983,10 @@ class IRtcEngineEventHandler (void)elapsed; } - /** @deprecated This method is deprecated from v3.0.0, use the \ref agora::rtc::IRtcEngineEventHandler::onRemoteAudioStateChanged "onRemoteAudioStateChanged" callback instead. - - Occurs when a remote user's audio stream playback pauses/resumes. + /** Occurs when a remote user's audio stream is muted/unmuted. - The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. - - @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. + @note This callback returns invalid when the number of users in a channel exceeds 20. @param uid User ID of the remote user. @param muted Whether the remote user's audio stream is muted/unmuted: @@ -3822,7 +3000,8 @@ class IRtcEngineEventHandler /** Occurs when a remote user's video stream playback pauses/resumes. * - * You can also use the + * @deprecated + * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: * - #REMOTE_VIDEO_STATE_STOPPED (0) and @@ -3835,7 +3014,8 @@ class IRtcEngineEventHandler * \ref agora::rtc::IRtcEngine::muteLocalVideoStream * "muteLocalVideoStream" method. * - * @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + * @note This callback returns invalid when the number of users in a + * channel exceeds 20. * * @param uid User ID of the remote user. * @param muted Whether the remote user's video stream playback is @@ -3851,8 +3031,7 @@ class IRtcEngineEventHandler /** Occurs when a specific remote user enables/disables the video * module. * - * @deprecated v2.9.0 - * + * @deprecated * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -3917,16 +3096,13 @@ class IRtcEngineEventHandler If the camera fails to turn on, fix the error reported in the \ref IRtcEngineEventHandler::onError "onError" callback. - Deprecated as of v2.4.1. Use #LOCAL_VIDEO_STREAM_STATE_CAPTURING (1) in the \ref agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_CAPTURING(1) in the agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. */ virtual void onCameraReady() {} /** Occurs when the camera focus area changes. - The SDK triggers this callback when the local user changes the camera focus position by calling the setCameraFocusPositionInPreview method. - - @note This callback is for Android and iOS only. - + The SDK triggers this callback when the local user changes the camera focus position by calling the setCameraFocusPositionInPreview method. @param x x coordinate of the changed camera focus area. @param y y coordinate of the changed camera focus area. @param width Width of the changed camera focus area. @@ -3938,47 +3114,10 @@ class IRtcEngineEventHandler (void)width; (void)height; } -#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) - /** - * Reports the face detection result of the local user. Applies to Android and iOS only. - * @since v3.0.1 - * - * Once you enable face detection by calling \ref IRtcEngine::enableFaceDetection "enableFaceDetection"(true), you can get the following information on the local user in real-time: - * - The width and height of the local video. - * - The position of the human face in the local video. - * - The distance between the human face and the device screen. This value is based on the fitting calculation of the local video size and the position of the human face. - * - * @note - * - If the SDK does not detect a face, it reduces the frequency of this callback to reduce power consumption on the local device. - * - The SDK stops triggering this callback when a human face is in close proximity to the screen. - * - On Android, the `distance` value reported in this callback may be slightly different from the actual distance. Therefore, Agora does not recommend using it for - * accurate calculation. - * @param imageWidth The width (px) of the local video. - * @param imageHeight The height (px) of the local video. - * @param vecRectangle The position and size of the human face on the local video: - * - `x`: The x coordinate (px) of the human face in the local video. Taking the top left corner of the captured video as the origin, - * the x coordinate represents the relative lateral displacement of the top left corner of the human face to the origin. - * - `y`: The y coordinate (px) of the human face in the local video. Taking the top left corner of the captured video as the origin, - * the y coordinate represents the relative longitudinal displacement of the top left corner of the human face to the origin. - * - `width`: The width (px) of the human face in the captured video. - * - `height`: The height (px) of the human face in the captured video. - * @param vecDistance The distance (cm) between the human face and the screen. - * @param numFaces The number of faces detected. If the value is 0, it means that no human face is detected. - */ - virtual void onFacePositionChanged(int imageWidth, int imageHeight, Rectangle* vecRectangle, int* vecDistance, int numFaces){ - (void)imageWidth; - (void)imageHeight; - (void)vecRectangle; - (void)vecDistance; - (void)numFaces; - } -#endif + /** Occurs when the camera exposure area changes. The SDK triggers this callback when the local user changes the camera exposure position by calling the setCameraExposurePosition method. - - @note This callback is for Android and iOS only. - @param x x coordinate of the changed camera exposure area. @param y y coordinate of the changed camera exposure area. @param width Width of the changed camera exposure area. @@ -4005,14 +3144,13 @@ class IRtcEngineEventHandler /** Occurs when the state of the local user's audio mixing file changes. - When you call the \ref IRtcEngine::startAudioMixing "startAudioMixing" method and the state of audio mixing file changes, the SDK triggers this callback. - - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. - - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. - - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. + - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. + - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. + - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - @param state The state code. See #AUDIO_MIXING_STATE_TYPE. - @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. - */ + @param state The state code. See #AUDIO_MIXING_STATE_TYPE. + @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. + */ virtual void onAudioMixingStateChanged(AUDIO_MIXING_STATE_TYPE state, AUDIO_MIXING_ERROR_TYPE errorCode){ } /** Occurs when a remote user starts audio mixing. @@ -4039,18 +3177,14 @@ class IRtcEngineEventHandler /** Occurs when the SDK decodes the first remote audio frame for playback. - @deprecated v3.0.0 - - This callback is deprecated. Use `onRemoteAudioStateChanged` instead. - This callback is triggered in either of the following scenarios: - The remote user joins the channel and sends the audio stream. - The remote user stops sending the audio stream and re-sends it after 15 seconds. Reasons for such an interruption include: - - The remote user leaves channel. - - The remote user drops offline. - - The remote user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method to stop sending the local audio stream. - - The remote user calls the \ref agora::rtc::IRtcEngine::disableAudio "disableAudio" method to disable audio. + - The remote user leaves channel. + - The remote user drops offline. + - The remote user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method to stop sending the local audio stream. + - The remote user calls the \ref agora::rtc::IRtcEngine::disableAudio "disableAudio" method to disable audio. @param uid User ID of the remote user sending the audio stream. @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. @@ -4076,12 +3210,10 @@ class IRtcEngineEventHandler /** Occurs when the local video stream state changes. - This callback indicates the state of the local video stream, including camera capturing and video encoding, and allows you to troubleshoot issues when exceptions occur. + @note This callback indicates the state of the local video stream, including camera capturing and video encoding, and allows you to troubleshoot issues when exceptions occur. - @note For some device models, the SDK will not trigger this callback when the state of the local video changes while the local video capturing device is in use, so you have to make your own timeout judgment. - - @param localVideoState State type #LOCAL_VIDEO_STREAM_STATE. When the state is LOCAL_VIDEO_STREAM_STATE_FAILED (3), see the `error` parameter for details. - @param error The detailed error information: #LOCAL_VIDEO_STREAM_ERROR. + @param localVideoState State type #LOCAL_VIDEO_STREAM_STATE. When the state is LOCAL_VIDEO_STREAM_STATE_FAILED (3), see the *error* parameter for details. + @param error The detailed error information. code #LOCAL_VIDEO_STREAM_ERROR. */ virtual void onLocalVideoStateChanged(LOCAL_VIDEO_STREAM_STATE localVideoState, LOCAL_VIDEO_STREAM_ERROR error) { (void)localVideoState; @@ -4102,15 +3234,14 @@ class IRtcEngineEventHandler (void)rotation; } /** Occurs when the remote video state changes. - @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. - - @param uid ID of the remote user whose video state changes. - @param state State of the remote video. See #REMOTE_VIDEO_STATE. - @param reason The reason of the remote video state change. See - #REMOTE_VIDEO_STATE_REASON. - @param elapsed Time elapsed (ms) from the local user calling the - \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the - SDK triggers this callback. + * + * @param uid ID of the remote user whose video state changes. + * @param state State of the remote video. See #REMOTE_VIDEO_STATE. + * @param reason The reason of the remote video state change. See + * #REMOTE_VIDEO_STATE_REASON. + * @param elapsed Time elapsed (ms) from the local user calling the + * \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the + * SDK triggers this callback. */ virtual void onRemoteVideoStateChanged(uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { (void)uid; @@ -4119,11 +3250,10 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a specified remote user enables/disables the local video + /** Occurs when a specified remote user enables/disables the local video * capturing function. * - * @deprecated v2.9.0 - * + * @deprecated * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -4172,7 +3302,7 @@ class IRtcEngineEventHandler /** Occurs when the local user does not receive the data stream from the remote user within five seconds. - The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. + The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. @param uid User ID of the remote user sending the message. @param streamId Stream ID. @param code Error code: #ERROR_CODE_TYPE. @@ -4193,27 +3323,6 @@ class IRtcEngineEventHandler /** Occurs when the media engine call starts.*/ virtual void onMediaEngineStartCallSuccess() { } - /// @cond - /** Reports whether the super-resolution algorithm is enabled. - * - * @since v3.2.0 - * - * After calling \ref IRtcEngine::enableRemoteSuperResolution "enableRemoteSuperResolution", the SDK triggers this - * callback to report whether the super-resolution algorithm is successfully enabled. If not successfully enabled, - * you can use reason for troubleshooting. - * - * @param uid The ID of the remote user. - * @param enabled Whether the super-resolution algorithm is successfully enabled: - * - true: The super-resolution algorithm is successfully enabled. - * - false: The super-resolution algorithm is not successfully enabled. - * @param reason The reason why the super-resolution algorithm is not successfully enabled. See #SUPER_RESOLUTION_STATE_REASON. - */ - virtual void onUserSuperResolutionEnabled(uid_t uid, bool enabled, SUPER_RESOLUTION_STATE_REASON reason) { - (void)uid; - (void)enabled; - (void)reason; - } - /// @endcond /** Occurs when the state of the media stream relay changes. * @@ -4235,35 +3344,14 @@ class IRtcEngineEventHandler /** Occurs when the engine sends the first local audio frame. - @deprecated Deprecated as of v3.1.0. Use the \ref IRtcEngineEventHandler::onFirstLocalAudioFramePublished "onFirstLocalAudioFramePublished" callback instead. - - @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. - */ + @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ virtual void onFirstLocalAudioFrame(int elapsed) { (void)elapsed; } - /** Occurs when the first audio frame is published. - * - * @since v3.1.0 - * - * The SDK triggers this callback under one of the following circumstances: - * - The local client enables the audio module and calls \ref IRtcEngine::joinChannel "joinChannel" successfully. - * - The local client calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" and \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(false)" in sequence. - * - The local client calls \ref IRtcEngine::disableAudio "disableAudio" and \ref IRtcEngine::enableAudio "enableAudio" in sequence. - * - * @param elapsed The time elapsed (ms) from the local client calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. - */ - virtual void onFirstLocalAudioFramePublished(int elapsed) { - (void)elapsed; - } - /** Occurs when the engine receives the first audio frame from a specific remote user. - @deprecated v3.0.0 - - This callback is deprecated. Use `onRemoteAudioStateChanged` instead. - @param uid User ID of the remote user. @param elapsed Time elapsed (ms) from the remote user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. */ @@ -4285,25 +3373,11 @@ class IRtcEngineEventHandler */ virtual void onRtmpStreamingStateChanged(const char *url, RTMP_STREAM_PUBLISH_STATE state, RTMP_STREAM_PUBLISH_ERROR errCode) { (void) url; - (void) state; - (void) errCode; + (RTMP_STREAM_PUBLISH_STATE) state; + (RTMP_STREAM_PUBLISH_ERROR) errCode; } - /** Reports events during the RTMP streaming. - * - * @since v3.1.0 - * - * @param url The RTMP streaming URL. - * @param eventCode The event code. See #RTMP_STREAMING_EVENT - */ - virtual void onRtmpStreamingEvent(const char* url, RTMP_STREAMING_EVENT eventCode) { - (void) url; - (void) eventCode; - } - - /** @deprecated This method is deprecated, use the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback instead. - - Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) + /** Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) @param url The RTMP URL address. @param error Error code: #ERROR_CODE_TYPE. Main errors include: @@ -4324,9 +3398,7 @@ class IRtcEngineEventHandler (void)url; (void)error; } - /** @deprecated This method is deprecated, use the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback instead. - - Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) + /** Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) This callback indicates whether you have successfully removed an RTMP stream from the CDN. @@ -4335,16 +3407,10 @@ class IRtcEngineEventHandler virtual void onStreamUnpublished(const char *url) { (void)url; } -/** Occurs when the publisher's transcoding is updated. - * - * When the `LiveTranscoding` class in the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. - * - * @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - * - */ +/** Occurs when the publisher's transcoding is updated. */ virtual void onTranscodingUpdated() { } - /** Occurs when a voice or video stream URL address is added to the live interactive streaming. + /** Occurs when a voice or video stream URL address is added to a live broadcast. @param url Pointer to the URL address of the externally injected stream. @param uid User ID. @@ -4357,21 +3423,24 @@ class IRtcEngineEventHandler } /** Occurs when the local audio route changes. - @param routing The current audio routing. See: #AUDIO_ROUTE_TYPE. + + The SDK triggers this callback when the local audio route switches to an earpiece, speakerphone, headset, or Bluetooth device. + + @note This callback is for Android and iOS only. + + @param routing Audio output routing. See: #AUDIO_ROUTE_TYPE. */ virtual void onAudioRouteChanged(AUDIO_ROUTE_TYPE routing) { - (void)routing; - } + (void)routing; + } - /** Occurs when the published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. + /** Occurs when the locally published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. - If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the - published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. - @note If the local stream fallbacks to the audio-only stream, the remote user receives the \ref IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback. + If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the locally published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. - @param isFallbackOrRecover Whether the published stream falls back to audio-only or switches back to the video: - - true: The published stream falls back to audio-only due to poor network conditions. - - false: The published stream switches back to the video after the network conditions improve. + @param isFallbackOrRecover Whether the locally published stream falls back to audio-only or switches back to the video: + - true: The locally published stream falls back to audio-only due to poor network conditions. + - false: The locally published stream switches back to the video after the network conditions improve. */ virtual void onLocalPublishFallbackToAudioOnly(bool isFallbackOrRecover) { (void)isFallbackOrRecover; @@ -4460,9 +3529,7 @@ class IRtcEngineEventHandler (void)rxKBitRate; } - /** Occurs when the microphone is enabled/disabled. - * - * @deprecated v2.9.0 + /** **DEPRECATED** Occurs when the microphone is enabled/disabled. * * The \ref onMicrophoneEnabled() "onMicrophoneEnabled" callback is * deprecated. Use #LOCAL_AUDIO_STREAM_STATE_STOPPED (0) or @@ -4472,7 +3539,7 @@ class IRtcEngineEventHandler * * The SDK triggers this callback when the local user resumes or stops * capturing the local audio stream by calling the - * \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio" method. + * \ref agora::rtc::IRtcEngine::enableLocalAudio "enbaleLocalAudio" method. * * @param enabled Whether the microphone is enabled/disabled: * - true: Enabled. @@ -4494,7 +3561,7 @@ class IRtcEngineEventHandler /** Occurs when the local network type changes. - When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. + When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. @param type See #NETWORK_TYPE. */ @@ -4577,9 +3644,7 @@ class IVideoDeviceManager /** Enumerates the video devices. - This method returns an IVideoDeviceCollection object including all video devices - in the system. With the IVideoDeviceCollection object, the application can enumerate - the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. + This method returns an IVideoDeviceCollection object including all video devices in the system. With the IVideoDeviceCollection object, the application can enumerate the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. @return - An IVideoDeviceCollection object including all video devices in the system: Success. @@ -4701,7 +3766,7 @@ class IAudioDeviceCollection - < 0: Failure. */ virtual int setApplicationMute(bool mute) = 0; - /** Gets the mute state of the application. + /** Retrieves the mute status of the application. @param mute Pointer to whether the application is muted/unmuted. - true: The application is muted. @@ -4974,35 +4039,25 @@ class IAudioDeviceManager */ struct RtcEngineContext { - /** The IRtcEngineEventHandler object. - */ IRtcEngineEventHandler* eventHandler; - /** - * The App ID issued to you by Agora. See [How to get the App ID](https://docs.agora.io/en/Agora%20Platform/token#get-an-app-id). - * Only users in apps with the same App ID can join the same channel and communicate with each other. Use an App ID to create only - * one `IRtcEngine` instance. To change your App ID, call `release` to destroy the current `IRtcEngine` instance and then call `createAgoraRtcEngine` - * and `initialize` to create an `IRtcEngine` instance with the new App ID. + /** App ID issued to you by Agora. Apply for a new App ID from Agora if + * it is missing from your kit. */ const char* appId; // For android, it the context(Activity or Application - // for windows,Video hot plug device - /** The video window handle. Once set, this parameter enables you to plug - * or unplug the video devices while they are powered. - */ - void* context; - /** - * The region for connection. This advanced feature applies to scenarios that have regional restrictions. - * - * For the regions that Agora supports, see #AREA_CODE. After specifying the region, the SDK connects to the Agora servers within that region. - * - * @note The SDK supports specify only one region. - */ - unsigned int areaCode; + // for windows,Video hot plug device + void* context; RtcEngineContext() + /** The IRtcEngineEventHandler object. + */ :eventHandler(NULL) + /** The App ID issued to your project by Agora. + */ ,appId(NULL) + /** The video window handle. Once set, this parameter enables you to plug + * or unplug the video devices while they are powered. + */ ,context(NULL) - ,areaCode(rtc::AREA_CODE_GLOB) {} }; @@ -5038,7 +4093,7 @@ class IMetadataObserver /** Buffer address of the sent or received Metadata. */ unsigned char *buffer; - /** Timestamp (ms) of the frame following the metadata. + /** Time statmp of the frame following the metadata. */ long long timeStampMs; }; @@ -5051,7 +4106,7 @@ class IMetadataObserver - `uid`: ID of the user who sends the metadata. - `size`: The size of the sent or received metadata. - `buffer`: The sent or received metadata. - - `timeStampMs`: The timestamp (ms) of the metadata. + - `timeStampMs`: The timestamp of the metadata. The SDK triggers this callback after you successfully call the \ref agora::rtc::IRtcEngine::registerMediaMetadataObserver "registerMediaMetadataObserver" method. You need to specify the maximum size of the metadata in the return value of this callback. @@ -5077,65 +4132,6 @@ class IMetadataObserver virtual void onMetadataReceived(const Metadata &metadata) = 0; }; -/** Encryption mode. -*/ -enum ENCRYPTION_MODE -{ - /** 1: (Default) 128-bit AES encryption, XTS mode. - */ - AES_128_XTS = 1, - /** 2: 128-bit AES encryption, ECB mode. - */ - AES_128_ECB = 2, - /** 3: 256-bit AES encryption, XTS mode. - */ - AES_256_XTS = 3, - /** 4: 128-bit SM4 encryption, ECB mode. - */ - SM4_128_ECB = 4, - /** Enumerator boundary. - */ - MODE_END, -}; - -/** Configurations of built-in encryption schemas. */ -struct EncryptionConfig{ - /** - * Encryption mode. The default encryption mode is `AES_128_XTS`. See #ENCRYPTION_MODE. - */ - ENCRYPTION_MODE encryptionMode; - /** - * Encryption key in string type. - * - * @note If you do not set an encryption key or set it as NULL, you cannot use the built-in encryption, and the SDK returns #ERR_INVALID_ARGUMENT (-2). - */ - const char* encryptionKey; - - EncryptionConfig() { - encryptionMode = AES_128_XTS; - encryptionKey = nullptr; - } - - /// @cond - const char* getEncryptionString() const { - switch(encryptionMode) - { - case AES_128_XTS: - return "aes-128-xts"; - case AES_128_ECB: - return "aes-128-ecb"; - case AES_256_XTS: - return "aes-256-xts"; - case SM4_128_ECB: - return "sm4-128-ecb"; - default: - return "aes-128-xts"; - } - return "aes-128-xts"; - } - /// @endcond -}; - /** IRtcEngine is the base interface class of the Agora SDK that provides the main Agora SDK methods invoked by your application. Enable the Agora SDK's communication functionality through the creation of an IRtcEngine object, then call the methods of this object. @@ -5146,135 +4142,64 @@ class IRtcEngine virtual ~IRtcEngine() {} public: - /** Initializes the Agora service. + /** Initializes the Agora SDK service. * - * Unless otherwise specified, all the methods provided by the IRtcEngine class are executed asynchronously. Agora recommends calling these methods in the same thread. - * - * @note Ensure that you call the + * Ensure that you call the * \ref agora::rtc::IRtcEngine::createAgoraRtcEngine * "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize - * "initialize" methods before calling any other APIs. + * "initialize" methods before calling any other API. * * @param context Pointer to the RTC engine context. See RtcEngineContext. * * @return - * - 0(ERR_OK): Success. + * - 0: Success. * - < 0: Failure. - * - -1(ERR_FAILED): A general error occurs (no specified reason). - * - -2(ERR_INALID_ARGUMENT): No `IRtcEngineEventHandler` object is specified. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Check whether `context` is properly set. - * - -22(ERR_RESOURCE_LIMITED): The resource is limited. The app uses too much of the system resource and fails to allocate any resources. - * - -101(ERR_INVALID_APP_ID): The App ID is invalid. */ virtual int initialize(const RtcEngineContext& context) = 0; /** Releases all IRtcEngine resources. - * - * Use this method for apps in which users occasionally make voice or video calls. When users do not make calls, you - * can free up resources for other operations. Once you call `release` to destroy the created `IRtcEngine` instance, - * you cannot use any method or callback in the SDK any more. If you want to use the real-time communication functions - * again, you must call \ref createAgoraRtcEngine "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize "initialize" - * to create a new `IRtcEngine` instance. - * - * @note If you want to create a new `IRtcEngine` instance after destroying the current one, ensure that you wait - * till the `release` method completes executing. - * - * @param sync - * - true: Synchronous call. Agora suggests calling this method in a sub-thread to avoid congestion in the main thread - * because the synchronous call and the app cannot move on to another task until the execution completes. - * Besides, you **cannot** call this method in any method or callback of the SDK. Otherwise, the SDK cannot release the - * resources occupied by the `IRtcEngine` instance until the callbacks return results, which may result in a deadlock. - * The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to - * take additional time. - * - false: Asynchronous call. Do not immediately uninstall the SDK's dynamic library after the call, or it may cause - * a crash due to the SDK clean-up thread not quitting. - */ - AGORA_CPP_API static void release (bool sync = false); - - /** Sets the channel profile of the Agora IRtcEngine. - * - * The Agora IRtcEngine differentiates channel profiles and applies optimization algorithms accordingly. - * For example, it prioritizes smoothness and low latency for a video call, and prioritizes video quality for the live interactive video streaming. - * - * @warning - * - To ensure the quality of real-time communication, we recommend that all users in a channel use the same channel profile. - * - Call this method before calling \ref IRtcEngine::joinChannel "joinChannel" . You cannot set the channel profile once you have joined the channel. - * - The default audio route and video encoding bitrate are different in different channel profiles. For details, see - * \ref IRtcEngine::setDefaultAudioRouteToSpeakerphone "setDefaultAudioRouteToSpeakerphone" and \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". - * - * @param profile The channel profile of the Agora IRtcEngine. See #CHANNEL_PROFILE_TYPE - * @return - * - 0(ERR_OK): Success. - * - < 0: Failure. - * - -2 (ERR_INVALID_ARGUMENT): The parameter is invalid. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + + @param sync + - true: (Synchronous call) The result returns after the IRtcEngine resources are released. The application should not call this method in the SDK generated callbacks. Otherwise, the SDK must wait for the callbacks to return to recover the associated IRtcEngine resources, resulting in a deadlock. The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to take additional time. + - false: (Asynchronous call) The result returns immediately, even when the IRtcEngine resources have not been released. The SDK releases all resources. + + @note Do not immediately uninstall the SDK's dynamic library after the call, or it may cause a crash due to the SDK clean-up thread not quitting. + */ + virtual void release(bool sync=false) = 0; + + /** Sets the channel profile. + + The SDK needs to know the application scenario to set the appropriate channel profile to apply different optimization methods. + + @note + - Users in the same channel must use the same channel profile. + - Before calling this method to set a new channel profile, \ref IRtcEngine::release "release" the current engine and create a new engine using createAgoraRtcEngine() and \ref IRtcEngine::initialize "initialize". + - Call this method before a user \ref IRtcEngine::joinChannel "joins a channel" because you cannot configure the channel profile when the channel is in use. + - In the Communication profile, the Agora SDK supports encoding only in raw data, not in texture. + + @param profile Sets the channel profile. See #CHANNEL_PROFILE_TYPE. + @return + - 0: Success. + - < 0: Failure. */ virtual int setChannelProfile(CHANNEL_PROFILE_TYPE profile) = 0; - /** Sets the role of the user, such as a host or an audience (default), before joining a channel in the live interactive streaming. - * - * This method can be used to switch the user role in the live interactive streaming after the user joins a channel. - * - * In the `LIVE_BROADCASTING` profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: - * - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" - * - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) - * - * @note - * This method applies only to the `LIVE_BROADCASTING` profile. - * - * @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. - * - * @return - * - 0(ERR_OK): Success. - * - < 0: Failure. - * - -1(ERR_FAILED): A general error occurs (no specified reason). - * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in a live broadcast. + + This method can be used to switch the user role in a live broadcast after the user joins a channel. + + In the Live Broadcast profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) + + @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. + @return + - 0: Success. + - < 0: Failure. */ virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; - /// @cond - /** Sets the role of a user in a live interactive streaming. - * - * @since v3.2.0 - * - * You can call this method either before or after joining the channel to set the user role as audience or host. If - * you call this method to switch the user role after joining the channel, the SDK triggers the following callbacks: - * - The local client: \ref IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged". - * - The remote client: \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" - * or \ref IRtcEngineEventHandler::onUserOffline "onUserOffline". - * - * @note - * - This method applies to the `LIVE_BROADCASTING` profile only (when the `profile` parameter in - * \ref IRtcEngine::setChannelProfile "setChannelProfile" is set as `CHANNEL_PROFILE_LIVE_BROADCASTING`). - * - The difference between this method and \ref IRtcEngine::setClientRole(CLIENT_ROLE_TYPE) "setClientRole1" is that - * this method can set the user level in addition to the user role. - * - The user role determines the permissions that the SDK grants to a user, such as permission to send local - * streams, receive remote streams, and push streams to a CDN address. - * - The user level determines the level of services that a user can enjoy within the permissions of the user's - * role. For example, an audience can choose to receive remote streams with low latency or ultra low latency. Levels - * affect prices. - * - * **Example** - * ```cpp - * ClientRoleOptions options; - * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY; - * options.audienceLatencyLevel = AUDIENCE_LATENCY_LEVEL_LOW_LATENCY; - * agoraEngine->setClientRole(role, options); - * ``` - * - * @param role The role of a user in a live interactive streaming. See #CLIENT_ROLE_TYPE. - * @param options The detailed options of a user, including user level. See ClientRoleOptions. - * - * @return - * - 0(ERR_OK): Success. - * - < 0: Failure. - * - -1(ERR_FAILED): A general error occurs (no specified reason). - * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. - */ - virtual int setClientRole(CLIENT_ROLE_TYPE role, const ClientRoleOptions& options) = 0; - /// @endcond - /** Joins a channel with the user ID. + + /** Allows a user to join a channel. Users in the same channel can talk to each other, and multiple users in the same channel can start a group chat. Users with different App IDs cannot call each other. @@ -5283,38 +4208,36 @@ class IRtcEngine A successful \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method call triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. When the connection between the client and Agora's server is interrupted due to poor network conditions, the SDK tries reconnecting to the server. When the local client successfully rejoins the channel, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRejoinChannelSuccess "onRejoinChannelSuccess" callback on the local client. @note A channel does not accept duplicate uids, such as two users with the same @p uid. If you set @p uid as 0, the system automatically assigns a @p uid. If you want to join a channel from different devices, ensure that each device has a different uid. @warning Ensure that the App ID used for creating the token is the same App ID used by the \ref IRtcEngine::initialize "initialize" method for initializing the RTC engine. Otherwise, the CDN live streaming may fail. - @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a token. + @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a Channel Key. - If the user uses a static App ID, *token* is optional and can be set as NULL. - - If the user uses a token, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. + - If the user uses a Channel Key, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. @param channelId Pointer to the unique channel name for the Agora RTC session in the string format smaller than 64 bytes. Supported characters: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - The 26 lowercase English letters: a to z + - The 26 uppercase English letters: A to Z + - The 10 numbers: 0 to 9 + - The space + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", "," @param info (Optional) Pointer to additional information about the channel. This parameter can be set to NULL or contain channel related information. Other users in the channel will not receive this message. @param uid (Optional) User ID. A 32-bit unsigned integer with a value ranging from 1 to 232-1. The @p uid must be unique. If a @p uid is not assigned (or set to 0), the SDK assigns and returns a @p uid in the \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. Your application must record and maintain the returned *uid* since the SDK does not do so. @return - - 0(ERR_OK): Success. + - 0: Success. - < 0: Failure. - - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. - - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: - - You have created an IChannel object with the same channel name. - - You have joined and published a stream in a channel created by the IChannel object. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) */ virtual int joinChannel(const char* token, const char* channelId, const char* info, uid_t uid) = 0; /** Switches to a different channel. * - * This method allows the audience of a `LIVE_BROADCASTING` channel to switch + * This method allows the audience of a Live-broadcast channel to switch * to a different channel. * * After the user successfully switches to another channel, the @@ -5324,34 +4247,29 @@ class IRtcEngine * user has left the original channel and joined a new one. * * @note - * This method applies to the audience role in a `LIVE_BROADCASTING` channel + * This method applies to the audience role in a Live-broadcast channel * only. * * @param token The token generated at your server: * - For low-security requirements: You can use the temporary token - * generated in Console. For details, see - * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platform=All%20Platforms#generate-a-token). + * generated in Dashboard. For details, see + * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-temporary-token). * - For high-security requirements: Use the token generated at your * server. For details, see - * [Get a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=All%20Platforms). + * [Get a token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-token). * @param channelId Unique channel name for the AgoraRTC session in the * string format. The string length must be less than 64 bytes. Supported * character scopes are: - * - All lowercase English letters: a to z. - * - All uppercase English letters: A to Z. - * - All numeric characters: 0 to 9. - * - The space character. - * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * - The 26 lowercase English letters: a to z. + * - The 26 uppercase English letters: A to Z. + * - The 10 numbers: 0 to 9. + * - The space. + * - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", + * ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". * * @return - * - 0(ERR_OK): Success. - * - < 0: Failure. - * - -1(ERR_FAILED): A general error occurs (no specified reason). - * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - * - -5(ERR_REFUSED): The request is rejected, probably because the user is not an audience. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. - * - -102(ERR_INVALID_CHANNEL_NAME): The channel name is invalid. - * - -113(ERR_NOT_IN_CHANNEL): The user is not in the channel. + * - 0: Success. + * - <0: Failure. */ virtual int switchChannel(const char* token, const char* channelId) = 0; @@ -5365,38 +4283,31 @@ class IRtcEngine A successful \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method call triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the `COMMUNICATION` channel, or is a host in the `LIVE_BROADCASTING` profile. + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a BROADCASTER in the Live Broadcast profile. @note - If you call the \ref IRtcEngine::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. @return - - 0(ERR_OK): Success. + - 0: Success. - < 0: Failure. - - -1(ERR_FAILED): A general error occurs (no specified reason). - - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int leaveChannel() = 0; /** Gets a new token when the current token expires after a period of time. - The `token` expires after a period of time once the token schema is enabled when: + The *token* expires after a period of time once the token schema is enabled when: - The SDK triggers the \ref IRtcEngineEventHandler::onTokenPrivilegeWillExpire "onTokenPrivilegeWillExpire" callback, or - The \ref IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" reports CONNECTION_CHANGED_TOKEN_EXPIRED(9). - The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. + The application should call this method to get the new *token*. Failure to do so will result in the SDK disconnecting from the server. @param token Pointer to the new token. - @return - - 0(ERR_OK): Success. + - 0: Success. - < 0: Failure. - - -1(ERR_FAILED): A general error occurs (no specified reason). - - -2(ERR_INALID_ARGUMENT): The parameter is invalid. - - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int renewToken(const char* token) = 0; @@ -5431,11 +4342,11 @@ class IRtcEngine @param appId The App ID of your project. @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @return - 0: Success. @@ -5448,33 +4359,30 @@ class IRtcEngine After the user successfully joins the channel, the SDK triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. + The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. @param token The token generated at your server: - - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). + - For low-security requirements: You can use the temporary token generated at Dashboard. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - All lowercase English letters: a to z. - - All uppercase English letters: A to Z. - - All numeric characters: 0 to 9. - - The space character. - - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - The 26 lowercase English letters: a to z. + - The 26 uppercase English letters: A to Z. + - The 10 numbers: 0 to 9. + - The space. + - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @return - 0: Success. - < 0: Failure. - - #ERR_INVALID_ARGUMENT (-2) - - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) */ virtual int joinChannelWithUserAccount(const char* token, const char* channelId, @@ -5489,7 +4397,7 @@ class IRtcEngine remote user from the `userInfo` object by passing in the user account. @param userAccount The user account of the user. Ensure that you set this parameter. - @param [in,out] userInfo A userInfo object that identifies the user: + @param[in/out] userInfo A userInfo object that identifies the user: - Input: A userInfo object. - Output: A userInfo object that contains the user account and user ID of the user. @@ -5507,7 +4415,7 @@ class IRtcEngine from the `userInfo` object by passing in the user ID. @param uid The user ID of the remote user. Ensure that you set this parameter. - @param[in,out] userInfo A userInfo object that identifies the user: + @param[in/out] userInfo A userInfo object that identifies the user: - Input: A userInfo object. - Output: A userInfo object that contains the user account and user ID of the user. @@ -5530,7 +4438,7 @@ class IRtcEngine @note - After calling this method, always call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the application cannot run the next echo test. - - In the `LIVE_BROADCASTING` profile, only the hosts can call this method. If the user switches from the `COMMUNICATION` to`LIVE_BROADCASTING` profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. + - In the Live-broadcast profile, only the hosts can call this method. If the user switches from the Communication to Live-broadcast profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. @return - 0: Success. @@ -5547,7 +4455,7 @@ class IRtcEngine @note - Call this method before joining a channel. - After calling this method, call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the app cannot run the next echo test, or call the \ref IRtcEngine::joinChannel "joinChannel" method. - - In the `LIVE_BROADCASTING` profile, only a host can call this method. + - In the Live-broadcast profile, only a host can call this method. @param intervalInSeconds The time interval (s) between when you speak and when the recording plays back. @return @@ -5609,7 +4517,6 @@ class IRtcEngine Each video profile includes a set of parameters, such as the resolution, frame rate, and bitrate. If the camera device does not support the specified resolution, the SDK automatically chooses a suitable camera resolution, keeping the encoder resolution specified by the *setVideoProfile* method. @note - - You can call this method either before or after joining a channel. - If you do not need to set the video profile after joining the channel, call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. - Always set the video profile before calling the \ref IRtcEngine::joinChannel "joinChannel" or \ref IRtcEngine::startPreview "startPreview" method. @@ -5632,9 +4539,7 @@ class IRtcEngine The parameters specified in this method are the maximum values under ideal network conditions. If the video engine cannot render the video using the specified parameters due to poor network conditions, the parameters further down the list are considered until a successful configuration is found. - @note - - You can call this method either before or after joining a channel. - - If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. + @note If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. @param config Sets the local video encoder configuration. See VideoEncoderConfiguration. @return @@ -5644,7 +4549,7 @@ class IRtcEngine virtual int setVideoEncoderConfiguration(const VideoEncoderConfiguration& config) = 0; /** Sets the camera capture configuration. - For a video call or the live interactive video streaming, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: + For a video call or live broadcast, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to avoid such problems. - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to optimize CPU and RAM usage. @@ -5660,16 +4565,9 @@ class IRtcEngine */ virtual int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) = 0; - /** Initializes the local video view. - - This method initializes the video view of a local stream on the local device. It affects only the video view that the local user sees, not the published local video stream. + /** Sets the local video view and configures the video display settings on the local machine. - Call this method to bind the local video stream to a video view and to set the rendering and mirror modes of the video view. - The binding is still valid after the user leaves the channel, which means that the window still displays. To unbind the view, set the *view* in VideoCanvas to NULL. - - @note - - You can call this method either before or after joining a channel. - - During a call, you can call this method as many times as necessary to update the display mode of the local video view. + The application calls this method to bind each video window (view) of the local video streams and configures the video display settings. Call this method after initialization to configure the local video display settings before joining a channel. The binding is still valid after the user leaves the channel, which means that the window still displays. To unbind the view, set the *view* in VideoCanvas to NULL. @param canvas Pointer to the local video view and settings. See VideoCanvas. @return @@ -5678,17 +4576,17 @@ class IRtcEngine */ virtual int setupLocalVideo(const VideoCanvas& canvas) = 0; - /** Initializes the video view of a remote user. + /** Sets the remote video view. - This method initializes the video view of a remote stream on the local device. It affects only the video view that the local user sees. + This method binds the remote user to the video display window (sets the view for the remote user by the specified uid in VideoCanvas). - Call this method to bind the remote video stream to a video view and to set the rendering and mirror modes of the video view. + The application specifies the uid of the remote video in this method before the remote user joins the channel. + + If the remote uid is unknown to the application, set it after the application receives the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. - The application specifies the uid of the remote video in this method before the remote user joins the channel. If the remote uid is unknown to the application, set it after the application receives the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. If the Video Recording function is enabled, the Video Recording Service joins the channel as a dummy client, causing other clients to also receive the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. Do not bind the dummy client to the application view because the dummy client does not send any video streams. If your application does not recognize the dummy client, bind the remote user to the view when the SDK triggers the \ref IRtcEngineEventHandler::onFirstRemoteVideoDecoded "onFirstRemoteVideoDecoded" callback. - To unbind the remote user from the view, set the view in VideoCanvas to NULL. Once the remote user leaves the channel, the SDK unbinds the remote user. - @note To update the rendering or mirror mode of the remote video view during a call, use the \ref IRtcEngine::setRemoteRenderMode "setRemoteRenderMode" method. + To unbind the remote user from the view, set the view in VideoCanvas to NULL. Once the remote user leaves the channel, the SDK unbinds the remote user. @param canvas Pointer to the remote video view and settings. See VideoCanvas. @return @@ -5713,19 +4611,17 @@ class IRtcEngine virtual int startPreview() = 0; /** Prioritizes a remote user's stream. - * - * The SDK ensures the high-priority user gets the best possible stream quality. - * - * @note - * - The Agora SDK supports setting @p userPriority as high for one user only. - * - Ensure that you call this method before joining a channel. - * - * @param uid The ID of the remote user. - * @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. - * - * @return - * - 0: Success. - * - < 0: Failure. + + Use this method with the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. If the fallback function is enabled for a subscribed stream, the SDK ensures the high-priority user gets the best possible stream quality. + + @note The Agora SDK supports setting @p userPriority as high for one user only. + + @param uid The ID of the remote user. + @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + + @return + - 0: Success. + - < 0: Failure. */ virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; @@ -5757,20 +4653,18 @@ class IRtcEngine /** Disables/Re-enables the local audio function. - The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. + The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. - This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to - receive remote audio streams without sending any audio stream to other users in the channel. + This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to receive remote audio streams without sending any audio stream to other users in the channel. - Once the local audio function is disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalAudioStateChanged "onLocalAudioStateChanged" callback, - which reports `LOCAL_AUDIO_STREAM_STATE_STOPPED(0)` or `LOCAL_AUDIO_STREAM_STATE_RECORDING(1)`. + The SDK triggers the \ref IRtcEngineEventHandler::onMicrophoneEnabled "onMicrophoneEnabled" callback once the local audio function is disabled or enabled. @note + - Call this method after the \ref IRtcEngine::joinChannel "joinChannel" method. - This method is different from the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method: + - \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio": Disables/Re-enables the local audio capturing and processing. - If you disable or re-enable local audio recording using the `enableLocalAudio` method, the local user may hear a pause in the remote audio playback. - \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream": Sends/Stops sending the local audio streams. - - You can call this method either before or after joining a channel. @param enabled Sets whether to disable/re-enable the local audio function: - true: (Default) Re-enable the local audio function, that is, to start the local audio capturing device (for example, the microphone). @@ -5794,17 +4688,15 @@ class IRtcEngine */ virtual int disableAudio() = 0; - /** Sets the audio parameters and application scenarios. + /** Sets the audio parameters and application scenarios. @note - - The `setAudioProfile` method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. - - In the `COMMUNICATION` and `LIVE_BROADCASTING` profiles, the bitrate may be different from your settings due to network self-adaptation. - - In scenarios requiring high-quality audio, for example, a music teaching scenario, we recommend setting profile as AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) and scenario as AUDIO_SCENARIO_GAME_STREAMING (3). + - The *setAudioProfile* method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. + - In the Communication and Live-broadcast profiles, the bitrate may be different from your settings due to network self-adaptation. + - In scenarios involving music education, we recommend setting profile as #AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) and scenario as #AUDIO_SCENARIO_GAME_STREAMING (3). @param profile Sets the sample rate, bitrate, encoding mode, and the number of channels. See #AUDIO_PROFILE_TYPE. - @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. - Under different audio scenarios, the device uses different volume types. For details, see - [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). + @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. Under different audio scenarios, the device uses different volume tracks, i.e. either the in-call volume or the media volume. For details, see [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). @return - 0: Success. @@ -5814,10 +4706,7 @@ class IRtcEngine /** Stops/Resumes sending the local audio stream. A successful \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteAudio "onUserMuteAudio" callback on the remote client. - - @note - - When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. - - You can call this method either before or after joining a channel. If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local audio according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. + @note When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. @param mute Sets whether to send/stop sending the local audio stream: - true: Stops sending the local audio stream. @@ -5830,8 +4719,6 @@ class IRtcEngine virtual int muteLocalAudioStream(bool mute) = 0; /** Stops/Resumes receiving all remote users' audio streams. - @note You can call this method either before or after joining a channel. - @param mute Sets whether to receive/stop receiving all remote users' audio streams. - true: Stops receiving all remote users' audio streams. - false: (Default) Receives all remote users' audio streams. @@ -5840,16 +4727,9 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteAllRemoteAudioStreams(bool mute) = 0; + virtual int muteAllRemoteAudioStreams(bool mute) = 0; /** Stops/Resumes receiving all remote users' audio streams by default. - You can call this method either before or after joining a channel. If you call `setDefaultMuteAllRemoteAudioStreams (true)` after joining a channel, the remote audio streams of all subsequent users are not received. - - @note If you want to resume receiving the audio stream, call \ref agora::rtc::IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream (false)", - and specify the ID of the remote user whose audio stream you want to receive. - To receive the audio streams of multiple remote users, call `muteRemoteAudioStream (false)` as many times. - Calling `setDefaultMuteAllRemoteAudioStreams (false)` resumes receiving the audio streams of subsequent users only. - @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: - true: Stops receiving all remote users' audio streams by default. - false: (Default) Receives all remote users' audio streams by default. @@ -5858,33 +4738,10 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - - /** Adjusts the playback volume of a specified remote user. - - You can call this method as many times as necessary to adjust the playback volume of different remote users, or to repeatedly adjust the playback volume of the same remote user. - - @note - - Call this method after joining a channel. - - The playback volume here refers to the mixed volume of a specified remote user. - - This method can only adjust the playback volume of one specified remote user at a time. To adjust the playback volume of different remote users, call the method as many times, once for each remote user. - - @param uid The ID of the remote user. - @param volume The playback volume of the specified remote user. The value ranges from 0 to 100: - - 0: Mute. - - 100: Original volume. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int adjustUserPlaybackSignalVolume(unsigned int uid, int volume) = 0; + virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; /** Stops/Resumes receiving a specified remote user's audio stream. - @note - - You can call this method either before or after joining a channel. If you call it before joining a channel, - you need to maintain the `uid` of the remote user on your app level. - - If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. + @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. @param userId User ID of the specified remote user sending the audio. @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: @@ -5896,14 +4753,11 @@ class IRtcEngine - < 0: Failure. */ - virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; + virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; /** Stops/Resumes sending the local video stream. A successful \ref agora::rtc::IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback on the remote client. - - @note - - When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. - - You can call this method either before or after joining a channel. If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" after this method, the SDK resets whether or not to mute the local video according to the channel profile and user role. Therefore, we recommend calling this method after the `setChannelProfile` method. + @note When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. @param mute Sets whether to send/stop sending the local video stream: - true: Stop sending the local video stream. @@ -5913,18 +4767,17 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteLocalVideoStream(bool mute) = 0; - /** Enables/Disables the local video capture. + virtual int muteLocalVideoStream(bool mute) = 0; + /** Disables/Re-enables the local video. - This method disables or re-enables the local video capturer, and does not affect receiving the remote video stream. + This method disables/re-enables the local video and enableLocalVideo(false) is only applicable when the user wants to watch the remote video without sending any video stream to the other user. - After you call the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method, the local video capturer is enabled by default. You can call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local video capturer. If you want to re-enable it, call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(true)". + Call this method after calling the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method. Otherwise, this method may not work properly. - After the local video capturer is successfully disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableLocalVideo "onUserEnableLocalVideo" callback on the remote client. + After the *enableVideo* method is called, the local video is enabled by default. This method is used to disable/re-enable the local video while the remote video remains unaffected. - @note - - You can call this method either before or after joining a channel. - - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + A successful \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableLocalVideo "onUserEnableLocalVideo" callback on the remote client. + @note This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. @param enabled Sets whether to disable/re-enable the local video, including the capturer, renderer, and sender: - true: (Default) Re-enable the local video. @@ -5934,10 +4787,8 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int enableLocalVideo(bool enabled) = 0; - /** Stops/Resumes receiving all video stream from a specified remote user. - - @note You can call this method either before or after joining a channel. + virtual int enableLocalVideo(bool enabled) = 0; + /** Stops/Resumes receiving all remote users' video streams. @param mute Sets whether to receive/stop receiving all remote users' video streams: - true: Stop receiving all remote users' video streams. @@ -5947,13 +4798,9 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteAllRemoteVideoStreams(bool mute) = 0; + virtual int muteAllRemoteVideoStreams(bool mute) = 0; /** Stops/Resumes receiving all remote users' video streams by default. - You can call this method either before or after joining a channel. If you call `setDefaultMuteAllRemoteVideoStreams (true)` after joining a channel, the remote video streams of all subsequent users are not received. - - @note If you want to resume receiving the video stream, call \ref agora::rtc::IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream (false)", and specify the ID of the remote user whose video stream you want to receive. To receive the video streams of multiple remote users, call `muteRemoteVideoStream (false)` as many times. Calling `setDefaultMuteAllRemoteVideoStreams (false)` resumes receiving the video streams of subsequent users only. - @param mute Sets whether to receive/stop receiving all remote users' video streams by default: - true: Stop receiving all remote users' video streams by default. - false: (Default) Receive all remote users' video streams by default. @@ -5962,16 +4809,13 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; - /** Stops/Resumes receiving the video stream from a specified remote user. + virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; + /** Stops/Resumes receiving a specified remote user's video stream. - @note - - You can call this method either before or after joining a channel. If you call it before joining a channel, you - need to maintain the `uid` of the remote user on your app level. - - If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. + @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. @param userId User ID of the specified remote user. - @param mute Sets whether to stop/resume receiving the video stream from a specified remote user: + @param mute Sets whether to receive/stop receiving the specified remote user's video stream: - true: Stop receiving the specified remote user's video stream. - false: (Default) Receive the specified remote user's video stream. @@ -5979,26 +4823,16 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; - /** Sets the stream type of the remote video. - - Under limited network conditions, if the publisher has not disabled the dual-stream mode using `enableDualStreamMode(false)`, - the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or - the low-video stream (the low resolution, and low bitrate video stream). - - By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. - This method allows the app to adjust the corresponding video stream type based on the size of the video window to - reduce the bandwidth and resources. + virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; + /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. - The aspect ratio of the low-video stream is the same as the high-quality video stream. Once the resolution of the high-quality video - stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. + This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. + - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the SDK receives the high-stream video by default. + - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. - @note You can call this method either before or after joining a channel. If you call both - \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" and - \ref IRtcEngine::setRemoteDefaultVideoStreamType "setRemoteDefaultVideoStreamType", the SDK applies the settings in - the \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" method. + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. + By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. @param userId ID of the remote user sending the video stream. @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -6006,25 +4840,13 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Sets the default stream type of remote videos. + virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. - Under limited network conditions, if the publisher has not disabled the dual-stream mode using `enableDualStreamMode(false)`, - the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or - the low-video stream (the low resolution, and low bitrate video stream). + - If the dual-stream mode is enabled by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the user receives the high-stream video by default. The @p setRemoteDefaultVideoStreamType method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. + - If the dual-stream mode is not enabled, the user receives the high-stream video by default. - By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. - This method allows the app to adjust the corresponding video stream type based on the size of the video window to - reduce the bandwidth and resources. The aspect ratio of the low-video stream is the same as the high-quality video stream. - Once the resolution of the high-quality video - stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - - @note You can call this method either before or after joining a channel. If you call both - \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" and - \ref IRtcEngine::setRemoteDefaultVideoStreamType "setRemoteDefaultVideoStreamType", the SDK applies the settings in - the \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" method. + The result after calling this method is returned in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -6032,38 +4854,29 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; /** Enables the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at a set time interval to report on which users are speaking and the speakers' volume. Once this method is enabled, the SDK returns the volume indication in the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the set time interval, whether or not any user is speaking in the channel. - @note You can call this method either before or after joining a channel. - @param interval Sets the time interval between two consecutive volume indications: - ≤ 0: Disables the volume indication. - > 0: Time interval (ms) between two consecutive volume indications. We recommend setting @p interval > 200 ms. Do not set @p interval < 10 ms, or the *onAudioVolumeIndication* callback will not be triggered. @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. - @param report_vad - - true: Enable the voice activity detection of the local user. Once it is enabled, the `vad` parameter of the `onAudioVolumeIndication` callback reports the voice activity status of the local user. - - false: (Default) Disable the voice activity detection of the local user. Once it is disabled, the `vad` parameter of the `onAudioVolumeIndication` callback does not report the voice activity status of the local user, except for the scenario where the engine automatically detects the voice activity of the local user. @return - 0: Success. - < 0: Failure. */ - virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; - /** @deprecated Starts an audio recording. - - Use \ref IRtcEngine::startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) "startAudioRecording"2 instead. + virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; + /** Starts an audio recording. The SDK allows recording during a call. Supported formats: - .wav: Large file size with high fidelity. - .aac: Small file size with low fidelity. - This method has a fixed sample rate of 32 kHz. - Ensure that the directory to save the recording file exists and is writable. This method is usually called after the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. The recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. @@ -6075,33 +4888,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; - - /** Starts an audio recording on the client. - * - * The SDK allows recording during a call. After successfully calling this method, you can record the audio of all the users in the channel and get an audio recording file. - * Supported formats of the recording file are as follows: - * - .wav: Large file size with high fidelity. - * - .aac: Small file size with low fidelity. - * - * @note - * - Ensure that the directory you use to save the recording file exists and is writable. - * - This method is usually called after the `joinChannel` method. The recording automatically stops when you call the `leaveChannel` method. - * - For better recording effects, set quality as #AUDIO_RECORDING_QUALITY_MEDIUM or #AUDIO_RECORDING_QUALITY_HIGH when `sampleRate` is 44.1 kHz or 48 kHz. - * - * @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8, such as c:/music/audio.aac. - * @param sampleRate Sample rate (kHz) of the recording file. Supported values are as follows: - * - 16 - * - (Default) 32 - * - 44.1 - * - 48 - * @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; /** Stops an audio recording on the client. You can call this method before calling the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method else, the recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. @@ -6110,7 +4897,7 @@ class IRtcEngine - 0: Success - < 0: Failure. */ - virtual int stopAudioRecording() = 0; + virtual int stopAudioRecording() = 0; /** Starts playing and mixing the music file. This method mixes the specified local audio file with the audio stream from the microphone, or replaces the microphone's audio stream with the specified local audio file. You can choose whether the other user can hear the local audio playback and specify the number of playback loops. This method also supports online music playback. @@ -6121,25 +4908,25 @@ class IRtcEngine When the audio mixing file playback finishes, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingStateChanged "onAudioMixingStateChanged" (STOPPED) callback on the local client. @note - - Call this method after joining a channel, otherwise issues may occur. + - Call this method when you are in a channel. - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - - If you want to play an online music file, ensure that the time interval between calling this method is more than 100 ms, or the AUDIO_MIXING_ERROR_TOO_FREQUENT_CALL(702) error code occurs. - @param filePath Pointer to the absolute path (including the suffixes of the filename) of the local or online audio file to mix, for example, c:/music/audio.mp4. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MP4, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). + + @param filePath Pointer to the absolute path of the local or online audio file to mix. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). @param loopback Sets which user can hear the audio mixing: - true: Only the local user can hear the audio mixing. - false: Both users can hear the audio mixing. @param replace Sets the audio mixing content: - - true: Only publish the specified audio file. The audio stream from the microphone is not published. + - true: Only the specified audio file is published; the audio stream received by the microphone is not published. - false: The local audio file is mixed with the audio stream from the microphone. @param cycle Sets the number of playback loops: - Positive integer: Number of playback loops. - - `-1`: Infinite playback loops. + - -1: Infinite playback loops. @return - 0: Success. - < 0: Failure. */ - virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; + virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; /** Stops playing and mixing the music file. Call this method when you are in a channel. @@ -6148,7 +4935,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int stopAudioMixing() = 0; + virtual int stopAudioMixing() = 0; /** Pauses playing and mixing the music file. Call this method when you are in a channel. @@ -6157,7 +4944,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int pauseAudioMixing() = 0; + virtual int pauseAudioMixing() = 0; /** Resumes playing and mixing the music file. Call this method when you are in a channel. @@ -6166,33 +4953,10 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int resumeAudioMixing() = 0; - /** **DEPRECATED** Agora does not recommend using this method. - - Sets the high-quality audio preferences. Call this method and set all parameters before joining a channel. - - Do not call this method again after joining a channel. - - @param fullband Sets whether to enable/disable full-band codec (48-kHz sample rate). Not compatible with SDK versions before v1.7.4: - - true: Enable full-band codec. - - false: Disable full-band codec. - @param stereo Sets whether to enable/disable stereo codec. Not compatible with SDK versions before v1.7.4: - - true: Enable stereo codec. - - false: Disable stereo codec. - @param fullBitrate Sets whether to enable/disable high-bitrate mode. Recommended in voice-only mode: - - true: Enable high-bitrate mode. - - false: Disable high-bitrate mode. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) = 0; + virtual int resumeAudioMixing() = 0; /** Adjusts the volume during audio mixing. - @note - - Calling this method does not affect the volume of audio effect file playback invoked by the \ref agora::rtc::IRtcEngine::playEffect "playEffect" method. - - Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". + Call this method when you are in a channel. @param volume Audio mixing volume. The value ranges between 0 and 100 (default). @@ -6200,10 +4964,10 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int adjustAudioMixingVolume(int volume) = 0; + virtual int adjustAudioMixingVolume(int volume) = 0; /** Adjusts the audio mixing volume for local playback. - @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". + @note Call this method when you are in a channel. @param volume Audio mixing volume for local playback. The value ranges between 0 and 100 (default). @@ -6225,7 +4989,7 @@ class IRtcEngine virtual int getAudioMixingPlayoutVolume() = 0; /** Adjusts the audio mixing volume for publishing (for remote users). - @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". + @note Call this method when you are in a channel. @param volume Audio mixing volume for publishing. The value ranges between 0 and 100 (default). @@ -6254,7 +5018,7 @@ class IRtcEngine - ≥ 0: The audio mixing duration, if this method call succeeds. - < 0: Failure. */ - virtual int getAudioMixingDuration() = 0; + virtual int getAudioMixingDuration() = 0; /** Retrieves the playback position (ms) of the music file. Call this method when you are in a channel. @@ -6263,63 +5027,37 @@ class IRtcEngine - ≥ 0: The current playback position of the audio mixing, if this method call succeeds. - < 0: Failure. */ - virtual int getAudioMixingCurrentPosition() = 0; + virtual int getAudioMixingCurrentPosition() = 0; /** Sets the playback position of the music file to a different starting position (the default plays from the beginning). - @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". - @param pos The playback starting position (ms) of the music file. @return - 0: Success. - < 0: Failure. */ - virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; - /** Sets the pitch of the local music file. - * @since v3.0.1 - * - * When a local music file is mixed with a local human voice, call this method to set the pitch of the local music file only. - * - * @note - * Call this method after calling `startAudioMixing`. - * - * @param pitch Sets the pitch of the local music file by chromatic scale. The default value is 0, - * which means keeping the original pitch. The value ranges from -12 to 12, and the pitch value between - * consecutive values is a chromatic value. The greater the absolute value of this parameter, the - * higher or lower the pitch of the local music file. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int setAudioMixingPitch(int pitch) = 0; + virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; /** Retrieves the volume of the audio effects. The value ranges between 0.0 and 100.0. - @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". - @return - ≥ 0: Volume of the audio effects, if this method call succeeds. - < 0: Failure. */ - virtual int getEffectsVolume() = 0; + virtual int getEffectsVolume() = 0; /** Sets the volume of the audio effects. - @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". - @param volume Sets the volume of the audio effects. The value ranges between 0 and 100 (default). @return - 0: Success. - < 0: Failure. */ - virtual int setEffectsVolume(int volume) = 0; + virtual int setEffectsVolume(int volume) = 0; /** Sets the volume of a specified audio effect. - @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". - @param soundId ID of the audio effect. Each audio effect has a unique ID. @param volume Sets the volume of the specified audio effect. The value ranges between 0 and 100 (default). @@ -6327,33 +5065,8 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setVolumeOfEffect(int soundId, int volume) = 0; + virtual int setVolumeOfEffect(int soundId, int volume) = 0; -#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) - /** - * Enables/Disables face detection for the local user. - * - * @since v3.0.1 - * - * @note - * - Applies to Android and iOS only. - * - You can call this method either before or after joining a channel. - * - * Once face detection is enabled, the SDK triggers the \ref IRtcEngineEventHandler::onFacePositionChanged "onFacePositionChanged" callback - * to report the face information of the local user, which includes the following aspects: - * - The width and height of the local video. - * - The position of the human face in the local video. - * - The distance between the human face and the device screen. - * - * @param enable Determines whether to enable the face detection function for the local user: - * - true: Enable face detection. - * - false: (Default) Disable face detection. - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int enableFaceDetection(bool enable) = 0; -#endif /** Plays a specified local or online audio effect file. This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. @@ -6365,9 +5078,8 @@ class IRtcEngine @note - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. - Playing multiple online audio effect files simultaneously is not supported on macOS and Windows. - - Ensure that you call this method after joining a channel. - @param filePath Specifies the absolute path (including the suffixes of the filename) to the local audio effect file or the URL of the online audio effect file, for example, c:/music/audio.mp4. Supported audio formats: mp3, mp4, m4a, aac, 3gp, mkv and wav. + @param filePath The absolute path to the local audio effect file or the URL of the online audio effect file. @param loopCount Sets the number of times the audio effect loops: - 0: Play the audio effect once. - 1: Play the audio effect twice. @@ -6386,7 +5098,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) = 0; + virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false, int startPos = 0) = 0; /** Stops playing a specified audio effect. @param soundId ID of the audio effect to stop playing. Each audio effect has a unique ID. @@ -6395,14 +5107,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int stopEffect(int soundId) = 0; + virtual int stopEffect(int soundId) = 0; /** Stops playing all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int stopAllEffects() = 0; + virtual int stopAllEffects() = 0; /** Preloads a specified audio effect file into the memory. @@ -6419,7 +5131,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int preloadEffect(int soundId, const char* filePath) = 0; + virtual int preloadEffect(int soundId, const char* filePath) = 0; /** Releases a specified preloaded audio effect from the memory. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -6427,7 +5139,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int unloadEffect(int soundId) = 0; + virtual int unloadEffect(int soundId) = 0; /** Pauses a specified audio effect. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -6435,14 +5147,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int pauseEffect(int soundId) = 0; + virtual int pauseEffect(int soundId) = 0; /** Pauses all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int pauseAllEffects() = 0; + virtual int pauseAllEffects() = 0; /** Resumes playing a specified audio effect. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -6450,14 +5162,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int resumeEffect(int soundId) = 0; + virtual int resumeEffect(int soundId) = 0; /** Resumes playing all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int resumeAllEffects() = 0; + virtual int resumeAllEffects() = 0; /** Enables/Disables stereo panning for remote users. Ensure that you call this method before joinChannel to enable stereo panning for remote users so that the local user can track the position of a remote user by calling \ref agora::rtc::IRtcEngine::setRemoteVoicePosition "setRemoteVoicePosition". @@ -6478,7 +5190,6 @@ class IRtcEngine @note - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. - - Ensure that you call this method after joining a channel. @param uid The ID of the remote user. @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: @@ -6495,32 +5206,26 @@ class IRtcEngine /** Changes the voice pitch of the local speaker. - @note You can call this method either before or after joining a channel. - @param pitch Sets the voice pitch. The value ranges between 0.5 and 2.0. The lower the value, the lower the voice pitch. The default value is 1.0 (no change to the local voice pitch). @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVoicePitch(double pitch) = 0; + virtual int setLocalVoicePitch(double pitch) = 0; /** Sets the local voice equalization effect. - @note You can call this method either before or after joining a channel. - - @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 250, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. + @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. @param bandGain Sets the gain of each band in dB. The value ranges between -15 and 15. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; + virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; /** Sets the local voice reverberation. v2.4.0 adds the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, a more user-friendly method for setting the local voice reverberation. You can use this method to set the local reverberation effect, such as pop music, R&B, rock music, and hip-hop. - @note You can call this method either before or after joining a channel. - @param reverbKey Sets the reverberation key. See #AUDIO_REVERB_TYPE. @param value Sets the value of the reverberation key. @@ -6528,366 +5233,148 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; + virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; /** Sets the local voice changer option. - @deprecated Deprecated from v3.2.0. Use \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" or - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" instead. + @note Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, because the method called later overrides the one called earlier. - This method can be used to set the local voice effect for users in a `COMMUNICATION` channel or hosts in a `LIVE_BROADCASTING` channel. - Voice changer options include the following voice effects: + @param voiceChanger Sets the local voice changer option. See #VOICE_CHANGER_PRESET. - - `VOICE_CHANGER_XXX`: Changes the local voice to an old man, a little boy, or the Hulk. Applies to the voice talk scenario. - - `VOICE_BEAUTY_XXX`: Beautifies the local voice by making it sound more vigorous, resounding, or adding spacial resonance. Applies to the voice talk and singing scenario. - - `GENERAL_VOICE_BEAUTY_XXX`: Adds gender-based beautification effect to the local voice. Applies to the voice talk scenario. - - For a male voice: Adds magnetism to the voice. - - For a female voice: Adds freshness or vitality to the voice. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; + /** Sets the preset local voice reverberation effect. @note - - To achieve better voice effect quality, Agora recommends setting the profile parameter in \ref IRtcEngine::setAudioProfile "setAudioProfile" as #AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) or #AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO (5) - - This method works best with the human voice, and Agora does not recommend using it for audio containing music and a human voice. - - Do not use this method with \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" , because the method called later overrides the one called earlier. For detailed considerations, see the advanced guide *Voice Changer and Reverberation*. - - You can call this method either before or after joining a channel. + - Do not use this method together with \ref agora::rtc::IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb". + - Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" method, because the method called later overrides the one called earlier. - @param voiceChanger Sets the local voice changer option. The default value is #VOICE_CHANGER_OFF, which means the original voice. See details in #VOICE_CHANGER_PRESET - Gender-based beatification effect works best only when assigned a proper gender: - - For male: #GENERAL_BEAUTY_VOICE_MALE_MAGNETIC - - For female: #GENERAL_BEAUTY_VOICE_FEMALE_FRESH or #GENERAL_BEAUTY_VOICE_FEMALE_VITALITY - Failure to do so can lead to voice distortion. + @param reverbPreset Sets the preset audio reverberation configuration. See #AUDIO_REVERB_PRESET. @return - 0: Success. - - < 0: Failure. Check if the enumeration is properly set. - */ - virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; - /** Sets the local voice reverberation option, including the virtual stereo. - * - * @deprecated Deprecated from v3.2.0. Use \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" or - * \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" instead. - * - * This method sets the local voice reverberation for users in a `COMMUNICATION` channel or hosts in a `LIVE_BROADCASTING` channel. - * After successfully calling this method, all users in the channel can hear the voice with reverberation. - * - * @note - * - When calling this method with enumerations that begin with `AUDIO_REVERB_FX`, ensure that you set profile in `setAudioProfile` as - * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`; otherwise, this methods cannot set the corresponding voice reverberation option. - * - When calling this method with `AUDIO_VIRTUAL_STEREO`, Agora recommends setting the `profile` parameter in `setAudioProfile` as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. - * - This method works best with the human voice, and Agora does not recommend using it for audio containing music and a human voice. - * - Do not use this method with `setLocalVoiceChanger`, because the method called later overrides the one called earlier. - * For detailed considerations, see the advanced guide *Voice Changer and Reverberation*. - * - You can call this method either before or after joining a channel. - * - * @param reverbPreset The local voice reverberation option. The default value is `AUDIO_REVERB_OFF`, - * which means the original voice. See #AUDIO_REVERB_PRESET. - * To achieve better voice effects, Agora recommends the enumeration whose name begins with `AUDIO_REVERB_FX`. - * - * @return - * - 0: Success. - * - < 0: Failure. + - < 0: Failure. */ virtual int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) = 0; - /** Sets an SDK preset voice beautifier effect. - * - * @since v3.2.0 - * - * Call this method to set an SDK preset voice beautifier effect for the local user who sends an audio stream. After - * setting a voice beautifier effect, all users in the channel can hear the effect. - * - * You can set different voice beautifier effects for different scenarios. See *Set the Voice Beautifier and Audio Effects*. - * - * To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and - * setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` and the `profile` parameter to - * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before calling this method. - * - * @note - * - You can call this method either before or after joining a channel. - * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" to `AUDIO_PROFILE_SPEECH_STANDARD(1)` - * or `AUDIO_PROFILE_IOT(6)`; otherwise, this method call fails. - * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. - * - After calling this method, Agora recommends not calling the following methods, because they can override \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters": - * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" - * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" - * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" - * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" - * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" - * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" - * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" - * - * @param preset The options for SDK preset voice beautifier effects: #VOICE_BEAUTIFIER_PRESET. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) = 0; - /** Sets an SDK preset audio effect. - * - * @since v3.2.0 - * - * Call this method to set an SDK preset audio effect for the local user who sends an audio stream. This audio effect - * does not change the gender characteristics of the original voice. After setting an audio effect, all users in the - * channel can hear the effect. - * - * You can set different audio effects for different scenarios. See *Set the Voice Beautifier and Audio Effects*. - * - * To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` before calling this method. - * - * @note - * - You can call this method either before or after joining a channel. - * - Do not set the profile `parameter` of `setAudioProfile` to `AUDIO_PROFILE_SPEECH_STANDARD(1)` or `AUDIO_PROFILE_IOT(6)`; - * otherwise, this method call fails. - * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. - * - If you call this method and set the `preset` parameter to enumerators except `ROOM_ACOUSTICS_3D_VOICE` or `PITCH_CORRECTION`, - * do not call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters"; otherwise, `setAudioEffectParameters` - * overrides this method. - * - After calling this method, Agora recommends not calling the following methods, because they can override `setAudioEffectPreset`: - * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" - * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" - * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" - * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" - * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" - * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" - * - * @param preset The options for SDK preset audio effects. See #AUDIO_EFFECT_PRESET. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset) = 0; - /** Sets parameters for SDK preset audio effects. - * - * @since v3.2.0 - * - * Call this method to set the following parameters for the local user who send an audio stream: - * - 3D voice effect: Sets the cycle period of the 3D voice effect. - * - Pitch correction effect: Sets the basic mode and tonic pitch of the pitch correction effect. Different songs - * have different modes and tonic pitches. Agora recommends bounding this method with interface elements to enable - * users to adjust the pitch correction interactively. - * - * After setting parameters, all users in the channel can hear the relevant effect. - * - * You can call this method directly or after \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset". If you - * call this method after \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset", ensure that you set the preset - * parameter of `setAudioEffectPreset` to `ROOM_ACOUSTICS_3D_VOICE` or `PITCH_CORRECTION` and then call this method - * to set the same enumerator; otherwise, this method overrides `setAudioEffectPreset`. - * - * @note - * - You can call this method either before or after joining a channel. - * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" - * and setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` before calling this method. - * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" to `AUDIO_PROFILE_SPEECH_STANDARD(1)` or - * `AUDIO_PROFILE_IOT(6)`; otherwise, this method call fails. - * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. - * - After calling this method, Agora recommends not calling the following methods, because they can override `setAudioEffectParameters`: - * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" - * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" - * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" - * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" - * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" - * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" - * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" - * - * @param preset The options for SDK preset audio effects: - * - 3D voice effect: `ROOM_ACOUSTICS_3D_VOICE`. - * - Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` - * or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator; otherwise, the enumerator setting does not take effect. - * - If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect. - * - Pitch correction effect: `PITCH_CORRECTION`. To achieve better audio effect quality, Agora recommends calling - * \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or - * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator. - * @param param1 - * - If you set `preset` to `ROOM_ACOUSTICS_3D_VOICE`, the `param1` sets the cycle period of the 3D voice effect. - * The value range is [1,60] and the unit is a second. The default value is 10 seconds, indicating that the voice moves - * around you every 10 seconds. - * - If you set `preset` to `PITCH_CORRECTION`, `param1` sets the basic mode of the pitch correction effect: - * - `1`: (Default) Natural major scale. - * - `2`: Natural minor scale. - * - `3`: Japanese pentatonic scale. - * @param param2 - * - If you set `preset` to `ROOM_ACOUSTICS_3D_VOICE`, you do not need to set `param2`. - * - If you set `preset` to `PITCH_CORRECTION`, `param2` sets the tonic pitch of the pitch correction effect: - * - `1`: A - * - `2`: A# - * - `3`: B - * - `4`: (Default) C - * - `5`: C# - * - `6`: D - * - `7`: D# - * - `8`: E - * - `9`: F - * - `10`: F# - * - `11`: G - * - `12`: G# - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2) = 0; - /** Sets the log files that the SDK outputs. - * - * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with a default size of 1024 KB. - * These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is full, the SDK deletes the log file with the earliest - * modification time among the other four, renames `agorasdk.log` to the name of the deleted log file, and create a new `agorasdk.log` to record latest logs. - * - * @note Ensure that you call this method immediately after calling \ref agora::rtc::IRtcEngine::initialize "initialize" , otherwise the output logs may not be complete. - * - * @see \ref IRtcEngine::setLogFileSize "setLogFileSize" - * @see \ref IRtcEngine::setLogFilter "setLogFilter" - * - * @param filePath The absolute path of log files. The default file path is `C: \Users\\AppData\Local\Agora\\agorasdk.log`. - * Ensure that the directory for the log files exists and is writable. You can use this parameter to rename the log files. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int setLogFile(const char* filePath) = 0; - /** Sets the output log level of the SDK. - You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. + /** Specifies an SDK output log file. - If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. + The log file records all SDK operations during runtime. If it does not exist, the SDK creates one. - @see \ref IRtcEngine::setLogFile "setLogFile" - @see \ref IRtcEngine::setLogFileSize "setLogFileSize" + @note + - The default log file is located at: C:\Users\\AppData\Local\Agora\. + - Ensure that you call this method immediately after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method, otherwise the output log may not be complete. - @param filter Sets the log filter level. See #LOG_FILTER_TYPE. + @param filePath File path of the log file. The string of the log file is in UTF-8. @return - 0: Success. - < 0: Failure. */ - virtual int setLogFilter(unsigned int filter) = 0; - /** Sets the size of a log file that the SDK outputs. - * - * - * @note If you want to set the log file size, ensure that you call - * this method before \ref IRtcEngine::setLogFile "setLogFile", or the logs are cleared. - * - * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with a default size of 1024 KB. - * These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is full, the SDK deletes the log file with the earliest - * modification time among the other four, renames `agorasdk.log` to the name of the deleted log file, and create a new `agorasdk.log` to record latest logs. - * - * @see \ref IRtcEngine::setLogFile "setLogFile" - * @see \ref IRtcEngine::setLogFilter "setLogFilter" - * - * @param fileSizeInKBytes The size (KB) of a log file. The default value is 1024 KB. If you set `fileSizeInKByte` to 1024 KB, - * the SDK outputs at most 5 MB log files; if you set it to less than 1024 KB, the maximum size of a log file is still 1024 KB. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; - /** - @deprecated This method is deprecated, use the \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode"2 method instead. - Sets the local video display mode. + virtual int setLogFile(const char* filePath) = 0; + + /** Specifies an SDK external log writer. - This method can be called multiple times during a call to change the display mode. + The external log writer output all SDK operations during runtime if it exist. + + @note + - Ensure that you call this method after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method. + + @param pLogWriter . - @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; - /** Updates the display mode of the local video view. - - @since v3.0.0 - - After initializing the local video view, you can call this method to update its rendering and mirror modes. It affects only the video view that the local user sees, not the published local video stream. - + virtual int setLogWriter(agora::commons::ILogWriter* pLogWriter) = 0; + + /** Set the value of external log writer to null @note - - Ensure that you have called the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view before calling this method. - - During a call, you can call this method as many times as necessary to update the display mode of the local video view. - @param renderMode The rendering mode of the local video view. See #RENDER_MODE_TYPE. - @param mirrorMode - - The mirror mode of the local video view. See #VIDEO_MIRROR_MODE_TYPE. - - **Note**: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. + - Ensure that you call this method after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method. + @return - 0: Success. - < 0: Failure. */ - virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** - @deprecated This method is deprecated, use the \ref IRtcEngine::setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setRemoteRenderMode"2 method instead. - Sets the video display mode of a specified remote user. + virtual int releaseLogWriter() = 0; + + /** Sets the output log level of the SDK. - This method can be called multiple times during a call to change the display mode. + You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. + + If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. + + @param filter Sets the log filter level. See #LOG_FILTER_TYPE. - @param userId ID of the remote user. - @param renderMode Sets the video display mode. See #RENDER_MODE_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; - /** Updates the display mode of the video view of a remote user. + virtual int setLogFilter(unsigned int filter) = 0; + /** Sets the log file size (KB). - @since v3.0.0 - After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. This method affects only the video view that the local user sees. + The SDK has two log files, each with a default size of 512 KB. If you set @p fileSizeInBytes as 1024 KB, the SDK outputs log files with a total maximum size of 2 MB. If the total size of the log files exceed the set value, the new output log files overwrite the old output log files. - @note - - Ensure that you have called the \ref IRtcEngine::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view before calling this method. - - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. + @param fileSizeInKBytes The SDK log file size (KB). + @return + - 0: Success. + - <0: Failure. + */ + virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; + /** Sets the local video display mode. - @param userId The ID of the remote user. - @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. - @param mirrorMode - - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. - - **Note**: The SDK disables the mirror mode by default. + This method can be called multiple times during a call to change the display mode. + @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** - @deprecated This method is deprecated, use the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" - or \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" method instead. + virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; + /** Sets the video display mode of a specified remote user. + + This method can be called multiple times during a call to change the display mode. - Sets the local video mirror mode. + @param userId ID of the remote user. + @param renderMode Sets the video display mode. See #RENDER_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; + /** Sets the local video mirror mode. - @warning Call this method after calling the \ref agora::rtc::IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view. + You must call this method before calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, otherwise the mirror mode will not work. @param mirrorMode Sets the local video mirror mode. See #VIDEO_MIRROR_MODE_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** Sets the stream mode to the single-stream (default) or dual-stream mode. (`LIVE_BROADCASTING` only.) + virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** Sets the stream mode to the single-stream (default) or dual-stream mode. (Live broadcast only.) If the dual-stream mode is enabled, the receiver can choose to receive the high stream (high-resolution and high-bitrate video stream), or the low stream (low-resolution and low-bitrate video stream). - @note You can call this method either before or after joining a channel. - @param enabled Sets the stream mode: - true: Dual-stream mode. - - false: Single-stream mode. + - false: (Default) Single-stream mode. */ - virtual int enableDualStreamMode(bool enabled) = 0; - /** Sets the external audio source. - - @note Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" - and \ref IRtcEngine::startPreview "startPreview". + virtual int enableDualStreamMode(bool enabled) = 0; + /** Sets the external audio source. Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". @param enabled Sets whether to enable/disable the external audio source: - true: Enables the external audio source. - false: (Default) Disables the external audio source. - @param sampleRate Sets the sample rate (Hz) of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param channels Sets the number of audio channels of the external audio source: - - 1: Mono. - - 2: Stereo. - + @param sampleRate Sets the sample rate of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channels Sets the audio channels of the external audio source (two channels maximum). @return - 0: Success. - < 0: Failure. */ - virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; + virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; /** Sets the external audio sink. * This method applies to scenarios where you want to use external audio * data for playback. After enabling the external audio sink, you can call @@ -6895,15 +5382,15 @@ class IRtcEngine * it, and play it with the audio effects that you want. * * @note - * - Once you enable the external audio sink, the app will not retrieve any + * Once you enable the external audio sink, the app will not retrieve any * audio data from the * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. - * - Ensure that you call this method before joining a channel. * * @param enabled * - true: Enables the external audio sink. * - false: (Default) Disables the external audio sink. - * @param sampleRate Sets the sample rate (Hz) of the external audio sink, which can be set as 16000, 32000, 44100 or 48000. + * @param sampleRate Sets the sample rate of the external audio sink. You + * can set this parameter as 8000, 16000, 32000, 44100 or 48000. * @param channels Sets the number of audio channels of the external * audio sink: * - 1: Mono. @@ -6916,99 +5403,76 @@ class IRtcEngine virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels) = 0; /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. - @note Ensure that you call this method before joining a channel. - @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onRecordAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param channel Sets the number of audio channels (@p channels) returned in the *onRecordAudioFrame* callback: - 1: Mono - 2: Stereo @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onRecordAudioFrame* callback. - @param samplesPerCall Sets the number of samples returned in the *onRecordAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. - + @param samplesPerCall Sets the sample points (@p samples) returned in the *onRecordAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. - @note The SDK triggers the `onRecordAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). + samplesPerCall = (int)(samplesPerSec × sampleInterval × numChannels), where sampleInterval ≥ 0.01 in seconds. @return - 0: Success. - < 0: Failure. */ - virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; /** Sets the audio playback format for the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. - @note Ensure that you call this method before joining a channel. - @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onPlaybackAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param channel Sets the number of channels (@p channels) returned in the *onPlaybackAudioFrame* callback: - 1: Mono - 2: Stereo @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onPlaybackAudioFrame* callback. - @param samplesPerCall Sets the number of samples returned in the *onPlaybackAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. + @param samplesPerCall Sets the sample points (*samples*) returned in the *onPlaybackAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. - @note The SDK triggers the `onPlaybackAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). + samplesPerCall = (int)(samplesPerSec × sampleInterval × numChannels), where sampleInterval ≥ 0.01 in seconds. @return - 0: Success. - < 0: Failure. */ - virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; /** Sets the mixed audio format for the \ref agora::media::IAudioFrameObserver::onMixedAudioFrame "onMixedAudioFrame" callback. - @note Ensure that you call this method before joining a channel. - @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onMixedAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param samplesPerCall Sets the number of samples (`samples`) returned in the *onMixedAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP streaming. + @param samplesPerCall Sets the sample points (@p samples) returned in the *onMixedAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. - @note The SDK triggers the `onMixedAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channels`). + samplesPerCall = (int)(samplesPerSec × sampleInterval × numChannels), where sampleInterval ≥ 0.01 in seconds. @return - 0: Success. - < 0: Failure. */ - virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; + virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; /** Adjusts the recording volume. - @note You can call this method either before or after joining a channel. - - @param volume Recording volume. To avoid echoes and - improve call quality, Agora recommends setting the value of volume between - 0 and 100. If you need to set the value higher than 100, contact - support@agora.io first. + @param volume Recording volume. The value ranges between 0 and 400: - 0: Mute. - 100: Original volume. - + - 400: (Maximum) Four times the original volume with signal clipping protection. @return - 0: Success. - < 0: Failure. */ - virtual int adjustRecordingSignalVolume(int volume) = 0; - /** Adjusts the playback volume of all remote users. + virtual int adjustRecordingSignalVolume(int volume) = 0; + /** Adjusts the playback volume. - @note - - This method adjusts the playback volume that is the mixed volume of all remote users. - - You can call this method either before or after joining a channel. - - (Since v2.3.2) To mute the local audio playback, call both the `adjustPlaybackSignalVolume` and \ref IRtcEngine::adjustAudioMixingVolume "adjustAudioMixingVolume" methods and set the volume as `0`. - - @param volume The playback volume of all remote users. To avoid echoes and - improve call quality, Agora recommends setting the value of volume between - 0 and 100. If you need to set the value higher than 100, contact - support@agora.io first. + @param volume Playback volume. The value ranges between 0 and 400: - 0: Mute. - 100: Original volume. + - 400: (Maximum) Four times the original volume with signal clipping protection. @return - 0: Success. - < 0: Failure. */ - virtual int adjustPlaybackSignalVolume(int volume) = 0; + virtual int adjustPlaybackSignalVolume(int volume) = 0; - /** - @deprecated This method is deprecated. As of v3.0.0, the Native SDK automatically enables interoperability with the Web SDK, so you no longer need to call this method. - Enables interoperability with the Agora Web SDK. + /** Enables interoperability with the Agora Web SDK. - @note - - This method applies only to the `LIVE_BROADCASTING` profile. In the `COMMUNICATION` profile, interoperability with the Agora Web SDK is enabled by default. - - If the channel has Web SDK users, ensure that you call this method, or the video of the Native user will be a black screen for the Web user. + @note This method applies only to the Live-broadcast profile. In the Communication profile, interoperability with the Agora Web SDK is enabled by default. @param enabled Sets whether to enable/disable interoperability with the Agora Web SDK: - true: Enable. @@ -7018,38 +5482,21 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int enableWebSdkInteroperability(bool enabled) = 0; - //only for live broadcast - /** **DEPRECATED** Sets the preferences for the high-quality video. (`LIVE_BROADCASTING` only). + virtual int enableWebSdkInteroperability(bool enabled) = 0; + /** Sets the fallback option for the locally published video stream based on the network conditions. - This method is deprecated as of v2.4.0. - - @param preferFrameRateOverImageQuality Sets the video quality preference: - - true: Frame rate over image quality. - - false: (Default) Image quality over frame rate. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setVideoQualityParameters(bool preferFrameRateOverImageQuality) = 0; - /** Sets the fallback option for the published video stream based on the network conditions. + The default setting for @p option is #STREAM_FALLBACK_OPTION_DISABLED, where there is no fallback behavior for the locally published video stream when the uplink network conditions are poor. - If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK will: + If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK will: - - Disable the upstream video but enable audio only when the network conditions deteriorate and cannot support both video and audio. + - Disable the upstream video but enable audio only when the network conditions worsen and cannot support both video and audio. - Re-enable the video when the network conditions improve. - When the published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. - - @note - - Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the published video stream falls back to audio only. - - Ensure that you call this method before joining a channel. + When the locally published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. - @param option Sets the fallback option for the published video stream: - - #STREAM_FALLBACK_OPTION_DISABLED (0): (Default) No fallback behavior for the published video stream when the uplink network condition is poor. The stream quality is not guaranteed. - - #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2): The published video stream falls back to audio only when the uplink network condition is poor. + @note Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the locally publish stream falls back to audio-only. + @param option Sets the fallback option for the locally published video stream. See #STREAM_FALLBACK_OPTIONS. @return - 0: Success. - < 0: Failure. @@ -7057,14 +5504,12 @@ class IRtcEngine virtual int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; /** Sets the fallback option for the remotely subscribed video stream based on the network conditions. - The default setting for `option` is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW (1), where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. + The default setting for @p option is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW, where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. - If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. + If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. When the remotely subscribed video stream falls back to audio only or when the audio-only stream switches back to the video stream, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRemoteSubscribeFallbackToAudioOnly "onRemoteSubscribeFallbackToAudioOnly" callback. - @note Ensure that you call this method before joining a channel. - @param option Sets the fallback option for the remotely subscribed video stream. See #STREAM_FALLBACK_OPTIONS. @return - 0: Success. @@ -7073,62 +5518,41 @@ class IRtcEngine virtual int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) - /** Switches between front and rear cameras. - - @note - - This method is for Android and iOS only. - - Ensure that you call this method after the camera starts, for example, by - calling \ref IRtcEngine::startPreview "startPreview" or \ref IRtcEngine::joinChannel "joinChannel". - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int switchCamera() = 0; - /// @cond - /** Switches between front and rear cameras. + /** Switches between front and rear cameras. @note This method is for Android and iOS only. - @note This method is private. - - @param direction Sets the camera to be used: - - CAMERA_DIRECTION.CAMERA_REAR: Use the rear camera. - - CAMERA_DIRECTION.CAMERA_FRONT: Use the front camera. @return - 0: Success. - < 0: Failure. */ - virtual int switchCamera(CAMERA_DIRECTION direction) = 0; - /// @endcond + virtual int switchCamera() = 0; /** Sets the default audio playback route. This method sets whether the received audio is routed to the earpiece or speakerphone by default before joining a channel. If a user does not call this method, the audio is routed to the earpiece by default. If you need to change the default audio route after joining a channel, call the \ref IRtcEngine::setEnableSpeakerphone "setEnableSpeakerphone" method. - The default setting for each profile: - - `COMMUNICATION`: In a voice call, the default audio route is the earpiece. In a video call, the default audio route is the speakerphone. If a user who is in the `COMMUNICATION` profile calls - the \ref IRtcEngine.disableVideo "disableVideo" method or if the user calls - the \ref IRtcEngine.muteLocalVideoStream "muteLocalVideoStream" and - \ref IRtcEngine.muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the - default audio route switches back to the earpiece automatically. - - `LIVE_BROADCASTING`: Speakerphone. + The default setting for each mode: + - Voice: Earpiece. + - Video: Speakerphone. If a user who is in the Communication profile calls the \ref IRtcEngine::disableVideo "disableVideo" method or if the user calls the \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" and \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the default audio route switches back to the earpiece automatically. + - Live Broadcast: Speakerphone. + - Gaming Voice: Speakerphone. @note - This method is for Android and iOS only. - - This method is applicable only to the `COMMUNICATION` profile. - - For iOS, this method only works in a voice call. + - This method only works in audio mode. - Call this method before calling the \ref IRtcEngine::joinChannel "joinChannel" method. + - Regardless of whether the audio is routed to the speakerphone or earpiece by default, once a headset is plugged in or Bluetooth device is connected, the default audio route changes. The default audio route switches to the earpiece once removing the headset or disconnecting the Bluetooth device. @param defaultToSpeaker Sets the default audio route: - - true: Route the audio to the speakerphone. If the playback device connects to the earpiece or Bluetooth, the audio cannot be routed to the speakerphone. - - false: (Default) Route the audio to the earpiece. If a headset is plugged in, the audio is routed to the headset. + - true: Speakerphone. + - false: (Default) Earpiece. @return - 0: Success. - < 0: Failure. */ - virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; + virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; /** Enables/Disables the audio playback route to the speakerphone. This method sets whether the audio is routed to the speakerphone or earpiece. @@ -7142,48 +5566,28 @@ class IRtcEngine - This method does not take effect if a headset is used. @param speakerOn Sets whether to route the audio to the speakerphone or earpiece: - - true: Route the audio to the speakerphone. If the playback device connects to the earpiece or Bluetooth, the audio cannot be routed to the speakerphone. - - false: Route the audio to the earpiece. If a headset is plugged in, the audio is routed to the headset. + - true: Route the audio to the speakerphone. + - false: Route the audio to the earpiece. @return - 0: Success. - < 0: Failure. */ - virtual int setEnableSpeakerphone(bool speakerOn) = 0; - /** Enables in-ear monitoring (for Android and iOS only). - * - * @note - * - Users must use wired earphones to hear their own voices. - * - You can call this method either before or after joining a channel. - * - * @param enabled Determines whether to enable in-ear monitoring. - * - true: Enable. - * - false: (Default) Disable. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int enableInEarMonitoring(bool enabled) = 0; + virtual int setEnableSpeakerphone(bool speakerOn) = 0; /** Sets the volume of the in-ear monitor. - * - * @note - * - This method is for Android and iOS only. - * - Users must use wired earphones to hear their own voices. - * - You can call this method either before or after joining a channel. - * - * @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). - * - * @return - * - 0: Success. - * - < 0: Failure. + + @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). + + @note This method is for Android and iOS only. + + @return + - 0: Success. + - < 0: Failure. */ - virtual int setInEarMonitoringVolume(int volume) = 0; + virtual int setInEarMonitoringVolume(int volume) = 0; /** Checks whether the speakerphone is enabled. - @note - - This method is for Android and iOS only. - - You can call this method either before or after joining a channel. + @note This method is for Android and iOS only. @return - 0: Success. @@ -7202,7 +5606,6 @@ class IRtcEngine @note - This method is for iOS only. - This method restricts the SDK’s manipulation of the audio session. Any operation to the audio session relies solely on the app, other apps, or third-party components. - - You can call this method either before or after joining a channel. @param restriction The operational restriction (bit mask) of the SDK on the audio session. See #AUDIO_SESSION_OPERATION_RESTRICTION. @@ -7218,8 +5621,6 @@ class IRtcEngine If you enable loopback recording, the output of the sound card is mixed into the audio stream sent to the other end. - @note You can call this method either before or after joining a channel. - @param enabled Sets whether to enable/disable loopback recording. - true: Enable loopback recording. - false: (Default) Disable loopback recording. @@ -7234,186 +5635,56 @@ class IRtcEngine #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) /** Shares the whole or part of a screen by specifying the display ID. - * - * @note - * - This method is for macOS only. - * - Ensure that you call this method after joining a channel. - * - * @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. - * @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. - * @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. - * - * - * @return - * - 0: Success. - * - < 0: Failure: - * - #ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being - * shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. - * - #ERR_INVALID_ARGUMENT: the argument is invalid. + + @note This method is for macOS and Windows only. + + @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. + @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + + + @return + - 0: Success. + - < 0: Failure: + - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. + - ERR_INVALID_ARGUMENT: the argument is invalid. */ virtual int startScreenCaptureByDisplayId(unsigned int displayId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; #endif #if defined(_WIN32) /** Shares the whole or part of a screen by specifying the screen rect. - * - * @note - * - Ensure that you call this method after joining a channel. - * - Applies to the Windows platform only. - * - * @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see the advanced guide *Share Screen*. - * @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. - * @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. - * - * @return - * - 0: Success. - * - < 0: Failure: - * - #ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being - * shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. - * - #ERR_INVALID_ARGUMENT : the argument is invalid. + + @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see [Share the Screen]. + @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + + @return + - 0: Success. + - < 0: Failure: + - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call stopScreenCapture to stop the current screen sharing. + - ERR_INVALID_ARGUMENT: the argument is invalid. */ virtual int startScreenCaptureByScreenRect(const Rectangle& screenRect, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; #endif /** Shares the whole or part of a window by specifying the window ID. - * - * @note - * - Ensure that you call this method after joining a channel. - * - Applies to the macOS and Windows platforms only. - * - * Since v3.0.0, this method supports window sharing of UWP (Universal Windows Platform) applications. - * - * Agora tests the mainstream UWP applications by using the lastest SDK, see details as follows: - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - * - *
OS versionSoftwareSoftware nameWhether support
win10Chrome76.0.3809.100No
Office Word18.1903.1152.0Yes
Office ExcelNo
Office PPTYes
WPS Word11.1.0.9145Yes
WPS Excel
WPS PPT
Media Player (come with the system)AllYes
win8ChromeAllYes
Office WordAllYes
Office Excel
Office PPT
WPS Word11.1.0.9098Yes
WPS Excel
WPS PPT
Media Player(come with the system)AllYes
win7Chrome73.0.3683.103No
Office WordAllYes
Office Excel
Office PPT
WPS Word11.1.0.9098No
WPS Excel
WPS PPT11.1.0.9098Yes
Media Player(come with the system)AllNo
- * @param windowId The ID of the window to be shared. For information on how to get the windowId, see the advanced guide *Share Screen*. - * @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. - * @param captureParams Window sharing encoding parameters. See ScreenCaptureParameters. - * - * @return - * - 0: Success. - * - < 0: Failure: - * - #ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being - * shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. - * - #ERR_INVALID_ARGUMENT: the argument is invalid. + + @param windowId The ID of the window to be shared. For information on how to get the windowId, see [Share the Window]. + @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. + @param captureParams Window sharing encoding parameters. See ScreenCaptureParameters. + + @return + - 0: Success. + - < 0: Failure: + - ERR_INVALID_STATE: the window sharing state is invalid, probably because another screen or window is being shared. Call stopScreenCapture to stop sharing the current window. + - ERR_INVALID_ARGUMENT: the argument is invalid. */ virtual int startScreenCaptureByWindowId(view_t windowId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; /** Sets the content hint for screen sharing. - A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. - - @note You can call this method either before or after you start screen sharing. + A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. @param contentHint Sets the content hint for screen sharing. See VideoContentHint. @@ -7430,7 +5701,7 @@ class IRtcEngine @return - 0: Success. - < 0: Failure: - - #ERR_NOT_READY: no screen or windows is being shared. + - ERR_NOT_READY: no screen or windows is being shared. */ virtual int updateScreenCaptureParameters(const ScreenCaptureParameters& captureParams) = 0; @@ -7441,7 +5712,7 @@ class IRtcEngine @return - 0: Success. - < 0: Failure: - - #ERR_NOT_READY: no screen or window is being shared. + - ERR_NOT_READY: no screen or window is being shared. */ virtual int updateScreenCaptureRegion(const Rectangle& regionRect) = 0; @@ -7495,25 +5766,6 @@ class IRtcEngine - < 0: Failure. */ virtual int updateScreenCaptureRegion(const Rect *rect) = 0; - -#endif - -#if defined(_WIN32) - /** Sets a custom video source. - * - * During real-time communication, the Agora SDK enables the default video input device, that is, the built-in camera to - * capture video. If you need a custom video source, implement the IVideoSource class first, and call this method to add - * the custom video source to the SDK. - * - * @note You can call this method either before or after joining a channel. - * - * @param source The custom video source. See IVideoSource. - * - * @return - * - true: The custom video source is added to the SDK. - * - false: The custom video source is not added to the SDK. - */ - virtual bool setVideoSource(IVideoSource *source) = 0; #endif /** Retrieves the current call ID. @@ -7522,8 +5774,6 @@ class IRtcEngine The \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods require the @p callId parameter retrieved from the *getCallId* method during a call. @p callId is passed as an argument into the \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods after the call ends. - @note Ensure that you call this method after joining a channel. - @param callId Pointer to the current call ID. @return @@ -7534,8 +5784,6 @@ class IRtcEngine /** Allows a user to rate a call after the call ends. - @note Ensure that you call this method after joining a channel. - @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. @param rating Rating of the call. The value is between 1 (lowest score) and 5 (highest score). If you set a value out of this range, the #ERR_INVALID_ARGUMENT (2) error returns. @param description (Optional) Pointer to the description of the rating, with a string length of less than 800 bytes. @@ -7548,8 +5796,6 @@ class IRtcEngine /** Allows a user to complain about the call quality after a call ends. - @note Ensure that you call this method after joining a channel. - @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. @param description (Optional) Pointer to the description of the complaint, with a string length of less than 800 bytes. @@ -7580,7 +5826,6 @@ class IRtcEngine @note - Do not call any other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" callback. Otherwise, the callback may be interrupted by other methods, and hence may not be triggered. - A host should not call this method after joining a channel (when in a call). - - If you call this method to test the last-mile quality, the SDK consumes the bandwidth of a video stream, whose bitrate corresponds to the bitrate you set in the \ref agora::rtc::IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. After you join the channel, whether you have called the `disableLastmileTest` method or not, the SDK automatically stops consuming the bandwidth. @return - 0: Success. @@ -7608,7 +5853,7 @@ class IRtcEngine @note - This method consumes extra network traffic and may affect communication quality. We do not recommend calling this method together with enableLastmileTest. - Do not call other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" and \ref IRtcEngineEventHandler::onLastmileProbeResult "onLastmileProbeResult" callbacks. Otherwise, the callbacks may be interrupted. - - In the `LIVE_BROADCASTING` profile, a host should not call this method after joining a channel. + - In the Live-broadcast profile, a host should not call this method after joining a channel. @param config Sets the configurations of the last-mile network probe test. See LastmileProbeConfig. @@ -7623,15 +5868,11 @@ class IRtcEngine /** Retrieves the warning or error description. - @param code Warning code or error code returned in the \ref agora::rtc::IRtcEngineEventHandler::onWarning "onWarning" or \ref agora::rtc::IRtcEngineEventHandler::onError "onError" callback. - - @return #WARN_CODE_TYPE or #ERROR_CODE_TYPE. + @return code #WARN_CODE_TYPE or #ERROR_CODE_TYPE returned in the \ref IRtcEngineEventHandler::onWarning "onWarning" or \ref IRtcEngineEventHandler::onError "onError" callback. */ virtual const char* getErrorDescription(int code) = 0; - /** **DEPRECATED** Enables built-in encryption with an encryption password before users join a channel. - - Deprecated as of v3.1.0. Use the \ref agora::rtc::IRtcEngine::enableEncryption "enableEncryption" instead. + /** Enables built-in encryption with an encryption password before users join a channel. All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. @@ -7649,9 +5890,7 @@ class IRtcEngine */ virtual int setEncryptionSecret(const char* secret) = 0; - /** **DEPRECATED** Sets the built-in encryption mode. - - @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IRtcEngine::enableEncryption "enableEncryption" instead. + /** Sets the built-in encryption mode. The Agora SDK supports built-in encryption, which is set to the @p aes-128-xts mode by default. Call this method to use other encryption modes. @@ -7673,42 +5912,10 @@ class IRtcEngine */ virtual int setEncryptionMode(const char* encryptionMode) = 0; - /** Enables/Disables the built-in encryption. - * - * @since v3.1.0 - * - * In scenarios requiring high security, Agora recommends calling this method to enable the built-in encryption before joining a channel. - * - * All users in the same channel must use the same encryption mode and encryption key. Once all users leave the channel, the encryption key of this channel is automatically cleared. - * - * @note - * - If you enable the built-in encryption, you cannot use the RTMP streaming function. - * - Agora supports four encryption modes. If you choose an encryption mode (excepting `SM4_128_ECB` mode), you need to add an external encryption library when integrating the Android and iOS SDK. See the advanced guide *Channel Encryption*. - * - * @param enabled Whether to enable the built-in encryption: - * - true: Enable the built-in encryption. - * - false: Disable the built-in encryption. - * @param config Configurations of built-in encryption schemas. See EncryptionConfig. - * - * @return - * - 0: Success. - * - < 0: Failure. - * - -2(ERR_INVALID_ARGUMENT): An invalid parameter is used. Set the parameter with a valid value. - * - -4(ERR_NOT_SUPPORTED): The encryption mode is incorrect or the SDK fails to load the external encryption library. Check the enumeration or reload the external encryption library. - * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Initialize the `IRtcEngine` instance before calling this method. - */ - virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; - /** Registers a packet observer. The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. - @note - - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. - - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. - - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. - - Call this method before joining a channel. - @param observer Pointer to the registered packet observer. See IPacketObserver. @return @@ -7719,13 +5926,11 @@ class IRtcEngine /** Creates a data stream. - Each user can create up to five data streams during the lifecycle of the IRtcEngine. + Each user can create up to five data streams during the lifecycle of the RtcEngine. - @note - - Set both the @p reliable and @p ordered parameters to true or false. Do not set one as true and the other as false. - - Ensure that you call this method after joining a channel. + @note Set both the @p reliable and @p ordered parameters to true or false. Do not set one as true and the other as false. - @param[out] streamId Pointer to the ID of the created data stream. + @param streamId Pointer to the ID of the created data stream. @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, an error is reported to the application. - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for any delay or missing data stream. @@ -7734,7 +5939,7 @@ class IRtcEngine - false: The recipients do not receive the data stream in the sent order. @return - - 0: Success. + - Returns 0: Success. - < 0: Failure. */ virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; @@ -7746,12 +5951,11 @@ class IRtcEngine - Each client can send up to 6 kB of data per second. - Each user can have up to five data streams simultaneously. - A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the - \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + + A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. + @note This method applies only to the Communication profile or to the hosts in the Live-broadcast profile. If an audience in the Live-broadcast profile calls this method, the audience may be switched to a host. - A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the - \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client. - @note This method applies only to the `COMMUNICATION` profile or to the hosts in the `LIVE_BROADCASTING` profile. If an audience in the `LIVE_BROADCASTING` profile calls this method, the audience may be switched to a host. @param streamId ID of the sent data stream, returned in the \ref IRtcEngine::createDataStream "createDataStream" method. @param data Pointer to the sent data. @param length Length of the sent data. @@ -7769,13 +5973,13 @@ class IRtcEngine The \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of adding a local stream to the CDN. @note - Ensure that the user joins the channel before calling this method. - - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. - This method adds only one stream RTMP URL address each time it is called. - - This method applies to `LIVE_BROADCASTING` only. + - The RTMP URL address must not contain special characters, such as Chinese language characters. + - This method applies to Live Broadcast only. - @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. The RTMP URL address must not contain special characters, such as Chinese language characters. + @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. @param transcodingEnabled Sets whether transcoding is enabled/disabled: - - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. If you set this parameter as `true`, ensure that you call the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method before this method. + - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. - false: Disable transcoding. @return @@ -7794,7 +5998,7 @@ class IRtcEngine @note - This method removes only one RTMP URL address each time it is called. - The RTMP URL address must not contain special characters, such as Chinese language characters. - - This method applies to `LIVE_BROADCASTING` only. + - This method applies to Live Broadcast only. @param url The RTMP URL address to be removed. The maximum length of this parameter is 1024 bytes. @@ -7805,14 +6009,7 @@ class IRtcEngine virtual int removePublishStreamUrl(const char *url) = 0; /** Sets the video layout and audio settings for CDN live. (CDN live only.) - - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you call the `setLiveTranscoding` method to update the transcoding setting. - - @note - - This method applies to `LIVE_BROADCASTING` only. - - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. - - If you call the `setLiveTranscoding` method to update the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. - - Ensure that you call this method after joining a channel. + @note This method applies to Live Broadcast only. @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. @@ -7822,9 +6019,7 @@ class IRtcEngine */ virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; - /** **DEPRECATED** Adds a watermark image to the local video or CDN live stream. - - This method is deprecated from v2.9.1. Use \ref agora::rtc::IRtcEngine::addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) "addVideoWatermark"2 instead. + /** Adds a watermark image to the local video or CDN live stream. This method adds a PNG watermark image to the local video stream for the recording device, channel audience, and CDN live audience to view and capture. @@ -7834,8 +6029,8 @@ class IRtcEngine @note - The URL descriptions are different for the local video and CDN live streams: - - In a local video stream, `url` in RtcImage refers to the absolute path of the added watermark image file in the local video stream. - - In a CDN live stream, `url` in RtcImage refers to the URL address of the added watermark image in the CDN live streaming. + - In a local video stream, @p url in RtcImage refers to the absolute path of the added watermark image file in the local video stream. + - In a CDN live stream, @p url in RtcImage refers to the URL address of the added watermark image in the CDN live broadcast. - The source file of the watermark image must be in the PNG file format. If the width and height of the PNG file differ from your settings in this method, the PNG file will be cropped to conform to your settings. - The Agora SDK supports adding only one watermark image onto a local video or CDN live stream. The newly added watermark image replaces the previous one. @@ -7845,34 +6040,7 @@ class IRtcEngine */ virtual int addVideoWatermark(const RtcImage& watermark) = 0; - /** Adds a watermark image to the local video. - - This method adds a PNG watermark image to the local video in the live streaming. Once the watermark image is added, all the audience in the channel (CDN audience included), - and the recording device can see and capture it. Agora supports adding only one watermark image onto the local video, and the newly watermark image replaces the previous one. - - The watermark position depends on the settings in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method: - - If the orientation mode of the encoding video is #ORIENTATION_MODE_FIXED_LANDSCAPE, or the landscape mode in #ORIENTATION_MODE_ADAPTIVE, the watermark uses the landscape orientation. - - If the orientation mode of the encoding video is #ORIENTATION_MODE_FIXED_PORTRAIT, or the portrait mode in #ORIENTATION_MODE_ADAPTIVE, the watermark uses the portrait orientation. - - When setting the watermark position, the region must be less than the dimensions set in the `setVideoEncoderConfiguration` method. Otherwise, the watermark image will be cropped. - - @note - - Ensure that you have called the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method to enable the video module before calling this method. - - If you only want to add a watermark image to the local video for the audience in the CDN live streaming channel to see and capture, you can call this method or the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. - - This method supports adding a watermark image in the PNG file format only. Supported pixel formats of the PNG image are RGBA, RGB, Palette, Gray, and Alpha_gray. - - If the dimensions of the PNG image differ from your settings in this method, the image will be cropped or zoomed to conform to your settings. - - If you have enabled the local video preview by calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, you can use the `visibleInPreview` member in the WatermarkOptions class to set whether or not the watermark is visible in preview. - - If you have enabled the mirror mode for the local video, the watermark on the local video is also mirrored. To avoid mirroring the watermark, Agora recommends that you do not use the mirror and watermark functions for the local video at the same time. You can implement the watermark function in your application layer. - - @param watermarkUrl The local file path of the watermark image to be added. This method supports adding a watermark image from the local absolute or relative file path. - @param options Pointer to the watermark's options to be added. See WatermarkOptions for more infomation. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) = 0; - - /** Removes the watermark image from the video stream added by the \ref agora::rtc::IRtcEngine::addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) "addVideoWatermark" method. + /** Removes the watermark image from the video stream added by the \ref IRtcEngine::addVideoWatermark "addVideoWatermark" method. @return - 0: Success. @@ -7880,21 +6048,23 @@ class IRtcEngine */ virtual int clearVideoWatermarks() = 0; - /** Enables/Disables image enhancement and sets the options. - * - * @note Call this method after calling the \ref IRtcEngine::enableVideo "enableVideo" method. - * - * @param enabled Sets whether or not to enable image enhancement: - * - true: enables image enhancement. - * - false: disables image enhancement. - * @param options Sets the image enhancement option. See BeautyOptions. + /** **Supports Android and iOS only!** Enables/Disables image enhancement and sets the options. + + @param enabled Sets whether or not to enable image enhancement: + - true: enables image enhancement. + - false: disables image enhancement. + @param options Sets the image enhancement option. See BeautyOptions. */ virtual int setBeautyEffectOptions(bool enabled, BeautyOptions options) = 0; - /** Adds a voice or video stream URL address to the live streaming. + /** Adds a voice or video stream URL address to a live broadcast. The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. + @note + - Contact support@agora.io to enable the CDN streaming function before calling this method. + - This method applies to the Native SDK v2.4.1 and later. + The \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: - The local client: - \ref agora::rtc::IRtcEngineEventHandler::onStreamInjectedStatus "onStreamInjectedStatus" , with the state of the injecting the online stream. @@ -7902,16 +6072,9 @@ class IRtcEngine - The remote client: - \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. - @note - - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. - - This method applies to the Native SDK v2.4.1 and later. - - This method applies to the `LIVE_BROADCASTING` profile only. - - You can inject only one media stream into the channel at the same time. - - Ensure that you call this method after joining a channel. - - @param url Pointer to the URL address to be added to the ongoing streaming. Valid protocols are RTMP, HLS, and HTTP-FLV. - - Supported audio codec type: AAC. - - Supported video codec type: H264 (AVC). + @param url Pointer to the URL address to be added to the ongoing live broadcast. Valid protocols are RTMP, HLS, and FLV. + - Supported FLV audio codec type: AAC. + - Supported FLV video codec type: H264 (AVC). @param config Pointer to the InjectStreamConfig object that contains the configuration of the added voice or video stream. @return @@ -7919,7 +6082,7 @@ class IRtcEngine - < 0: Failure. - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. - #ERR_NOT_READY (3): The user is not in the channel. - - #ERR_NOT_SUPPORTED (4): The channel profile is not `LIVE_BROADCASTING`. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to `LIVE_BROADCASTING` before calling this method. + - #ERR_NOT_SUPPORTED (4): The channel profile is not live broadcast. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to live broadcast before calling this method. - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IRtcEngine object is initialized before calling this method. */ virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; @@ -7934,10 +6097,10 @@ class IRtcEngine * - If the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged * "onChannelMediaRelayStateChanged" callback returns - * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the + * #RELAY_STATE_RUNNING (1) and #RELAY_OK (0), and the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent * "onChannelMediaRelayEvent" callback returns - * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the host starts + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the broadcaster starts * sending data to the destination channel. * - If the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged @@ -7947,14 +6110,12 @@ class IRtcEngine * * @note * - Call this method after the \ref joinChannel() "joinChannel" method. - * - This method takes effect only when you are a host in a - * `LIVE_BROADCASTING` channel. + * - This method takes effect only when you are a broadcaster in a + * Live-broadcast channel. * - After a successful method call, if you want to call this method * again, ensure that you call the * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the * current relay. - * - Contact sales-us@agora.io before implementing this function. - * - We do not support string user accounts in this API. * * @param configuration The configuration of the media stream relay: * ChannelMediaRelayConfiguration. @@ -7963,7 +6124,7 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Updates the channels for media stream relay. After a successful * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if * you want to relay the media stream to more channels, or leave the @@ -7971,8 +6132,8 @@ class IRtcEngine * \ref updateChannelMediaRelay() "updateChannelMediaRelay" method. * * After a successful method call, the SDK triggers the - * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent - * "onChannelMediaRelayEvent" callback with the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback with the * #RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL (7) state code. * * @note @@ -7987,16 +6148,16 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Stops the media stream relay. * - * Once the relay stops, the host quits all the destination + * Once the relay stops, the broadcaster quits all the destination * channels. * * After a successful method call, the SDK triggers the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged * "onChannelMediaRelayStateChanged" callback. If the callback returns - * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the host successfully + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the broadcaster successfully * stops the relay. * * @note @@ -8012,104 +6173,40 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int stopChannelMediaRelay() = 0; + virtual int stopChannelMediaRelay() = 0; - /** Removes the voice or video stream URL address from the live streaming. + /** Removes the voice or video stream URL address from a live broadcast. - This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live streaming. + This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live broadcast. @note If this method is called successfully, the SDK triggers the \ref IRtcEngineEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. - @param url Pointer to the URL address of the injected stream to be removed. + @param url Pointer to the URL address of the added stream to be removed. @return - 0: Success. - < 0: Failure. */ virtual int removeInjectStreamUrl(const char* url) = 0; + virtual bool registerEventHandler(IRtcEngineEventHandler *eventHandler) = 0; virtual bool unregisterEventHandler(IRtcEngineEventHandler *eventHandler) = 0; - /** Agora supports reporting and analyzing customized messages. - * - * @since v3.1.0 - * - * This function is in the beta stage with a free trial. The ability provided in its beta test version is reporting a maximum of 10 message pieces within 6 seconds, with each message piece not exceeding 256 bytes and each string not exceeding 100 bytes. - * To try out this function, contact [support@agora.io](mailto:support@agora.io) and discuss the format of customized messages with us. - */ virtual int sendCustomReportMessage(const char *id, const char* category, const char* event, const char* label, int value) = 0; - /** Gets the current connection state of the SDK. - @note You can call this method either before or after joining a channel. + /** Gets the connection state of the SDK. @return #CONNECTION_STATE_TYPE. */ virtual CONNECTION_STATE_TYPE getConnectionState() = 0; - /// @cond - /** Enables/Disables the super-resolution algorithm for a remote user's video stream. - * - * @since v3.2.0 - * - * The algorithm effectively improves the resolution of the specified remote user's video stream. When the original - * resolution of the remote video stream is a × b pixels, you can receive and render the stream at a higher - * resolution (2a × 2b pixels) by enabling the algorithm. - * - * After calling this method, the SDK triggers the - * \ref IRtcEngineEventHandler::onUserSuperResolutionEnabled "onUserSuperResolutionEnabled" callback to report - * whether you have successfully enabled the super-resolution algorithm. - * - * @warning The super-resolution algorithm requires extra system resources. - * To balance the visual experience and system usage, the SDK poses the following restrictions: - * - The algorithm can only be used for a single user at a time. - * - On the Android platform, the original resolution of the remote video must not exceed 640 × 360 pixels. - * - On the iOS platform, the original resolution of the remote video must not exceed 640 × 480 pixels. - * If you exceed these limitations, the SDK triggers the \ref IRtcEngineEventHandler::onWarning "onWarning" - * callback with the corresponding warning codes: - * - #WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION (1610): The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. - * - #WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION (1611): Another user is already using the super-resolution algorithm. - * - #WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED (1612): The device does not support the super-resolution algorithm. - * - * @note - * - This method applies to Android and iOS only. - * - Requirements for the user's device: - * - Android: The following devices are known to support the method: - * - VIVO: V1821A, NEX S, 1914A, 1916A, and 1824BA - * - OPPO: PCCM00 - * - OnePlus: A6000 - * - Xiaomi: Mi 8, Mi 9, MIX3, and Redmi K20 Pro - * - SAMSUNG: SM-G9600, SM-G9650, SM-N9600, SM-G9708, SM-G960U, and SM-G9750 - * - HUAWEI: SEA-AL00, ELE-AL00, VOG-AL00, YAL-AL10, HMA-AL00, and EVR-AN00 - * - iOS: This method is supported on devices running iOS 12.0 or later. The following - * device models are known to support the method: - * - iPhone XR - * - iPhone XS - * - iPhone XS Max - * - iPhone 11 - * - iPhone 11 Pro - * - iPhone 11 Pro Max - * - iPad Pro 11-inch (3rd Generation) - * - iPad Pro 12.9-inch (3rd Generation) - * - iPad Air 3 (3rd Generation) - * - * @param userId The ID of the remote user. - * @param enable Whether to enable the super-resolution algorithm: - * - true: Enable the super-resolution algorithm. - * - false: Disable the super-resolution algorithm. - * - * @return - * - 0: Success. - * - < 0: Failure. - */ - virtual int enableRemoteSuperResolution(uid_t userId, bool enable) = 0; - /// @endcond /** Registers the metadata observer. Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. - This method enables you to add synchronized metadata in the video stream for more diversified live interactive streaming, such as sending shopping links, digital coupons, and online quizzes. + This method enables you to add synchronized metadata in the video stream for more diversified live broadcast interactions, such as sending shopping links, digital coupons, and online quizzes. @note - Call this method before the joinChannel method. - - This method applies to the `LIVE_BROADCASTING` channel profile. + - This method applies to the Live-broadcast channel profile. @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. @@ -8119,24 +6216,12 @@ class IRtcEngine - < 0: Failure. */ virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; - /** Provides technical preview functionalities or special customizations by configuring the SDK with JSON options. - - The JSON options are not public by default. Agora is working on making commonly used JSON options public in a standard way. - - @param parameters Sets the parameter as a JSON string in the specified format. - - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setParameters(const char* parameters) = 0; }; class IRtcEngineParameter { public: - virtual ~IRtcEngineParameter () {} /** * Releases all IRtcEngineParameter resources. */ @@ -8304,7 +6389,7 @@ class IRtcEngineParameter */ virtual int setProfile(const char* profile, bool merge) = 0; - virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; + virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; }; class AAudioDeviceManager : public agora::util::AutoPtr @@ -8312,7 +6397,7 @@ class AAudioDeviceManager : public agora::util::AutoPtr public: AAudioDeviceManager(IRtcEngine* engine) { - queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); + queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); } }; @@ -8321,7 +6406,7 @@ class AVideoDeviceManager : public agora::util::AutoPtr public: AVideoDeviceManager(IRtcEngine* engine) { - queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); + queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); } }; @@ -8340,7 +6425,8 @@ class AParameter : public agora::util::AutoPtr return p != NULL; } }; -/** **DEPRECATED** The RtcEngineParameters class is deprecated, use the IRtcEngine class instead. +/** The RtcEngineParameters class is an auxiliary class setting parameters for the SDK. + */ class RtcEngineParameters { @@ -8350,44 +6436,122 @@ class RtcEngineParameters RtcEngineParameters(IRtcEngine* engine) :m_parameter(engine){} + /** Disables/Re-enables the local video. + + This method is only applicable when the user wants to watch the remote video without sending any video stream to the other user. + + Call this method after calling the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method. Otherwise, this method may not work properly. + + After the *enableVideo* method is called, the local video is enabled by default. This method is used to disable/re-enable the local video while the remote video remains unaffected. + + @note This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + + @param enabled Sets whether to disable/re-enable the local video, including the capturer, renderer, and sender: + - true: (Default) Re-enable the local video. + - false: Disable the local video. Once the local video is disabled, the remote users can no longer receive the video stream of this user, while this user can still receive the video streams of the other remote users. + @return + - 0: Success. + - < 0: Failure. + */ int enableLocalVideo(bool enabled) { return setParameters("{\"rtc.video.capture\":%s,\"che.video.local.capture\":%s,\"che.video.local.render\":%s,\"che.video.local.send\":%s}", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false"); } + /** Stops/Resumes sending the local video stream. + + @note When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. + + @param mute Sets whether to send/stop sending the local video stream: + - true: Stop sending the local video stream. + - false: (Default) Send the local video stream. + @return + - 0: Success. + - < 0: Failure. + */ int muteLocalVideoStream(bool mute) { return setParameters("{\"rtc.video.mute_me\":%s,\"che.video.local.send\":%s}", mute ? "true" : "false", mute ? "false" : "true"); } + /** Stops/Resumes receiving all remote users' video streams. + @param mute Sets whether to receive/stop receiving all remote users' video streams: + - true: Stop receiving all remote users' video streams. + - false: (Default) Receive all remote users' video streams. + + @return + - 0: Success. + - < 0: Failure. + */ int muteAllRemoteVideoStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.video.mute_peers", mute) : -ERR_NOT_INITIALIZED; } + /** Stops/Resumes receiving all remote users' video streams by default. + + @param mute Sets whether to receive/stop receiving all remote users' video streams by default: + - true: Stop receiving all remote users' video streams by default. + - false: (Default) Receive all remote users' video streams by default. + @return + - 0: Success. + - < 0: Failure. + */ int setDefaultMuteAllRemoteVideoStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.video.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; } + /** Stops/Resumes receiving a specified remote user's video stream. + + @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. + + @param uid User ID of the specified remote user. + @param mute Sets whether to receive/stop receiving the specified remote user's video stream: + - true: Stop receiving the specified remote user's video stream. + - false: (Default) Receive the specified remote user's video stream. + @return + - 0: Success. + - < 0: Failure. + */ int muteRemoteVideoStream(uid_t uid, bool mute) { return setObject("rtc.video.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute ? "true" : "false"); } + /** **DEPRECATED** Use \ref agora::rtc::IAudioDeviceManager::setPlaybackDeviceVolume "setPlaybackDeviceVolume" instead. Sets the playback device volume. + + @param volume Sets the volume of the playback device. The value ranges between 0 and 255. + @return + - 0: Success. + - < 0: Failure. + */ int setPlaybackDeviceVolume(int volume) {// [0,255] return m_parameter ? m_parameter->setInt("che.audio.output.volume", volume) : -ERR_NOT_INITIALIZED; } + /** Starts an audio recording. - int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) { - return startAudioRecording(filePath, 32000, quality); - } + The SDK allows recording during a call. Supported formats: + + - .wav: Large file size with high fidelity. + - .aac: Small file size with low fidelity. + + Ensure that the directory to save the recording file exists and is writable. + This method is usually called after the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. + The recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. - int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) { + @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8. + @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ + int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) util::AString path; @@ -8396,15 +6560,46 @@ class RtcEngineParameters else return -ERR_INVALID_ARGUMENT; #endif - return setObject("che.audio.start_recording", "{\"filePath\":\"%s\",\"sampleRate\":%d,\"quality\":%d}", filePath, sampleRate, quality); + return setObject("che.audio.start_recording", "{\"filePath\":\"%s\",\"quality\":%d}", filePath, quality); } + /** Stops an audio recording on the client. + + You can call this method before calling the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method else, the recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. + @return + - 0: Success + - < 0: Failure. + */ int stopAudioRecording() { return m_parameter ? m_parameter->setBool("che.audio.stop_recording", true) : -ERR_NOT_INITIALIZED; } + /** Starts playing and mixing the music file. + + This method mixes the specified local audio file with the audio stream from the microphone, or replaces the microphone's audio stream with the specified local audio file. You can choose whether the other user can hear the local audio playback and specify the number of playback loops. This method also supports online music playback. + + When the audio mixing file playback finishes after calling this method, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingFinished "onAudioMixingFinished" callback. + + @note + - Call this method when you are in a channel. + - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. + + @param filePath Pointer to the absolute path of the local or online audio file to mix. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). + @param loopback Sets which user can hear the audio mixing: + - true: Only the local user can hear the audio mixing. + - false: Both users can hear the audio mixing. + @param replace Sets the audio mixing content: + - true: Only the specified audio file is published; the audio stream received by the microphone is not published. + - false: The local audio file is mixed with the audio stream from the microphone. + @param cycle Sets the number of playback loops: + - Positive integer: Number of playback loops. + - -1: Infinite playback loops. + @return + - 0: Success. + - < 0: Failure. + */ int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) @@ -8421,22 +6616,52 @@ class RtcEngineParameters cycle); } + /** Stops playing and mixing the music file. + + Call this method when you are in a channel. + @return + - 0: Success. + - < 0: Failure. + */ int stopAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.stop_file_as_playout", true) : -ERR_NOT_INITIALIZED; } + /** Pauses playing and mixing the music file. + + Call this method when you are in a channel. + @return + - 0: Success. + - < 0: Failure. + */ int pauseAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", true) : -ERR_NOT_INITIALIZED; } + /** Resumes playing and mixing the music file. + + Call this method when you are in a channel. + @return + - 0: Success. + - < 0: Failure. + */ int resumeAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", false) : -ERR_NOT_INITIALIZED; } + /** Adjusts the volume during audio mixing. + + Call this method when you are in a channel. + + @param volume Audio mixing volume. The value ranges between 0 and 100 (default). + @return + - 0: Success. + - < 0: Failure. + */ int adjustAudioMixingVolume(int volume) { int ret = adjustAudioMixingPlayoutVolume(volume); if (ret == 0) { @@ -8445,12 +6670,30 @@ class RtcEngineParameters return ret; } + /** Adjusts the audio mixing volume for local playback. + + @note Call this method when you are in a channel. + + @param volume Audio mixing volume for local playback. The value ranges between 0 and 100 (default). + @return + - 0: Success. + - < 0: Failure. + */ int adjustAudioMixingPlayoutVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; } + /** Retrieves the audio mixing volume for local playback. + + This method helps troubleshoot audio volume related issues. + + @note Call this method when you are in a channel. + @return + - ≥ 0: The audio mixing volume, if this method call succeeds. The value range is [0,100]. + - < 0: Failure. + */ int getAudioMixingPlayoutVolume() { int volume = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; @@ -8459,12 +6702,30 @@ class RtcEngineParameters return r; } + /** Adjusts the audio mixing volume for publishing (for remote users). + + @note Call this method when you are in a channel. + + @param volume Audio mixing volume for publishing. The value ranges between 0 and 100 (default). + @return + - 0: Success. + - < 0: Failure. + */ int adjustAudioMixingPublishVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; } + /** Retrieves the audio mixing volume for publishing. + + This method helps troubleshoot audio volume related issues. + + @note Call this method when you are in a channel. + @return + - ≥ 0: The audio mixing volume for publishing, if this method call succeeds. The value range is [0,100]. + - < 0: Failure. + */ int getAudioMixingPublishVolume() { int volume = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; @@ -8473,7 +6734,14 @@ class RtcEngineParameters return r; } + /** Retrieves the duration (ms) of the music file. + + Call this method when you are in a channel. + @return + - ≥ 0: The audio mixing duration, if this method call succeeds. + - < 0: Failure. + */ int getAudioMixingDuration() { int duration = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_mixing_file_length_ms", duration) : -ERR_NOT_INITIALIZED; @@ -8482,7 +6750,14 @@ class RtcEngineParameters return r; } + /** Retrieves the playback position (ms) of the music file. + + Call this method when you are in a channel. + @return + 0: The current playback position of the audio mixing, if this method call succeeds. + < 0: Failure. + */ int getAudioMixingCurrentPosition() { if (!m_parameter) return -ERR_NOT_INITIALIZED; int pos = 0; @@ -8491,21 +6766,27 @@ class RtcEngineParameters r = pos; return r; } + /** Sets the playback position of the music file to a different starting position (the default plays from the beginning). + + @param pos The playback starting position (ms) of the music file. + @return + - 0: Success. + - < 0: Failure. + */ int setAudioMixingPosition(int pos /*in ms*/) { return m_parameter ? m_parameter->setInt("che.audio.mixing.file.position", pos) : -ERR_NOT_INITIALIZED; } - int setAudioMixingPitch(int pitch) { - if (!m_parameter) { - return -ERR_NOT_INITIALIZED; - } - if (pitch > 12 || pitch < -12) { - return -ERR_INVALID_ARGUMENT; - } - return m_parameter->setInt("che.audio.set_playout_file_pitch_semitones", pitch); - } + /** Retrieves the volume of the audio effects. + + The value ranges between 0.0 and 100.0. + + @return + - ≥ 0: Volume of the audio effects, if this method call succeeds. + - < 0: Failure. + */ int getEffectsVolume() { if (!m_parameter) return -ERR_NOT_INITIALIZED; int volume = 0; @@ -8515,12 +6796,27 @@ class RtcEngineParameters return r; } + /** Sets the volume of the audio effects. + + @param volume Sets the volume of the audio effects. The value ranges between 0 and 100 (default). + @return + - 0: Success. + - < 0: Failure. + */ int setEffectsVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.game_set_effects_volume", volume) : -ERR_NOT_INITIALIZED; } + /** Sets the volume of a specified audio effect. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param volume Sets the volume of the specified audio effect. The value ranges between 0.0 and 100.0 (default). + @return + - 0: Success. + - < 0: Failure. + */ int setVolumeOfEffect(int soundId, int volume) { return setObject( "che.audio.game_adjust_effect_volume", @@ -8528,34 +6824,92 @@ class RtcEngineParameters soundId, volume); } + /** Plays a specified local or online audio effect file. - int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) { -#if defined(_WIN32) - util::AString path; - if (!m_parameter->convertPath(filePath, path)) - filePath = path->c_str(); - else if (!filePath) - filePath = ""; -#endif - return setObject( - "che.audio.game_play_effect", - "{\"soundId\":%d,\"filePath\":\"%s\",\"loopCount\":%d, \"pitch\":%lf,\"pan\":%lf,\"gain\":%d, \"send2far\":%d}", - soundId, filePath, loopCount, pitch, pan, gain, publish); - } + This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. + To play multiple audio effect files simultaneously, call this method multiple times with different soundIds and filePaths. We recommend playing no more than three audio effect files at the same time. - int stopEffect(int soundId) { + When the audio effect file playback finishes, the SDK returns the \ref IRtcEngineEventHandler::onAudioEffectFinished "onAudioEffectFinished" callback. + + @param soundId ID of the specified audio effect. Each audio effect has a unique ID. + + @note + - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. + - Playing multiple online audio effect files simultaneously is not supported on macOS and Windows. + + @param filePath The absolute path to the local audio effect file or the URL of the online audio effect file. + @param loopCount Sets the number of times the audio effect loops: + - 0: Play the audio effect once. + - 1: Play the audio effect twice. + - -1: Play the audio effect in an indefinite loop until the \ref IRtcEngine::stopEffect "stopEffect" or \ref IRtcEngine::stopAllEffects "stopAllEffects" method is called. + @param pitch Sets the pitch of the audio effect. The value ranges between 0.5 and 2. The default value is 1 (no change to the pitch). The lower the value, the lower the pitch. + @param pan Sets the spatial position of the audio effect. The value ranges between -1.0 and 1.0: + - 0.0: The audio effect displays ahead. + - 1.0: The audio effect displays to the right. + - -1.0: The audio effect displays to the left. + @param gain Sets the volume of the audio effect. The value ranges between 0.0 and 100.0 (default). The lower the value, the lower the volume of the audio effect. + @param publish Sets whether or not to publish the specified audio effect to the remote stream: + - true: The locally played audio effect is published to the Agora Cloud and the remote users can hear it. + - false: The locally played audio effect is not published to the Agora Cloud and the remote users cannot hear it. + + @return + - 0: Success. + - < 0: Failure. + */ + int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false, int startPos = 0) { +#if defined(_WIN32) + util::AString path; + if (!m_parameter->convertPath(filePath, path)) + filePath = path->c_str(); + else if (!filePath) + filePath = ""; +#endif + return setObject( + "che.audio.game_play_effect", + "{\"soundId\":%d,\"filePath\":\"%s\",\"loopCount\":%d, \"pitch\":%lf,\"pan\":%lf,\"gain\":%d, \"send2far\":%d, \"startPos\":%d}", + soundId, filePath, loopCount, pitch, pan, gain, publish, startPos); + } + + /** Stops playing a specified audio effect. + + @param soundId ID of the audio effect to stop playing. Each audio effect has a unique ID. + + @return + - 0: Success. + - < 0: Failure. + */ + int stopEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_stop_effect", soundId) : -ERR_NOT_INITIALIZED; } + /** Stops playing all audio effects. + @return + - 0: Success. + - < 0: Failure. + */ int stopAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_stop_all_effects", true) : -ERR_NOT_INITIALIZED; } + /** Preloads a specified audio effect file into the memory. + + @note This method does not support online audio effect files. + + To ensure smooth communication, limit the size of the audio effect file. We recommend using this method to preload the audio effect before calling the \ref IRtcEngine::joinChannel "joinChannel" method. + Supported audio formats: mp3, aac, m4a, 3gp, and wav. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param filePath Pointer to the absolute path of the audio effect file. + + @return + - 0: Success. + - < 0: Failure. + */ int preloadEffect(int soundId, char* filePath) { return setObject( "che.audio.game_preload_effect", @@ -8563,61 +6917,267 @@ class RtcEngineParameters soundId, filePath); } + /** Releases a specified preloaded audio effect from the memory. + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @return + - 0: Success. + - < 0: Failure. + */ int unloadEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_unload_effect", soundId) : -ERR_NOT_INITIALIZED; } + /** Pauses a specified audio effect. + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @return + - 0: Success. + - < 0: Failure. + */ int pauseEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_pause_effect", soundId) : -ERR_NOT_INITIALIZED; } + /** Pauses all audio effects. + @return + - 0: Success. + - < 0: Failure. + */ int pauseAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_pause_all_effects", true) : -ERR_NOT_INITIALIZED; } + /** Resumes playing a specified audio effect. + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @return + - 0: Success. + - < 0: Failure. + */ int resumeEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_resume_effect", soundId) : -ERR_NOT_INITIALIZED; } + /** Resumes playing all audio effects. + @return + - 0: Success. + - < 0: Failure. + */ int resumeAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_resume_all_effects", true) : -ERR_NOT_INITIALIZED; } + /** Retrieves the playback position (ms) of specified audio effect. + + Call this method when you are in a channel. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + + @return >= 0: The current playback position of the audio effect, if this method call is successful. + < 0: Failure. + */ + int getEffectCurrentPosition(int soundId) { + int position = 0; + char key[512]; + sprintf(key, "che.audio.get_effect_file_position:%d", soundId); + int r = m_parameter ? m_parameter->getInt(key, position) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = position; + return r; + } + + /** Sets the instantaneous playback position of specified audio effect file. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param pos The instantaneous playback position (ms) of the audio effect file. + + @return * 0: Success. + * < 0: Failure. + */ + int setEffectPosition(int soundId, int pos) { + return setObject( + "che.audio.set_effect_file_position", + "{\"soundId\":%d, \"effectPos\":%d}", + soundId, pos); + } + + /** Adjusts the volume of specified audio effect for local playback.. + + Call this method when you are in a channel. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param volume Volume of specified audio effect for local playback. The value ranges between 0 and 100 (default). + + @return * 0: Success. + * < 0: Failure. + */ + int adjustEffectPlayoutVolume(int soundId, int volume) { + return setObject( + "che.audio.set_effect_file_playout_volume", + "{\"soundId\":%d, \"effectPlayoutVolume\":%d}", + soundId, volume); + } + + /** Adjusts the volume of specified audio effect for publishing (sending to other users). + + Call this method when you are in a channel. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + @param volume Volume of specified audio effect for publishing. The value ranges between 0 and 100 (default). + + @return * 0: Success. + * < 0: Failure. + */ + int adjustEffectPublishVolume(int soundId, int volume) { + return setObject( + "che.audio.set_effect_file_publish_volume", + "{\"soundId\":%d, \"effectPublishVolume\":%d}", + soundId, volume); + } + + /** Retrieves the volume of specified audio effect for local playback. + + Call this method when you are in a channel. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + + @return >= 0: The current local playback volume of specified audio effect, if this method call is successful. + * < 0: Failure. + */ + int getEffectPlayoutVolume(int soundId) { + int volume = 0; + char key[512]; + sprintf(key, "che.audio.get_effect_file_playout_volume:%d", soundId); + int r = m_parameter ? m_parameter->getInt(key, volume) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = volume; + return r; + } + + /** Retrieves the volume of specified audio effect for publishing (sending to other users). + + Call this method when you are in a channel. + @param soundId ID of the audio effect. Each audio effect has a unique ID. + + @return >= 0: The current publish volume of specified audio effect, if this method call is successful. + * < 0: Failure. + */ + int getEffectPublishVolume(int soundId) { + int volume = 0; + char key[512]; + sprintf(key, "che.audio.get_effect_file_publish_volume:%d", soundId); + int r = m_parameter ? m_parameter->getInt(key, volume) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = volume; + return r; + } + + /** Retrieves the duration (ms) of specified audio effect. + + Call this method when you are in a channel. + + @param soundId ID of the audio effect. Each audio effect has a unique ID. + + @return >= 0: The duration (ms) of specified audio effect, if this method call is successful. + * < 0: Failure. + */ + int getEffectDuration(const char* filePath) { + int duration = 0; + char key[512]; + sprintf(key, "che.audio.get_effect_file_duration:%s", filePath); + int r = m_parameter ? m_parameter->getInt(key, duration) : -ERR_NOT_INITIALIZED; + if (r == 0) + r = duration; + return r; + } + + /** Enables/Disables stereo panning for remote users. + + Ensure that you call this method before joinChannel to enable stereo panning for remote users so that the local user can track the position of a remote user by calling \ref agora::rtc::IRtcEngine::setRemoteVoicePosition "setRemoteVoicePosition". + + @param enabled Sets whether or not to enable stereo panning for remote users: + - true: enables stereo panning. + - false: disables stereo panning. + + @return + - 0: Success. + - < 0: Failure. + */ int enableSoundPositionIndication(bool enabled) { return m_parameter ? m_parameter->setBool( "che.audio.enable_sound_position", enabled) : -ERR_NOT_INITIALIZED; } + /** Sets the sound position and gain of a remote user. + + When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, such as Battle Royale games. + @note + - For this method to work, enable stereo panning for remote users by calling enableSoundPositionIndication before joining a channel. + - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + + @param uid The ID of the remote user. + @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: + - 0.0: the remote sound comes from the front. + - -1.0: the remote sound comes from the left. + - 1.0: the remote sound comes from the right. + @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). The smaller the value, the less the gain. + + @return + - 0: Success. + - < 0: Failure. + */ int setRemoteVoicePosition(uid_t uid, double pan, double gain) { return setObject("che.audio.game_place_sound_position", "{\"uid\":%u,\"pan\":%lf,\"gain\":%lf}", uid, pan, gain); } + /** Changes the voice pitch of the local speaker. + @param pitch Sets the voice pitch. The value ranges between 0.5 and 2.0. The lower the value, the lower the voice pitch. The default value is 1.0 (no change to the local voice pitch). + @return + - 0: Success. + - < 0: Failure. + */ int setLocalVoicePitch(double pitch) { return m_parameter ? m_parameter->setInt( "che.audio.morph.pitch_shift", static_cast(pitch * 100)) : -ERR_NOT_INITIALIZED; } + /** Sets the local voice equalization effect. + + @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. + @param bandGain Sets the gain of each band in dB. The value ranges between -15 and 15. + @return + - 0: Success. + - < 0: Failure. + */ int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) { return setObject( "che.audio.morph.equalization", "{\"index\":%d,\"gain\":%d}", static_cast(bandFrequency), bandGain); } + /** Sets the local voice reverberation. + + v2.4.0 adds the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, a more user-friendly method for setting the local voice reverberation. You can use this method to set the local reverberation effect, such as pop music, R&B, rock music, and hip-hop. + @param reverbKey Sets the reverberation key. See #AUDIO_REVERB_TYPE. + @param value Sets the value of the reverberation key. + + @return + - 0: Success. + - < 0: Failure. + */ int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) { return setObject( "che.audio.morph.reverb", @@ -8625,175 +7185,39 @@ class RtcEngineParameters static_cast(reverbKey), value); } + /** Sets the local voice changer option. + @note Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, because the method called later overrides the one called earlier. + + + @param voiceChanger Sets the local voice changer option. See #VOICE_CHANGER_PRESET. + + @return + - 0: Success. + - < 0: Failure. + */ int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) { - if(!m_parameter) - return -ERR_NOT_INITIALIZED; - if(voiceChanger == 0x00000000) { - return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)); - } - else if(voiceChanger > 0x00000000 && voiceChanger < 0x00100000) { - return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)); - } - else if(voiceChanger > 0x00100000 && voiceChanger < 0x00200000) { - return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger - 0x00100000 + 6)); - } - else if(voiceChanger > 0x00200000 && voiceChanger < 0x00300000) { - return m_parameter->setInt("che.audio.morph.beauty_voice", static_cast(voiceChanger - 0x00200000)); - } - else { - return -ERR_INVALID_ARGUMENT; - } + return m_parameter ? m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)) : -ERR_NOT_INITIALIZED; } + /** Sets the preset local voice reverberation effect. - int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) { - if(!m_parameter) - return -ERR_NOT_INITIALIZED; - if(reverbPreset == 0x00000000) { - return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)); - } - else if(reverbPreset > 0x00000000 && reverbPreset < 0x00100000) { - return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset + 8)); - } - else if(reverbPreset > 0x00100000 && reverbPreset < 0x00200000) { - return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset - 0x00100000)); - } - else if(reverbPreset > 0x00200000 && reverbPreset < 0x00200002) { - return m_parameter->setInt("che.audio.morph.virtual_stereo", static_cast(reverbPreset - 0x00200000)); - } - else if (reverbPreset > (AUDIO_REVERB_PRESET) 0x00300000 && reverbPreset < (AUDIO_REVERB_PRESET) 0x00300002) - return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", 1, 4); - else if (reverbPreset > (AUDIO_REVERB_PRESET) 0x00400000 && reverbPreset < (AUDIO_REVERB_PRESET) 0x00400002) - return m_parameter->setInt("che.audio.morph.threedim_voice", 10); - else { - return -ERR_INVALID_ARGUMENT; - } - } + @note + - Do not use this method together with \ref agora::rtc::IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb". + - Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" method, because the method called later overrides the one called earlier. - int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset){ - if(!m_parameter) - return -ERR_NOT_INITIALIZED; - if(preset == AUDIO_EFFECT_OFF) { - return m_parameter->setInt("che.audio.morph.voice_changer", 0); - } - if(preset == ROOM_ACOUSTICS_KTV){ - return m_parameter->setInt("che.audio.morph.reverb_preset", 1); - } - if(preset == ROOM_ACOUSTICS_VOCAL_CONCERT) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 2); - } - if(preset == ROOM_ACOUSTICS_STUDIO) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 5); - } - if(preset == ROOM_ACOUSTICS_PHONOGRAPH) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 8); - } - if(preset == ROOM_ACOUSTICS_VIRTUAL_STEREO) { - return m_parameter->setInt("che.audio.morph.virtual_stereo", 1); - } - if(preset == ROOM_ACOUSTICS_SPACIAL) { - return m_parameter->setInt("che.audio.morph.voice_changer", 15); - } - if(preset == ROOM_ACOUSTICS_ETHEREAL) { - return m_parameter->setInt("che.audio.morph.voice_changer", 5); - } - if(preset == ROOM_ACOUSTICS_3D_VOICE) { - return m_parameter->setInt("che.audio.morph.threedim_voice", 10); - } - if(preset == VOICE_CHANGER_EFFECT_UNCLE) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 3); - } - if(preset == VOICE_CHANGER_EFFECT_OLDMAN) { - return m_parameter->setInt("che.audio.morph.voice_changer", 1); - } - if(preset == VOICE_CHANGER_EFFECT_BOY) { - return m_parameter->setInt("che.audio.morph.voice_changer", 2); - } - if(preset == VOICE_CHANGER_EFFECT_SISTER) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 4); - } - if(preset == VOICE_CHANGER_EFFECT_GIRL) { - return m_parameter->setInt("che.audio.morph.voice_changer", 3); - } - if(preset == VOICE_CHANGER_EFFECT_PIGKING) { - return m_parameter->setInt("che.audio.morph.voice_changer", 4); - } - if(preset == VOICE_CHANGER_EFFECT_HULK) { - return m_parameter->setInt("che.audio.morph.voice_changer", 6); - } - if(preset == STYLE_TRANSFORMATION_RNB) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 7); - } - if(preset == STYLE_TRANSFORMATION_POPULAR) { - return m_parameter->setInt("che.audio.morph.reverb_preset", 6); - } - if(preset == PITCH_CORRECTION) { - return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", 1, 4); - } - return -ERR_INVALID_ARGUMENT; - } - int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) { - if(!m_parameter) - return -ERR_NOT_INITIALIZED; - if(preset == VOICE_BEAUTIFIER_OFF) { - return m_parameter->setInt("che.audio.morph.voice_changer", 0); - } - if(preset == CHAT_BEAUTIFIER_MAGNETIC) { - return m_parameter->setInt("che.audio.morph.beauty_voice", 1); - } - if(preset == CHAT_BEAUTIFIER_FRESH) { - return m_parameter->setInt("che.audio.morph.beauty_voice", 2); - } - if(preset == CHAT_BEAUTIFIER_VITALITY) { - return m_parameter->setInt("che.audio.morph.beauty_voice", 3); - } - /*if(preset == SINGING_BEAUTIFICATION_MAN) { - return m_parameter->setInt("che.audio.morph.beauty_sing", 1); - } - if(preset == SINGING_BEAUTIFICATION_WOMAN) { - return m_parameter->setInt("che.audio.morph.beauty_sing", 2); - }*/ - if(preset == TIMBRE_TRANSFORMATION_VIGOROUS) { - return m_parameter->setInt("che.audio.morph.voice_changer", 7); - } - if(preset == TIMBRE_TRANSFORMATION_DEEP) { - return m_parameter->setInt("che.audio.morph.voice_changer", 8); - } - if(preset == TIMBRE_TRANSFORMATION_MELLOW) { - return m_parameter->setInt("che.audio.morph.voice_changer", 9); - } - if(preset == TIMBRE_TRANSFORMATION_FALSETTO) { - return m_parameter->setInt("che.audio.morph.voice_changer", 10); - } - if(preset == TIMBRE_TRANSFORMATION_FULL) { - return m_parameter->setInt("che.audio.morph.voice_changer", 11); - } - if(preset == TIMBRE_TRANSFORMATION_CLEAR) { - return m_parameter->setInt("che.audio.morph.voice_changer", 12); - } - if(preset == TIMBRE_TRANSFORMATION_RESOUNDING) { - return m_parameter->setInt("che.audio.morph.voice_changer", 13); - } - if(preset == TIMBRE_TRANSFORMATION_RINGING) { - return m_parameter->setInt("che.audio.morph.voice_changer", 14); - } - return -ERR_INVALID_ARGUMENT; - } + @param reverbPreset Sets the preset audio reverberation configuration. See #AUDIO_REVERB_PRESET. - int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2){ - if(!m_parameter) - return -ERR_NOT_INITIALIZED; - if(preset == PITCH_CORRECTION){ - return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", param1, param2); - } - if(preset == ROOM_ACOUSTICS_3D_VOICE){ - return m_parameter->setInt("che.audio.morph.threedim_voice", param1); - } - return -ERR_INVALID_ARGUMENT; + @return + - 0: Success. + - < 0: Failure. + */ + int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) { + return m_parameter ? m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)) : -ERR_NOT_INITIALIZED; } + /** **DEPRECATED** Use \ref IRtcEngine::disableAudio "disableAudio" instead. Disables the audio function in the channel. @return @@ -8804,17 +7228,52 @@ class RtcEngineParameters return m_parameter ? m_parameter->setBool("che.pause.audio", true) : -ERR_NOT_INITIALIZED; } + /** **DEPRECATED** Use the \ref IRtcEngine::enableAudio "enableAudio" method instead. + Resumes playing the audio in the channel. + @return + - 0: Success. + - < 0: Failure. + */ int resumeAudio() { return m_parameter ? m_parameter->setBool("che.pause.audio", false) : -ERR_NOT_INITIALIZED; } + /** **DEPRECATED** Agora does not recommend using this method. + + Sets the high-quality audio preferences. Call this method and set all parameters before joining a channel. + + Do not call this method again after joining a channel. + + @param fullband Sets whether to enable/disable full-band codec (48-kHz sample rate). Not compatible with SDK versions before v1.7.4: + - true: Enable full-band codec. + - false: Disable full-band codec. + @param stereo Sets whether to enable/disable stereo codec. Not compatible with SDK versions before v1.7.4: + - true: Enable stereo codec. + - false: Disable stereo codec. + @param fullBitrate Sets whether to enable/disable high-bitrate mode. Recommended in voice-only mode: + - true: Enable high-bitrate mode. + - false: Disable high-bitrate mode. + @return + - 0: Success. + - < 0: Failure. + */ int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) { return setObject("che.audio.codec.hq", "{\"fullband\":%s,\"stereo\":%s,\"fullBitrate\":%s}", fullband ? "true" : "false", stereo ? "true" : "false", fullBitrate ? "true" : "false"); } + /** Adjusts the recording volume. + + @param volume Recording volume. The value ranges between 0 and 400: + - 0: Mute. + - 100: Original volume. + - 400: (Maximum) Four times the original volume with signal clipping protection. + @return + - 0: Success. + - < 0: Failure. + */ int adjustRecordingSignalVolume(int volume) {//[0, 400]: e.g. 50~0.5x 100~1x 400~4x if (volume < 0) volume = 0; @@ -8823,7 +7282,17 @@ class RtcEngineParameters return m_parameter ? m_parameter->setInt("che.audio.record.signal.volume", volume) : -ERR_NOT_INITIALIZED; } + /** Adjusts the playback volume. + + @param volume Playback volume. The value ranges between 0 and 400: + - 0: Mute. + - 100: Original volume. + - 400: (Maximum) Four times the original volume with signal clipping protection. + @return + - 0: Success. + - < 0: Failure. + */ int adjustPlaybackSignalVolume(int volume) {//[0, 400] if (volume < 0) volume = 0; @@ -8832,35 +7301,99 @@ class RtcEngineParameters return m_parameter ? m_parameter->setInt("che.audio.playout.signal.volume", volume) : -ERR_NOT_INITIALIZED; } + /** Enables the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at a set time interval to report on which users are speaking and the speakers' volume. + + Once this method is enabled, the SDK returns the volume indication in the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the set time interval, whether or not any user is speaking in the channel. + + @param interval Sets the time interval between two consecutive volume indications: + - ≤ 0: Disables the volume indication. + - > 0: Time interval (ms) between two consecutive volume indications. We recommend setting @p interval > 200 ms. Do not set @p interval < 10 ms, or the *onAudioVolumeIndication* callback will not be triggered. + @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. + @return + - 0: Success. + - < 0: Failure. + */ int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) { // in ms: <= 0: disable, > 0: enable, interval in ms if (interval < 0) interval = 0; - return setObject("che.audio.volume_indication", "{\"interval\":%d,\"smooth\":%d,\"vad\":%d}", interval, smooth, report_vad); + return setObject("che.audio.volume_indication", "{\"interval\":%d,\"smooth\":%d,\"vad\":%d}", interval, smooth, (int)report_vad); } + /** Stops/Resumes sending the local audio stream. + + @note When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. + @param mute Sets whether to send/stop sending the local audio stream: + - true: Stops sending the local audio stream. + - false: (Default) Sends the local audio stream. + + @return + - 0: Success. + - < 0: Failure. + */ int muteLocalAudioStream(bool mute) { return setParameters("{\"rtc.audio.mute_me\":%s,\"che.audio.mute_me\":%s}", mute ? "true" : "false", mute ? "true" : "false"); } // mute/unmute all peers. unmute will clear all muted peers specified mutePeer() interface + /** Stops/Resumes receiving a specified remote user's audio stream. + + @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. + + @param uid User ID of the specified remote user sending the audio. + @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: + - true: Stops receiving the specified remote user's audio stream. + - false: (Default) Receives the specified remote user's audio stream. + + @return + - 0: Success. + - < 0: Failure. + */ int muteRemoteAudioStream(uid_t uid, bool mute) { return setObject("rtc.audio.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute?"true":"false"); } + /** Stops/Resumes receiving all remote users' audio streams. + + @param mute Sets whether to receive/stop receiving all remote users' audio streams. + - true: Stops receiving all remote users' audio streams. + - false: (Default) Receives all remote users' audio streams. + @return + - 0: Success. + - < 0: Failure. + */ int muteAllRemoteAudioStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.audio.mute_peers", mute) : -ERR_NOT_INITIALIZED; } + /** Stops/Resumes receiving all remote users' audio streams by default. + + @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: + - true: Stops receiving all remote users' audio streams by default. + - false: (Default) Receives all remote users' audio streams by default. + @return + - 0: Success. + - < 0: Failure. + */ int setDefaultMuteAllRemoteAudioStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.audio.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; } + /** Sets the external audio source. + @param enabled Sets whether to enable/disable the external audio source: + - true: Enables the external audio source. + - false: (Default) Disables the external audio source. + @param sampleRate Sets the sample rate of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channels Sets the audio channels of the external audio source (two channels maximum). + @return + - 0: Success. + - < 0: Failure. + */ int setExternalAudioSource(bool enabled, int sampleRate, int channels) { if (enabled) return setParameters("{\"che.audio.external_capture\":true,\"che.audio.external_capture.push\":true,\"che.audio.set_capture_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE); @@ -8868,7 +7401,21 @@ class RtcEngineParameters return setParameters("{\"che.audio.external_capture\":false,\"che.audio.external_capture.push\":false}"); } + /** Sets the external audio sink. + + If you enable the external audio sink, you can pull the audio frame by periodically calling the \ref agora::media::IMediaEngine::pullAudioFrame "pullAudioFrame" method. + + @param enabled + - true: Enables the external audio sink. + - false: Disables the external audio sink. + @param sampleRate Sets the sample rate of the external audio sink, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channels Sets the audio channels of the external audio sink (two channels maximum). + @note Enabling the external audio sink disables the "Raw Audio Data" method, and the application will not retrieve the audio frame from the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + @return + - 0: Success. + - < 0: Failure. + */ int setExternalAudioSink(bool enabled, int sampleRate, int channels) { if (enabled) return setParameters("{\"che.audio.external_render\":true,\"che.audio.external_render.pull\":true,\"che.audio.set_render_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_ONLY); @@ -8876,7 +7423,20 @@ class RtcEngineParameters return setParameters("{\"che.audio.external_render\":false,\"che.audio.external_render.pull\":false}"); } + /** Specifies an SDK output log file. + + The log file records all SDK operations during runtime. If it does not exist, the SDK creates one. + + @note + - The default log file is located at: C:\Users\\AppData\Local\Agora\. + - Ensure that you call this method immediately after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method, otherwise the output log may not be complete. + + @param filePath File path of the log file. The string of the log file is in UTF-8. + @return + - 0: Success. + - < 0: Failure. + */ int setLogFile(const char* filePath) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) @@ -8889,73 +7449,226 @@ class RtcEngineParameters return m_parameter->setString("rtc.log_file", filePath); } + /** Sets the output log level of the SDK. + + You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. + + If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. + + @param filter Sets the log filter level. See #LOG_FILTER_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ int setLogFilter(unsigned int filter) { return m_parameter ? m_parameter->setUInt("rtc.log_filter", filter&LOG_FILTER_MASK) : -ERR_NOT_INITIALIZED; } + /** Sets the log file size (KB). + + The SDK has two log files, each with a default size of 512 KB. If you set @p fileSizeInBytes as 1024 KB, the SDK outputs log files with a total maximum size of 2 MB. If the total size of the log files exceed the set value, the new output log files overwrite the old output log files. + @param fileSizeInKBytes The SDK log file size (KB). + @return + - 0: Success. + - <0: Failure. + */ int setLogFileSize(unsigned int fileSizeInKBytes) { return m_parameter ? m_parameter->setUInt("rtc.log_size", fileSizeInKBytes) : -ERR_NOT_INITIALIZED; } + /** Sets the local video display mode. + + This method can be called multiple times during a call to change the display mode. + @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ int setLocalRenderMode(RENDER_MODE_TYPE renderMode) { return setRemoteRenderMode(0, renderMode); } + /** Sets the video display mode of a specified remote user. + + This method can be called multiple times during a call to change the display mode. + @param uid ID of the remote user. + @param renderMode Sets the video display mode. See #RENDER_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ int setRemoteRenderMode(uid_t uid, RENDER_MODE_TYPE renderMode) { - return setParameters("{\"che.video.render_mode\":[{\"uid\":%u,\"renderMode\":%d}]}", uid, renderMode); + return setObject("che.video.render_mode", "{\"uid\":%u,\"mode\":%d}", uid, renderMode); } + /** Sets the camera capturer configuration. + + For a video call or live broadcast, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: + + - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to avoid such problems. + - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to optimize CPU and RAM usage. + - If you want better quality for the local video preview, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PREVIEW = 2. + + @note Call this method before enabling the local camera. That said, you can call this method before calling \ref agora::rtc::IRtcEngine::joinChannel "joinChannel", \ref agora::rtc::IRtcEngine::enableVideo "enableVideo", or \ref IRtcEngine::enableLocalVideo "enableLocalVideo", depending on which method you use to turn on your local camera. + @param config Sets the camera capturer configuration. See CameraCapturerConfiguration. + + @return + - 0: Success. + - < 0: Failure. + */ int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) { if (!m_parameter) return -ERR_NOT_INITIALIZED; return m_parameter->setInt("che.video.camera_capture_mode", (int)config.preference); } + /** Sets the stream mode to the single-stream (default) or dual-stream mode. (Live broadcast only.) + + If the dual-stream mode is enabled, the receiver can choose to receive the high stream (high-resolution and high-bitrate video stream), or the low stream (low-resolution and low-bitrate video stream). + @param enabled Sets the stream mode: + - true: Dual-stream mode. + - false: (Default) Single-stream mode. + */ int enableDualStreamMode(bool enabled) { return setParameters("{\"rtc.dual_stream_mode\":%s,\"che.video.enableLowBitRateStream\":%d}", enabled ? "true" : "false", enabled ? 1 : 0); } + /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. + + This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. + + - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the SDK receives the high-stream video by default. + - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. + By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. + + @param uid ID of the remote user sending the video stream. + @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ int setRemoteVideoStreamType(uid_t uid, REMOTE_VIDEO_STREAM_TYPE streamType) { return setParameters("{\"rtc.video.set_remote_video_stream\":{\"uid\":%u,\"stream\":%d}, \"che.video.setstream\":{\"uid\":%u,\"stream\":%d}}", uid, streamType, uid, streamType); // return setObject("rtc.video.set_remote_video_stream", "{\"uid\":%u,\"stream\":%d}", uid, streamType); } + /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. + + - If the dual-stream mode is enabled by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the user receives the high-stream video by default. The @p setRemoteDefaultVideoStreamType method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. + - If the dual-stream mode is not enabled, the user receives the high-stream video by default. + + The result after calling this method is returned in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. + @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) { return m_parameter ? m_parameter->setInt("rtc.video.set_remote_default_video_stream_type", streamType) : -ERR_NOT_INITIALIZED; } + /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. + + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onRecordAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channel Sets the number of audio channels (@p channels) returned in the *onRecordAudioFrame* callback: + - 1: Mono + - 2: Stereo + @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onRecordAudioFrame* callback. + @param samplesPerCall Sets the sample points (@p samples) returned in the *onRecordAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. + + samplesPerCall = (int)(sampleRate × sampleInterval), where sampleInterval ≥ 0.01 in seconds. + @return + - 0: Success. + - < 0: Failure. + */ int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { return setObject("che.audio.set_capture_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); } + /** Sets the audio playback format for the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onPlaybackAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channel Sets the number of channels (@p channels) returned in the *onPlaybackAudioFrame* callback: + - 1: Mono + - 2: Stereo + @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onPlaybackAudioFrame* callback. + @param samplesPerCall Sets the sample points (*samples*) returned in the *onPlaybackAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. + + samplesPerCall = (int)(sampleRate × sampleInterval), where sampleInterval ≥ 0.01 in seconds. + @return + - 0: Success. + - < 0: Failure. + */ int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { return setObject("che.audio.set_render_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); } + /** Sets the mixed audio format for the \ref agora::media::IAudioFrameObserver::onMixedAudioFrame "onMixedAudioFrame" callback. + + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onMixedAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param samplesPerCall Sets the sample points (@p samples) returned in the *onMixedAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. + + samplesPerCall = (int)(sampleRate × sampleInterval), where sampleInterval ≥ 0.01 in seconds. + @return + - 0: Success. + - < 0: Failure. + */ int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) { return setObject("che.audio.set_mixed_raw_audio_format", "{\"sampleRate\":%d,\"samplesPerCall\":%d}", sampleRate, samplesPerCall); } + /** Enables interoperability with the Agora Web SDK. + + @note This method applies only to the Live-broadcast profile. In the Communication profile, interoperability with the Agora Web SDK is enabled by default. + + @param enabled Sets whether to enable/disable interoperability with the Agora Web SDK: + - true: Enable. + - false: (Default) Disable. + @return + - 0: Success. + - < 0: Failure. + */ int enableWebSdkInteroperability(bool enabled) {//enable interoperability with zero-plugin web sdk return setParameters("{\"rtc.video.web_h264_interop_enable\":%s,\"che.video.web_h264_interop_enable\":%s}", enabled ? "true" : "false", enabled ? "true" : "false"); } //only for live broadcast + /** **DEPRECATED** Sets the preferences for the high-quality video. (Live broadcast only). + + This method is deprecated as of v2.4.0. + + @param preferFrameRateOverImageQuality Sets the video quality preference: + - true: Frame rate over image quality. + - false: (Default) Image quality over frame rate. + @return + - 0: Success. + - < 0: Failure. + */ int setVideoQualityParameters(bool preferFrameRateOverImageQuality) { return setParameters("{\"rtc.video.prefer_frame_rate\":%s,\"che.video.prefer_frame_rate\":%s}", preferFrameRateOverImageQuality ? "true" : "false", preferFrameRateOverImageQuality ? "true" : "false"); } + /** Sets the local video mirror mode. + + You must call this method before calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, otherwise the mirror mode will not work. + @param mirrorMode Sets the local video mirror mode. See #VIDEO_MIRROR_MODE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) { if (!m_parameter) return -ERR_NOT_INITIALIZED; const char *value; @@ -8975,18 +7688,57 @@ class RtcEngineParameters return m_parameter->setString("che.video.localViewMirrorSetting", value); } + /** Sets the fallback option for the locally published video stream based on the network conditions. + + The default setting for @p option is #STREAM_FALLBACK_OPTION_DISABLED, where there is no fallback behavior for the locally published video stream when the uplink network conditions are poor. + If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK will: + + - Disable the upstream video but enable audio only when the network conditions worsen and cannot support both video and audio. + - Re-enable the video when the network conditions improve. + + When the locally published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. + + @note Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the locally publish stream falls back to audio-only. + + @param option Sets the fallback option for the locally published video stream. See #STREAM_FALLBACK_OPTIONS. + @return + - 0: Success. + - < 0: Failure. + */ int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) { return m_parameter ? m_parameter->setInt("rtc.local_publish_fallback_option", option) : -ERR_NOT_INITIALIZED; } + /** Sets the fallback option for the remotely subscribed video stream based on the network conditions. + + The default setting for @p option is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW, where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. + + If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. + When the remotely subscribed video stream falls back to audio only or when the audio-only stream switches back to the video stream, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRemoteSubscribeFallbackToAudioOnly "onRemoteSubscribeFallbackToAudioOnly" callback. + + @param option Sets the fallback option for the remotely subscribed video stream. See #STREAM_FALLBACK_OPTIONS. + @return + - 0: Success. + - < 0: Failure. + */ int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) { return m_parameter ? m_parameter->setInt("rtc.remote_subscribe_fallback_option", option) : -ERR_NOT_INITIALIZED; } #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) || defined(_WIN32) + /** Enables loopback recording. + @param enabled Sets whether to enable/disable loopback recording: + - true: Enables loopback recording. + - false: (Default) Disables loopback recording. + @param deviceName Pointer to the device name of the sound card. The default value is NULL (the default sound card). + If you use a virtual sound card like "Soundflower", set this parameter as the name of the sound card, "Soundflower", and the SDK will find the corresponding sound card and start capturing. + @return + - 0: Success. + - < 0: Failure. + */ int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) { if (!deviceName) { return setParameters("{\"che.audio.loopback.recording\":%s}", enabled ? "true" : "false"); @@ -8997,7 +7749,14 @@ class RtcEngineParameters } #endif + /** Sets the volume of the in-ear monitor. + + @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). + @return + - 0: Success. + - < 0: Failure. + */ int setInEarMonitoringVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.headset.monitoring.parameter", volume) : -ERR_NOT_INITIALIZED; } @@ -9032,7 +7791,11 @@ class RtcEngineParameters } //namespace rtc } // namespace agora +/** Retrieves the SDK version number. + @param build Build number of the Agora SDK. + @return String of the SDK version. + */ #define getAgoraRtcEngineVersion getAgoraSdkVersion //////////////////////////////////////////////////////// @@ -9041,11 +7804,9 @@ class RtcEngineParameters */ //////////////////////////////////////////////////////// -/** Creates the IRtcEngine object and returns the pointer. - * - * @note The Agora RTC Native SDK supports creating only one `IRtcEngine` object for an app for now. - * - * @return Pointer to the IRtcEngine object. +/** Creates the RtcEngine object and returns the pointer. + + @return Pointer to the RtcEngine object. */ AGORA_API agora::rtc::IRtcEngine* AGORA_CALL createAgoraRtcEngine(); diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h index 299158c..a607ed3 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h @@ -25,12 +25,11 @@ class IAgoraService { protected: virtual ~IAgoraService(){} - public: - AGORA_CPP_API static void release (); + virtual void release() = 0; /** Initializes the engine. - + @param context RtcEngine context. @return - 0: Success. @@ -51,7 +50,7 @@ class IAgoraService } // namespace agora /** Gets the SDK version number. - + @param build Build number of the Agora SDK. @return - 0: Success. diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java index 9c5e31b..50a983f 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java @@ -52,6 +52,7 @@ public int getBufferType() { return MediaIO.BufferType.BYTE_ARRAY.intValue(); } + /* @Override public int getCaptureType() { return 0; @@ -60,7 +61,7 @@ public int getCaptureType() { @Override public int getContentHint() { return 0; - } + }*/ public IVideoFrameConsumer getFrameConsumer () { return this.mVideoFrameConsumer; diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java index 6256292..97b87f8 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java @@ -177,6 +177,7 @@ public int detachPlayerFromRtc() { this.rotation = 0; nativeEnablePushAudioToRtc(false); nativeEnableLocalPlayoutVolume(false); + nativeUnregisterAudioFrameObserver(); mediaVideoSource = null; nativeRelease(); Log.i(TAG, "detachPlayerFromRtc"); @@ -194,6 +195,7 @@ public void release() { enablePushAudioToRtc = false; nativeEnablePushAudioToRtc(false); nativeEnableLocalPlayoutVolume(false); + nativeUnregisterAudioFrameObserver(); // mRtcEngine.setVideoSource(new AgoraDefaultSource()); adjustPublishSignalVolume(400, 0); mediaVideoSource = null; @@ -282,6 +284,8 @@ public void onFrame(VideoFrame videoFrame) { private native int adjustPublishVoiceVolume(float volume); + private native int nativeUnregisterAudioFrameObserver(); + public void onJoinChannelSuccess(String channel, int uid, int elapsed) { if (!enablePushVideoToRtc) { enablePushVideoToRtc = true; diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle index 822e31b..ed5cf64 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle @@ -48,7 +48,7 @@ dependencies { implementation fileTree(include: ['*.jar'], dir: 'libs') implementation(name: 'RtcChannelPublishHelper', ext: 'aar') // api project(':RtcChannelPublishHelper') - implementation 'io.agora.rtc:full-sdk:3.2.0' + implementation 'io.agora.rtc:full-sdk:2.9.0.107' //implementation files('lib/AgoraMediaPlayer.jar') //implementation files('lib/agora-rtc-sdk.jar') implementation 'io.agora:agoraplayer:1.2.2' diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar index f861254be657e34aea350eccdb8d4dac935721ed..f16758d0ea8be4adfc396ddb9856b507117fb21d 100644 GIT binary patch delta 78585 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

|s|)CnW2qKaGW1RF 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�UNZ_o+D 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

PeY^6)A>(Jfy_o{(dmO^T$A)Eo?FrB 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 DkCk(V*>b75~*N(UfA&1 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 K2IbQN0001bgzc07 diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java index 13b6a77..21086fd 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/java/io/agora/mediaplayer/PlayerFragment.java @@ -652,6 +652,7 @@ private void video1GetStreamInfo() { streamInfos = streamInfos + streamInfo + "\n"; LogUtil.i( "streamInfo:" + streamInfo); } + agoraMediaPlayerKit1.getStreamInfo(streamCount); setInfo1Text("streamInfos:" + streamInfos); } @@ -691,7 +692,7 @@ private void video1Connect() { video1Connect.setTag(true); video1Connect.setText("断开"); rtcChannelPublishHelper.attachPlayerToRtc(agoraMediaPlayerKit1, this.mRtcEngine); - //rtcChannelPublishHelper.enableLocalPlayoutVolume(true); + rtcChannelPublishHelper.enableLocalPlayoutVolume(true); //agoraMediaPlayerKit1.mute(true); } else { video1Connect.setTag(false); diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml index b1dfcd1..353f5c0 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/src/main/res/values/strings.xml @@ -6,5 +6,5 @@ - + YOUR APPID From c13c149673aefd1fb2606efff274f99fc225e148 Mon Sep 17 00:00:00 2001 From: tangnianji Date: Tue, 1 Jun 2021 16:37:06 +0800 Subject: [PATCH 6/7] fix detachFromRtc crash bug --- .../src/main/java/io/agora/RtcChannelPublishHelper.java | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java index 97b87f8..8910136 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/RtcChannelPublishHelper.java @@ -170,6 +170,7 @@ public int detachPlayerFromRtc() { } //mRtcEngine.setVideoSource(new AgoraDefaultSource()); //adjustPublishSignalVolume(400,0); + nativeUnregisterAudioFrameObserver(); this.agoraMediaPlayerKit.unregisterAudioFrameObserver(this); this.agoraMediaPlayerKit.unregisterVideoFrameObserver(this); enablePushVideoToRtc = false; @@ -177,7 +178,6 @@ public int detachPlayerFromRtc() { this.rotation = 0; nativeEnablePushAudioToRtc(false); nativeEnableLocalPlayoutVolume(false); - nativeUnregisterAudioFrameObserver(); mediaVideoSource = null; nativeRelease(); Log.i(TAG, "detachPlayerFromRtc"); From 651e0ad72b46b599b58f8994ad74aad22ef06b09 Mon Sep 17 00:00:00 2001 From: Tongjiangyong Date: Tue, 14 Sep 2021 11:45:01 +0800 Subject: [PATCH 7/7] update sdk --- .../RtcChannelPublishHelper/build.gradle | 2 +- .../src/main/cpp/include/AgoraBase.h | 333 +- .../src/main/cpp/include/IAgoraMediaEngine.h | 786 ++- .../src/main/cpp/include/IAgoraRtcChannel.h | 1385 +++- .../src/main/cpp/include/IAgoraRtcEngine.h | 6220 +++++++++++------ .../src/main/cpp/include/IAgoraService.h | 7 +- .../main/java/io/agora/MediaVideoSource.java | 10 + .../AgoraPlayer_Quickstart/app/build.gradle | 6 +- .../app/lib/RtcChannelPublishHelper.aar | Bin 89087 -> 0 bytes .../io/agora/mediaplayer/PlayerFragment.java | 2 +- 10 files changed, 6135 insertions(+), 2616 deletions(-) delete mode 100644 MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle index 3b39106..d191f41 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/build.gradle @@ -56,7 +56,7 @@ dependencies { //dependencies { compile fileTree(dir:'../../../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} //provided files('../../../../build/android/arm/android/lib/agora-rtc-sdk/agora-rtc-sdk.jar') compile 'com.android.support:support-v4:23.2.0' - implementation 'io.agora.rtc:full-sdk:2.9.0.107' + implementation 'io.agora.rtc:full-sdk:3.3.0' //dependencies { compile fileTree(dir:'../../build/android/arm/android/lib/agora-rtc-sdk',include:['*.jar'])} //implementation 'net.butterflytv.utils:rtmp-client:0.2.6' //implementation 'net.butterflytv.utils:rtmp-client:3.1.0' diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h index 56c4997..654bb9c 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/AgoraBase.h @@ -18,18 +18,23 @@ #define AGORA_CALL __cdecl #if defined(AGORARTC_EXPORT) #define AGORA_API extern "C" __declspec(dllexport) +#define AGORA_CPP_API __declspec(dllexport) #else #define AGORA_API extern "C" __declspec(dllimport) +#define AGORA_CPP_API __declspec(dllimport) #endif #elif defined(__APPLE__) #include #define AGORA_API __attribute__((visibility("default"))) extern "C" +#define AGORA_CPP_API __attribute__((visibility("default"))) #define AGORA_CALL #elif defined(__ANDROID__) || defined(__linux__) #define AGORA_API extern "C" __attribute__((visibility("default"))) +#define AGORA_CPP_API __attribute__((visibility("default"))) #define AGORA_CALL #else #define AGORA_API extern "C" +#define AGORA_CPP_API #define AGORA_CALL #endif @@ -130,7 +135,7 @@ enum WARN_CODE_TYPE */ WARN_LOOKUP_CHANNEL_TIMEOUT = 104, /** **DEPRECATED** 105: The server rejects the request to look up the channel. The server cannot process this request or the request is illegal. - + Deprecated as of v2.4.1. Use CONNECTION_CHANGED_REJECTED_BY_SERVER(10) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ WARN_LOOKUP_CHANNEL_REJECTED = 105, @@ -145,7 +150,7 @@ enum WARN_CODE_TYPE /** 111: A timeout occurs when switching to the live video. */ WARN_SWITCH_LIVE_VIDEO_TIMEOUT = 111, - /** 118: A timeout occurs when setting the client role in the live broadcast profile. + /** 118: A timeout occurs when setting the client role in the interactive live streaming profile. */ WARN_SET_CLIENT_ROLE_TIMEOUT = 118, /** 121: The ticket to open the channel is invalid. @@ -154,93 +159,103 @@ enum WARN_CODE_TYPE /** 122: Try connecting to another server. */ WARN_OPEN_CHANNEL_TRY_NEXT_VOS = 122, + /** 131: The channel connection cannot be recovered. + */ WARN_CHANNEL_CONNECTION_UNRECOVERABLE = 131, + /** 132: The IP address has changed. + */ WARN_CHANNEL_CONNECTION_IP_CHANGED = 132, + /** 133: The port has changed. + */ WARN_CHANNEL_CONNECTION_PORT_CHANGED = 133, + /** 134: The socket error occurs, try to rejoin channel. + */ + WARN_CHANNEL_SOCKET_ERROR = 134, /** 701: An error occurs in opening the audio mixing file. */ WARN_AUDIO_MIXING_OPEN_ERROR = 701, - /** 1014: Audio Device Module: a warning occurs in the playback device. + /** 1014: Audio Device Module: A warning occurs in the playback device. */ WARN_ADM_RUNTIME_PLAYOUT_WARNING = 1014, - /** 1016: Audio Device Module: a warning occurs in the recording device. + /** 1016: Audio Device Module: A warning occurs in the audio capturing device. */ WARN_ADM_RUNTIME_RECORDING_WARNING = 1016, - /** 1019: Audio Device Module: no valid audio data is collected. + /** 1019: Audio Device Module: No valid audio data is captured. */ WARN_ADM_RECORD_AUDIO_SILENCE = 1019, - /** 1020: Audio Device Module: the playback device fails. + /** 1020: Audio device module: The audio playback frequency is abnormal, which may cause audio freezes. This abnormality is caused by high CPU usage. Agora recommends stopping other apps. */ WARN_ADM_PLAYOUT_MALFUNCTION = 1020, - /** 1021: Audio Device Module: the recording device fails. + /** 1021: Audio device module: the audio capturing frequency is abnormal, which may cause audio freezes. This abnormality is caused by high CPU usage. Agora recommends stopping other apps. */ WARN_ADM_RECORD_MALFUNCTION = 1021, - - /** 1025: Call is interrupted by system events such as phone call or siri (iOS) etc. + /** 1025: The audio playback or capturing is interrupted by system events (such as a phone call). */ WARN_ADM_CALL_INTERRUPTION = 1025, - - /** 1029: During a call, the audio session category should be set to - * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. - * If the audio session category is set to other values, this warning code - * is triggered and RtcEngine will forcefully set it back to + /** 1029: During a call, the audio session category should be set to + * AVAudioSessionCategoryPlayAndRecord, and RtcEngine monitors this value. + * If the audio session category is set to other values, this warning code + * is triggered and RtcEngine will forcefully set it back to * AVAudioSessionCategoryPlayAndRecord. */ WARN_ADM_IOS_CATEGORY_NOT_PLAYANDRECORD = 1029, - /** - */ - WARN_ADM_IOS_SAMPLERATE_CHANGE = 1030, - /** 1031: Audio Device Module: the recorded audio voice is too low. + /** 1031: Audio Device Module: The captured audio voice is too low. */ WARN_ADM_RECORD_AUDIO_LOWLEVEL = 1031, - /** 1032: Audio Device Module: the playback audio voice is too low. + /** 1032: Audio Device Module: The playback audio voice is too low. */ WARN_ADM_PLAYOUT_AUDIO_LOWLEVEL = 1032, - /** - */ + /** 1033: Audio device module: The audio capturing device is occupied. + */ WARN_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, - /** 1040: Audio device module: An exception occurs with the audio drive. - * Solutions: + /** 1040: Audio device module: An exception occurs with the audio drive. + * Solutions: * - Disable or re-enable the audio device. * - Re-enable your device. * - Update the sound card drive. */ WARN_ADM_WINDOWS_NO_DATA_READY_EVENT = 1040, - /** 1051: Audio Device Module: howling is detected. + /** 1042: Audio device module: The audio capturing device is different from the audio playback device, + * which may cause echoes problem. Agora recommends using the same audio device to capture and playback + * audio. + */ + WARN_ADM_INCONSISTENT_AUDIO_DEVICE = 1042, + /** 1051: (Communication profile only) Audio processing module: A howling sound is detected when capturing the audio data. */ WARN_APM_HOWLING = 1051, - /** 1052: Audio Device Module: the device is in the glitch state. + /** 1052: Audio Device Module: The device is in the glitch state. */ WARN_ADM_GLITCH_STATE = 1052, - /** 1053: Audio Device Module: the underlying audio settings have changed. + /** 1053: Audio Processing Module: A residual echo is detected, which may be caused by the belated scheduling of system threads or the signal overflow. */ - WARN_ADM_IMPROPER_SETTINGS = 1053, - /** - */ + WARN_APM_RESIDUAL_ECHO = 1053, + /// @cond WARN_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, - /** 1323: Audio device module: No available playback device. + /// @endcond + /** 1323: Audio device module: No available playback device. * Solution: Plug in the audio device. */ WARN_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, - /** Audio device module: The capture device is released improperly. - * Solutions: + /** Audio device module: The capture device is released improperly. + * Solutions: * - Disable or re-enable the audio device. * - Re-enable your device. * - Update the sound card drive. */ WARN_ADM_WIN_CORE_IMPROPER_CAPTURE_RELEASE = 1324, - /** 1610: Super-resolution warning: the original video dimensions of the remote user exceed 640 × 480. + /** 1610: The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. */ WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION = 1610, - /** 1611: Super-resolution warning: another user is using super resolution. + /** 1611: Another user is already using the super-resolution algorithm. */ WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION = 1611, - /** 1612: The device is not supported. + /** 1612: The device does not support the super-resolution algorithm. */ WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED = 1612, - + /// @cond WARN_RTM_LOGIN_TIMEOUT = 2005, WARN_RTM_KEEP_ALIVE_TIMEOUT = 2009 + /// @endcond }; /** Error code. @@ -267,7 +282,7 @@ enum ERROR_CODE_TYPE /** 4: The SDK does not support this function. */ ERR_NOT_SUPPORTED = 4, - /** 5: The request is rejected. This is for internal SDK use only, and it does not return to the application through any method or callback. + /** 5: The request is rejected. */ ERR_REFUSED = 5, /** 6: The buffer size is not big enough to store the returned data. @@ -276,7 +291,7 @@ enum ERROR_CODE_TYPE /** 7: The SDK is not initialized before calling this method. */ ERR_NOT_INITIALIZED = 7, - /** 9: No permission exists. This is for internal SDK use only, and it does not return to the application through any method or callback. + /** 9: No permission exists. Check if the user has granted access to the audio or video device. */ ERR_NO_PERMISSION = 9, /** 10: An API method timeout occurs. Some API methods require the SDK to return the execution result, and this error occurs if the request takes too long (more than 10 seconds) for the SDK to process. @@ -285,7 +300,7 @@ enum ERROR_CODE_TYPE /** 11: The request is canceled. This is for internal SDK use only, and it does not return to the application through any method or callback. */ ERR_CANCELED = 11, - /** 12: The method is called too often. This is for internal SDK use only, and it does not return to the application through any method or callback. + /** 12: The method is called too often. */ ERR_TOO_OFTEN = 12, /** 13: The SDK fails to bind to the network socket. This is for internal SDK use only, and it does not return to the application through any method or callback. @@ -297,7 +312,15 @@ enum ERROR_CODE_TYPE /** 15: No network buffers are available. This is for internal SDK internal use only, and it does not return to the application through any method or callback. */ ERR_NET_NOBUFS = 15, - /** 17: The request to join the channel is rejected. This error usually occurs when the user is already in the channel, and still calls the method to join the channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + /** 17: The request to join the channel is rejected. + * + * - This error usually occurs when the user is already in the channel, and still calls the method to join the + * channel, for example, \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + * - This error usually occurs when the user tries to join a channel + * during \ref agora::rtc::IRtcEngine::startEchoTest "startEchoTest". Once you + * call \ref agora::rtc::IRtcEngine::startEchoTest "startEchoTest", you need to + * call \ref agora::rtc::IRtcEngine::stopEchoTest "stopEchoTest" before joining a channel. + * - The user tries to join the channel with a token that is expired. */ ERR_JOIN_CHANNEL_REJECTED = 17, /** 18: The request to leave the channel is rejected. @@ -326,19 +349,22 @@ enum ERROR_CODE_TYPE /** 102: The specified channel name is invalid. Please try to rejoin the channel with a valid channel name. */ ERR_INVALID_CHANNEL_NAME = 102, + /** 103: Fails to get server resources in the specified region. Please try to specify another region when calling \ref agora::rtc::IRtcEngine::initialize "initialize". + */ + ERR_NO_SERVER_RESOURCES = 103, /** **DEPRECATED** 109: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_TOKEN_EXPIRED(9) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. - + The token expired due to one of the following reasons: - - - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within five minutes after the Token is generated. If the user does not access the Agora service after five minutes, this Token is no longer valid. + + - Authorized Timestamp expired: The timestamp is represented by the number of seconds elapsed since 1/1/1970. The user can use the Token to access the Agora service within 24 hours after the Token is generated. If the user does not access the Agora service after 24 hours, this Token is no longer valid. - Call Expiration Timestamp expired: The timestamp is the exact time when a user can no longer use the Agora service (for example, when a user is forced to leave an ongoing call). When a value is set for the Call Expiration Timestamp, it does not mean that the token will expire, but that the user will be banned from the channel. */ ERR_TOKEN_EXPIRED = 109, /** **DEPRECATED** 110: Deprecated as of v2.4.1. Use CONNECTION_CHANGED_INVALID_TOKEN(8) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. - + The token is invalid due to one of the following reasons: - - - The App Certificate for the project is enabled in Dashboard, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token. + + - The App Certificate for the project is enabled in Console, but the user is still using the App ID. Once the App Certificate is enabled, the user must use a token. - The uid is mandatory, and users must set the same uid as the one set in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. */ ERR_INVALID_TOKEN = 110, @@ -348,7 +374,7 @@ enum ERROR_CODE_TYPE /** 112: The internet connection is lost. This applies to the Agora Web SDK only. */ ERR_CONNECTION_LOST = 112, // only used in web sdk - /** 113: The user is not in the channel when calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" or \ref agora::rtc::IRtcEngine::getUserInfoByUserAccount "getUserInfoByUserAccount" method. + /** 113: The user is not in the channel when calling the method. */ ERR_NOT_IN_CHANNEL = 113, /** 114: The size of the sent data is over 1024 bytes when the user calls the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. @@ -369,7 +395,7 @@ enum ERROR_CODE_TYPE /** 120: Decryption fails. The user may have used a different encryption password to join the channel. Check your settings or try rejoining the channel. */ ERR_DECRYPTION_FAILED = 120, - /** 123: The client is banned by the server. + /** 123: The user is banned by the server. This error occurs when the user is kicked out the channel from the server. */ ERR_CLIENT_IS_BANNED_BY_SERVER = 123, /** 124: Incorrect watermark file parameter. @@ -411,109 +437,57 @@ enum ERROR_CODE_TYPE /** 155: The server fails to find the stream. */ ERR_PUBLISH_STREAM_NOT_FOUND = 155, - /** 156: The format of the RTMP stream URL is not supported. Check whether the URL format is correct. + /** 156: The format of the RTMP or RTMPS stream URL is not supported. Check whether the URL format is correct. */ ERR_PUBLISH_STREAM_FORMAT_NOT_SUPPORTED = 156, + /** 157: The necessary dynamical library is not integrated. For example, if you call + * the \ref agora::rtc::IRtcEngine::enableDeepLearningDenoise "enableDeepLearningDenoise" but do not integrate the dynamical + * library for the deep-learning noise reduction into your project, the SDK reports this error code. + * + */ + ERR_MODULE_NOT_FOUND = 157, + /// @cond + /** 158: The dynamical library for the super-resolution algorithm is not integrated. + * When you call the \ref agora::rtc::IRtcEngine::enableRemoteSuperResolution "enableRemoteSuperResolution" method but + * do not integrate the dynamical library for the super-resolution algorithm + * into your project, the SDK reports this error code. + */ + ERR_MODULE_SUPER_RESOLUTION_NOT_FOUND = 158, + /// @endcond //signaling: 400~600 - /** - */ ERR_LOGOUT_OTHER = 400, // - /** 401: The user logged out. - */ ERR_LOGOUT_USER = 401, // logout by user - /** 402: Network failure. - */ ERR_LOGOUT_NET = 402, // network failure - /** 403: Logged in another device. - */ ERR_LOGOUT_KICKED = 403, // login in other device - /** - */ ERR_LOGOUT_PACKET = 404, // - /** 405: The token expired. - */ ERR_LOGOUT_TOKEN_EXPIRED = 405, // token expired - /** - */ ERR_LOGOUT_OLDVERSION = 406, // - /** - */ ERR_LOGOUT_TOKEN_WRONG = 407, - /** - */ ERR_LOGOUT_ALREADY_LOGOUT = 408, - /** - */ ERR_LOGIN_OTHER = 420, - /** - */ ERR_LOGIN_NET = 421, - /** - */ ERR_LOGIN_FAILED = 422, - /** - */ ERR_LOGIN_CANCELED = 423, - /** - */ ERR_LOGIN_TOKEN_EXPIRED = 424, - /** - */ ERR_LOGIN_OLD_VERSION = 425, - /** - */ ERR_LOGIN_TOKEN_WRONG = 426, - /** - */ ERR_LOGIN_TOKEN_KICKED = 427, - /** - */ ERR_LOGIN_ALREADY_LOGIN = 428, - /** - */ ERR_JOIN_CHANNEL_OTHER = 440, - /** - */ ERR_SEND_MESSAGE_OTHER = 440, - /** - */ ERR_SEND_MESSAGE_TIMEOUT = 441, - /** - */ ERR_QUERY_USERNUM_OTHER = 450, - /** - */ ERR_QUERY_USERNUM_TIMEOUT = 451, - /** - */ ERR_QUERY_USERNUM_BYUSER = 452, - /** - */ ERR_LEAVE_CHANNEL_OTHER = 460, - /** - */ ERR_LEAVE_CHANNEL_KICKED = 461, - /** - */ ERR_LEAVE_CHANNEL_BYUSER = 462, - /** - */ ERR_LEAVE_CHANNEL_LOGOUT = 463, - /** - */ ERR_LEAVE_CHANNEL_DISCONNECTED = 464, - /** - */ ERR_INVITE_OTHER = 470, - /** - */ ERR_INVITE_REINVITE = 471, - /** - */ ERR_INVITE_NET = 472, - /** - */ ERR_INVITE_PEER_OFFLINE = 473, ERR_INVITE_TIMEOUT = 474, ERR_INVITE_CANT_RECV = 475, @@ -527,7 +501,7 @@ enum ERROR_CODE_TYPE */ ERR_START_CALL = 1002, /** **DEPRECATED** 1003: Fails to start the camera. - + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE(4) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ ERR_START_CAMERA = 1003, @@ -552,29 +526,29 @@ enum ERROR_CODE_TYPE /** 1010: Audio Device Module: An error occurs in stopping the playback device. */ ERR_ADM_STOP_PLAYOUT = 1010, - /** 1011: Audio Device Module: An error occurs in initializing the recording device. + /** 1011: Audio Device Module: An error occurs in initializing the capturing device. */ ERR_ADM_INIT_RECORDING = 1011, - /** 1012: Audio Device Module: An error occurs in starting the recording device. + /** 1012: Audio Device Module: An error occurs in starting the capturing device. */ ERR_ADM_START_RECORDING = 1012, - /** 1013: Audio Device Module: An error occurs in stopping the recording device. + /** 1013: Audio Device Module: An error occurs in stopping the capturing device. */ ERR_ADM_STOP_RECORDING = 1013, /** 1015: Audio Device Module: A playback error occurs. Check your playback device and try rejoining the channel. */ ERR_ADM_RUNTIME_PLAYOUT_ERROR = 1015, - /** 1017: Audio Device Module: A recording error occurs. + /** 1017: Audio Device Module: A capturing error occurs. */ ERR_ADM_RUNTIME_RECORDING_ERROR = 1017, /** 1018: Audio Device Module: Fails to record. */ ERR_ADM_RECORD_AUDIO_FAILED = 1018, - /** 1022: Audio Device Module: An error occurs in initializing the + /** 1022: Audio Device Module: An error occurs in initializing the * loopback device. */ ERR_ADM_INIT_LOOPBACK = 1022, - /** 1023: Audio Device Module: An error occurs in starting the loopback + /** 1023: Audio Device Module: An error occurs in starting the loopback * device. */ ERR_ADM_START_LOOPBACK = 1023, @@ -582,37 +556,37 @@ enum ERROR_CODE_TYPE * recording permission is granted. */ ERR_ADM_NO_PERMISSION = 1027, - /** 1033: Audio device module: The device is occupied. + /** 1033: Audio device module: The device is occupied. */ ERR_ADM_RECORD_AUDIO_IS_ACTIVE = 1033, /** 1101: Audio device module: A fatal exception occurs. */ ERR_ADM_ANDROID_JNI_JAVA_RESOURCE = 1101, - /** 1108: Audio device module: The recording frequency is lower than 50. - * 0 indicates that the recording is not yet started. We recommend + /** 1108: Audio device module: The capturing frequency is lower than 50. + * 0 indicates that the capturing is not yet started. We recommend * checking your recording permission. */ ERR_ADM_ANDROID_JNI_NO_RECORD_FREQUENCY = 1108, - /** 1109: The playback frequency is lower than 50. 0 indicates that the - * playback is not yet started. We recommend checking if you have created - * too many AudioTrack instances. + /** 1109: The playback frequency is lower than 50. 0 indicates that the + * playback is not yet started. We recommend checking if you have created + * too many AudioTrack instances. */ ERR_ADM_ANDROID_JNI_NO_PLAYBACK_FREQUENCY = 1109, - /** 1111: Audio device module: AudioRecord fails to start up. A ROM system - * error occurs. We recommend the following options to debug: + /** 1111: Audio device module: AudioRecord fails to start up. A ROM system + * error occurs. We recommend the following options to debug: * - Restart your App. - * - Restart your cellphone. + * - Restart your cellphone. * - Check your recording permission. */ ERR_ADM_ANDROID_JNI_JAVA_START_RECORD = 1111, - /** 1112: Audio device module: AudioTrack fails to start up. A ROM system - * error occurs. We recommend the following options to debug: + /** 1112: Audio device module: AudioTrack fails to start up. A ROM system + * error occurs. We recommend the following options to debug: * - Restart your App. - * - Restart your cellphone. + * - Restart your cellphone. * - Check your playback permission. */ ERR_ADM_ANDROID_JNI_JAVA_START_PLAYBACK = 1112, - /** 1115: Audio device module: AudioRecord returns error. The SDK will + /** 1115: Audio device module: AudioRecord returns error. The SDK will * automatically restart AudioRecord. */ ERR_ADM_ANDROID_JNI_JAVA_RECORD_ERROR = 1115, /** **DEPRECATED** */ @@ -625,113 +599,115 @@ enum ERROR_CODE_TYPE ERR_ADM_ANDROID_OPENSL_CREATE_AUDIO_PLAYER = 1157, /** **DEPRECATED** */ ERR_ADM_ANDROID_OPENSL_START_PLAYER_THREAD = 1160, - /** 1201: Audio device module: The current device does not support audio + /** 1201: Audio device module: The current device does not support audio * input, possibly because you have mistakenly configured the audio session - * category, or because some other app is occupying the input device. We + * category, or because some other app is occupying the input device. We * recommend terminating all background apps and re-joining the channel. */ ERR_ADM_IOS_INPUT_NOT_AVAILABLE = 1201, /** 1206: Audio device module: Cannot activate the Audio Session.*/ ERR_ADM_IOS_ACTIVATE_SESSION_FAIL = 1206, - /** 1210: Audio device module: Fails to initialize the audio device, + /** 1210: Audio device module: Fails to initialize the audio device, * normally because the audio device parameters are wrongly set.*/ ERR_ADM_IOS_VPIO_INIT_FAIL = 1210, - /** 1213: Audio device module: Fails to re-initialize the audio device, + /** 1213: Audio device module: Fails to re-initialize the audio device, * normally because the audio device parameters are wrongly set.*/ ERR_ADM_IOS_VPIO_REINIT_FAIL = 1213, - /** 1214: Fails to re-start up the Audio Unit, possibly because the audio + /** 1214: Fails to re-start up the Audio Unit, possibly because the audio * session category is not compatible with the settings of the Audio Unit. */ ERR_ADM_IOS_VPIO_RESTART_FAIL = 1214, + ERR_ADM_IOS_SET_RENDER_CALLBACK_FAIL = 1219, + /** **DEPRECATED** */ ERR_ADM_IOS_SESSION_SAMPLERATR_ZERO = 1221, - /** 1301: Audio device module: An audio driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1301: Audio device module: An audio driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system.*/ ERR_ADM_WIN_CORE_INIT = 1301, - /** 1303: Audio device module: A recording driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1303: Audio device module: A recording driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_INIT_RECORDING = 1303, - /** 1306: Audio device module: A playout driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1306: Audio device module: A playout driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_INIT_PLAYOUT = 1306, - /** 1307: Audio device module: No audio device is available. Solutions: + /** 1307: Audio device module: No audio device is available. Solutions: * Plug in a proper audio device. */ ERR_ADM_WIN_CORE_INIT_PLAYOUT_NULL = 1307, - /** 1309: Audio device module: An audio driver abnomality or a - * compatibility issue occurs. Solutions: Disable and restart the audio + /** 1309: Audio device module: An audio driver abnormality or a + * compatibility issue occurs. Solutions: Disable and restart the audio * device, or reboot the system. */ ERR_ADM_WIN_CORE_START_RECORDING = 1309, - /** 1311: Audio device module: Insufficient system memory or poor device + /** 1311: Audio device module: Insufficient system memory or poor device * performance. Solutions: Reboot the system or replace the device. */ ERR_ADM_WIN_CORE_CREATE_REC_THREAD = 1311, - /** 1314: Audio device module: An audio driver abnormality occurs. + /** 1314: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver.*/ ERR_ADM_WIN_CORE_CAPTURE_NOT_STARTUP = 1314, - /** 1319: Audio device module: Insufficient system memory or poor device + /** 1319: Audio device module: Insufficient system memory or poor device * performance. Solutions: Reboot the system or replace the device. */ ERR_ADM_WIN_CORE_CREATE_RENDER_THREAD = 1319, - /** 1320: Audio device module: An audio driver abnormality occurs. + /** 1320: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Replace the device. */ ERR_ADM_WIN_CORE_RENDER_NOT_STARTUP = 1320, - /** 1322: Audio device module: No audio sampling device is available. - * Solutions: Plug in a proper recording device. */ + /** 1322: Audio device module: No audio sampling device is available. + * Solutions: Plug in a proper capturing device. */ ERR_ADM_WIN_CORE_NO_RECORDING_DEVICE = 1322, - /** 1323: Audio device module: No audio playout device is available. + /** 1323: Audio device module: No audio playout device is available. * Solutions: Plug in a proper playback device.*/ ERR_ADM_WIN_CORE_NO_PLAYOUT_DEVICE = 1323, - /** 1351: Audio device module: An audio driver abnormality or a + /** 1351: Audio device module: An audio driver abnormality or a * compatibility issue occurs. Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT = 1351, - /** 1353: Audio device module: An audio driver abnormality occurs. + /** 1353: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_RECORDING = 1353, - /** 1354: Audio device module: An audio driver abnormality occurs. + /** 1354: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_MICROPHONE = 1354, - /** 1355: Audio device module: An audio driver abnormality occurs. + /** 1355: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_PLAYOUT = 1355, - /** 1356: Audio device module: An audio driver abnormality occurs. + /** 1356: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_INIT_SPEAKER = 1356, - /** 1357: Audio device module: An audio driver abnormality occurs. + /** 1357: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver. */ ERR_ADM_WIN_WAVE_START_RECORDING = 1357, - /** 1358: Audio device module: An audio driver abnormality occurs. + /** 1358: Audio device module: An audio driver abnormality occurs. * Solutions: * - Disable and then re-enable the audio device. * - Reboot the system. * - Upgrade your audio card driver.*/ ERR_ADM_WIN_WAVE_START_PLAYOUT = 1358, - /** 1359: Audio Device Module: No recording device exists. + /** 1359: Audio Device Module: No capturing device exists. */ ERR_ADM_NO_RECORDING_DEVICE = 1359, /** 1360: Audio Device Module: No playback device exists. @@ -739,14 +715,13 @@ enum ERROR_CODE_TYPE ERR_ADM_NO_PLAYOUT_DEVICE = 1360, // VDM error code starts from 1500 - /** 1500: Video Device Module: There is no camera device. - */ - ERR_VDM_CAMERA_NO_DEVICE = 1500, /** 1501: Video Device Module: The camera is unauthorized. */ ERR_VDM_CAMERA_NOT_AUTHORIZED = 1501, + + // VDM error code starts from 1500 /** **DEPRECATED** 1502: Video Device Module: The camera in use. - + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY(3) in the \ref agora::rtc::IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" callback instead. */ ERR_VDM_WIN_DEVICE_IN_USE = 1502, @@ -766,7 +741,7 @@ enum ERROR_CODE_TYPE ERR_VCM_ENCODER_SET_ERROR = 1603, }; - /** Output log filter level. */ +/** Output log filter level. */ enum LOG_FILTER_TYPE { /** 0: Do not output any log information. */ @@ -785,7 +760,27 @@ enum LOG_FILTER_TYPE LOG_FILTER_ERROR = 0x000c, /** 0x0008: Outputs CRITICAL level log information. */ LOG_FILTER_CRITICAL = 0x0008, + /// @cond LOG_FILTER_MASK = 0x80f, + /// @endcond +}; +/** The output log level of the SDK. + * + * @since v3.3.0 + */ +enum class LOG_LEVEL { + /** 0: Do not output any log. */ + LOG_LEVEL_NONE = 0x0000, + /** 0x0001: (Default) Output logs of the FATAL, ERROR, WARN and INFO level. We recommend setting your log filter as this level. + */ + LOG_LEVEL_INFO = 0x0001, + /** 0x0002: Output logs of the FATAL, ERROR and WARN level. + */ + LOG_LEVEL_WARN = 0x0002, + /** 0x0004: Output logs of the FATAL and ERROR level. */ + LOG_LEVEL_ERROR = 0x0004, + /** 0x0008: Output logs of the FATAL level. */ + LOG_LEVEL_FATAL = 0x0008, }; } // namespace agora diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h index 45cca10..c740a72 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraMediaEngine.h @@ -1,90 +1,394 @@ #ifndef AGORA_MEDIA_ENGINE_H #define AGORA_MEDIA_ENGINE_H -#if defined _WIN32 || defined __CYGWIN__ -typedef __int64 int64_t; -typedef unsigned __int64 uint64_t; -typedef __int32 int32_t; -typedef unsigned __int32 uint32_t; -#else #include -#endif - -namespace agora -{ -namespace media -{ +namespace agora { +namespace media { +/** **DEPRECATED** Type of audio device. + */ enum MEDIA_SOURCE_TYPE { - AUDIO_PLAYOUT_SOURCE = 0, - AUDIO_RECORDING_SOURCE = 1, + /** Audio playback device. + */ + AUDIO_PLAYOUT_SOURCE = 0, + /** Microphone. + */ + AUDIO_RECORDING_SOURCE = 1, }; -class IAudioFrameObserver -{ -public: +/** + * The IAudioFrameObserver class. + */ +class IAudioFrameObserver { + public: + /** The frame type. */ enum AUDIO_FRAME_TYPE { - FRAME_TYPE_PCM16 = 0, //PCM 16bit little endian + /** 0: PCM16. */ + FRAME_TYPE_PCM16 = 0, // PCM 16bit little endian }; + /** Definition of AudioFrame */ struct AudioFrame { + /** The type of the audio frame. See #AUDIO_FRAME_TYPE + */ AUDIO_FRAME_TYPE type; - int samples; //number of samples in this frame + /** The number of samples per channel in the audio frame. + */ + int samples; //number of samples for each channel in this frame + /**The number of bytes per audio sample, which is usually 16-bit (2-byte). + */ int bytesPerSample; //number of bytes per sample: 2 for PCM16 + /** The number of audio channels. + - 1: Mono + - 2: Stereo (the data is interleaved) + */ int channels; //number of channels (data are interleaved if stereo) + /** The sample rate. + */ int samplesPerSec; //sampling rate + /** The data buffer of the audio frame. When the audio frame uses a stereo channel, the data buffer is interleaved. + The size of the data buffer is as follows: `buffer` = `samples` × `channels` × `bytesPerSample`. + */ void* buffer; //data buffer + /** The timestamp (ms) of the external audio frame. You can use this parameter for the following purposes: + - Restore the order of the captured audio frame. + - Synchronize audio and video frames in video-related scenarios, including where external video sources are used. + */ int64_t renderTimeMs; + /** Reserved parameter. + */ int avsync_type; }; -public: + + public: + /** Retrieves the captured audio frame. + + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame, and the captured audio frame is sent out. + - false: Invalid buffer in AudioFrame, and the captured audio frame is discarded. + */ virtual bool onRecordAudioFrame(AudioFrame& audioFrame) = 0; + /** Retrieves the audio playback frame for getting the audio. + + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame, and the audio playback frame is sent out. + - false: Invalid buffer in AudioFrame, and the audio playback frame is discarded. + */ virtual bool onPlaybackAudioFrame(AudioFrame& audioFrame) = 0; + /** Retrieves the mixed captured and playback audio frame. + + + @note This callback only returns the single-channel data. + + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame and the mixed captured and playback audio frame is sent out. + - false: Invalid buffer in AudioFrame and the mixed captured and playback audio frame is discarded. + */ virtual bool onMixedAudioFrame(AudioFrame& audioFrame) = 0; - virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, AudioFrame& audioFrame) = 0; + /** Retrieves the audio frame of a specified user before mixing. + + The SDK triggers this callback if isMultipleChannelFrameWanted returns false. + + @param uid The user ID + @param audioFrame Pointer to AudioFrame. + @return + - true: Valid buffer in AudioFrame, and the mixed captured and playback audio frame is sent out. + - false: Invalid buffer in AudioFrame, and the mixed captured and playback audio frame is discarded. + */ + virtual bool onPlaybackAudioFrameBeforeMixing(unsigned int uid, + AudioFrame& audioFrame) = 0; + /** Determines whether to receive audio data from multiple channels. + + @since v3.0.1 + + After you register the audio frame observer, the SDK triggers this callback every time it captures an audio frame. + + In the multi-channel scenario, if you want to get audio data from multiple channels, + set the return value of this callback as true. After that, the SDK triggers the + \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixingEx "onPlaybackAudioFrameBeforeMixingEx" callback to send you the before-mixing + audio data from various channels. You can also get the channel ID of each audio frame. + + @note + - Once you set the return value of this callback as true, the SDK triggers + only the \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixingEx "onPlaybackAudioFrameBeforeMixingEx" callback + to send the before-mixing audio frame. \ref IAudioFrameObserver::onPlaybackAudioFrameBeforeMixing "onPlaybackAudioFrameBeforeMixing" is not triggered. + In the multi-channel scenario, Agora recommends setting the return value as true. + - If you set the return value of this callback as false, the SDK triggers only the `onPlaybackAudioFrameBeforeMixing` callback to send the audio data. + @return + - `true`: Receive audio data from multiple channels. + - `false`: Do not receive audio data from multiple channels. + */ virtual bool isMultipleChannelFrameWanted() { return false; } + + /** Gets the before-mixing playback audio frame from multiple channels. + + After you successfully register the audio frame observer, if you set the return + value of \ref IAudioFrameObserver::isMultipleChannelFrameWanted "isMultipleChannelFrameWanted" as true, the SDK triggers this callback each + time it receives a before-mixing audio frame from any of the channel. + + @param channelId The channel ID of this audio frame. + @param uid The ID of the user sending this audio frame. + @param audioFrame The pointer to AudioFrame. + @return + - `true`: The data in AudioFrame is valid, and send this audio frame. + - `false`: The data in AudioFrame in invalid, and do not send this audio frame. + */ virtual bool onPlaybackAudioFrameBeforeMixingEx(const char *channelId, unsigned int uid, AudioFrame& audioFrame) { return true; } + }; -class IVideoFrameObserver -{ -public: +/** + * The IVideoFrameObserver class. + */ +class IVideoFrameObserver { + public: + /** The video frame type. */ enum VIDEO_FRAME_TYPE { - FRAME_TYPE_YUV420 = 0, //YUV 420 format + /** + * 0: YUV420 + */ + FRAME_TYPE_YUV420 = 0, // YUV 420 format + /** + * 1: YUV422 + */ + FRAME_TYPE_YUV422 = 1, // YUV 422 format + /** + * 2: RGBA + */ FRAME_TYPE_RGBA = 2, // RGBA format }; + /** + * The frame position of the video observer. + */ enum VIDEO_OBSERVER_POSITION { + /** + * 1: The post-capturer position, which corresponds to the video data in the onCaptureVideoFrame callback. + */ POSITION_POST_CAPTURER = 1 << 0, + /** + * 2: The pre-renderer position, which corresponds to the video data in the onRenderVideoFrame callback. + */ POSITION_PRE_RENDERER = 1 << 1, + /** + * 4: The pre-encoder position, which corresponds to the video data in the onPreEncodeVideoFrame callback. + */ POSITION_PRE_ENCODER = 1 << 2, }; + /** Video frame information. The video data format is YUV420. The buffer provides a pointer to a pointer. The interface cannot modify the pointer of the buffer, but can modify the content of the buffer only. + */ struct VideoFrame { VIDEO_FRAME_TYPE type; + /** Video pixel width. + */ int width; //width of video frame + /** Video pixel height. + */ int height; //height of video frame + /** Line span of the Y buffer within the YUV data. + */ int yStride; //stride of Y data buffer + /** Line span of the U buffer within the YUV data. + */ int uStride; //stride of U data buffer + /** Line span of the V buffer within the YUV data. + */ int vStride; //stride of V data buffer + /** Pointer to the Y buffer pointer within the YUV data. + */ void* yBuffer; //Y data buffer + /** Pointer to the U buffer pointer within the YUV data. + */ void* uBuffer; //U data buffer + /** Pointer to the V buffer pointer within the YUV data. + */ void* vBuffer; //V data buffer + /** Set the rotation of this frame before rendering the video. Supports 0, 90, 180, 270 degrees clockwise. + */ int rotation; // rotation of this frame (0, 90, 180, 270) + /** The timestamp (ms) of the external audio frame. It is mandatory. You can use this parameter for the following purposes: + - Restore the order of the captured audio frame. + - Synchronize audio and video frames in video-related scenarios, including scenarios where external video sources are used. + @note This timestamp is for rendering the video stream, and not for capturing the video stream. + */ int64_t renderTimeMs; int avsync_type; }; -public: + + public: + /** Occurs each time the SDK receives a video frame captured by the local camera. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time a video frame is received. In this callback, + * you can get the video data captured by the local camera. You can then pre-process the data according to your scenarios. + * + * After pre-processing, you can send the processed video data back to the SDK by setting the `videoFrame` parameter in this callback. + * + * @note + * - This callback does not support sending processed RGBA video data back to the SDK. + * - The video data that this callback gets has not been pre-processed, without the watermark, the cropped content, the rotation, and the image enhancement. + * + * @param videoFrame Pointer to VideoFrame. + * @return Whether or not to ignore the current video frame if the pre-processing fails: + * - true: Do not ignore. + * - false: Ignore the current video frame, and do not send it back to the SDK. + */ virtual bool onCaptureVideoFrame(VideoFrame& videoFrame) = 0; + /** @since v3.0.0 + * + * Occurs each time the SDK receives a video frame before encoding. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time when it receives a video frame. In this callback, you can get the video data before encoding. You can then process the data according to your particular scenarios. + * + * After processing, you can send the processed video data back to the SDK by setting the `VideoFrame` parameter in this callback. + * + * @note + * - As of v3.0.1, if you want to receive this callback, you also need to set `POSITION_PRE_ENCODE(1 << 2)` as a frame position in the \ref getObservedFramePosition "getObservedFramePosition" callback. + * - The video data that this callback gets has been pre-processed, with its content cropped, rotated, and the image enhanced. + * - This callback does not support sending processed RGBA video data back to the SDK. + * + * @param videoFrame A pointer to VideoFrame + * @return Whether to ignore the current video frame if the processing fails: + * - true: Do not ignore the current video frame. + * - false: Ignore the current video frame, and do not send it back to the SDK. + */ virtual bool onPreEncodeVideoFrame(VideoFrame& videoFrame) { return true; } + /** Occurs each time the SDK receives a video frame sent by the remote user. + * + * After you successfully register the video frame observer and isMultipleChannelFrameWanted return false, the SDK triggers this callback each time a video frame is received. + * In this callback, you can get the video data sent by the remote user. You can then post-process the data according to your scenarios. + * + * After post-processing, you can send the processed data back to the SDK by setting the `videoFrame` parameter in this callback. + * + * @note + * This callback does not support sending processed RGBA video data back to the SDK. + * + * @param uid ID of the remote user who sends the current video frame. + * @param videoFrame Pointer to VideoFrame. + * @return Whether or not to ignore the current video frame if the post-processing fails: + * - true: Do not ignore. + * - false: Ignore the current video frame, and do not send it back to the SDK. + */ virtual bool onRenderVideoFrame(unsigned int uid, VideoFrame& videoFrame) = 0; + /** Occurs each time the SDK receives a video frame and prompts you to set the video format. + * + * YUV420 is the default video format. If you want to receive other video formats, register this callback in the IVideoFrameObserver class. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. + * You need to set your preferred video data in the return value of this callback. + * + * @return Sets the video format: #VIDEO_FRAME_TYPE + * - #FRAME_TYPE_YUV420 (0): (Default) YUV420. + * - #FRAME_TYPE_RGBA (2): RGBA + */ + virtual VIDEO_FRAME_TYPE getVideoFormatPreference() { return FRAME_TYPE_YUV420; } + /** Occurs each time the SDK receives a video frame and prompts you whether or not to rotate the captured video according to the rotation member in the VideoFrame class. + * + * The SDK does not rotate the captured video by default. If you want to rotate the captured video according to the rotation member in the VideoFrame class, register this callback in the IVideoFrameObserver class. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time it receives a video frame. You need to set whether or not to rotate the video frame in the return value of this callback. + * + * @note + * This callback applies to RGBA video data only. + * + * @return Sets whether or not to rotate the captured video: + * - true: Rotate. + * - false: （Default) Do not rotate. + */ virtual bool getRotationApplied() { return false; } - virtual uint32_t getObservedFramePosition() { return POSITION_POST_CAPTURER | POSITION_PRE_RENDERER; } + /** Occurs each time the SDK receives a video frame and prompts you whether or not to mirror the captured video. + * + * The SDK does not mirror the captured video by default. Register this callback in the IVideoFrameObserver class if you want to mirror the captured video. + * + * After you successfully register the video frame observer, the SDK triggers this callback each time a video frame is received. + * You need to set whether or not to mirror the captured video in the return value of this callback. + * + * @note + * This callback applies to RGBA video data only. + * + * @return Sets whether or not to mirror the captured video: + * - true: Mirror. + * - false: (Default) Do not mirror. + */ + virtual bool getMirrorApplied() { return false; } + /** @since v3.0.0 + + Sets whether to output the acquired video frame smoothly. + + If you want the video frames acquired from \ref IVideoFrameObserver::onRenderVideoFrame "onRenderVideoFrame" to be more evenly spaced, you can register the `getSmoothRenderingEnabled` callback in the `IVideoFrameObserver` class and set its return value as `true`. + + @note + - Register this callback before joining a channel. + - This callback applies to scenarios where the acquired video frame is self-rendered after being processed, not to scenarios where the video frame is sent back to the SDK after being processed. + + @return Set whether or not to smooth the video frames: + - true: Smooth the video frame. + - false: (Default) Do not smooth. + */ + virtual bool getSmoothRenderingEnabled(){ return false; } + /** + * Sets the frame position for the video observer. + * @since v3.0.1 + * + * After you successfully register the video observer, the SDK triggers this callback each time it receives a video frame. You can determine which position to observe by setting the return value. + * The SDK provides 3 positions for observer. Each position corresponds to a callback function: + * - `POSITION_POST_CAPTURER(1 << 0)`: The position after capturing the video data, which corresponds to the \ref onCaptureVideoFrame "onCaptureVideoFrame" callback. + * - `POSITION_PRE_RENDERER(1 << 1)`: The position before receiving the remote video data, which corresponds to the \ref onRenderVideoFrame "onRenderVideoFrame" callback. + * - `POSITION_PRE_ENCODER(1 << 2)`: The position before encoding the video data, which corresponds to the \ref onPreEncodeVideoFrame "onPreEncodeVideoFrame" callback. + * + * @note + * - Use '|' (the OR operator) to observe multiple frame positions. + * - This callback observes `POSITION_POST_CAPTURER(1 << 0)` and `POSITION_PRE_RENDERER(1 << 1)` by default. + * - To conserve the system consumption, you can reduce the number of frame positions that you want to observe. + * + * @return A bit mask that controls the frame position of the video observer: #VIDEO_OBSERVER_POSITION. + * + */ + virtual uint32_t getObservedFramePosition() { return static_cast(POSITION_POST_CAPTURER | POSITION_PRE_RENDERER); } + + /** Determines whether to receive video data from multiple channels. + + After you register the video frame observer, the SDK triggers this callback + every time it captures a video frame. + + In the multi-channel scenario, if you want to get video data from multiple channels, + set the return value of this callback as true. After that, the SDK triggers the + \ref IVideoFrameObserver::onRenderVideoFrameEx "onRenderVideoFrameEx" callback to send you + the video data from various channels. You can also get the channel ID of each video frame. + + @note + - Once you set the return value of this callback as true, the SDK triggers only the `onRenderVideoFrameEx` callback to + send the video frame. \ref IVideoFrameObserver::onRenderVideoFrame "onRenderVideoFrame" will not be triggered. In the multi-channel scenario, Agora recommends setting the return value as true. + - If you set the return value of this callback as false, the SDK triggers only the `onRenderVideoFrame` callback to send the video data. + @return + - `true`: Receive video data from multiple channels. + - `false`: Do not receive video data from multiple channels. + */ virtual bool isMultipleChannelFrameWanted() { return false; } + + /** Gets the video frame from multiple channels. + + After you successfully register the video frame observer, if you set the return value of + \ref IVideoFrameObserver::isMultipleChannelFrameWanted "isMultipleChannelFrameWanted" as true, the SDK triggers this callback each time it receives a video frame + from any of the channel. + + You can process the video data retrieved from this callback according to your scenario, and send the + processed data back to the SDK using the `videoFrame` parameter in this callback. + + @note This callback does not support sending RGBA video data back to the SDK. + + @param channelId The channel ID of this video frame. + @param uid The ID of the user sending this video frame. + @param videoFrame The pointer to VideoFrame. + @return Whether to send this video frame to the SDK if post-processing fails: + - `true`: Send this video frame. + - `false`: Do not send this video frame. + */ virtual bool onRenderVideoFrameEx(const char *channelId, unsigned int uid, VideoFrame& videoFrame) { return true; } - virtual VIDEO_FRAME_TYPE getVideoFormatPreference() { return FRAME_TYPE_YUV420; } }; -class IVideoFrame -{ -public: +class IVideoFrame { + public: enum PLANE_TYPE { Y_PLANE = 0, U_PLANE = 1, @@ -109,190 +413,342 @@ class IVideoFrame VIDEO_TYPE_NV12 = 14, VIDEO_TYPE_BGRA = 15, VIDEO_TYPE_RGBA = 16, + VIDEO_TYPE_I422 = 17, }; virtual void release() = 0; virtual const unsigned char* buffer(PLANE_TYPE type) const = 0; - // Copy frame: If required size is bigger than allocated one, new buffers of - // adequate size will be allocated. - // Return value: 0 on success ,-1 on error. + /** Copies the frame. + + If the required size is larger than the allocated size, new buffers of the adequate size will be allocated. + + @param dest_frame Address of the returned destination frame. See IVideoFrame. + @return + - 0: Success. + - -1: Failure. + */ virtual int copyFrame(IVideoFrame** dest_frame) const = 0; + /** Converts the frame. + + @note The source and destination frames have equal heights. + + @param dst_video_type Type of the output video. + @param dst_sample_size Required only for the parsing of M-JPEG. + @param dst_frame Pointer to a destination frame. See IVideoFrame. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, + unsigned char* dst_frame) const = 0; + /** Retrieves the specified component in the YUV space. - // Convert frame - // Input: - // - src_frame : Reference to a source frame. - // - dst_video_type : Type of output video. - // - dst_sample_size : Required only for the parsing of MJPG. - // - dst_frame : Pointer to a destination frame. - // Return value: 0 if OK, < 0 otherwise. - // It is assumed that source and destination have equal height. - virtual int convertFrame(VIDEO_TYPE dst_video_type, int dst_sample_size, unsigned char* dst_frame) const = 0; - - // Get allocated size per plane. + @param type Component type: #PLANE_TYPE + */ virtual int allocated_size(PLANE_TYPE type) const = 0; + /** Retrieves the stride of the specified component in the YUV space. - // Get allocated stride per plane. + @param type Component type: #PLANE_TYPE + */ virtual int stride(PLANE_TYPE type) const = 0; - - // Get frame width. + /** Retrieves the width of the frame. + */ virtual int width() const = 0; - - // Get frame height. + /** Retrieves the height of the frame. + */ virtual int height() const = 0; - - // Get frame timestamp (90kHz). + /** Retrieves the timestamp (ms) of the frame. + */ virtual unsigned int timestamp() const = 0; - - // Get render time in milliseconds. + /** Retrieves the render time (ms). + */ virtual int64_t render_time_ms() const = 0; + /** Checks if a plane is of zero size. - // Return true if underlying plane buffers are of zero size, false if not. + @return + - true: The plane is of zero size. + - false: The plane is not of zero size. + */ virtual bool IsZeroSize() const = 0; -}; -class IExternalVideoRenderCallback -{ -public: + virtual VIDEO_TYPE GetVideoType() const = 0; +}; +/** **DEPRECATED** */ +class IExternalVideoRenderCallback { + public: + /** Occurs when the video view size has changed. + */ virtual void onViewSizeChanged(int width, int height) = 0; + /** Occurs when the video view is destroyed. + */ virtual void onViewDestroyed() = 0; }; - -struct ExternalVideoRenerContext -{ +/** **DEPRECATED** */ +struct ExternalVideoRenerContext { IExternalVideoRenderCallback* renderCallback; + /** Video display window. + */ void* view; + /** Video display mode: \ref agora::rtc::RENDER_MODE_TYPE "RENDER_MODE_TYPE" */ int renderMode; + /** The image layer location. + + - 0: (Default) The image is at the bottom of the stack + - 100: The image is at the top of the stack. + + @note If the value is set to below 0 or above 100, the #ERR_INVALID_ARGUMENT error occurs. + */ int zOrder; + /** Video layout distance from the left. + */ float left; + /** Video layout distance from the top. + */ float top; + /** Video layout distance from the right. + */ float right; + /** Video layout distance from the bottom. + */ float bottom; }; -class IExternalVideoRender -{ -public: +class IExternalVideoRender { + public: virtual void release() = 0; virtual int initialize() = 0; - virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, bool mirrored) = 0; + virtual int deliverFrame(const IVideoFrame& videoFrame, int rotation, + bool mirrored) = 0; }; -class IExternalVideoRenderFactory -{ -public: - virtual IExternalVideoRender* createRenderInstance(const ExternalVideoRenerContext& context) = 0; +class IExternalVideoRenderFactory { + public: + virtual IExternalVideoRender* createRenderInstance( + const ExternalVideoRenerContext& context) = 0; }; +/** The external video frame. + */ struct ExternalVideoFrame { - enum VIDEO_BUFFER_TYPE - { - VIDEO_BUFFER_RAW_DATA = 1, - }; + /** The video buffer type. + */ + enum VIDEO_BUFFER_TYPE + { + /** 1: The video buffer in the format of raw data. + */ + VIDEO_BUFFER_RAW_DATA = 1, + }; - enum VIDEO_PIXEL_FORMAT - { - VIDEO_PIXEL_UNKNOWN = 0, - VIDEO_PIXEL_I420 = 1, - VIDEO_PIXEL_BGRA = 2, - VIDEO_PIXEL_NV12 = 8, - }; + /** The video pixel format. + * + * @note The SDK does not support the alpha channel, and discards any alpha value passed to the SDK. + */ + enum VIDEO_PIXEL_FORMAT + { + /** 0: The video pixel format is unknown. + */ + VIDEO_PIXEL_UNKNOWN = 0, + /** 1: The video pixel format is I420. + */ + VIDEO_PIXEL_I420 = 1, + /** 2: The video pixel format is BGRA. + */ + VIDEO_PIXEL_BGRA = 2, + /** 3: The video pixel format is NV21. + */ + VIDEO_PIXEL_NV21 = 3, + /** 4: The video pixel format is RGBA. + */ + VIDEO_PIXEL_RGBA = 4, + /** 5: The video pixel format is IMC2. + */ + VIDEO_PIXEL_IMC2 = 5, + /** 7: The video pixel format is ARGB. + */ + VIDEO_PIXEL_ARGB = 7, + /** 8: The video pixel format is NV12. + */ + VIDEO_PIXEL_NV12 = 8, + /** 16: The video pixel format is I422. + */ + VIDEO_PIXEL_I422 = 16, + }; - VIDEO_BUFFER_TYPE type; - VIDEO_PIXEL_FORMAT format; - void* buffer; - int stride; - int height; - int cropLeft; - int cropTop; - int cropRight; - int cropBottom; - int rotation; - long long timestamp; -}; + /** The buffer type. See #VIDEO_BUFFER_TYPE + */ + VIDEO_BUFFER_TYPE type; + /** The pixel format. See #VIDEO_PIXEL_FORMAT + */ + VIDEO_PIXEL_FORMAT format; + /** The video buffer. + */ + void* buffer; + /** Line spacing of the incoming video frame, which must be in pixels instead of bytes. For textures, it is the width of the texture. + */ + int stride; + /** Height of the incoming video frame. + */ + int height; + /** [Raw data related parameter] The number of pixels trimmed from the left. The default value is 0. + */ + int cropLeft; + /** [Raw data related parameter] The number of pixels trimmed from the top. The default value is 0. + */ + int cropTop; + /** [Raw data related parameter] The number of pixels trimmed from the right. The default value is 0. + */ + int cropRight; + /** [Raw data related parameter] The number of pixels trimmed from the bottom. The default value is 0. + */ + int cropBottom; + /** [Raw data related parameter] The clockwise rotation of the video frame. You can set the rotation angle as 0, 90, 180, or 270. The default value is 0. + */ + int rotation; + /** Timestamp (ms) of the incoming video frame. An incorrect timestamp results in frame loss or unsynchronized audio and video. + */ + long long timestamp; -enum CODEC_VIDEO_FRAME_TYPE { - CODEC_VIDEO_FRAME_TYPE_BLANK_FRAME = 0, - CODEC_VIDEO_FRAME_TYPE_KEY_FRAME = 3, - CODEC_VIDEO_FRAME_TYPE_DELTA_FRAME = 4, - CODEC_VIDEO_FRAME_TYPE_B_FRAME = 5, - CODEC_VIDEO_FRAME_TYPE_UNKNOW + ExternalVideoFrame() + :cropLeft(0) + ,cropTop(0) + ,cropRight(0) + ,cropBottom(0) + ,rotation(0) + {} }; -enum VIDEO_ORIENTATION { - VIDEO_ORIENTATION_0 = 0, - VIDEO_ORIENTATION_90 = 90, - VIDEO_ORIENTATION_180 = 180, - VIDEO_ORIENTATION_270 = 270 -}; +class IMediaEngine { + public: + virtual ~IMediaEngine () {}; + virtual void release() = 0; + /** Registers an audio frame observer object. -/** Video codec types */ -enum VIDEO_CODEC_TYPE { - /** Standard VP8 */ - VIDEO_CODEC_VP8 = 1, - /** Standard H264 */ - VIDEO_CODEC_H264 = 2, - /** Enhanced VP8 */ - VIDEO_CODEC_EVP = 3, - /** Enhanced H264 */ - VIDEO_CODEC_E264 = 4, -}; + This method is used to register an audio frame observer object (register a callback). This method is required to register callbacks when the engine is required to provide an \ref IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" or \ref IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. -/** * The struct of EncodedVideoFrameInfo. */ -struct EncodedVideoFrameInfo { - EncodedVideoFrameInfo() : codecType(VIDEO_CODEC_H264), - width(0), - height(0), - frameType(CODEC_VIDEO_FRAME_TYPE_BLANK_FRAME), - rotation(VIDEO_ORIENTATION_0), - renderTimeMs(0) {} - /** - * The video codec: #VIDEO_CODEC_TYPE. - */ - VIDEO_CODEC_TYPE codecType; - /** * The width (px) of the video. */ - int width; - /** * The height (px) of the video. */ - int height; - /** * The frame type of the encoded video frame: #VIDEO_FRAME_TYPE. */ - CODEC_VIDEO_FRAME_TYPE frameType; - /** * The rotation information of the encoded video frame: #VIDEO_ORIENTATION. */ - VIDEO_ORIENTATION rotation; - /** * The timestamp for rendering the video. */ - int64_t renderTimeMs; -}; - -class IVideoEncodedImageReceiver { -public: - /** - * Occurs each time the SDK receives an encoded video image. - * @param imageBuffer The pointer to the video image buffer. - * @param length The data length of the video image. - * @param videoEncodedFrameInfo The information of the encoded video frame: EncodedVideoFrameInfo. - * - */ - virtual bool OnEncodedVideoImageReceived(const uint8_t* imageBuffer, unsigned int length, const EncodedVideoFrameInfo& videoEncodedFrameInfo) = 0; - - virtual ~IVideoEncodedImageReceiver() {} -}; + @note Ensure that you call this method before joining a channel. -class IMediaEngine { -public: - virtual void release() = 0; + @param observer Audio frame observer object instance. See IAudioFrameObserver. Set the value as NULL to release the + audio observer object. Agora recommends calling `registerAudioFrameObserver(NULL)` after receiving the \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int registerAudioFrameObserver(IAudioFrameObserver* observer) = 0; + /** Registers a video frame observer object. + * + * You need to implement the IVideoFrameObserver class in this method, and register callbacks according to your scenarios. + * + * After you successfully register the video frame observer, the SDK triggers the registered callbacks each time a video frame is received. + * + * @note + * - When handling the video data returned in the callbacks, pay attention to the changes in the `width` and `height` parameters, + * which may be adapted under the following circumstances: + * - When the network condition deteriorates, the video resolution decreases incrementally. + * - If the user adjusts the video profile, the resolution of the video returned in the callbacks also changes. + * - Ensure that you call this method before joining a channel. + * @param observer Video frame observer object instance. If NULL is passed in, the registration is canceled. + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int registerVideoFrameObserver(IVideoFrameObserver* observer) = 0; + /** **DEPRECATED** */ virtual int registerVideoRenderFactory(IExternalVideoRenderFactory* factory) = 0; - virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, IAudioFrameObserver::AudioFrame *frame, bool wrap) = 0; - virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; - virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame *frame) = 0; + /** **DEPRECATED** Use \ref agora::media::IMediaEngine::pushAudioFrame(IAudioFrameObserver::AudioFrame* frame) "pushAudioFrame(IAudioFrameObserver::AudioFrame* frame)" instead. + + Pushes the external audio frame. + + @param type Type of audio capture device: #MEDIA_SOURCE_TYPE. + @param frame Audio frame pointer: \ref IAudioFrameObserver::AudioFrame "AudioFrame". + @param wrap Whether to use the placeholder. We recommend setting the default value. + - true: Use. + - false: (Default) Not use. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pushAudioFrame(MEDIA_SOURCE_TYPE type, + IAudioFrameObserver::AudioFrame* frame, + bool wrap) = 0; + /** Pushes the external audio frame. + + @param frame Pointer to the audio frame: \ref IAudioFrameObserver::AudioFrame "AudioFrame". + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pushAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0; + /** Pulls the remote audio data. + * + * Before calling this method, call the + * \ref agora::rtc::IRtcEngine::setExternalAudioSink + * "setExternalAudioSink(enabled: true)" method to enable and set the + * external audio sink. + * + * After a successful method call, the app pulls the decoded and mixed + * audio data for playback. + * + * @note + * - Once you call the \ref agora::media::IMediaEngine::pullAudioFrame + * "pullAudioFrame" method successfully, the app will not retrieve any audio + * data from the + * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame + * "onPlaybackAudioFrame" callback. + * - The difference between the + * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame + * "onPlaybackAudioFrame" callback and the + * \ref agora::media::IMediaEngine::pullAudioFrame "pullAudioFrame" method is as + * follows: + * - `onPlaybackAudioFrame`: The SDK sends the audio data to the app through this callback. + * Any delay in processing the audio frames may result in audio jitter. + * - `pullAudioFrame`: The app pulls the remote audio data. After setting the + * audio data parameters, the SDK adjusts the frame buffer and avoids + * problems caused by jitter in the external audio playback. + * + * @param frame Pointers to the audio frame. + * See: \ref IAudioFrameObserver::AudioFrame "AudioFrame". + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int pullAudioFrame(IAudioFrameObserver::AudioFrame* frame) = 0; + /** Configures the external video source. + + @note Ensure that you call this method before joining a channel. + + @param enable Sets whether to use the external video source: + - true: Use the external video source. + - false: (Default) Do not use the external video source. + + @param useTexture Sets whether to use texture as an input: + - true: Use texture as an input. + - false: (Default) Do not use texture as an input. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; + /** Pushes the video frame using the \ref ExternalVideoFrame "ExternalVideoFrame" and passes the video frame to the Agora SDK. + + @param frame Video frame to be pushed. See \ref ExternalVideoFrame "ExternalVideoFrame". + + @note In the `COMMUNICATION` profile, this method does not support video frames in the Texture format. - virtual int setExternalVideoSource(bool enable, bool useTexture) = 0; - virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; - virtual int registerVideoEncodedImageReceiver(IVideoEncodedImageReceiver*receiver) = 0; + @return + - 0: Success. + - < 0: Failure. + */ + virtual int pushVideoFrame(ExternalVideoFrame *frame) = 0; }; -} //media +} // namespace media -} //agora +} // namespace agora -#endif //AGORA_MEDIA_ENGINE_H +#endif // AGORA_MEDIA_ENGINE_H diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h index e7c7f4c..8527078 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcChannel.h @@ -10,104 +10,237 @@ namespace agora { namespace rtc { - -struct ChannelMediaOptions { - bool autoSubscribeAudio; - bool autoSubscribeVideo; - ChannelMediaOptions() - : autoSubscribeAudio(true) - , autoSubscribeVideo(true) - {} -}; - +/** The IChannel class. */ class IChannel; +/** The IChannelEventHandler class. */ class IChannelEventHandler { public: virtual ~IChannelEventHandler() {} - + /** Reports the warning code of `IChannel`. + + @param rtcChannel IChannel + @param warn The warning code: #WARN_CODE_TYPE + @param msg The warning message. + + */ virtual void onChannelWarning(IChannel *rtcChannel, int warn, const char* msg) { (void)rtcChannel; (void)warn; (void)msg; } - + /** Reports the error code of `IChannel`. + + @param rtcChannel IChannel + @param err The error code: #ERROR_CODE_TYPE + @param msg The error message. + */ virtual void onChannelError(IChannel *rtcChannel, int err, const char* msg) { (void)rtcChannel; (void)err; (void)msg; } - + /** Occurs when a user joins a channel. + + This callback notifies the application that a user joins a specified channel. + + @param rtcChannel IChannel + @param uid The user ID. If the `uid` is not specified in the \ref IChannel::joinChannel "joinChannel" method, the server automatically assigns a `uid`. + + @param elapsed Time elapsed (ms) from the local user calling \ref IChannel::joinChannel "joinChannel" until this callback is triggered. + */ virtual void onJoinChannelSuccess(IChannel *rtcChannel, uid_t uid, int elapsed) { (void)rtcChannel; (void)uid; (void)elapsed; } - + /** Occurs when a user rejoins the channel after being disconnected due to network problems. + + @param rtcChannel IChannel + @param uid The user ID. + @param elapsed Time elapsed (ms) from the local user starting to reconnect until this callback is triggered. + + */ virtual void onRejoinChannelSuccess(IChannel *rtcChannel, uid_t uid, int elapsed) { (void)rtcChannel; (void)uid; (void)elapsed; } - + /** Occurs when a user leaves the channel. + + This callback notifies the application that a user leaves the channel when the application calls the \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method. + + The application retrieves information, such as the call duration and statistics. + + @param rtcChannel IChannel + @param stats The call statistics: RtcStats. + */ virtual void onLeaveChannel(IChannel *rtcChannel, const RtcStats& stats) { (void)rtcChannel; (void)stats; } - + /** Occurs when the user role switches in the interactive live streaming. For example, from a host to an audience or vice versa. + + This callback notifies the application of a user role switch when the application calls the \ref IChannel::setClientRole "setClientRole" method. + + The SDK triggers this callback when the local user switches the user role by calling the \ref IChannel::setClientRole "setClientRole" method after joining the channel. + + @param rtcChannel IChannel + @param oldRole Role that the user switches from: #CLIENT_ROLE_TYPE. + @param newRole Role that the user switches to: #CLIENT_ROLE_TYPE. + */ virtual void onClientRoleChanged(IChannel *rtcChannel, CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { (void)rtcChannel; (void)oldRole; (void)newRole; } - + /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) joins the channel. + + - `COMMUNICATION` profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - `LIVE_BROADCASTING` profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + + The SDK triggers this callback under one of the following circumstances: + - A remote user/host joins the channel by calling the \ref agora::rtc::IChannel::joinChannel "joinChannel" method. + - A remote user switches the user role to the host by calling the \ref agora::rtc::IChannel::setClientRole "setClientRole" method after joining the channel. + - A remote user/host rejoins the channel after a network interruption. + - The host injects an online media stream into the channel by calling the \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method. + + @note In the `LIVE_BROADCASTING` profile: + - The host receives this callback when another host joins the channel. + - The audience in the channel receives this callback when a new host joins the channel. + - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. + + @param rtcChannel IChannel + @param uid User ID of the user or host joining the channel. + @param elapsed Time delay (ms) from the local user calling the \ref IChannel::joinChannel "joinChannel" method until the SDK triggers this callback. + */ virtual void onUserJoined(IChannel *rtcChannel, uid_t uid, int elapsed) { (void)rtcChannel; (void)uid; (void)elapsed; } - + /** Occurs when a remote user ( `COMMUNICATION`)/host (`LIVE_BROADCASTING`) leaves the channel. + + Reasons why the user is offline: + + - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. + - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using the Agora RTM SDK for more reliable offline detection. + + @param rtcChannel IChannel + @param uid User ID of the user leaving the channel or going offline. + @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. + */ virtual void onUserOffline(IChannel *rtcChannel, uid_t uid, USER_OFFLINE_REASON_TYPE reason) { (void)rtcChannel; (void)uid; (void)reason; } - + /** Occurs when the SDK cannot reconnect to Agora's edge server 10 seconds after its connection to the server is interrupted. + + The SDK triggers this callback when it cannot connect to the server 10 seconds after calling the \ref IChannel::joinChannel "joinChannel" method, whether or not it is in the channel. + + This callback is different from \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted": + + - The SDK triggers the `onConnectionInterrupted` callback when it loses connection with the server for more than four seconds after it successfully joins the channel. + - The SDK triggers the `onConnectionLost` callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. + + If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. + + @param rtcChannel IChannel + */ virtual void onConnectionLost(IChannel *rtcChannel) { (void)rtcChannel; } - + /** Occurs when the token expires. + + After a token is specified by calling the \ref IChannel::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. + + Once you receive this callback, generate a new token on your app server, and call + \ref agora::rtc::IChannel::renewToken "renewToken" to pass the new token to the SDK. + + @param rtcChannel IChannel + */ virtual void onRequestToken(IChannel *rtcChannel) { (void)rtcChannel; } - + /** Occurs when the token expires in 30 seconds. + + The user becomes offline if the token used in the \ref IChannel::joinChannel "joinChannel" method expires. The SDK triggers this callback 30 seconds before the token expires to remind the application to get a new token. Upon receiving this callback, generate a new token on the server and call the \ref IChannel::renewToken "renewToken" method to pass the new token to the SDK. + + @param rtcChannel IChannel + @param token Token that expires in 30 seconds. + */ virtual void onTokenPrivilegeWillExpire(IChannel *rtcChannel, const char* token) { (void)rtcChannel; (void)token; } - + /** Reports the statistics of the current call. + + The SDK triggers this callback once every two seconds after the user joins the channel. + + @param rtcChannel IChannel + @param stats Statistics of the RtcEngine: RtcStats. + */ virtual void onRtcStats(IChannel *rtcChannel, const RtcStats& stats) { (void)rtcChannel; (void)stats; } - + /** Reports the last mile network quality of each user in the channel once every two seconds. + + Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. + + @param rtcChannel IChannel + @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 * 480 and a frame rate of 15 fps in the `LIVE_BROADCASTING` profile, but may be inadequate for resolutions higher than 1280 * 720. See #QUALITY_TYPE. + @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. + */ virtual void onNetworkQuality(IChannel *rtcChannel, uid_t uid, int txQuality, int rxQuality) { (void)rtcChannel; (void)uid; (void)txQuality; (void)rxQuality; } - + /** Reports the statistics of the video stream from each remote user/host. + * + * The SDK triggers this callback once every two seconds for each remote + * user/host. If a channel includes multiple remote users, the SDK + * triggers this callback as many times. + * + * @param rtcChannel IChannel + * @param stats Statistics of the remote video stream. See + * RemoteVideoStats. + */ virtual void onRemoteVideoStats(IChannel *rtcChannel, const RemoteVideoStats& stats) { (void)rtcChannel; (void)stats; } - + /** Reports the statistics of the audio stream from each remote user/host. + + This callback replaces the \ref agora::rtc::IRtcEngineEventHandler::onAudioQuality "onAudioQuality" callback. + + The SDK triggers this callback once every two seconds for each remote user/host. If a channel includes multiple remote users, the SDK triggers this callback as many times. + + @param rtcChannel IChannel + @param stats The statistics of the received remote audio streams. See RemoteAudioStats. + */ virtual void onRemoteAudioStats(IChannel *rtcChannel, const RemoteAudioStats& stats) { (void)rtcChannel; (void)stats; } - + /** Occurs when the remote audio state changes. + + This callback indicates the state change of the remote audio stream. + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param rtcChannel IChannel + @param uid ID of the remote user whose audio state changes. + @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + @param reason The reason of the remote audio state change. + See #REMOTE_AUDIO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref IChannel::joinChannel "joinChannel" method until the SDK + triggers this callback. + */ virtual void onRemoteAudioStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { (void)rtcChannel; (void)uid; @@ -116,21 +249,55 @@ class IChannelEventHandler (void)elapsed; } - virtual void onAudioPublishStateChange(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + /** Occurs when the audio publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local audio stream. + * + * @param rtcChannel IChannel + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioPublishStateChanged(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - virtual void onVideoPublishStateChange(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + /** Occurs when the video publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local video stream. + * + * @param rtcChannel IChannel + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoPublishStateChanged(IChannel *rtcChannel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - virtual void onAudioSubscribeStateChange(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote audio stream. + * + * @param rtcChannel IChannel + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioSubscribeStateChanged(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)uid; (void)oldState; @@ -138,39 +305,74 @@ class IChannelEventHandler (void)elapseSinceLastState; } - virtual void onVideoSubscribeStateChange(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote video stream. + * + * @param rtcChannel IChannel + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoSubscribeStateChanged(IChannel *rtcChannel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)rtcChannel; (void)uid; (void)oldState; (void)newState; (void)elapseSinceLastState; } - - virtual void onActiveSpeaker(IChannel *rtcChannel, uid_t uid) { - (void)rtcChannel; - (void)uid; - } - - virtual void onFirstRemoteVideoFrame(IChannel *rtcChannel, uid_t uid, int width, int height, int elapsed) { - (void)rtcChannel; - (void)uid; - (void)width; - (void)height; - (void)elapsed; - } - - virtual void onUserMuteAudio(IChannel *rtcChannel, uid_t uid, bool muted) { + /// @cond + /** Reports whether the super-resolution algorithm is enabled. + * + * @since v3.2.0 + * + * After calling \ref IRtcChannel::enableRemoteSuperResolution "enableRemoteSuperResolution", the SDK triggers this + * callback to report whether the super-resolution algorithm is successfully enabled. If not successfully enabled, + * you can use reason for troubleshooting. + * + * @param rtcChannel IChannel + * @param uid The ID of the remote user. + * @param enabled Whether the super-resolution algorithm is successfully enabled: + * - true: The super-resolution algorithm is successfully enabled. + * - false: The super-resolution algorithm is not successfully enabled. + * @param reason The reason why the super-resolution algorithm is not successfully enabled. See #SUPER_RESOLUTION_STATE_REASON. + */ + virtual void onUserSuperResolutionEnabled(IChannel *rtcChannel, uid_t uid, bool enabled, SUPER_RESOLUTION_STATE_REASON reason) { (void)rtcChannel; (void)uid; - (void)muted; + (void)enabled; + (void)reason; } - - virtual void onFirstRemoteAudioDecoded(IChannel *rtcChannel, uid_t uid, int elapsed) { + /// @endcond + + /** Occurs when the most active speaker is detected. + + After a successful call of \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication", + the SDK continuously detects which remote user has the loudest volume. During the current period, the remote user, + who is detected as the loudest for the most times, is the most active user. + + When the number of user is no less than two and an active speaker exists, the SDK triggers this callback and reports the `uid` of the most active speaker. + - If the most active speaker is always the same user, the SDK triggers this callback only once. + - If the most active speaker changes to another user, the SDK triggers this callback again and reports the `uid` of the new active speaker. + + @param rtcChannel IChannel + @param uid The user ID of the most active speaker. + */ + virtual void onActiveSpeaker(IChannel *rtcChannel, uid_t uid) { (void)rtcChannel; (void)uid; - (void)elapsed; } - + /** Occurs when the video size or rotation of a specified user changes. + + @param rtcChannel IChannel + @param uid User ID of the remote user or local user (0) whose video size or rotation changes. + @param width New width (pixels) of the video. + @param height New height (pixels) of the video. + @param rotation New rotation of the video [0 to 360). + */ virtual void onVideoSizeChanged(IChannel *rtcChannel, uid_t uid, int width, int height, int rotation) { (void)rtcChannel; (void)uid; @@ -178,7 +380,19 @@ class IChannelEventHandler (void)height; (void)rotation; } - + /** Occurs when the remote video state changes. + + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param rtcChannel IChannel + @param uid ID of the remote user whose video state changes. + @param state State of the remote video. See #REMOTE_VIDEO_STATE. + @param reason The reason of the remote video state change. See + #REMOTE_VIDEO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref agora::rtc::IChannel::joinChannel "joinChannel" method until the + SDK triggers this callback. + */ virtual void onRemoteVideoStateChanged(IChannel *rtcChannel, uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { (void)rtcChannel; (void)uid; @@ -186,7 +400,16 @@ class IChannelEventHandler (void)reason; (void)elapsed; } - + /** Occurs when the local user receives the data stream from the remote user within five seconds. + + The SDK triggers this callback when the local user receives the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. + + @param rtcChannel IChannel + @param uid User ID of the remote user sending the message. + @param streamId Stream ID. + @param data The data received by the local user. + @param length Length of the data in bytes. + */ virtual void onStreamMessage(IChannel *rtcChannel, uid_t uid, int streamId, const char* data, size_t length) { (void)rtcChannel; (void)uid; @@ -194,7 +417,17 @@ class IChannelEventHandler (void)data; (void)length; } - + /** Occurs when the local user does not receive the data stream from the remote user within five seconds. + + The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method. + + @param rtcChannel IChannel + @param uid User ID of the remote user sending the message. + @param streamId Stream ID. + @param code Error code: #ERROR_CODE_TYPE. + @param missed Number of lost messages. + @param cached Number of incoming cached messages when the data stream is interrupted. + */ virtual void onStreamMessageError(IChannel *rtcChannel, uid_t uid, int streamId, int code, int missed, int cached) { (void)rtcChannel; (void)uid; @@ -203,59 +436,132 @@ class IChannelEventHandler (void)missed; (void)cached; } - + /** Occurs when the state of the media stream relay changes. + * + * The SDK returns the state of the current media relay with any error + * message. + * @param rtcChannel IChannel + * @param state The state code in #CHANNEL_MEDIA_RELAY_STATE. + * @param code The error code in #CHANNEL_MEDIA_RELAY_ERROR. + */ virtual void onChannelMediaRelayStateChanged(IChannel *rtcChannel, CHANNEL_MEDIA_RELAY_STATE state,CHANNEL_MEDIA_RELAY_ERROR code) { (void)rtcChannel; (void)state; (void)code; } - + /** Reports events during the media stream relay. + * @param rtcChannel IChannel + * @param code The event code in #CHANNEL_MEDIA_RELAY_EVENT. + */ virtual void onChannelMediaRelayEvent(IChannel *rtcChannel, CHANNEL_MEDIA_RELAY_EVENT code) { (void)rtcChannel; (void)code; } - - virtual void onFirstRemoteAudioFrame(IChannel *rtcChannel, uid_t uid, int elapsed) { - (void)rtcChannel; - (void)uid; - (void)elapsed; - } - + /** + Occurs when the state of the RTMP or RTMPS streaming changes. + + The SDK triggers this callback to report the result of the local user calling the \ref agora::rtc::IChannel::addPublishStreamUrl "addPublishStreamUrl" or \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method. + + This callback indicates the state of the RTMP or RTMPS streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. + + @param rtcChannel IChannel + @param url The CDN streaming URL. + @param state The RTMP or RTMPS streaming state. See: #RTMP_STREAM_PUBLISH_STATE. + @param errCode The detailed error information for streaming. See: #RTMP_STREAM_PUBLISH_ERROR. + */ virtual void onRtmpStreamingStateChanged(IChannel *rtcChannel, const char *url, RTMP_STREAM_PUBLISH_STATE state, RTMP_STREAM_PUBLISH_ERROR errCode) { (void)rtcChannel; (void) url; (RTMP_STREAM_PUBLISH_STATE) state; (RTMP_STREAM_PUBLISH_ERROR) errCode; } - - virtual void onStreamPublished(IChannel *rtcChannel, const char *url, int error) { - (void)rtcChannel; - (void)url; - (void)error; - } - - virtual void onStreamUnpublished(IChannel *rtcChannel, const char *url) { - (void)rtcChannel; - (void)url; + + /** Reports events during the RTMP or RTMPS streaming. + * + * @since v3.1.0 + * + * @param rtcChannel IChannel + * @param url The RTMP or RTMPS streaming URL. + * @param eventCode The event code. See #RTMP_STREAMING_EVENT + */ + virtual void onRtmpStreamingEvent(IChannel *rtcChannel, const char* url, RTMP_STREAMING_EVENT eventCode) { + (void) rtcChannel; + (void) url; + (RTMP_STREAMING_EVENT) eventCode; } - + + /** Occurs when the publisher's transcoding is updated. + + When the `LiveTranscoding` class in the \ref agora::rtc::IChannel::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. + + @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + + @param rtcChannel IChannel + */ virtual void onTranscodingUpdated(IChannel *rtcChannel) { (void)rtcChannel; } - + /** Occurs when a voice or video stream URL address is added to the interactive live streaming. + + @param rtcChannel IChannel + @param url The URL address of the externally injected stream. + @param uid User ID. + @param status State of the externally injected stream: #INJECT_STREAM_STATUS. + */ virtual void onStreamInjectedStatus(IChannel *rtcChannel, const char* url, uid_t uid, int status) { (void)rtcChannel; (void)url; (void)uid; (void)status; } - + /** Occurs when the published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. + + If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + + @param rtcChannel IChannel + @param isFallbackOrRecover Whether the published stream falls back to audio-only or switches back to the video: + - true: The published stream falls back to audio-only due to poor network conditions. + - false: The published stream switches back to the video after the network conditions improve. + */ + virtual void onLocalPublishFallbackToAudioOnly(IChannel *rtcChannel, bool isFallbackOrRecover) { + (void)rtcChannel; + (void)isFallbackOrRecover; + } + /** Occurs when the remote media stream falls back to audio-only stream + * due to poor network conditions or switches back to the video stream + * after the network conditions improve. + * + * If you call + * \ref IRtcEngine::setRemoteSubscribeFallbackOption + * "setRemoteSubscribeFallbackOption" and set + * @p option as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this + * callback when the remote media stream falls back to audio-only mode due + * to poor uplink conditions, or when the remote media stream switches + * back to the video after the uplink network condition improves. + * + * @note Once the remote media stream switches to the low stream due to + * poor network conditions, you can monitor the stream switch between a + * high and low stream in the RemoteVideoStats callback. + * @param rtcChannel IChannel + * @param uid ID of the remote user sending the stream. + * @param isFallbackOrRecover Whether the remotely subscribed media stream + * falls back to audio-only or switches back to the video: + * - true: The remotely subscribed media stream falls back to audio-only + * due to poor network conditions. + * - false: The remotely subscribed media stream switches back to the + * video stream after the network conditions improved. + */ virtual void onRemoteSubscribeFallbackToAudioOnly(IChannel *rtcChannel, uid_t uid, bool isFallbackOrRecover) { (void)rtcChannel; (void)uid; (void)isFallbackOrRecover; } - + /** Occurs when the connection state between the SDK and the server changes. + + @param rtcChannel IChannel + @param state See #CONNECTION_STATE_TYPE. + @param reason See #CONNECTION_CHANGED_REASON_TYPE. + */ virtual void onConnectionStateChanged(IChannel *rtcChannel, CONNECTION_STATE_TYPE state, CONNECTION_CHANGED_REASON_TYPE reason) { @@ -265,110 +571,951 @@ class IChannelEventHandler } }; +/** The IChannel class. */ class IChannel { public: virtual ~IChannel() {} - + /** Releases all IChannel resources. + + @return + - 0: Success. + - < 0: Failure. + - `ERR_NOT_INITIALIZED (7)`: The SDK is not initialized before calling this method. + */ virtual int release() = 0; - + /** Sets the channel event handler. + + After setting the channel event handler, you can listen for channel events and receive the statistics of the corresponding `IChannel` object. + + @param channelEh The event handler of the `IChannel` object. For details, see IChannelEventHandler. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int setChannelEventHandler(IChannelEventHandler *channelEh) = 0; + /** Joins the channel with a user ID. + + This method differs from the `joinChannel` method in the `IRtcEngine` class in the following aspects: + + | IChannel::joinChannel | IRtcEngine::joinChannel | + |------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------| + | Does not contain the `channelId` parameter, because `channelId` is specified when creating the `IChannel` object. | Contains the `channelId` parameter, which specifies the channel to join. | + | Contains the `options` parameter, which decides whether to subscribe to all streams before joining the channel. | Does not contain the `options` parameter. By default, users subscribe to all streams when joining the channel. | + | Users can join multiple channels simultaneously by creating multiple `IChannel` objects and calling the `joinChannel` method of each object. | Users can join only one channel. | + | By default, the SDK does not publish any stream after the user joins the channel. You need to call the publish method to do that. | By default, the SDK publishes streams once the user joins the channel. | + + Once the user joins the channel, the user subscribes to the audio and video streams of all the other users in the channel by default, giving rise to usage and billing calculation. If you do not want to subscribe to a specified stream or all remote streams, call the `mute` methods accordingly. + + @note + - If you are already in a channel, you cannot rejoin it with the same `uid`. + - We recommend using different UIDs for different channels. + - If you want to join the same channel from different devices, ensure that the UIDs in all devices are different. + - Ensure that the app ID you use to generate the token is the same with the app ID used when creating the `IRtcEngine` object. + + @param token The token for authentication: + - In situations not requiring high security: You can use the temporary token generated at Console. For details, see [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platform=All%20Platforms#generate-a-token). + - In situations requiring high security: Set it as the token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=All%20Platforms). + @param info (Optional) Additional information about the channel. This parameter can be set as null. Other users in the channel do not receive this information. + @param uid The user ID. A 32-bit unsigned integer with a value ranging from 1 to (232-1). This parameter must be unique. If `uid` is not assigned (or set as `0`), the SDK assigns a `uid` and reports it in the \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. The app must maintain this user ID. + @param options The channel media options: \ref agora::rtc::ChannelMediaOptions::ChannelMediaOptions "ChannelMediaOptions" + @return + - 0(ERR_OK): Success. + - < 0: Failure. + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. + - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: + - You have created an IChannel object with the same channel name. + - You have joined and published a stream in a channel created by the IChannel object. + */ virtual int joinChannel(const char* token, const char* info, uid_t uid, const ChannelMediaOptions& options) = 0; + /** Joins the channel with a user account. + + After the user successfully joins the channel, the SDK triggers the following callbacks: + + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IChannelEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. + + Once the user joins the channel, the user subscribes to the audio and video streams of all the other users in the channel by default, giving rise to usage and billing calculation. If you do not want to subscribe to a specified stream or all remote streams, call the `mute` methods accordingly. + @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. + If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. + + @param token The token generated at your server: + - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). + - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). + @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that the user account is unique and do not set it as null. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + @param options The channel media options: \ref agora::rtc::ChannelMediaOptions::ChannelMediaOptions “ChannelMediaOptions”. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) + */ virtual int joinChannelWithUserAccount(const char* token, const char* userAccount, const ChannelMediaOptions& options) = 0; - + /** Allows a user to leave a channel, such as hanging up or exiting a call. + + After joining a channel, the user must call the *leaveChannel* method to end the call before joining another channel. + + This method returns 0 if the user leaves the channel and releases all resources related to the call. + + This method call is asynchronous, and the user has not left the channel when the method call returns. Once the user leaves the channel, the SDK triggers the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback. + + A successful \ref agora::rtc::IChannel::leaveChannel "leaveChannel" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IChannelEventHandler::onLeaveChannel "onLeaveChannel" + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a host in the `LIVE_BROADCASTING` profile. + + @note + - If you call the \ref IChannel::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IChannelEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. + - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IChannel::removePublishStreamUrl "removePublishStreamUrl" method. + + @return + - 0(ERR_OK): Success. + - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + */ virtual int leaveChannel() = 0; - - /** Allows this connection to upload stream. This method will unpublish the current publishing connection if there exists. + + /** Publishes the local stream to the channel. + + You must keep the following restrictions in mind when calling this method. Otherwise, the SDK returns the #ERR_REFUSED (5): + - This method publishes one stream only to the channel corresponding to the current `IChannel` object. + - In the interactive live streaming channel, only a host can call this method. To switch the client role, call \ref agora::rtc::IChannel::setClientRole "setClientRole" of the current `IChannel` object. + - You can publish a stream to only one channel at a time. For details on joining multiple channels, see the advanced guide *Join Multiple Channels*. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_REFUSED (5): The method call is refused. */ virtual int publish() = 0; - - /** Stops publishing stream. + + /** Stops publishing a stream to the channel. + + If you call this method in a channel where you are not publishing streams, the SDK returns #ERR_REFUSED (5). + + @return + - 0: Success. + - < 0: Failure. + - #ERR_REFUSED (5): The method call is refused. */ virtual int unpublish() = 0; - - /** Gets the channel ID of IChannel. - - @return Channel ID of IChannel. + + /** Gets the channel ID of the current `IChannel` object. + + @return + - The channel ID of the current `IChannel` object, if the method call succeeds. + - The empty string "", if the method call fails. */ virtual const char *channelId() = 0; - + /** Retrieves the current call ID. + + When a user joins a channel on a client, a `callId` is generated to identify the call from the client. + Feedback methods, such as \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain", must be called after the call ends to submit feedback to the SDK. + + The `rate` and `complain` methods require the `callId` parameter retrieved from the `getCallId` method during a call. `callId` is passed as an argument into the `rate` and `complain` methods after the call ends. + + @note Ensure that you call this method after joining a channel. + + @param callId The current call ID. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int getCallId(agora::util::AString& callId) = 0; + /** Gets a new token when the current token expires after a period of time. + + The `token` expires after a period of time once the token schema is enabled when: + + - The SDK triggers the \ref IChannelEventHandler::onTokenPrivilegeWillExpire "onTokenPrivilegeWillExpire" callback, or + - The \ref IChannelEventHandler::onConnectionStateChanged "onConnectionStateChanged" reports CONNECTION_CHANGED_TOKEN_EXPIRED(9). + + The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. + @param token Pointer to the new token. + + @return + - 0(ERR_OK): Success. + - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + */ virtual int renewToken(const char* token) = 0; - + /** Enables built-in encryption with an encryption password before users join a channel. + + @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IChannel::enableEncryption "enableEncryption" instead. + + All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. + + If an encryption password is not specified, the encryption functionality will be disabled. + + @note + - Do not use this method for CDN live streaming. + - For optimal transmission, ensure that the encrypted data size does not exceed the original data size + 16 bytes. 16 bytes is the maximum padding size for AES encryption. + + @param secret Pointer to the encryption password. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int setEncryptionSecret(const char* secret) = 0; - + /** Sets the built-in encryption mode. + + @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IChannel::enableEncryption "enableEncryption" instead. + + The Agora SDK supports built-in encryption, which is set to the `aes-128-xts` mode by default. Call this method to use other encryption modes. + + All users in the same channel must use the same encryption mode and password. + + Refer to the information related to the AES encryption algorithm on the differences between the encryption modes. + + @note Call the \ref IChannel::setEncryptionSecret "setEncryptionSecret" method to enable the built-in encryption function before calling this method. + + @param encryptionMode The set encryption mode: + - "aes-128-xts": (Default) 128-bit AES encryption, XTS mode. + - "aes-128-ecb": 128-bit AES encryption, ECB mode. + - "aes-256-xts": 256-bit AES encryption, XTS mode. + - "": When encryptionMode is set as NULL, the encryption mode is set as "aes-128-xts" by default. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int setEncryptionMode(const char* encryptionMode) = 0; - + /** Enables/Disables the built-in encryption. + * + * @since v3.1.0 + * + * In scenarios requiring high security, Agora recommends calling this method to enable the built-in encryption before joining a channel. + * + * All users in the same channel must use the same encryption mode and encryption key. Once all users leave the channel, the encryption key of this channel is automatically cleared. + * + * @note + * - If you enable the built-in encryption, you cannot use the RTMP or RTMPS streaming function. + * - You need to add an external encryption library when integrating the Android and iOS SDK. See the advanced guide *Channel Encryption*. + * + * @param enabled Whether to enable the built-in encryption: + * - true: Enable the built-in encryption. + * - false: Disable the built-in encryption. + * @param config Configurations of built-in encryption schemas. See EncryptionConfig. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - -2(ERR_INVALID_ARGUMENT): An invalid parameter is used. Set the parameter with a valid value. + * - -4(ERR_NOT_SUPPORTED): The encryption mode is incorrect or the SDK fails to load the external encryption library. Check the enumeration or reload the external encryption library. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Initialize the `IChannel` instance before calling this method. + */ + virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; + /** Registers a packet observer. + + The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. + + @note + - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. + - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. + - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. + - Call this method before joining a channel. + @param observer The registered packet observer. See IPacketObserver. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int registerPacketObserver(IPacketObserver* observer) = 0; - + /** Registers the metadata observer. + + Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. + This method enables you to add synchronized metadata in the video stream for more diversified interactive live streaming, such as sending shopping links, digital coupons, and online quizzes. + + @note + - Call this method before the joinChannel method. + - This method applies to the `LIVE_BROADCASTING` channel profile. + + @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. + @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; - + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in the interactive live streaming. + + This method can be used to switch the user role in the interactive live streaming after the user joins a channel. + + In the `LIVE_BROADCASTING` profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IChannel::setClientRole "setClientRole" method call triggers the following callbacks: + - The local client: \ref agora::rtc::IChannelEventHandler::onClientRoleChanged "onClientRoleChanged" + - The remote client: \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IChannelEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) + + @note + This method applies only to the `LIVE_BROADCASTING` profile. + + @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; - + + /** Sets the role of a user in interactive live streaming. + * + * @since v3.2.0 + * + * You can call this method either before or after joining the channel to set the user role as audience or host. If + * you call this method to switch the user role after joining the channel, the SDK triggers the following callbacks: + * - The local client: \ref IChannelEventHandler::onClientRoleChanged "onClientRoleChanged". + * - The remote client: \ref IChannelEventHandler::onUserJoined "onUserJoined" + * or \ref IChannelEventHandler::onUserOffline "onUserOffline". + * + * @note + * - This method applies to the `LIVE_BROADCASTING` profile only. + * - The difference between this method and \ref IChannel::setClientRole(CLIENT_ROLE_TYPE) "setClientRole" [1/2] is that + * this method can set the user level in addition to the user role. + * - The user role determines the permissions that the SDK grants to a user, such as permission to send local + * streams, receive remote streams, and push streams to a CDN address. + * - The user level determines the level of services that a user can enjoy within the permissions of the user's + * role. For example, an audience can choose to receive remote streams with low latency or ultra low latency. Levels + * affect prices. + * + * @param role The role of a user in interactive live streaming. See #CLIENT_ROLE_TYPE. + * @param options The detailed options of a user, including user level. See ClientRoleOptions. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + */ + virtual int setClientRole(CLIENT_ROLE_TYPE role, const ClientRoleOptions& options) = 0; + + /** Prioritizes a remote user's stream. + * + * The SDK ensures the high-priority user gets the best possible stream quality. + * + * @note + * - The Agora SDK supports setting `serPriority` as high for one user only. + * - Ensure that you call this method before joining a channel. + * + * @param uid The ID of the remote user. + * @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; + /** Sets the sound position and gain of a remote user. + When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the + local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, + such as Battle Royale games. + + @note + - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. + - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + - Ensure that you call this method after joining a channel. + + @param uid The ID of the remote user. + @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: + - 0.0: the remote sound comes from the front. + - -1.0: the remote sound comes from the left. + - 1.0: the remote sound comes from the right. + @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). + The smaller the value, the less the gain. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int setRemoteVoicePosition(uid_t uid, double pan, double gain) = 0; + /** Updates the display mode of the video view of a remote user. - virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; + After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. + This method affects only the video view that the local user sees. + @note + - Call this method after calling the \ref agora::rtc::IRtcEngine::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view. + - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. + + @param userId The ID of the remote user. + @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. + @param mirrorMode + - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. + - **Note**: The SDK disables the mirror mode by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** Stops or resumes subscribing to the audio streams of all remote users by default. + * + * @deprecated This method is deprecated from v3.3.0. + * + * + * Call this method after joining a channel. After successfully calling this method, the + * local user stops or resumes subscribing to the audio streams of all subsequent users. + * + * @note If you need to resume subscribing to the audio streams of remote users in the + * channel after calling \ref IRtcEngine::setDefaultMuteAllRemoteAudioStreams "setDefaultMuteAllRemoteAudioStreams" (true), do the following: + * - If you need to resume subscribing to the audio stream of a specified user, call \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream" (false), and specify the user ID. + * - If you need to resume subscribing to the audio streams of multiple remote users, call \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream" (false) multiple times. + * + * @param mute Sets whether to stop subscribing to the audio streams of all remote users by default. + * - true: Stop subscribing to the audio streams of all remote users by default. + * - false: (Default) Resume subscribing to the audio streams of all remote users by default. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - + /** Stops or resumes subscribing to the video streams of all remote users by default. + * + * @deprecated This method is deprecated from v3.3.0. + * + * Call this method after joining a channel. After successfully calling this method, the + * local user stops or resumes subscribing to the video streams of all subsequent users. + * + * @note If you need to resume subscribing to the video streams of remote users in the + * channel after calling \ref IChannel::setDefaultMuteAllRemoteVideoStreams "setDefaultMuteAllRemoteVideoStreams" (true), do the following: + * - If you need to resume subscribing to the video stream of a specified user, call \ref IChannel::muteRemoteVideoStream "muteRemoteVideoStream" (false), and specify the user ID. + * - If you need to resume subscribing to the video streams of multiple remote users, call \ref IChannel::muteRemoteVideoStream "muteRemoteVideoStream" (false) multiple times. + * + * @param mute Sets whether to stop subscribing to the video streams of all remote users by default. + * - true: Stop subscribing to the video streams of all remote users by default. + * - false: (Default) Resume subscribing to the video streams of all remote users by default. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; - + /** + * Stops or resumes subscribing to the audio streams of all remote users. + * + * As of v3.3.0, after successfully calling this method, the local user stops or resumes + * subscribing to the audio streams of all remote users, including all subsequent users. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param mute Sets whether to stop subscribing to the audio streams of all remote users. + * - true: Stop subscribing to the audio streams of all remote users. + * - false: (Default) Resume subscribing to the audio streams of all remote users. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int muteAllRemoteAudioStreams(bool mute) = 0; - + /** Adjust the playback signal volume of the specified remote user. + + After joining a channel, call \ref agora::rtc::IRtcEngine::adjustPlaybackSignalVolume "adjustPlaybackSignalVolume" to adjust the playback volume of different remote users, + or adjust multiple times for one remote user. + + @note + - Call this method after joining a channel. + - This method adjusts the playback volume, which is the mixed volume for the specified remote user. + - This method can only adjust the playback volume of one specified remote user at a time. If you want to adjust the playback volume of several remote users, + call the method multiple times, once for each remote user. + + @param userId The user ID, which should be the same as the `uid` of \ref agora::rtc::IChannel::joinChannel "joinChannel" + @param volume The playback volume of the voice. The value ranges from 0 to 100: + - 0: Mute. + - 100: Original volume. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int adjustUserPlaybackSignalVolume(uid_t userId, int volume) = 0; + /** + * Stops or resumes subscribing to the audio stream of a specified user. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param userId The user ID of the specified remote user. + * @param mute Sets whether to stop subscribing to the audio stream of a specified user. + * - true: Stop subscribing to the audio stream of a specified user. + * - false: (Default) Resume subscribing to the audio stream of a specified user. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; - + /** + * Stops or resumes subscribing to the video streams of all remote users. + * + * As of v3.3.0, after successfully calling this method, the local user stops or resumes + * subscribing to the video streams of all remote users, including all subsequent users. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param mute Sets whether to stop subscribing to the video streams of all remote users. + * - true: Stop subscribing to the video streams of all remote users. + * - false: (Default) Resume subscribing to the video streams of all remote users. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int muteAllRemoteVideoStreams(bool mute) = 0; - + /** + * Stops or resumes subscribing to the video stream of a specified user. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param userId The user ID of the specified remote user. + * @param mute Sets whether to stop subscribing to the video stream of a specified user. + * - true: Stop subscribing to the video stream of a specified user. + * - false: (Default) Resume subscribing to the video stream of a specified user. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; - + /** Sets the stream type of the remote video. + + Under limited network conditions, if the publisher has not disabled the dual-stream mode using + \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" (false), + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). + + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. + + The aspect ratio of the low-video stream is the same as the high-quality video stream. Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. + + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. + + @param userId The ID of the remote user sending the video stream. + @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + @return + - 0: Success. + - < 0: Failure. + */ virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - + /** Sets the default stream type of remote videos. + + Under limited network conditions, if the publisher has not disabled the dual-stream mode using + \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" (false), + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). + + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. The aspect ratio of the low-video stream is the same as the high-quality video stream. + Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. + + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. + + @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Creates a data stream. + + @deprecated This method is deprecated from v3.3.0. Use the \ref IChannel::createDataStream(int* streamId, DataStreamConfig& config) "createDataStream" [2/2] method instead. + Each user can create up to five data streams during the lifecycle of the IChannel. + + @note + - Do not set `reliable` as `true` while setting `ordered` as `false`. + - Ensure that you call this method after joining a channel. + + @param[out] streamId The ID of the created data stream. + @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: + - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, + an error is reported to the application. + - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for + any delay or missing data stream. + @param ordered Sets whether or not the recipients receive the data stream in the sent order: + - true: The recipients receive the data stream in the sent order. + - false: The recipients do not receive the data stream in the sent order. + + @return + - Returns 0: Success. + - < 0: Failure. + */ virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; - + /** Creates a data stream. + * + * @since v3.3.0 + * + * Each user can create up to five data streams in a single channel. + * + * This method does not support data reliability. If the receiver receives a data packet five + * seconds or more after it was sent, the SDK directly discards the data. + * + * @param[out] streamId The ID of the created data stream. + * @param config The configurations for the data stream: DataStreamConfig. + * + * @return + * - 0: Creates the data stream successfully. + * - < 0: Fails to create the data stream. + */ + virtual int createDataStream(int* streamId, DataStreamConfig& config) = 0; + /** Sends data stream messages to all users in a channel. + + The SDK has the following restrictions on this method: + - Up to 30 packets can be sent per second in a channel with each packet having a maximum size of 1 kB. + - Each client can send up to 6 kB of data per second. + - Each user can have up to five data streams simultaneously. + + A successful \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers + the \ref agora::rtc::IChannelEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + + A failed \ref agora::rtc::IChannel::sendStreamMessage "sendStreamMessage" method call triggers + the \ref agora::rtc::IChannelEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. + + @note + - This method applies only to the `COMMUNICATION` profile or to the hosts in the `LIVE_BROADCASTING` profile. If an audience in the `LIVE_BROADCASTING` profile calls this method, the audience may be switched to a host. + - Ensure that you have created the data stream using \ref agora::rtc::IChannel::createDataStream "createDataStream" before calling this method. + + @param streamId The ID of the sent data stream, returned in the \ref IChannel::createDataStream "createDataStream" method. + @param data The sent data. + @param length The length of the sent data. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int sendStreamMessage(int streamId, const char* data, size_t length) = 0; - + /** Publishes the local stream to a specified CDN streaming URL. (CDN live only.) + + The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback. + + After calling this method, you can push media streams in RTMP or RTMPS protocol to the CDN. The SDK triggers + the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client + to report the state of adding a local stream to the CDN. + + @note + - Ensure that the user joins the channel before calling this method. + - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*. + - This method adds only one stream CDN streaming URL each time it is called. + - Agora supports pushing media streams in RTMPS protocol to the CDN only when you enable transcoding. + + @param url The CDN streaming URL in the RTMP or RTMPS format. The maximum length of this parameter is 1024 bytes. The CDN streaming URL must not contain special characters, such as Chinese language characters. + @param transcodingEnabled Sets whether transcoding is enabled/disabled: + - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. If you set this parameter as `true`, ensure that you call the \ref IChannel::setLiveTranscoding "setLiveTranscoding" method before this method. + - false: Disable transcoding. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2): The CDN streaming URL is NULL or has a string length of 0. + - #ERR_NOT_INITIALIZED (-7): You have not initialized `IChannel` when publishing the stream. + */ virtual int addPublishStreamUrl(const char *url, bool transcodingEnabled) = 0; - + /** Removes an RTMP or RTMPS stream from the CDN. + + This method removes the CDN streaming URL (added by the \ref IChannel::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. + The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamUnpublished "onStreamUnpublished" callback. + + The \ref agora::rtc::IChannel::removePublishStreamUrl "removePublishStreamUrl" method call triggers + the \ref agora::rtc::IChannelEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP or RTMPS stream from the CDN. + + @note + - This method removes only one CDN streaming URL each time it is called. + - The CDN streaming URL must not contain special characters, such as Chinese language characters. + + @param url The CDN streaming URL to be removed. The maximum length of this parameter is 1024 bytes. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int removePublishStreamUrl(const char *url) = 0; - + /** Sets the video layout and audio settings for CDN live. (CDN live only.) + + The SDK triggers the \ref agora::rtc::IChannelEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you + call the `setLiveTranscoding` method to update the transcoding setting. + + @note + - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*.. + - If you call the `setLiveTranscoding` method to set the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + - Ensure that you call this method after joining a channel. + - Agora supports pushing media streams in RTMPS protocol to the CDN only when you enable transcoding. + + @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; - + /** Adds a voice or video stream URL address to the interactive live streaming. + + The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. + If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. + This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. + + The \ref agora::rtc::IChannel::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: + - The local client: + - \ref agora::rtc::IChannelEventHandler::onStreamInjectedStatus "onStreamInjectedStatus" , with the state of the injecting the online stream. + - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. + - The remote client: + - \ref agora::rtc::IChannelEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. + + @note + - Ensure that you enable the RTMP Converter service before using this function. See Prerequisites in the advanced guide *Push Streams to CDN*. + - This method applies to the Native SDK v2.4.1 and later. + - This method applies to the `LIVE_BROADCASTING` profile only. + - You can inject only one media stream into the channel at the same time. + - Ensure that you call this method after joining a channel. + + @param url The URL address to be added to the ongoing live streaming. Valid protocols are RTMP, HLS, and HTTP-FLV. + - Supported audio codec type: AAC. + - Supported video codec type: H264 (AVC). + @param config The InjectStreamConfig object that contains the configuration of the added voice or video stream. + + @return + - 0: Success. + - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. + - #ERR_NOT_READY (-3): The user is not in the channel. + - #ERR_NOT_SUPPORTED (-4): The channel profile is not `LIVE_BROADCASTING`. Call the \ref IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to `LIVE_BROADCASTING` before calling this method. + - #ERR_NOT_INITIALIZED (-7): The SDK is not initialized. Ensure that the IChannel object is initialized before calling this method. + */ virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; - + /** Removes the voice or video stream URL address from a live streaming. + + This method removes the URL address (added by the \ref IChannel::addInjectStreamUrl "addInjectStreamUrl" method) from the live streaming. + + @note If this method is called successfully, the SDK triggers the \ref IChannelEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. + + @param url Pointer to the URL address of the added stream to be removed. + + @return + - 0: Success. + - < 0: Failure. + */ virtual int removeInjectStreamUrl(const char* url) = 0; - + /** Starts to relay media streams across channels. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" and + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callbacks, and these callbacks return the + * state and events of the media stream relay. + * - If the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback returns + * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback returns + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the host starts + * sending data to the destination channel. + * - If the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback returns + * #RELAY_STATE_FAILURE (3), an exception occurs during the media stream + * relay. + * + * @note + * - Call this method after the \ref joinChannel() "joinChannel" method. + * - This method takes effect only when you are a host in a + * `LIVE_BROADCASTING` channel. + * - After a successful method call, if you want to call this method + * again, ensure that you call the + * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the + * current relay. + * - Contact sales-us@agora.io before implementing this function. + * - We do not support string user accounts in this API. + * + * @param configuration The configuration of the media stream relay: + * ChannelMediaRelayConfiguration. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; - + /** Updates the channels for media stream relay. + * + * After a successful + * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if + * you want to relay the media stream to more channels, or leave the + * current relay channel, you can call the + * \ref updateChannelMediaRelay() "updateChannelMediaRelay" method. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback with the + * #RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL (7) state code. + * + * @note + * Call this method after the + * \ref startChannelMediaRelay() "startChannelMediaRelay" method to update + * the destination channel. + * + * @param configuration The media stream relay configuration: + * ChannelMediaRelayConfiguration. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; - + /** Stops the media stream relay. + * + * Once the relay stops, the host quits all the destination + * channels. + * + * After a successful method call, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback. If the callback returns + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the host successfully + * stops the relay. + * + * @note + * If the method call fails, the SDK triggers the + * \ref agora::rtc::IChannelEventHandler::onChannelMediaRelayStateChanged + * "onChannelMediaRelayStateChanged" callback with the + * #RELAY_ERROR_SERVER_NO_RESPONSE (2) or + * #RELAY_ERROR_SERVER_CONNECTION_LOST (8) state code. You can leave the + * channel by calling the \ref leaveChannel() "leaveChannel" method, and + * the media stream relay automatically stops. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ virtual int stopChannelMediaRelay() = 0; - + /** Gets the current connection state of the SDK. + + @note You can call this method either before or after joining a channel. + + @return #CONNECTION_STATE_TYPE. + */ virtual CONNECTION_STATE_TYPE getConnectionState() = 0; + /// @cond + /** Enables/Disables the super-resolution algorithm for a remote user's video stream. + * + * @since v3.2.0 + * + * The algorithm effectively improves the resolution of the specified remote user's video stream. When the original + * resolution of the remote video stream is a × b pixels, you can receive and render the stream at a higher + * resolution (2a × 2b pixels) by enabling the algorithm. + * + * After calling this method, the SDK triggers the + * \ref IRtcChannelEventHandler::onUserSuperResolutionEnabled "onUserSuperResolutionEnabled" callback to report + * whether you have successfully enabled the super-resolution algorithm. + * + * @warning The super-resolution algorithm requires extra system resources. + * To balance the visual experience and system usage, the SDK poses the following restrictions: + * - The algorithm can only be used for a single user at a time. + * - On the Android platform, the original resolution of the remote video must not exceed 640 × 360 pixels. + * - On the iOS platform, the original resolution of the remote video must not exceed 640 × 480 pixels. + * If you exceed these limitations, the SDK triggers the \ref IRtcChannelEventHandler::onWarning "onWarning" + * callback with the corresponding warning codes: + * - #WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION (1610): The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. + * - #WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION (1611): Another user is already using the super-resolution algorithm. + * - #WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED (1612): The device does not support the super-resolution algorithm. + * + * @note + * - This method applies to Android and iOS only. + * - Requirements for the user's device: + * - Android: The following devices are known to support the method: + * - VIVO: V1821A, NEX S, 1914A, 1916A, and 1824BA + * - OPPO: PCCM00 + * - OnePlus: A6000 + * - Xiaomi: Mi 8, Mi 9, MIX3, and Redmi K20 Pro + * - SAMSUNG: SM-G9600, SM-G9650, SM-N9600, SM-G9708, SM-G960U, and SM-G9750 + * - HUAWEI: SEA-AL00, ELE-AL00, VOG-AL00, YAL-AL10, HMA-AL00, and EVR-AN00 + * - iOS: This method is supported on devices running iOS 12.0 or later. The following + * device models are known to support the method: + * - iPhone XR + * - iPhone XS + * - iPhone XS Max + * - iPhone 11 + * - iPhone 11 Pro + * - iPhone 11 Pro Max + * - iPad Pro 11-inch (3rd Generation) + * - iPad Pro 12.9-inch (3rd Generation) + * - iPad Air 3 (3rd Generation) + * + * @param userId The ID of the remote user. + * @param enable Whether to enable the super-resolution algorithm: + * - true: Enable the super-resolution algorithm. + * - false: Disable the super-resolution algorithm. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableRemoteSuperResolution(uid_t userId, bool enable) = 0; + /// @endcond }; +/** @since v3.0.0 + The IRtcEngine2 class. */ class IRtcEngine2 : public IRtcEngine { public: - - /** Gets a the *IChannel* object. - - @param channelId Channel ID of the RTC connection. - @return Pointer to the *IChannel* object. If the connection hasn't been created, NULL will be returned. + + /** Creates and gets an `IChannel` object. + + To join more than one channel, call this method multiple times to create as many `IChannel` objects as needed, and + call the \ref agora::rtc::IChannel::joinChannel "joinChannel" method of each created `IChannel` object. + + After joining multiple channels, you can simultaneously subscribe to streams of all the channels, but publish a stream in only one channel at one time. + @param channelId The unique channel name for an Agora RTC session. It must be in the string format and not exceed 64 bytes in length. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @note + - This parameter does not have a default value. You must set it. + - Do not set it as the empty string "". Otherwise, the SDK returns #ERR_REFUSED (5). + + @return + - The `IChannel` object, if the method call succeeds. + - An empty pointer NULL, if the method call fails. + - `ERR_REFUSED(5)`, if you set channelId as the empty string "". */ virtual IChannel* createChannel(const char *channelId) = 0; - + }; @@ -376,4 +1523,4 @@ class IRtcEngine2 : public IRtcEngine } -#endif /* IAgoraRtcChannel_h */ +#endif diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h index 0f75da2..53669f4 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraRtcEngine.h @@ -12,7 +12,10 @@ #define AGORA_RTC_ENGINE_H #include "AgoraBase.h" #include "IAgoraService.h" -#include "IAgoraLog.h" + +#if defined(_WIN32) +#include "IAgoraMediaEngine.h" +#endif namespace agora { namespace rtc { @@ -34,7 +37,7 @@ enum MAX_USER_ACCOUNT_LENGTH_TYPE */ MAX_USER_ACCOUNT_LENGTH = 256 }; -/** Maximum length of channel id. +/** Maximum length of channel ID. */ enum MAX_CHANNEL_ID_LENGTH_TYPE { @@ -146,16 +149,17 @@ enum MEDIA_ENGINE_EVENT_CODE_TYPE /** The states of the local user's audio mixing file. */ enum AUDIO_MIXING_STATE_TYPE{ - /** 710: The audio mixing file is playing. - */ + /** 710: The audio mixing file is playing after the method call of + * \ref IRtcEngine::startAudioMixing "startAudioMixing" or \ref IRtcEngine::resumeAudioMixing "resumeAudioMixing" succeeds. + */ AUDIO_MIXING_STATE_PLAYING = 710, - /** 711: The audio mixing file pauses playing. + /** 711: The audio mixing file pauses playing after the method call of \ref IRtcEngine::pauseAudioMixing "pauseAudioMixing" succeeds. */ AUDIO_MIXING_STATE_PAUSED = 711, - /** 713: The audio mixing file stops playing. + /** 713: The audio mixing file stops playing after the method call of \ref IRtcEngine::stopAudioMixing "stopAudioMixing" succeeds. */ AUDIO_MIXING_STATE_STOPPED = 713, - /** 714: An exception occurs when playing the audio mixing file. See #AUDIO_MIXING_ERROR_TYPE. + /** 714: An exception occurs during the playback of the audio mixing file. See the `errorCode` for details. */ AUDIO_MIXING_STATE_FAILED = 714, }; @@ -177,16 +181,6 @@ enum AUDIO_MIXING_ERROR_TYPE{ AUDIO_MIXING_ERROR_OK = 0, }; -enum XLA_EXP_NET_POOR_REASON { - XLA_EXP_NET_REMOTE_POOR = 1, - XLA_EXP_NET_GATWAYRTT_POOR = 2, - XLA_EXP_NET_WANRTT_POOR = 4, - XLA_EXP_NET_VOSRTT_POOR = 8, - XLA_EXP_NET_LINKSPEED_POOR = 16, - XLA_EXP_NET_RSSI_POOR = 32, - XLA_EXP_NET_WIFI_BLUETOOTH_COEXIST = 64, -}; - /** Media device states. */ enum MEDIA_DEVICE_STATE_TYPE @@ -202,7 +196,10 @@ enum MEDIA_DEVICE_STATE_TYPE MEDIA_DEVICE_STATE_NOT_PRESENT = 4, /** 8: The device is unplugged. */ - MEDIA_DEVICE_STATE_UNPLUGGED = 8 + MEDIA_DEVICE_STATE_UNPLUGGED = 8, + /** 16: The device is not recommended. + */ + MEDIA_DEVICE_STATE_UNRECOMMENDED = 16 }; /** Media device types. @@ -215,7 +212,7 @@ enum MEDIA_DEVICE_TYPE /** 0: Audio playback device. */ AUDIO_PLAYOUT_DEVICE = 0, - /** 1: Audio recording device. + /** 1: Audio capturing device. */ AUDIO_RECORDING_DEVICE = 1, /** 2: Video renderer. @@ -233,33 +230,54 @@ enum MEDIA_DEVICE_TYPE */ enum LOCAL_VIDEO_STREAM_STATE { - /** Initial state */ + /** 0: Initial state */ LOCAL_VIDEO_STREAM_STATE_STOPPED = 0, - /** The capturer starts successfully. */ + /** 1: The local video capturing device starts successfully. + * + * The SDK also reports this state when you share a maximized window by calling \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId". + */ LOCAL_VIDEO_STREAM_STATE_CAPTURING = 1, - /** The first video frame is successfully encoded. */ + /** 2: The first video frame is successfully encoded. */ LOCAL_VIDEO_STREAM_STATE_ENCODING = 2, - /** The local video fails to start. */ + /** 3: The local video fails to start. */ LOCAL_VIDEO_STREAM_STATE_FAILED = 3 }; /** Local video state error codes */ enum LOCAL_VIDEO_STREAM_ERROR { - /** The local video is normal. */ + /** 0: The local video is normal. */ LOCAL_VIDEO_STREAM_ERROR_OK = 0, - /** No specified reason for the local video failure. */ + /** 1: No specified reason for the local video failure. */ LOCAL_VIDEO_STREAM_ERROR_FAILURE = 1, - /** No permission to use the local video device. */ + /** 2: No permission to use the local video capturing device. */ LOCAL_VIDEO_STREAM_ERROR_DEVICE_NO_PERMISSION = 2, - /** The local video capturer is in use. */ + /** 3: The local video capturing device is in use. */ LOCAL_VIDEO_STREAM_ERROR_DEVICE_BUSY = 3, - /** The local video capture fails. Check whether the capturer is working properly. */ + /** 4: The local video capture fails. Check whether the capturing device is working properly. */ LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE = 4, - /** The local video encoding fails. */ + /** 5: The local video encoding fails. */ LOCAL_VIDEO_STREAM_ERROR_ENCODE_FAILURE = 5, - /** No camera device. */ - LOCAL_VIDEO_STREAM_ERROR_DEVICE_NOT_FOUND = 6, + /** 6: capture InBackground. */ + LOCAL_VIDEO_STREAM_ERROR_CAPTURE_INBACKGROUND = 6, + /** 7:capture MultipleForegroundApps. */ + LOCAL_VIDEO_STREAM_ERROR_CAPTURE_MULTIPLE_FOREGROUND_APPS = 7, + /** 11: The shared window is minimized when you call \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" to share a window. + */ + LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_MINIMIZED = 11, + /** 12: The error code indicates that a window shared by the window ID has been closed, or a full-screen window + * shared by the window ID has exited full-screen mode. + * After exiting full-screen mode, remote users cannot see the shared window. To prevent remote users from seeing a + * black screen, Agora recommends that you immediately stop screen sharing. + * + * Common scenarios for reporting this error code: + * - When the local user closes the shared window, the SDK reports this error code. + * - The local user shows some slides in full-screen mode first, and then shares the windows of the slides. After + * the user exits full-screen mode, the SDK reports this error code. + * - The local user watches web video or reads web document in full-screen mode first, and then shares the window of + * the web video or document. After the user exits full-screen mode, the SDK reports this error code. + */ + LOCAL_VIDEO_STREAM_ERROR_SCREEN_CAPTURE_WINDOW_CLOSED = 12, }; /** Local audio state types. @@ -269,7 +287,7 @@ enum LOCAL_AUDIO_STREAM_STATE /** 0: The local audio is in the initial state. */ LOCAL_AUDIO_STREAM_STATE_STOPPED = 0, - /** 1: The recording device starts successfully. + /** 1: The capturing device starts successfully. */ LOCAL_AUDIO_STREAM_STATE_RECORDING = 1, /** 2: The first audio frame encodes successfully. @@ -296,19 +314,13 @@ enum LOCAL_AUDIO_STREAM_ERROR /** 3: The microphone is in use. */ LOCAL_AUDIO_STREAM_ERROR_DEVICE_BUSY = 3, - /** 4: The local audio recording fails. Check whether the recording device + /** 4: The local audio capturing fails. Check whether the capturing device * is working properly. */ LOCAL_AUDIO_STREAM_ERROR_RECORD_FAILURE = 4, /** 5: The local audio encoding fails. */ - LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE = 5, - /** 6: No recording audio device. - */ - LOCAL_AUDIO_STREAM_ERROR_NO_RECORDING_DEVICE = 6, - /** 7: No playout audio device. - */ - LOCAL_AUDIO_STREAM_ERROR_NO_PLAYOUT_DEVICE = 7 + LOCAL_AUDIO_STREAM_ERROR_ENCODE_FAILURE = 5 }; /** Audio recording qualities. @@ -366,12 +378,17 @@ enum RENDER_MODE_TYPE /** **DEPRECATED** 3: This mode is deprecated. */ RENDER_MODE_ADAPTIVE = 3, + /** + 4: The fill mode. In this mode, the SDK stretches or zooms the video to fill the display window. + */ + RENDER_MODE_FILL = 4, }; /** Video mirror modes. */ enum VIDEO_MIRROR_MODE_TYPE { - /** 0: The default mirror mode is determined by the SDK. */ + /** 0: (Default) The SDK enables the mirror mode. + */ VIDEO_MIRROR_MODE_AUTO = 0,//determined by SDK /** 1: Enable mirror mode. */ VIDEO_MIRROR_MODE_ENABLED = 1,//enabled mirror @@ -382,159 +399,159 @@ enum VIDEO_MIRROR_MODE_TYPE /** **DEPRECATED** Video profiles. */ enum VIDEO_PROFILE_TYPE { - /** 0: 160 × 120, frame rate 15 fps, bitrate 65 Kbps. */ + /** 0: 160 * 120, frame rate 15 fps, bitrate 65 Kbps. */ VIDEO_PROFILE_LANDSCAPE_120P = 0, - /** 2: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ + /** 2: 120 * 120, frame rate 15 fps, bitrate 50 Kbps. */ VIDEO_PROFILE_LANDSCAPE_120P_3 = 2, - /** 10: 320×180, frame rate 15 fps, bitrate 140 Kbps. */ + /** 10: 320*180, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P = 10, - /** 12: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ + /** 12: 180 * 180, frame rate 15 fps, bitrate 100 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P_3 = 12, - /** 13: 240 × 180, frame rate 15 fps, bitrate 120 Kbps. */ + /** 13: 240 * 180, frame rate 15 fps, bitrate 120 Kbps. */ VIDEO_PROFILE_LANDSCAPE_180P_4 = 13, - /** 20: 320 × 240, frame rate 15 fps, bitrate 200 Kbps. */ + /** 20: 320 * 240, frame rate 15 fps, bitrate 200 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P = 20, - /** 22: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ + /** 22: 240 * 240, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P_3 = 22, - /** 23: 424 × 240, frame rate 15 fps, bitrate 220 Kbps. */ + /** 23: 424 * 240, frame rate 15 fps, bitrate 220 Kbps. */ VIDEO_PROFILE_LANDSCAPE_240P_4 = 23, - /** 30: 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ + /** 30: 640 * 360, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P = 30, - /** 32: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ + /** 32: 360 * 360, frame rate 15 fps, bitrate 260 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_3 = 32, - /** 33: 640 × 360, frame rate 30 fps, bitrate 600 Kbps. */ + /** 33: 640 * 360, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_4 = 33, - /** 35: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ + /** 35: 360 * 360, frame rate 30 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_6 = 35, - /** 36: 480 × 360, frame rate 15 fps, bitrate 320 Kbps. */ + /** 36: 480 * 360, frame rate 15 fps, bitrate 320 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_7 = 36, - /** 37: 480 × 360, frame rate 30 fps, bitrate 490 Kbps. */ + /** 37: 480 * 360, frame rate 30 fps, bitrate 490 Kbps. */ VIDEO_PROFILE_LANDSCAPE_360P_8 = 37, - /** 38: 640 × 360, frame rate 15 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 38: 640 * 360, frame rate 15 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_9 = 38, - /** 39: 640 × 360, frame rate 24 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 39: 640 * 360, frame rate 24 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_10 = 39, - /** 100: 640 × 360, frame rate 24 fps, bitrate 1000 Kbps. - @note Live broadcast profile only. + /** 100: 640 * 360, frame rate 24 fps, bitrate 1000 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_LANDSCAPE_360P_11 = 100, - /** 40: 640 × 480, frame rate 15 fps, bitrate 500 Kbps. */ + /** 40: 640 * 480, frame rate 15 fps, bitrate 500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P = 40, - /** 42: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ + /** 42: 480 * 480, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_3 = 42, - /** 43: 640 × 480, frame rate 30 fps, bitrate 750 Kbps. */ + /** 43: 640 * 480, frame rate 30 fps, bitrate 750 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_4 = 43, - /** 45: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ + /** 45: 480 * 480, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_6 = 45, - /** 47: 848 × 480, frame rate 15 fps, bitrate 610 Kbps. */ + /** 47: 848 * 480, frame rate 15 fps, bitrate 610 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_8 = 47, - /** 48: 848 × 480, frame rate 30 fps, bitrate 930 Kbps. */ + /** 48: 848 * 480, frame rate 30 fps, bitrate 930 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_9 = 48, - /** 49: 640 × 480, frame rate 10 fps, bitrate 400 Kbps. */ + /** 49: 640 * 480, frame rate 10 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_LANDSCAPE_480P_10 = 49, - /** 50: 1280 × 720, frame rate 15 fps, bitrate 1130 Kbps. */ + /** 50: 1280 * 720, frame rate 15 fps, bitrate 1130 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P = 50, - /** 52: 1280 × 720, frame rate 30 fps, bitrate 1710 Kbps. */ + /** 52: 1280 * 720, frame rate 30 fps, bitrate 1710 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_3 = 52, - /** 54: 960 × 720, frame rate 15 fps, bitrate 910 Kbps. */ + /** 54: 960 * 720, frame rate 15 fps, bitrate 910 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_5 = 54, - /** 55: 960 × 720, frame rate 30 fps, bitrate 1380 Kbps. */ + /** 55: 960 * 720, frame rate 30 fps, bitrate 1380 Kbps. */ VIDEO_PROFILE_LANDSCAPE_720P_6 = 55, - /** 60: 1920 × 1080, frame rate 15 fps, bitrate 2080 Kbps. */ + /** 60: 1920 * 1080, frame rate 15 fps, bitrate 2080 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P = 60, - /** 62: 1920 × 1080, frame rate 30 fps, bitrate 3150 Kbps. */ + /** 62: 1920 * 1080, frame rate 30 fps, bitrate 3150 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P_3 = 62, - /** 64: 1920 × 1080, frame rate 60 fps, bitrate 4780 Kbps. */ + /** 64: 1920 * 1080, frame rate 60 fps, bitrate 4780 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1080P_5 = 64, - /** 66: 2560 × 1440, frame rate 30 fps, bitrate 4850 Kbps. */ + /** 66: 2560 * 1440, frame rate 30 fps, bitrate 4850 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1440P = 66, - /** 67: 2560 × 1440, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 67: 2560 * 1440, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_1440P_2 = 67, - /** 70: 3840 × 2160, frame rate 30 fps, bitrate 6500 Kbps. */ + /** 70: 3840 * 2160, frame rate 30 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_4K = 70, - /** 72: 3840 × 2160, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 72: 3840 * 2160, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_LANDSCAPE_4K_3 = 72, - /** 1000: 120 × 160, frame rate 15 fps, bitrate 65 Kbps. */ + /** 1000: 120 * 160, frame rate 15 fps, bitrate 65 Kbps. */ VIDEO_PROFILE_PORTRAIT_120P = 1000, - /** 1002: 120 × 120, frame rate 15 fps, bitrate 50 Kbps. */ + /** 1002: 120 * 120, frame rate 15 fps, bitrate 50 Kbps. */ VIDEO_PROFILE_PORTRAIT_120P_3 = 1002, - /** 1010: 180 × 320, frame rate 15 fps, bitrate 140 Kbps. */ + /** 1010: 180 * 320, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P = 1010, - /** 1012: 180 × 180, frame rate 15 fps, bitrate 100 Kbps. */ + /** 1012: 180 * 180, frame rate 15 fps, bitrate 100 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P_3 = 1012, - /** 1013: 180 × 240, frame rate 15 fps, bitrate 120 Kbps. */ + /** 1013: 180 * 240, frame rate 15 fps, bitrate 120 Kbps. */ VIDEO_PROFILE_PORTRAIT_180P_4 = 1013, - /** 1020: 240 × 320, frame rate 15 fps, bitrate 200 Kbps. */ + /** 1020: 240 * 320, frame rate 15 fps, bitrate 200 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P = 1020, - /** 1022: 240 × 240, frame rate 15 fps, bitrate 140 Kbps. */ + /** 1022: 240 * 240, frame rate 15 fps, bitrate 140 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P_3 = 1022, - /** 1023: 240 × 424, frame rate 15 fps, bitrate 220 Kbps. */ + /** 1023: 240 * 424, frame rate 15 fps, bitrate 220 Kbps. */ VIDEO_PROFILE_PORTRAIT_240P_4 = 1023, - /** 1030: 360 × 640, frame rate 15 fps, bitrate 400 Kbps. */ + /** 1030: 360 * 640, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P = 1030, - /** 1032: 360 × 360, frame rate 15 fps, bitrate 260 Kbps. */ + /** 1032: 360 * 360, frame rate 15 fps, bitrate 260 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_3 = 1032, - /** 1033: 360 × 640, frame rate 30 fps, bitrate 600 Kbps. */ + /** 1033: 360 * 640, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_4 = 1033, - /** 1035: 360 × 360, frame rate 30 fps, bitrate 400 Kbps. */ + /** 1035: 360 * 360, frame rate 30 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_6 = 1035, - /** 1036: 360 × 480, frame rate 15 fps, bitrate 320 Kbps. */ + /** 1036: 360 * 480, frame rate 15 fps, bitrate 320 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_7 = 1036, - /** 1037: 360 × 480, frame rate 30 fps, bitrate 490 Kbps. */ + /** 1037: 360 * 480, frame rate 30 fps, bitrate 490 Kbps. */ VIDEO_PROFILE_PORTRAIT_360P_8 = 1037, - /** 1038: 360 × 640, frame rate 15 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 1038: 360 * 640, frame rate 15 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_PORTRAIT_360P_9 = 1038, - /** 1039: 360 × 640, frame rate 24 fps, bitrate 800 Kbps. - @note Live broadcast profile only. + /** 1039: 360 * 640, frame rate 24 fps, bitrate 800 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_PORTRAIT_360P_10 = 1039, - /** 1100: 360 × 640, frame rate 24 fps, bitrate 1000 Kbps. - @note Live broadcast profile only. + /** 1100: 360 * 640, frame rate 24 fps, bitrate 1000 Kbps. + @note `LIVE_BROADCASTING` profile only. */ VIDEO_PROFILE_PORTRAIT_360P_11 = 1100, - /** 1040: 480 × 640, frame rate 15 fps, bitrate 500 Kbps. */ + /** 1040: 480 * 640, frame rate 15 fps, bitrate 500 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P = 1040, - /** 1042: 480 × 480, frame rate 15 fps, bitrate 400 Kbps. */ + /** 1042: 480 * 480, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_3 = 1042, - /** 1043: 480 × 640, frame rate 30 fps, bitrate 750 Kbps. */ + /** 1043: 480 * 640, frame rate 30 fps, bitrate 750 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_4 = 1043, - /** 1045: 480 × 480, frame rate 30 fps, bitrate 600 Kbps. */ + /** 1045: 480 * 480, frame rate 30 fps, bitrate 600 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_6 = 1045, - /** 1047: 480 × 848, frame rate 15 fps, bitrate 610 Kbps. */ + /** 1047: 480 * 848, frame rate 15 fps, bitrate 610 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_8 = 1047, - /** 1048: 480 × 848, frame rate 30 fps, bitrate 930 Kbps. */ + /** 1048: 480 * 848, frame rate 30 fps, bitrate 930 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_9 = 1048, - /** 1049: 480 × 640, frame rate 10 fps, bitrate 400 Kbps. */ + /** 1049: 480 * 640, frame rate 10 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_PORTRAIT_480P_10 = 1049, - /** 1050: 720 × 1280, frame rate 15 fps, bitrate 1130 Kbps. */ + /** 1050: 720 * 1280, frame rate 15 fps, bitrate 1130 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P = 1050, - /** 1052: 720 × 1280, frame rate 30 fps, bitrate 1710 Kbps. */ + /** 1052: 720 * 1280, frame rate 30 fps, bitrate 1710 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_3 = 1052, - /** 1054: 720 × 960, frame rate 15 fps, bitrate 910 Kbps. */ + /** 1054: 720 * 960, frame rate 15 fps, bitrate 910 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_5 = 1054, - /** 1055: 720 × 960, frame rate 30 fps, bitrate 1380 Kbps. */ + /** 1055: 720 * 960, frame rate 30 fps, bitrate 1380 Kbps. */ VIDEO_PROFILE_PORTRAIT_720P_6 = 1055, - /** 1060: 1080 × 1920, frame rate 15 fps, bitrate 2080 Kbps. */ + /** 1060: 1080 * 1920, frame rate 15 fps, bitrate 2080 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P = 1060, - /** 1062: 1080 × 1920, frame rate 30 fps, bitrate 3150 Kbps. */ + /** 1062: 1080 * 1920, frame rate 30 fps, bitrate 3150 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P_3 = 1062, - /** 1064: 1080 × 1920, frame rate 60 fps, bitrate 4780 Kbps. */ + /** 1064: 1080 * 1920, frame rate 60 fps, bitrate 4780 Kbps. */ VIDEO_PROFILE_PORTRAIT_1080P_5 = 1064, - /** 1066: 1440 × 2560, frame rate 30 fps, bitrate 4850 Kbps. */ + /** 1066: 1440 * 2560, frame rate 30 fps, bitrate 4850 Kbps. */ VIDEO_PROFILE_PORTRAIT_1440P = 1066, - /** 1067: 1440 × 2560, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 1067: 1440 * 2560, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_1440P_2 = 1067, - /** 1070: 2160 × 3840, frame rate 30 fps, bitrate 6500 Kbps. */ + /** 1070: 2160 * 3840, frame rate 30 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_4K = 1070, - /** 1072: 2160 × 3840, frame rate 60 fps, bitrate 6500 Kbps. */ + /** 1072: 2160 * 3840, frame rate 60 fps, bitrate 6500 Kbps. */ VIDEO_PROFILE_PORTRAIT_4K_3 = 1072, - /** Default 640 × 360, frame rate 15 fps, bitrate 400 Kbps. */ + /** Default 640 * 360, frame rate 15 fps, bitrate 400 Kbps. */ VIDEO_PROFILE_DEFAULT = VIDEO_PROFILE_LANDSCAPE_360P, }; @@ -543,35 +560,36 @@ enum VIDEO_PROFILE_TYPE Sets the sample rate, bitrate, encoding mode, and the number of channels:*/ enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music codec { - /** - 0: Default audio profile. - - - In the Communication profile, the default value is #AUDIO_PROFILE_SPEECH_STANDARD; - - In the Live-broadcast profile, the default value is #AUDIO_PROFILE_MUSIC_STANDARD. - */ + /** + 0: Default audio profile: + - For the interactive streaming profile: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 64 Kbps. + - For the `COMMUNICATION` profile: + - Windows: A sample rate of 16 KHz, music encoding, mono, and a bitrate of up to 16 Kbps. + - Android/macOS/iOS: A sample rate of 32 KHz, music encoding, mono, and a bitrate of up to 18 Kbps. + */ AUDIO_PROFILE_DEFAULT = 0, // use default settings /** - 1: A sample rate of 32 kHz, audio encoding, mono, and a bitrate of up to 18 Kbps. + 1: A sample rate of 32 KHz, audio encoding, mono, and a bitrate of up to 18 Kbps. */ AUDIO_PROFILE_SPEECH_STANDARD = 1, // 32Khz, 18Kbps, mono, speech /** - 2: A sample rate of 48 kHz, music encoding, mono, and a bitrate of up to 48 Kbps. + 2: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 64 Kbps. */ AUDIO_PROFILE_MUSIC_STANDARD = 2, // 48Khz, 48Kbps, mono, music /** - 3: A sample rate of 48 kHz, music encoding, stereo, and a bitrate of up to 56 Kbps. + 3: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 80 Kbps. */ AUDIO_PROFILE_MUSIC_STANDARD_STEREO = 3, // 48Khz, 56Kbps, stereo, music /** - 4: A sample rate of 48 kHz, music encoding, mono, and a bitrate of up to 128 Kbps. + 4: A sample rate of 48 KHz, music encoding, mono, and a bitrate of up to 96 Kbps. */ AUDIO_PROFILE_MUSIC_HIGH_QUALITY = 4, // 48Khz, 128Kbps, mono, music /** - 5: A sample rate of 48 kHz, music encoding, stereo, and a bitrate of up to 192 Kbps. + 5: A sample rate of 48 KHz, music encoding, stereo, and a bitrate of up to 128 Kbps. */ AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO = 5, // 48Khz, 192Kbps, stereo, music /** - 6: A sample rate of 16 kHz, audio encoding, mono, and Acoustic Echo Cancellation (AES) enabled. + 6: A sample rate of 16 KHz, audio encoding, mono, and Acoustic Echo Cancellation (AES) enabled. */ AUDIO_PROFILE_IOT = 6, AUDIO_PROFILE_NUM = 7, @@ -581,55 +599,91 @@ enum AUDIO_PROFILE_TYPE // sample rate, bit rate, mono/stereo, speech/music code */ enum AUDIO_SCENARIO_TYPE // set a suitable scenario for your app type { - /** 0: Default. */ + /** 0: Default audio scenario. */ AUDIO_SCENARIO_DEFAULT = 0, - /** 1: Entertainment scenario, supporting voice during gameplay. */ + /** 1: Entertainment scenario where users need to frequently switch the user role. */ AUDIO_SCENARIO_CHATROOM_ENTERTAINMENT = 1, - /** 2: Education scenario, prioritizing smoothness and stability. */ + /** 2: Education scenario where users want smoothness and stability. */ AUDIO_SCENARIO_EDUCATION = 2, - /** 3: Live gaming scenario, enabling the gaming audio effects in the speaker mode in a live broadcast scenario. Choose this scenario for high-fidelity music playback. */ + /** 3: High-quality audio chatroom scenario where hosts mainly play music. */ AUDIO_SCENARIO_GAME_STREAMING = 3, - /** 4: Showroom scenario, optimizing the audio quality with external professional equipment. */ + /** 4: Showroom scenario where a single host wants high-quality audio. */ AUDIO_SCENARIO_SHOWROOM = 4, - /** 5: Gaming scenario. */ + /** 5: Gaming scenario for group chat that only contains the human voice. */ AUDIO_SCENARIO_CHATROOM_GAMING = 5, - /** 6: Applicable to the IoT scenario. */ + /** 6: IoT (Internet of Things) scenario where users use IoT devices with low power consumption. */ AUDIO_SCENARIO_IOT = 6, - AUDIO_SCENARIO_NUM = 7, + /** 8: Meeting scenario that mainly contains the human voice. + * + * @since v3.2.0 + */ + AUDIO_SCENARIO_MEETING = 8, + /** The number of elements in the enumeration. + */ + AUDIO_SCENARIO_NUM = 9, }; - /** Channel profiles. + /** The channel profile. */ enum CHANNEL_PROFILE_TYPE { - /** 0: Communication. - - This is used in one-on-one calls or group calls, where all users in the channel can talk freely. - */ - CHANNEL_PROFILE_COMMUNICATION = 0, - /** 1: Live Broadcast. - - Host and audience roles that can be set by calling the \ref IRtcEngine::setClientRole "setClientRole" method. The host sends and receives voice, while the audience receives voice only with the sending function disabled. - */ - CHANNEL_PROFILE_LIVE_BROADCASTING = 1, - /** 2: Gaming. - - @note This profile applies to the Agora Gaming SDK only. - - Any user in the channel can talk freely. This mode uses the codec with low-power consumption and low bitrate by default. - */ + /** (Default) Communication. This profile applies to scenarios such as an audio call or video call, + * where all users can publish and subscribe to streams. + */ + CHANNEL_PROFILE_COMMUNICATION = 0, + /** Live streaming. In this profile, uses have roles, namely, host and audience (default). + * A host both publishes and subscribes to streams, while an audience subscribes to streams only. + * This profile applies to scenarios such as a chat room or interactive video streaming. + */ + CHANNEL_PROFILE_LIVE_BROADCASTING = 1, + /** 2: Gaming. This profile uses a codec with a lower bitrate and consumes less power. Applies to the gaming scenario, where all game players can talk freely. + * + * @note Agora does not recommend using this setting. + */ CHANNEL_PROFILE_GAME = 2, }; -/** Client roles in a live broadcast. */ +/** The role of a user in interactive live streaming. */ enum CLIENT_ROLE_TYPE { - /** 1: Host */ + /** 1: Host. A host can both send and receive streams. */ CLIENT_ROLE_BROADCASTER = 1, - /** 2: Audience */ + /** 2: (Default) Audience. An `audience` member can only receive streams. */ CLIENT_ROLE_AUDIENCE = 2, }; +/** The latency level of an audience member in interactive live streaming. + * + * @note Takes effect only when the user role is `CLIENT_ROLE_AUDIENCE`. + */ +enum AUDIENCE_LATENCY_LEVEL_TYPE +{ + /** 1: Low latency. */ + AUDIENCE_LATENCY_LEVEL_LOW_LATENCY = 1, + /** 2: (Default) Ultra low latency. */ + AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY = 2, +}; +/// @cond +/** The reason why the super-resolution algorithm is not successfully enabled. + */ +enum SUPER_RESOLUTION_STATE_REASON +{ + /** 0: The super-resolution algorithm is successfully enabled. + */ + SR_STATE_REASON_SUCCESS = 0, + /** 1: The origin resolution of the remote video is beyond the range where + * the super-resolution algorithm can be applied. + */ + SR_STATE_REASON_STREAM_OVER_LIMITATION = 1, + /** 2: Another user is already using the super-resolution algorithm. + */ + SR_STATE_REASON_USER_COUNT_OVER_LIMITATION = 2, + /** 3: The device does not support the super-resolution algorithm. + */ + SR_STATE_REASON_DEVICE_NOT_SUPPORTED = 3, +}; +/// @endcond + /** Reasons for a user being offline. */ enum USER_OFFLINE_REASON_TYPE { @@ -637,64 +691,72 @@ enum USER_OFFLINE_REASON_TYPE USER_OFFLINE_QUIT = 0, /** 1: The SDK times out and the user drops offline because no data packet is received within a certain period of time. If the user quits the call and the message is not passed to the SDK (due to an unreliable channel), the SDK assumes the user dropped offline. */ USER_OFFLINE_DROPPED = 1, - /** 2: (Live broadcast only.) The client role switched from the host to the audience. */ + /** 2: (`LIVE_BROADCASTING` only.) The client role switched from the host to the audience. */ USER_OFFLINE_BECOME_AUDIENCE = 2, }; /** - States of the RTMP streaming. + States of the RTMP or RTMPS streaming. */ enum RTMP_STREAM_PUBLISH_STATE { - /** The RTMP streaming has not started or has ended. This state is also triggered after you remove an RTMP address from the CDN by calling removePublishStreamUrl. + /** The RTMP or RTMPS streaming has not started or has ended. This state is also triggered after you remove an RTMP or RTMPS stream from the CDN by calling `removePublishStreamUrl`. */ RTMP_STREAM_PUBLISH_STATE_IDLE = 0, - /** The SDK is connecting to Agora's streaming server and the RTMP server. This state is triggered after you call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. + /** The SDK is connecting to Agora's streaming server and the CDN server. This state is triggered after you call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. */ RTMP_STREAM_PUBLISH_STATE_CONNECTING = 1, - /** The RTMP streaming publishes. The SDK successfully publishes the RTMP streaming and returns this state. + /** The RTMP or RTMPS streaming publishes. The SDK successfully publishes the RTMP or RTMPS streaming and returns this state. */ RTMP_STREAM_PUBLISH_STATE_RUNNING = 2, - /** The RTMP streaming is recovering. When exceptions occur to the CDN, or the streaming is interrupted, the SDK tries to resume RTMP streaming and returns this state. + /** The RTMP or RTMPS streaming is recovering. When exceptions occur to the CDN, or the streaming is interrupted, the SDK tries to resume RTMP or RTMPS streaming and returns this state. - If the SDK successfully resumes the streaming, #RTMP_STREAM_PUBLISH_STATE_RUNNING (2) returns. - If the streaming does not resume within 60 seconds or server errors occur, #RTMP_STREAM_PUBLISH_STATE_FAILURE (4) returns. You can also reconnect to the server by calling the \ref IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" and \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" methods. */ RTMP_STREAM_PUBLISH_STATE_RECOVERING = 3, - /** The RTMP streaming fails. See the errCode parameter for the detailed error information. You can also call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method to publish the RTMP streaming again. + /** The RTMP or RTMPS streaming fails. See the errCode parameter for the detailed error information. You can also call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method to publish the RTMP or RTMPS streaming again. */ RTMP_STREAM_PUBLISH_STATE_FAILURE = 4, }; /** - Error codes of the RTMP streaming. + Error codes of the RTMP or RTMPS streaming. */ enum RTMP_STREAM_PUBLISH_ERROR { - /** The RTMP streaming publishes successfully. */ + /** The RTMP or RTMPS streaming publishes successfully. */ RTMP_STREAM_PUBLISH_ERROR_OK = 0, /** Invalid argument used. If, for example, you do not call the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method to configure the LiveTranscoding parameters before calling the addPublishStreamUrl method, the SDK returns this error. Check whether you set the parameters in the *setLiveTranscoding* method properly. */ RTMP_STREAM_PUBLISH_ERROR_INVALID_ARGUMENT = 1, - /** The RTMP streaming is encrypted and cannot be published. */ + /** The RTMP or RTMPS streaming is encrypted and cannot be published. */ RTMP_STREAM_PUBLISH_ERROR_ENCRYPTED_STREAM_NOT_ALLOWED = 2, - /** Timeout for the RTMP streaming. Call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method to publish the streaming again. */ + /** Timeout for the RTMP or RTMPS streaming. Call the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method to publish the streaming again. */ RTMP_STREAM_PUBLISH_ERROR_CONNECTION_TIMEOUT = 3, - /** An error occurs in Agora's streaming server. Call the addPublishStreamUrl method to publish the streaming again. */ + /** An error occurs in Agora's streaming server. Call the `addPublishStreamUrl` method to publish the streaming again. */ RTMP_STREAM_PUBLISH_ERROR_INTERNAL_SERVER_ERROR = 4, - /** An error occurs in the RTMP server. */ + /** An error occurs in the CDN server. */ RTMP_STREAM_PUBLISH_ERROR_RTMP_SERVER_ERROR = 5, - /** The RTMP streaming publishes too frequently. */ + /** The RTMP or RTMPS streaming publishes too frequently. */ RTMP_STREAM_PUBLISH_ERROR_TOO_OFTEN = 6, /** The host publishes more than 10 URLs. Delete the unnecessary URLs before adding new ones. */ RTMP_STREAM_PUBLISH_ERROR_REACH_LIMIT = 7, /** The host manipulates other hosts' URLs. Check your app logic. */ RTMP_STREAM_PUBLISH_ERROR_NOT_AUTHORIZED = 8, - /** Agora's server fails to find the RTMP streaming. */ + /** Agora's server fails to find the RTMP or RTMPS streaming. */ RTMP_STREAM_PUBLISH_ERROR_STREAM_NOT_FOUND = 9, - /** The format of the RTMP streaming URL is not supported. Check whether the URL format is correct. */ + /** The format of the RTMP or RTMPS streaming URL is not supported. Check whether the URL format is correct. */ RTMP_STREAM_PUBLISH_ERROR_FORMAT_NOT_SUPPORTED = 10, }; -/** States of importing an external video stream in a live broadcast. */ +/** Events during the RTMP or RTMPS streaming. */ +enum RTMP_STREAMING_EVENT +{ + /** An error occurs when you add a background image or a watermark image to the RTMP or RTMPS stream. + */ + RTMP_STREAMING_EVENT_FAILED_LOAD_IMAGE = 1, +}; + +/** States of importing an external video stream in the interactive live streaming. */ enum INJECT_STREAM_STATUS { /** 0: The external video stream imported successfully. */ @@ -728,11 +790,31 @@ enum REMOTE_VIDEO_STREAM_TYPE /** 1: Low-stream video. */ REMOTE_VIDEO_STREAM_LOW = 1, }; +/** The brightness level of the video image captured by the local camera. + * + * @since v3.3.0 + */ +enum CAPTURE_BRIGHTNESS_LEVEL_TYPE { + /** -1: The SDK does not detect the brightness level of the video image. + * Wait a few seconds to get the brightness level from `CAPTURE_BRIGHTNESS_LEVEL_TYPE` in the next callback. + */ + CAPTURE_BRIGHTNESS_LEVEL_INVALID = -1, + /** 0: The brightness level of the video image is normal. + */ + CAPTURE_BRIGHTNESS_LEVEL_NORMAL = 0, + /** 1: The brightness level of the video image is too bright. + */ + CAPTURE_BRIGHTNESS_LEVEL_BRIGHT = 1, + /** 2: The brightness level of the video image is too dark. + */ + CAPTURE_BRIGHTNESS_LEVEL_DARK = 2, +}; -/** Use modes of the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. */ -enum RAW_AUDIO_FRAME_OP_MODE_TYPE +/** The use mode of the audio data in the \ref media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" or \ref media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + */ + enum RAW_AUDIO_FRAME_OP_MODE_TYPE { - /** 0: Read-only mode: Users only read the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data without modifying anything. For example, when users acquire the data with the Agora SDK, then push the RTMP streams. */ + /** 0: Read-only mode: Users only read the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data without modifying anything. For example, when users acquire the data with the Agora SDK, then push the RTMP or RTMPS streams. */ RAW_AUDIO_FRAME_OP_MODE_READ_ONLY = 0, /** 1: Write-only mode: Users replace the \ref agora::media::IAudioFrameObserver::AudioFrame "AudioFrame" data with their own data and pass the data to the SDK for encoding. For example, when users acquire the data. */ RAW_AUDIO_FRAME_OP_MODE_WRITE_ONLY = 1, @@ -757,7 +839,7 @@ enum VIDEO_CODEC_PROFILE_TYPE VIDEO_CODEC_PROFILE_BASELINE = 66, /** 77: Main video codec profile. Generally used in mainstream electronics such as MP4 players, portable video players, PSP, and iPads. */ VIDEO_CODEC_PROFILE_MAIN = 77, - /** 100: (Default) High video codec profile. Generally used in high-resolution broadcasts or television. */ + /** 100: (Default) High video codec profile. Generally used in high-resolution live streaming or television. */ VIDEO_CODEC_PROFILE_HIGH = 100, }; @@ -773,11 +855,11 @@ enum VIDEO_CODEC_TYPE { VIDEO_CODEC_E264 = 4, }; -/** Video Codec types. */ -enum VIDEO_CODEC_TRANSCODING_TYPE +/** Video Codec types for publishing streams. */ +enum VIDEO_CODEC_TYPE_FOR_STREAM { - VIDEO_CODEC_H264_TRANSCODING = 1, - VIDEO_CODEC_H265_TRANSCODING = 2, + VIDEO_CODEC_H264_FOR_STREAM = 1, + VIDEO_CODEC_H265_FOR_STREAM = 2, }; /** Audio equalization band frequencies. */ @@ -820,101 +902,421 @@ enum AUDIO_REVERB_TYPE AUDIO_REVERB_STRENGTH = 4, // ([0,100]), the strength of the reverberation }; -/** Local voice changer options. */ +/** + * @deprecated Deprecated from v3.2.0. + * + * Local voice changer options. + */ enum VOICE_CHANGER_PRESET { - /** 0: The original voice (no local voice change). - */ - VOICE_CHANGER_OFF = 0, //Turn off the voice changer - /** 1: An old man's voice. - */ - VOICE_CHANGER_OLDMAN = 1, - /** 2: A little boy's voice. - */ - VOICE_CHANGER_BABYBOY = 2, - /** 3: A little girl's voice. - */ - VOICE_CHANGER_BABYGIRL = 3, - /** 4: The voice of a growling bear. - */ - VOICE_CHANGER_ZHUBAJIE = 4, - /** 5: Ethereal vocal effects. - */ - VOICE_CHANGER_ETHEREAL = 5, - /** 6: Hulk's voice. - */ - VOICE_CHANGER_HULK = 6 + /** + * The original voice (no local voice change). + */ + VOICE_CHANGER_OFF = 0x00000000, //Turn off the voice changer + /** + * The voice of an old man. + */ + VOICE_CHANGER_OLDMAN = 0x00000001, + /** + * The voice of a little boy. + */ + VOICE_CHANGER_BABYBOY = 0x00000002, + /** + * The voice of a little girl. + */ + VOICE_CHANGER_BABYGIRL = 0x00000003, + /** + * The voice of Zhu Bajie, a character in Journey to the West who has a voice like that of a growling bear. + */ + VOICE_CHANGER_ZHUBAJIE = 0x00000004, + /** + * The ethereal voice. + */ + VOICE_CHANGER_ETHEREAL = 0x00000005, + /** + * The voice of Hulk. + */ + VOICE_CHANGER_HULK = 0x00000006, + /** + * A more vigorous voice. + */ + VOICE_BEAUTY_VIGOROUS = 0x00100001,//7, + /** + * A deeper voice. + */ + VOICE_BEAUTY_DEEP = 0x00100002, + /** + * A mellower voice. + */ + VOICE_BEAUTY_MELLOW = 0x00100003, + /** + * Falsetto. + */ + VOICE_BEAUTY_FALSETTO = 0x00100004, + /** + * A fuller voice. + */ + VOICE_BEAUTY_FULL = 0x00100005, + /** + * A clearer voice. + */ + VOICE_BEAUTY_CLEAR = 0x00100006, + /** + * A more resounding voice. + */ + VOICE_BEAUTY_RESOUNDING = 0x00100007, + /** + * A more ringing voice. + */ + VOICE_BEAUTY_RINGING = 0x00100008, + /** + * A more spatially resonant voice. + */ + VOICE_BEAUTY_SPACIAL = 0x00100009, + /** + * (For male only) A more magnetic voice. Do not use it when the speaker is a female; otherwise, voice distortion occurs. + */ + GENERAL_BEAUTY_VOICE_MALE_MAGNETIC = 0x00200001, + /** + * (For female only) A fresher voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs. + */ + GENERAL_BEAUTY_VOICE_FEMALE_FRESH = 0x00200002, + /** + * (For female only) A more vital voice. Do not use it when the speaker is a male; otherwise, voice distortion occurs. + */ + GENERAL_BEAUTY_VOICE_FEMALE_VITALITY = 0x00200003 + }; -/** Local voice reverberation presets. */ +/** @deprecated Deprecated from v3.2.0. + * + * Local voice reverberation presets. + */ enum AUDIO_REVERB_PRESET { - /** 0: The original voice (no local voice reverberation). - */ - AUDIO_REVERB_OFF = 0, // Turn off audio reverb - /** 1: Pop music. - */ - AUDIO_REVERB_POPULAR = 1, - /** 2: R&B. - */ - AUDIO_REVERB_RNB = 2, - /** 3: Rock music. - */ - AUDIO_REVERB_ROCK = 3, - /** 4: Hip-hop. - */ - AUDIO_REVERB_HIPHOP = 4, - /** 5: Pop concert. - */ - AUDIO_REVERB_VOCAL_CONCERT = 5, - /** 6: Karaoke. - */ - AUDIO_REVERB_KTV = 6, - /** 7: Recording studio. - */ - AUDIO_REVERB_STUDIO = 7 + /** + * Turn off local voice reverberation, that is, to use the original voice. + */ + AUDIO_REVERB_OFF = 0x00000000, // Turn off audio reverb + /** + * The reverberation style typical of a KTV venue (enhanced). + */ + AUDIO_REVERB_FX_KTV = 0x00100001, + /** + * The reverberation style typical of a concert hall (enhanced). + */ + AUDIO_REVERB_FX_VOCAL_CONCERT = 0x00100002, + /** + * The reverberation style typical of an uncle's voice. + */ + AUDIO_REVERB_FX_UNCLE = 0x00100003, + /** + * The reverberation style typical of a little sister's voice. + */ + AUDIO_REVERB_FX_SISTER = 0x00100004, + /** + * The reverberation style typical of a recording studio (enhanced). + */ + AUDIO_REVERB_FX_STUDIO = 0x00100005, + /** + * The reverberation style typical of popular music (enhanced). + */ + AUDIO_REVERB_FX_POPULAR = 0x00100006, + /** + * The reverberation style typical of R&B music (enhanced). + */ + AUDIO_REVERB_FX_RNB = 0x00100007, + /** + * The reverberation style typical of the vintage phonograph. + */ + AUDIO_REVERB_FX_PHONOGRAPH = 0x00100008, + /** + * The reverberation style typical of popular music. + */ + AUDIO_REVERB_POPULAR = 0x00000001, + /** + * The reverberation style typical of R&B music. + */ + AUDIO_REVERB_RNB = 0x00000002, + /** + * The reverberation style typical of rock music. + */ + AUDIO_REVERB_ROCK = 0x00000003, + /** + * The reverberation style typical of hip-hop music. + */ + AUDIO_REVERB_HIPHOP = 0x00000004, + /** + * The reverberation style typical of a concert hall. + */ + AUDIO_REVERB_VOCAL_CONCERT = 0x00000005, + /** + * The reverberation style typical of a KTV venue. + */ + AUDIO_REVERB_KTV = 0x00000006, + /** + * The reverberation style typical of a recording studio. + */ + AUDIO_REVERB_STUDIO = 0x00000007, + /** + * The reverberation of the virtual stereo. The virtual stereo is an effect that renders the monophonic + * audio as the stereo audio, so that all users in the channel can hear the stereo voice effect. + * To achieve better virtual stereo reverberation, Agora recommends setting `profile` in `setAudioProfile` + * as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. + */ + AUDIO_VIRTUAL_STEREO = 0x00200001, + /** 1: Electronic Voice.*/ + AUDIO_ELECTRONIC_VOICE = 0x00300001, + /** 1: 3D Voice.*/ + AUDIO_THREEDIM_VOICE = 0x00400001 +}; +/** The options for SDK preset voice beautifier effects. + */ +enum VOICE_BEAUTIFIER_PRESET +{ + /** Turn off voice beautifier effects and use the original voice. + */ + VOICE_BEAUTIFIER_OFF = 0x00000000, + /** A more magnetic voice. + * + * @note Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may experience vocal distortion. + */ + CHAT_BEAUTIFIER_MAGNETIC = 0x01010100, + /** A fresher voice. + * + * @note Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion. + */ + CHAT_BEAUTIFIER_FRESH = 0x01010200, + /** A more vital voice. + * + * @note Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may experience vocal distortion. + */ + CHAT_BEAUTIFIER_VITALITY = 0x01010300, + /** + * @since v3.3.0 + * + * Singing beautifier effect. + * - If you call \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" (SINGING_BEAUTIFIER), you can beautify a male-sounding voice and add a reverberation + * effect that sounds like singing in a small room. Agora recommends not using \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" (SINGING_BEAUTIFIER) + * to process a female-sounding voice; otherwise, you may experience vocal distortion. + * - If you call \ref IRtcEngine::setVoiceBeautifierParameters "setVoiceBeautifierParameters"(SINGING_BEAUTIFIER, param1, param2), you can beautify a male- or + * female-sounding voice and add a reverberation effect. + */ + SINGING_BEAUTIFIER = 0x01020100, + /** A more vigorous voice. + */ + TIMBRE_TRANSFORMATION_VIGOROUS = 0x01030100, + /** A deeper voice. + */ + TIMBRE_TRANSFORMATION_DEEP = 0x01030200, + /** A mellower voice. + */ + TIMBRE_TRANSFORMATION_MELLOW = 0x01030300, + /** A falsetto voice. + */ + TIMBRE_TRANSFORMATION_FALSETTO = 0x01030400, + /** A fuller voice. + */ + TIMBRE_TRANSFORMATION_FULL = 0x01030500, + /** A clearer voice. + */ + TIMBRE_TRANSFORMATION_CLEAR = 0x01030600, + /** A more resounding voice. + */ + TIMBRE_TRANSFORMATION_RESOUNDING = 0x01030700, + /** A more ringing voice. + */ + TIMBRE_TRANSFORMATION_RINGING = 0x01030800 +}; +/** The options for SDK preset audio effects. + */ +enum AUDIO_EFFECT_PRESET +{ + /** Turn off audio effects and use the original voice. + */ + AUDIO_EFFECT_OFF = 0x00000000, + /** An audio effect typical of a KTV venue. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_KTV = 0x02010100, + /** An audio effect typical of a concert hall. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_VOCAL_CONCERT = 0x02010200, + /** An audio effect typical of a recording studio. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_STUDIO = 0x02010300, + /** An audio effect typical of a vintage phonograph. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_PHONOGRAPH = 0x02010400, + /** A virtual stereo effect that renders monophonic audio as stereo audio. + * + * @note Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to + * `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this + * enumerator; otherwise, the enumerator setting does not take effect. + */ + ROOM_ACOUSTICS_VIRTUAL_STEREO = 0x02010500, + /** A more spatial audio effect. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_SPACIAL = 0x02010600, + /** A more ethereal audio effect. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` + * before setting this enumerator. + */ + ROOM_ACOUSTICS_ETHEREAL = 0x02010700, + /** A 3D voice effect that makes the voice appear to be moving around the user. The default cycle period of the 3D + * voice effect is 10 seconds. To change the cycle period, call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" + * after this method. + * + * @note + * - Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` + * or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator; otherwise, the enumerator setting does not take effect. + * - If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect. + */ + ROOM_ACOUSTICS_3D_VOICE = 0x02010800, + /** The voice of an uncle. + * + * @note + * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_UNCLE = 0x02020100, + /** The voice of an old man. + * + * @note + * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting + * this enumerator. + */ + VOICE_CHANGER_EFFECT_OLDMAN = 0x02020200, + /** The voice of a boy. + * + * @note + * - Agora recommends using this enumerator to process a male-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_BOY = 0x02020300, + /** The voice of a young woman. + * + * @note + * - Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_SISTER = 0x02020400, + /** The voice of a girl. + * + * @note + * - Agora recommends using this enumerator to process a female-sounding voice; otherwise, you may not hear the anticipated voice effect. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting + * the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_GIRL = 0x02020500, + /** The voice of Pig King, a character in Journey to the West who has a voice like a growling bear. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_PIGKING = 0x02020600, + /** The voice of Hulk. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + VOICE_CHANGER_EFFECT_HULK = 0x02020700, + /** An audio effect typical of R&B music. + * + * @note Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * set the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator; otherwise, the enumerator setting does not take effect. + */ + STYLE_TRANSFORMATION_RNB = 0x02030100, + /** An audio effect typical of popular music. + * + * @note Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * set the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator; otherwise, the enumerator setting does not take effect. + */ + STYLE_TRANSFORMATION_POPULAR = 0x02030200, + /** A pitch correction effect that corrects the user's pitch based on the pitch of the natural C major scale. + * To change the basic mode and tonic pitch, call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" after this method. + * + * @note To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before + * setting this enumerator. + */ + PITCH_CORRECTION = 0x02040100 }; /** Audio codec profile types. The default value is LC_ACC. */ enum AUDIO_CODEC_PROFILE_TYPE { /** 0: LC-AAC, which is the low-complexity audio codec type. */ - AUDIO_CODEC_PROFILE_LC_AAC = 0, + AUDIO_CODEC_PROFILE_LC_AAC = 0, /** 1: HE-AAC, which is the high-efficiency audio codec type. */ - AUDIO_CODEC_PROFILE_HE_AAC = 1, + AUDIO_CODEC_PROFILE_HE_AAC = 1, }; /** Remote audio states. */ enum REMOTE_AUDIO_STATE { - /** 0: The remote audio is in the default state, probably due to - * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), - * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or - * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). - */ - REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream - /** 1: The first remote audio packet is received. - */ - REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received - /** 2: The remote audio stream is decoded and plays normally, probably - * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), - * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or - * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). - */ - REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends - /** 3: The remote audio is frozen, probably due to - * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). - */ - REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue - /** 4: The remote audio fails to start, probably due to - * #REMOTE_AUDIO_REASON_INTERNAL (0). - */ - REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed + /** 0: The remote audio is in the default state, probably due to + * #REMOTE_AUDIO_REASON_LOCAL_MUTED (3), + * #REMOTE_AUDIO_REASON_REMOTE_MUTED (5), or + * #REMOTE_AUDIO_REASON_REMOTE_OFFLINE (7). + */ + REMOTE_AUDIO_STATE_STOPPED = 0, // Default state, audio is started or remote user disabled/muted audio stream + /** 1: The first remote audio packet is received. + */ + REMOTE_AUDIO_STATE_STARTING = 1, // The first audio frame packet has been received + /** 2: The remote audio stream is decoded and plays normally, probably + * due to #REMOTE_AUDIO_REASON_NETWORK_RECOVERY (2), + * #REMOTE_AUDIO_REASON_LOCAL_UNMUTED (4), or + * #REMOTE_AUDIO_REASON_REMOTE_UNMUTED (6). + */ + REMOTE_AUDIO_STATE_DECODING = 2, // The first remote audio frame has been decoded or fronzen state ends + /** 3: The remote audio is frozen, probably due to + * #REMOTE_AUDIO_REASON_NETWORK_CONGESTION (1). + */ + REMOTE_AUDIO_STATE_FROZEN = 3, // Remote audio is frozen, probably due to network issue + /** 4: The remote audio fails to start, probably due to + * #REMOTE_AUDIO_REASON_INTERNAL (0). + */ + REMOTE_AUDIO_STATE_FAILED = 4, // Remote audio play failed }; /** Remote audio state reasons. */ enum REMOTE_AUDIO_STATE_REASON { - /** 0: Internal reasons. + /** 0: The SDK reports this reason when the audio state changes. */ REMOTE_AUDIO_REASON_INTERNAL = 0, /** 1: Network congestion. @@ -977,18 +1379,48 @@ enum REMOTE_VIDEO_STATE { */ REMOTE_VIDEO_STATE_FAILED = 4 }; - +/** The publishing state. + */ enum STREAM_PUBLISH_STATE { + /** 0: The initial publishing state after joining the channel. + */ PUB_STATE_IDLE = 0, + /** 1: Fails to publish the local stream. Possible reasons: + * - The local user calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" or \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" to stop sending local streams. + * - The local user calls \ref IRtcEngine::disableAudio "disableAudio" or \ref IRtcEngine::disableVideo "disableVideo" to disable the entire audio or video module. + * - The local user calls \ref IRtcEngine::enableLocalAudio "enableLocalAudio(false)" or \ref IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local audio sampling or video capturing. + * - The role of the local user is `AUDIENCE`. + */ PUB_STATE_NO_PUBLISHED = 1, + /** 2: Publishing. + */ PUB_STATE_PUBLISHING = 2, + /** 3: Publishes successfully. + */ PUB_STATE_PUBLISHED = 3 }; - +/** The subscribing state. + */ enum STREAM_SUBSCRIBE_STATE { + /** 0: The initial subscribing state after joining the channel. + */ SUB_STATE_IDLE = 0, + /** 1: Fails to subscribe to the remote stream. Possible reasons: + * - The remote user: + * - Calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" or \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" to stop sending local streams. + * - Calls \ref IRtcEngine::disableAudio "disableAudio" or \ref IRtcEngine::disableVideo "disableVideo" to disable the entire audio or video modules. + * - Calls \ref IRtcEngine::enableLocalAudio "enableLocalAudio(false)" or \ref IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local audio sampling or video capturing. + * - The role of the remote user is `AUDIENCE`. + * - The local user calls the following methods to stop receiving remote streams: + * - Calls \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream(true)", \ref IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams(true)", or \ref IRtcEngine::setDefaultMuteAllRemoteAudioStreams "setDefaultMuteAllRemoteAudioStreams(true)" to stop receiving remote audio streams. + * - Calls \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream(true)", \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams(true)", or \ref IRtcEngine::setDefaultMuteAllRemoteVideoStreams "setDefaultMuteAllRemoteVideoStreams(true)" to stop receiving remote video streams. + */ SUB_STATE_NO_SUBSCRIBED = 1, + /** 2: Subscribing. + */ SUB_STATE_SUBSCRIBING = 2, + /** 3: Subscribes to and receives the remote stream successfully. + */ SUB_STATE_SUBSCRIBED = 3 }; @@ -1021,9 +1453,9 @@ enum XLA_REMOTE_AUDIO_FROZEN_TYPE { XLA_REMOTE_AUDIO_FROZEN_TYPE_MAX = 2, }; -/** The reason of the remote video state change. */ +/** The reason for the remote video state change. */ enum REMOTE_VIDEO_STATE_REASON { - /** 0: Internal reasons. + /** 0: The SDK reports this reason when the video state changes. */ REMOTE_VIDEO_STATE_REASON_INTERNAL = 0, @@ -1055,11 +1487,11 @@ enum REMOTE_VIDEO_STATE_REASON { */ REMOTE_VIDEO_STATE_REASON_REMOTE_OFFLINE = 7, - /** 8: The remote media stream falls back to the audio-only stream due to poor network conditions. + /** 8: The remote audio-and-video stream falls back to the audio-only stream due to poor network conditions. */ REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK = 8, - /** 9: The remote media stream switches back to the video stream after the network conditions improve. + /** 9: The remote audio-only stream switches back to the audio-and-video stream after the network conditions improve. */ REMOTE_VIDEO_STATE_REASON_AUDIO_FALLBACK_RECOVERY = 9 @@ -1124,25 +1556,30 @@ enum STREAM_FALLBACK_OPTIONS STREAM_FALLBACK_OPTION_DISABLED = 0, /** 1: Under poor downlink network conditions, the remote video stream, to which you subscribe, falls back to the low-stream (low resolution and low bitrate) video. You can set this option only in the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. Nothing happens when you set this in the \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" method. */ STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW = 1, - /** 2: Under poor uplink network conditions, the locally published video stream falls back to audio only. + /** 2: Under poor uplink network conditions, the published video stream falls back to audio only. Under poor downlink network conditions, the remote video stream, to which you subscribe, first falls back to the low-stream (low resolution and low bitrate) video; and then to an audio-only stream if the network conditions worsen.*/ STREAM_FALLBACK_OPTION_AUDIO_ONLY = 2, }; - /** Camera capturer configuration. + /** Camera capture preference. */ enum CAPTURER_OUTPUT_PREFERENCE { /** 0: (Default) self-adapts the camera output parameters to the system performance and network conditions to balance CPU consumption and video preview quality. */ CAPTURER_OUTPUT_PREFERENCE_AUTO = 0, - /** 2: Prioritizes the system performance. The SDK chooses the dimension and frame rate of the local camera capture closest to those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". + /** 1: Prioritizes the system performance. The SDK chooses the dimension and frame rate of the local camera capture closest to those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1, /** 2: Prioritizes the local preview quality. The SDK chooses higher camera output parameters to improve the local video preview quality. This option requires extra CPU and RAM usage for video pre-processing. */ CAPTURER_OUTPUT_PREFERENCE_PREVIEW = 2, + /** 3: Allows you to customize the width and height of the video image captured by the local camera. + * + * @since v3.3.0 + */ + CAPTURER_OUTPUT_PREFERENCE_MANUAL = 3, }; /** The priority of the remote user. @@ -1204,7 +1641,7 @@ enum CONNECTION_CHANGED_REASON_TYPE CONNECTION_CHANGED_JOIN_SUCCESS = 1, /** 2: The connection between the SDK and Agora's edge server is interrupted. */ CONNECTION_CHANGED_INTERRUPTED = 2, - /** 3: The connection between the SDK and Agora's edge server is banned by Agora's edge server. */ + /** 3: The user is banned by the server. This error occurs when the user is kicked out the channel from the server. */ CONNECTION_CHANGED_BANNED_BY_SERVER = 3, /** 4: The SDK fails to join the channel for more than 20 minutes and stops reconnecting to the channel. */ CONNECTION_CHANGED_JOIN_FAILED = 4, @@ -1216,13 +1653,19 @@ enum CONNECTION_CHANGED_REASON_TYPE CONNECTION_CHANGED_INVALID_CHANNEL_NAME = 7, /** 8: The connection failed since token is not valid, possibly because: - - The App Certificate for the project is enabled in Dashboard, but you do not use Token when joining the channel. If you enable the App Certificate, you must use a token to join the channel. + - The App Certificate for the project is enabled in Console, but you do not use Token when joining the channel. If you enable the App Certificate, you must use a token to join the channel. - The uid that you specify in the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method is different from the uid that you pass for generating the token. */ CONNECTION_CHANGED_INVALID_TOKEN = 8, /** 9: The connection failed since token is expired. */ CONNECTION_CHANGED_TOKEN_EXPIRED = 9, - /** 10: The connection is rejected by server. */ + /** 10: The connection is rejected by server. This error usually occurs in the following situations: + * - When the user is already in the channel, and still calls the method to join the channel, for example, + * \ref IRtcEngine::joinChannel "joinChannel". + * - When the user tries to join a channel during \ref IRtcEngine::startEchoTest "startEchoTest". Once you + * call \ref IRtcEngine::startEchoTest "startEchoTest", you need to call \ref IRtcEngine::stopEchoTest "stopEchoTest" before joining a channel. + * + */ CONNECTION_CHANGED_REJECTED_BY_SERVER = 10, /** 11: The connection changed to reconnecting since SDK has set a proxy server. */ CONNECTION_CHANGED_SETTING_PROXY_SERVER = 11, @@ -1232,6 +1675,8 @@ enum CONNECTION_CHANGED_REASON_TYPE CONNECTION_CHANGED_CLIENT_IP_ADDRESS_CHANGED = 13, /** 14: Timeout for the keep-alive of the connection between the SDK and Agora's edge server. The connection state changes to CONNECTION_STATE_RECONNECTING(4). */ CONNECTION_CHANGED_KEEP_ALIVE_TIMEOUT = 14, + /** 15: In cloud proxy mode, the proxy server connection interrupted. */ + CONNECTION_CHANGED_PROXY_SERVER_INTERRUPTED = 15, }; /** Network type. */ @@ -1243,7 +1688,7 @@ enum NETWORK_TYPE NETWORK_TYPE_DISCONNECTED = 0, /** 1: The network type is LAN. */ NETWORK_TYPE_LAN = 1, - /** 2: The network type is Wi-Fi(including hotspots). */ + /** 2: The network type is Wi-Fi (including hotspots). */ NETWORK_TYPE_WIFI = 2, /** 3: The network type is mobile 2G. */ NETWORK_TYPE_MOBILE_2G = 3, @@ -1251,9 +1696,28 @@ enum NETWORK_TYPE NETWORK_TYPE_MOBILE_3G = 4, /** 5: The network type is mobile 4G. */ NETWORK_TYPE_MOBILE_4G = 5, - /** 6: The network type is mobile 5G. */ - NETWORK_TYPE_MOBILE_5G = 6, }; +/// @cond +/** + * The reason for the upload failure. + * + * @since v3.3.0 + */ +enum UPLOAD_ERROR_REASON +{ + /** 0: The log file is successfully uploaded. + */ + UPLOAD_SUCCESS = 0, + /** + * 1: Network error. Check the network connection and call \ref IRtcEngine::uploadLogFile "uploadLogFile" again to upload the log file. + */ + UPLOAD_NET_ERROR = 1, + /** + * 2: An error occurs in the Agora server. Try uploading the log files later. + */ + UPLOAD_SERVER_ERROR = 2, +}; +/// @endcond /** States of the last-mile network probe test. */ enum LASTMILE_PROBE_RESULT_STATE { @@ -1286,7 +1750,37 @@ enum AUDIO_ROUTE_TYPE { AUDIO_ROUTE_LOUDSPEAKER = 4, /** Bluetooth headset. */ - AUDIO_ROUTE_BLUETOOTH = 5 + AUDIO_ROUTE_BLUETOOTH = 5, + /** USB peripheral (macOS only). + */ + AUDIO_ROUTE_USB = 6, + /** HDMI peripheral (macOS only). + */ + AUDIO_ROUTE_HDMI = 7, + /** DisplayPort peripheral (macOS only). + */ + AUDIO_ROUTE_DISPLAYPORT = 8, + /** Apple AirPlay (macOS only). + */ + AUDIO_ROUTE_AIRPLAY = 9, +}; + +/** The cloud proxy type. + * + * @since v3.3.0 + */ +enum CLOUD_PROXY_TYPE { + /** 0: Do not use the cloud proxy. + */ + NONE_PROXY = 0, + /** 1: The cloud proxy for the UDP protocol. + */ + UDP_PROXY = 1, + /// @cond + /** 2: The cloud proxy for the TCP (encrypted) protocol. + */ + TCP_PROXY = 2, + /// @endcond }; #if (defined(__APPLE__) && TARGET_OS_IOS) @@ -1305,13 +1799,22 @@ enum AUDIO_SESSION_OPERATION_RESTRICTION { }; #endif -/** The uplink or downlink last-mile network probe test result. */ +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) +enum CAMERA_DIRECTION { + /** The rear camera. */ + CAMERA_REAR = 0, + /** The front camera. */ + CAMERA_FRONT = 1, +}; +#endif + +/** The uplink or downlink last-mile network probe test result. */ struct LastmileProbeOneWayResult { /** The packet loss rate (%). */ unsigned int packetLossRate; /** The network jitter (ms). */ unsigned int jitter; - /* The estimated available bandwidth (Kbps). */ + /* The estimated available bandwidth (bps). */ unsigned int availableBandwidth; }; @@ -1329,7 +1832,7 @@ struct LastmileProbeResult{ /** Configurations of the last-mile network probe test. */ struct LastmileProbeConfig { - /** Sets whether or not to test the uplink network. Some users, for example, the audience in a Live-broadcast channel, do not need such a test: + /** Sets whether or not to test the uplink network. Some users, for example, the audience in a `LIVE_BROADCASTING` channel, do not need such a test: - true: test. - false: do not test. */ bool probeUplink; @@ -1337,50 +1840,68 @@ struct LastmileProbeConfig { - true: test. - false: do not test. */ bool probeDownlink; - /** The expected maximum sending bitrate (Kbps) of the local user. The value ranges between 100 and 5000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ + /** The expected maximum sending bitrate (bps) of the local user. The value ranges between 100000 and 5000000. We recommend setting this parameter according to the bitrate value set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". */ unsigned int expectedUplinkBitrate; - /** The expected maximum receiving bitrate (Kbps) of the local user. The value ranges between 100 and 5000. */ + /** The expected maximum receiving bitrate (bps) of the local user. The value ranges between 100000 and 5000000. */ unsigned int expectedDownlinkBitrate; }; -/** Properties of the audio volume information. - - An array containing the user ID and volume information for each speaker. +/** The volume information of users. */ struct AudioVolumeInfo { - /** - User ID of the speaker. The uid of the local user is 0. The user ID may come from different RtcConnection. - */ + /** + * The user ID. + * - In the local user's callback, `uid = 0`. + * - In the remote users' callback, `uid` is the ID of a remote user whose instantaneous volume is one of the three highest. + */ uid_t uid; - /** The volume of the speaker. The volume ranges between 0 (lowest volume) and 255 (highest volume). - */ + /** The volume of each user after audio mixing. The value ranges between 0 (lowest volume) and 255 (highest volume). + * In the local user's callback, `volume = totalVolume`. + */ unsigned int volume; - /** Whether current signal contains human voice. - */ + /** Voice activity status of the local user. + * - `0`: The local user is not speaking. + * - `1`: The local user is speaking. + * + * @note + * - The `vad` parameter cannot report the voice activity status of remote users. + * In the remote users' callback, `vad` is always `0`. + * - To use this parameter, you must set the `report_vad` parameter to `true` + * when calling \ref agora::rtc::IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication". + */ unsigned int vad; - /** The channel ID, which indicates which channel the speaker is in. + /** The name of the channel where the user is in. */ const char * channelId; }; - +/** The detailed options of a user. + */ +struct ClientRoleOptions +{ + /** The latency level of an audience member in interactive live streaming. See #AUDIENCE_LATENCY_LEVEL_TYPE. + */ + AUDIENCE_LATENCY_LEVEL_TYPE audienceLatencyLevel; + ClientRoleOptions() + : audienceLatencyLevel(AUDIENCE_LATENCY_LEVEL_ULTRA_LOW_LATENCY) {} +}; /** Statistics of the channel. */ struct RtcStats { - /** - Call duration (s), represented by an aggregate value. - */ + /** + * Call duration of the local user in seconds, represented by an aggregate value. + */ unsigned int duration; /** - Total number of bytes transmitted, represented by an aggregate value. + * Total number of bytes transmitted, represented by an aggregate value. */ unsigned int txBytes; /** - Total number of bytes received, represented by an aggregate value. + * Total number of bytes received, represented by an aggregate value. */ unsigned int rxBytes; - /** Total number of audio bytes sent (bytes), represented + /** Total number of audio bytes sent (bytes), represented * by an aggregate value. */ unsigned int txAudioBytes; @@ -1398,73 +1919,80 @@ struct RtcStats unsigned int rxVideoBytes; /** - Transmission bitrate (Kbps), represented by an instantaneous value. + * Transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txKBitRate; /** - Receive bitrate (Kbps), represented by an instantaneous value. + * Receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxKBitRate; /** - Audio receive bitrate (Kbps), represented by an instantaneous value. + * Audio receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxAudioKBitRate; /** - Audio transmission bitrate (Kbps), represented by an instantaneous value. + * Audio transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txAudioKBitRate; /** - Video receive bitrate (Kbps), represented by an instantaneous value. + * Video receive bitrate (Kbps), represented by an instantaneous value. */ unsigned short rxVideoKBitRate; /** - Video transmission bitrate (Kbps), represented by an instantaneous value. + * Video transmission bitrate (Kbps), represented by an instantaneous value. */ unsigned short txVideoKBitRate; /** Client-server latency (ms) */ unsigned short lastmileDelay; /** The packet loss rate (%) from the local client to Agora's edge server, - * before network countermeasures. + * before using the anti-packet-loss method. */ unsigned short txPacketLossRate; /** The packet loss rate (%) from Agora's edge server to the local client, - * before network countermeasures. + * before using the anti-packet-loss method. */ unsigned short rxPacketLossRate; /** Number of users in the channel. - - - Communication profile: The number of users in the channel. - - Live broadcast profile: - - - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. - - If the user is a host: The number of users in the channel = The number of hosts in the channel. + * + * - `COMMUNICATION` profile: The number of users in the channel. + * - `LIVE_BROADCASTING` profile: + * - If the local user is an audience: The number of users in the channel = The number of hosts in the channel + 1. + * - If the user is a host: The number of users in the channel = The number of hosts in the channel. */ unsigned int userCount; /** - Application CPU usage (%). + * Application CPU usage (%). */ double cpuAppUsage; /** System CPU usage (%). + + In the multi-kernel environment, this member represents the average CPU usage. + The value **=** 100 **-** System Idle Progress in Task Manager (%). */ double cpuTotalUsage; - /** gateway Rtt + /** The round-trip time delay from the client to the local router. */ int gatewayRtt; /** - Application memory usage (%). + * The memory usage ratio of the app (%). + * + * @note This value is for reference only. Due to system limitations, you may not get the value of this member. */ double memoryAppUsageRatio; /** - System memory usage (%). + * The memory usage ratio of the system (%). + * + * @note This value is for reference only. Due to system limitations, you may not get the value of this member. */ double memoryTotalUsageRatio; /** - Application memory size (KB). + * The memory usage of the app (KB). + * + * @note This value is for reference only. Due to system limitations, you may not get the value of this member. */ int memoryAppUsageInKbytes; - RtcStats() : duration(0) , txBytes(0) @@ -1501,8 +2029,43 @@ enum QUALITY_ADAPT_INDICATION { /** The quality worsens because the network bandwidth decreases. */ ADAPT_DOWN_BANDWIDTH = 2, }; +/** Quality of experience (QoE) of the local user when receiving a remote audio stream. + * + * @since v3.3.0 + */ +enum EXPERIENCE_QUALITY_TYPE +{ + /** 0: QoE of the local user is good. */ + EXPERIENCE_QUALITY_GOOD = 0, + /** 1: QoE of the local user is poor. */ + EXPERIENCE_QUALITY_BAD = 1, +}; +/** + * The reason for poor QoE of the local user when receiving a remote audio stream. + * + * @since v3.3.0 + */ +enum EXPERIENCE_POOR_REASON { + /** 0: No reason, indicating good QoE of the local user. + */ + EXPERIENCE_REASON_NONE = 0, + /** 1: The remote user's network quality is poor. + */ + REMOTE_NETWORK_QUALITY_POOR = 1, + /** 2: The local user's network quality is poor. + */ + LOCAL_NETWORK_QUALITY_POOR = 2, + /** 4: The local user's Wi-Fi or mobile network signal is weak. + */ + WIRELESS_SIGNAL_POOR = 4, + /** 8: The local user enables both Wi-Fi and bluetooth, and their signals interfere with each other. + * As a result, audio transmission quality is undermined. + */ + WIFI_BLUETOOTH_COEXIST = 8, +}; +/** The error code in CHANNEL_MEDIA_RELAY_ERROR. */ enum CHANNEL_MEDIA_RELAY_ERROR { /** 0: The state is normal. */ @@ -1510,25 +2073,31 @@ enum CHANNEL_MEDIA_RELAY_ERROR { /** 1: An error occurs in the server response. */ RELAY_ERROR_SERVER_ERROR_RESPONSE = 1, - /** 2: No server response. You can call the + /** 2: No server response. + * + * You can call the * \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method to * leave the channel. + * + * This error can also occur if your project has not enabled co-host token + * authentication. Contact support@agora.io to enable the co-host token + * authentication service before starting a channel media relay. */ RELAY_ERROR_SERVER_NO_RESPONSE = 2, /** 3: The SDK fails to access the service, probably due to limited * resources of the server. */ RELAY_ERROR_NO_RESOURCE_AVAILABLE = 3, - /** 4: The server fails to join the source channel. + /** 4: Fails to send the relay request. */ RELAY_ERROR_FAILED_JOIN_SRC = 4, - /** 5: The server fails to join the destination channel. + /** 5: Fails to accept the relay request. */ RELAY_ERROR_FAILED_JOIN_DEST = 5, - /** 6: The server fails to receive the data from the source channel. + /** 6: The server fails to receive the media stream. */ RELAY_ERROR_FAILED_PACKET_RECEIVED_FROM_SRC = 6, - /** 7: The source channel fails to transmit data. + /** 7: The server fails to send the media stream. */ RELAY_ERROR_FAILED_PACKET_SENT_TO_DEST = 7, /** 8: The SDK disconnects from the server due to poor network @@ -1547,6 +2116,7 @@ enum CHANNEL_MEDIA_RELAY_ERROR { RELAY_ERROR_DEST_TOKEN_EXPIRED = 11, }; +/** The event code in CHANNEL_MEDIA_RELAY_EVENT. */ enum CHANNEL_MEDIA_RELAY_EVENT { /** 0: The user disconnects from the server due to poor network * connections. @@ -1588,8 +2158,11 @@ enum CHANNEL_MEDIA_RELAY_EVENT { RELAY_EVENT_VIDEO_PROFILE_UPDATE = 11, }; +/** The state code in CHANNEL_MEDIA_RELAY_STATE. */ enum CHANNEL_MEDIA_RELAY_STATE { - /** 0: The SDK is initializing. + /** 0: The initial state. After you successfully stop the channel media + * relay by calling \ref IRtcEngine::stopChannelMediaRelay "stopChannelMediaRelay", + * the \ref IRtcEngineEventHandler::onChannelMediaRelayStateChanged "onChannelMediaRelayStateChanged" callback returns this state. */ RELAY_STATE_IDLE = 0, /** 1: The SDK tries to relay the media stream to the destination channel. @@ -1609,11 +2182,11 @@ enum CHANNEL_MEDIA_RELAY_STATE { struct LocalVideoStats { /** Bitrate (Kbps) sent in the reported interval, which does not include - * the bitrate of the re-transmission video after packet loss. + * the bitrate of the retransmission video after packet loss. */ int sentBitrate; /** Frame rate (fps) sent in the reported interval, which does not include - * the frame rate of the re-transmission video after packet loss. + * the frame rate of the retransmission video after packet loss. */ int sentFrameRate; /** The encoder output frame rate (fps) of the local video. @@ -1642,7 +2215,7 @@ struct LocalVideoStats /** The height of the encoding frame (px). */ int encodedFrameHeight; - /** The value of the sent frame rate, represented by an aggregate value. + /** The value of the sent frames, represented by an aggregate value. */ int encodedFrameCount; /** The codec type of the local video: @@ -1650,71 +2223,78 @@ struct LocalVideoStats * - VIDEO_CODEC_H264 = 2: (Default) H.264. */ VIDEO_CODEC_TYPE codecType; - - /** The packet loss rate (%) from the local client to Agora's edge server, - * before network countermeasures. - */ + /** The video packet loss rate (%) from the local client to the Agora edge server before applying the anti-packet loss strategies. + */ unsigned short txPacketLossRate; /** The capture frame rate (fps) of the local video. */ int captureFrameRate; - /** The PSNR point to show the quality of video, nomal level is in [20,40]. - */ - int videoQualityPoint; + /** The brightness level of the video image captured by the local camera. See #CAPTURE_BRIGHTNESS_LEVEL_TYPE. + * + * @since v3.3.0 + */ + CAPTURE_BRIGHTNESS_LEVEL_TYPE captureBrightnessLevel; }; /** Statistics of the remote video stream. */ struct RemoteVideoStats { - /** +/** User ID of the remote user sending the video streams. */ - uid_t uid; - /** **DEPRECATED** Time delay (ms). +uid_t uid; +/** **DEPRECATED** Time delay (ms). + * + * In scenarios where audio and video is synchronized, you can use the value of + * `networkTransportDelay` and `jitterBufferDelay` in `RemoteAudioStats` to know the delay statistics of the remote video. */ - int delay; -/** - Width (pixels) of the video stream. +int delay; +/** Width (pixels) of the video stream. */ - int width; - /** +int width; +/** Height (pixels) of the video stream. */ - int height; - /** +int height; +/** Bitrate (Kbps) received since the last count. */ - int receivedBitrate; - /** The decoder output frame rate (fps) of the remote video. - */ - int decoderOutputFrameRate; - /** The render output frame rate (fps) of the remote video. - */ - int rendererOutputFrameRate; - /** Packet loss rate (%) of the remote video stream after network - * countermeasures. - */ - int packetLossRate; - REMOTE_VIDEO_STREAM_TYPE rxStreamType; - /** - The total freeze time (ms) of the remote video stream after the remote user joins the channel. - In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when - the time interval between two adjacent renderable video frames is more than 500 ms. - */ - int totalFrozenTime; - /** - The total video freeze time as a percentage (%) of the total time when the video is available. - */ - int frozenRate; - /** - * The total active time (ms) of the remote video stream after the remote user joins the channel. - */ - int totalActiveTime; - /** - * The total active time (ms) of the remote video stream after the remote user publish the video stream. - */ - int publishDuration; +int receivedBitrate; +/** The decoder output frame rate (fps) of the remote video. + */ +int decoderOutputFrameRate; +/** The render output frame rate (fps) of the remote video. + */ +int rendererOutputFrameRate; +/** Packet loss rate (%) of the remote video stream after using the anti-packet-loss method. + */ +int packetLossRate; +/** The type of the remote video stream: #REMOTE_VIDEO_STREAM_TYPE + */ +REMOTE_VIDEO_STREAM_TYPE rxStreamType; +/** + The total freeze time (ms) of the remote video stream after the remote user joins the channel. + In a video session where the frame rate is set to no less than 5 fps, video freeze occurs when + the time interval between two adjacent renderable video frames is more than 500 ms. + */ +int totalFrozenTime; +/** + The total video freeze time as a percentage (%) of the total time when the video is available. + */ +int frozenRate; +/** + The total time (ms) when the remote user in the Communication profile or the remote + broadcaster in the Live-broadcast profile neither stops sending the video stream nor + disables the video module after joining the channel. + + @since v3.0.1 +*/ +int totalActiveTime; +/** + * The total publish duration (ms) of the remote video stream. + */ +int publishDuration; }; /** Audio statistics of the local user */ @@ -1729,8 +2309,7 @@ struct LocalAudioStats /** The average sending bitrate (Kbps). */ int sentBitrate; - /** The packet loss rate (%) from the local client to Agora's edge server, - * before network countermeasures. + /** The audio packet loss rate (%) from the local client to the Agora edge server before applying the anti-packet loss strategies. */ unsigned short txPacketLossRate; }; @@ -1751,7 +2330,7 @@ struct RemoteAudioStats /** Network delay (ms) from the receiver to the jitter buffer. */ int jitterBufferDelay; - /** Packet loss rate in the reported interval. + /** The audio frame loss rate in the reported interval. */ int audioLossRate; /** The number of channels. @@ -1765,19 +2344,30 @@ struct RemoteAudioStats * reported interval. */ int receivedBitrate; /** The total freeze time (ms) of the remote audio stream after the remote user joins the channel. In a session, audio freeze occurs when the audio frame loss rate reaches 4%. - * Agora uses 2 seconds as an audio piece unit to calculate the audio freeze time. The total audio freeze time = The audio freeze number × 2 seconds */ int totalFrozenTime; /** The total audio freeze time as a percentage (%) of the total time when the audio is available. */ int frozenRate; - /** - * The total active time (ms) of the remote audio stream after the remote user joins the channel. + /** The total time (ms) when the remote user in the `COMMUNICATION` profile or the remote host in + the `LIVE_BROADCASTING` profile neither stops sending the audio stream nor disables the audio module after joining the channel. */ int totalActiveTime; /** - * The total active time (ms) of the remote audio stream after the remote user publish the audio stream. + * The total publish duration (ms) of the remote audio stream. */ int publishDuration; + /** + * Quality of experience (QoE) of the local user when receiving a remote audio stream. See #EXPERIENCE_QUALITY_TYPE. + * + * @since v3.3.0 + */ + int qoeQuality; + /** + * The reason for poor QoE of the local user when receiving a remote audio stream. See #EXPERIENCE_POOR_REASON. + * + * @since v3.3.0 + */ + int qualityChangedReason; }; /** @@ -1798,17 +2388,17 @@ struct VideoDimensions { /** (Recommended) The standard bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. - In this mode, the bitrates differ between the live broadcast and communication profiles: + In this mode, the bitrates differ between the interactive live streaming and communication profiles: - - Communication profile: The video bitrate is the same as the base bitrate. - - Live broadcast profile: The video bitrate is twice the base bitrate. + - `COMMUNICATION` profile: The video bitrate is the same as the base bitrate. + - `LIVE_BROADCASTING` profile: The video bitrate is twice the base bitrate. */ const int STANDARD_BITRATE = 0; /** The compatible bitrate set in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. - The bitrate remains the same regardless of the channel profile. If you choose this mode in the Live-broadcast profile, the video frame rate may be lower than the set value. + The bitrate remains the same regardless of the channel profile. If you choose this mode in the `LIVE_BROADCASTING` profile, the video frame rate may be lower than the set value. */ const int COMPATIBLE_BITRATE = -1; @@ -1835,48 +2425,51 @@ struct VideoEncoderConfiguration { Choose one of the following options: - #STANDARD_BITRATE: (Recommended) The standard bitrate. - - The Communication profile: the encoding bitrate equals the base bitrate. - - The Live-broadcast profile: the encoding bitrate is twice the base bitrate. + - the `COMMUNICATION` profile: the encoding bitrate equals the base bitrate. + - the `LIVE_BROADCASTING` profile: the encoding bitrate is twice the base bitrate. - #COMPATIBLE_BITRATE: The compatible bitrate: the bitrate stays the same regardless of the profile. - The Communication profile prioritizes smoothness, while the Live-broadcast profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. + the `COMMUNICATION` profile prioritizes smoothness, while the `LIVE_BROADCASTING` profile prioritizes video quality (requiring a higher bitrate). We recommend setting the bitrate mode as #STANDARD_BITRATE to address this difference. + + The following table lists the recommended video encoder configurations, where the base bitrate applies to the `COMMUNICATION` profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. - The following table lists the recommended video encoder configurations, where the base bitrate applies to the Communication profile. Set your bitrate based on this table. If you set a bitrate beyond the proper range, the SDK automatically sets it to within the range. + @note + In the following table, **Base Bitrate** applies to the `COMMUNICATION` profile, and **Live Bitrate** applies to the `LIVE_BROADCASTING` profile. - | Resolution | Frame Rate (fps) | Base Bitrate (Kbps, for Communication) | Live Bitrate (Kbps, for Live Broadcast)| + | Resolution | Frame Rate (fps) | Base Bitrate (Kbps) | Live Bitrate (Kbps) | |------------------------|------------------|----------------------------------------|----------------------------------------| - | 160 × 120 | 15 | 65 | 130 | - | 120 × 120 | 15 | 50 | 100 | - | 320 × 180 | 15 | 140 | 280 | - | 180 × 180 | 15 | 100 | 200 | - | 240 × 180 | 15 | 120 | 240 | - | 320 × 240 | 15 | 200 | 400 | - | 240 × 240 | 15 | 140 | 280 | - | 424 × 240 | 15 | 220 | 440 | - | 640 × 360 | 15 | 400 | 800 | - | 360 × 360 | 15 | 260 | 520 | - | 640 × 360 | 30 | 600 | 1200 | - | 360 × 360 | 30 | 400 | 800 | - | 480 × 360 | 15 | 320 | 640 | - | 480 × 360 | 30 | 490 | 980 | - | 640 × 480 | 15 | 500 | 1000 | - | 480 × 480 | 15 | 400 | 800 | - | 640 × 480 | 30 | 750 | 1500 | - | 480 × 480 | 30 | 600 | 1200 | - | 848 × 480 | 15 | 610 | 1220 | - | 848 × 480 | 30 | 930 | 1860 | - | 640 × 480 | 10 | 400 | 800 | - | 1280 × 720 | 15 | 1130 | 2260 | - | 1280 × 720 | 30 | 1710 | 3420 | - | 960 × 720 | 15 | 910 | 1820 | - | 960 × 720 | 30 | 1380 | 2760 | - | 1920 × 1080 | 15 | 2080 | 4160 | - | 1920 × 1080 | 30 | 3150 | 6300 | - | 1920 × 1080 | 60 | 4780 | 6500 | - | 2560 × 1440 | 30 | 4850 | 6500 | - | 2560 × 1440 | 60 | 6500 | 6500 | - | 3840 × 2160 | 30 | 6500 | 6500 | - | 3840 × 2160 | 60 | 6500 | 6500 | + | 160 * 120 | 15 | 65 | 130 | + | 120 * 120 | 15 | 50 | 100 | + | 320 * 180 | 15 | 140 | 280 | + | 180 * 180 | 15 | 100 | 200 | + | 240 * 180 | 15 | 120 | 240 | + | 320 * 240 | 15 | 200 | 400 | + | 240 * 240 | 15 | 140 | 280 | + | 424 * 240 | 15 | 220 | 440 | + | 640 * 360 | 15 | 400 | 800 | + | 360 * 360 | 15 | 260 | 520 | + | 640 * 360 | 30 | 600 | 1200 | + | 360 * 360 | 30 | 400 | 800 | + | 480 * 360 | 15 | 320 | 640 | + | 480 * 360 | 30 | 490 | 980 | + | 640 * 480 | 15 | 500 | 1000 | + | 480 * 480 | 15 | 400 | 800 | + | 640 * 480 | 30 | 750 | 1500 | + | 480 * 480 | 30 | 600 | 1200 | + | 848 * 480 | 15 | 610 | 1220 | + | 848 * 480 | 30 | 930 | 1860 | + | 640 * 480 | 10 | 400 | 800 | + | 1280 * 720 | 15 | 1130 | 2260 | + | 1280 * 720 | 30 | 1710 | 3420 | + | 960 * 720 | 15 | 910 | 1820 | + | 960 * 720 | 30 | 1380 | 2760 | + | 1920 * 1080 | 15 | 2080 | 4160 | + | 1920 * 1080 | 30 | 3150 | 6300 | + | 1920 * 1080 | 60 | 4780 | 6500 | + | 2560 * 1440 | 30 | 4850 | 6500 | + | 2560 * 1440 | 60 | 6500 | 6500 | + | 3840 * 2160 | 30 | 6500 | 6500 | + | 3840 * 2160 | 60 | 6500 | 6500 | */ int bitrate; @@ -1884,20 +2477,21 @@ struct VideoEncoderConfiguration { The SDK automatically adjusts the encoding bitrate to adapt to the network conditions. Using a value greater than the default value forces the video encoder to output high-quality images but may cause more packet loss and hence sacrifice the smoothness of the video transmission. That said, unless you have special requirements for image quality, Agora does not recommend changing this value. - @note This parameter applies only to the Live-broadcast profile. + @note This parameter applies only to the `LIVE_BROADCASTING` profile. */ int minBitrate; /** The video orientation mode of the video: #ORIENTATION_MODE. */ ORIENTATION_MODE orientationMode; - /** the video encoding degradation preference under limited bandwidth: #DEGRADATION_PREFERENCE. + /** The video encoding degradation preference under limited bandwidth: #DEGRADATION_PREFERENCE. */ DEGRADATION_PREFERENCE degradationPreference; /** Sets the mirror mode of the published local video stream. It only affects the video that the remote user sees. See #VIDEO_MIRROR_MODE_TYPE - @note: The SDK disables the mirror mode by default. + @note The SDK disables the mirror mode by default. */ VIDEO_MIRROR_MODE_TYPE mirrorMode; + VideoEncoderConfiguration( const VideoDimensions& d, FRAME_RATE f, int b, ORIENTATION_MODE m, VIDEO_MIRROR_MODE_TYPE mr = VIDEO_MIRROR_MODE_AUTO) @@ -1925,52 +2519,53 @@ struct VideoEncoderConfiguration { {} }; -/** The video properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. +/** The video and audio properties of the user displaying the video in the CDN live. Agora supports a maximum of 17 transcoding users in a CDN streaming channel. */ typedef struct TranscodingUser { /** User ID of the user displaying the video in the CDN live. */ uid_t uid; -/** Horizontal position from the top left corner of the video frame. +/** Horizontal position (pixel) of the video frame relative to the top left corner. */ int x; - /** Vertical position from the top left corner of the video frame. + /** Vertical position (pixel) of the video frame relative to the top left corner. */ int y; - /** Width of the video frame. The default value is 360. + /** Width (pixel) of the video frame. The default value is 360. */ int width; - /** Height of the video frame. The default value is 640. + /** Height (pixel) of the video frame. The default value is 640. */ int height; - /** Layer position of the video frame. The value ranges between 0 and 100. + /** The layer index of the video frame. An integer. The value range is [0, 100]. - - 0: (Default) Lowest - - 100: Highest + - 0: (Default) Bottom layer. + - 100: Top layer. @note - If zOrder is beyond this range, the SDK reports #ERR_INVALID_ARGUMENT. - As of v2.3, the SDK supports zOrder = 0. */ int zOrder; - /** Transparency of the video frame in CDN live. The value ranges between 0 and 1.0: + /** The transparency level of the user's video. The value ranges between 0 and 1.0: - 0: Completely transparent - 1.0: (Default) Opaque */ double alpha; - /** The audio channel of the sound. The default value is 0: + /** The audio channel where the host's audio is located. The value range is [0,5]. - - 0: (Default) Supports dual channels at most, depending on the upstream of the broadcaster. - - 1: The audio stream of the broadcaster uses the FL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 2: The audio stream of the broadcaster uses the FC audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 3: The audio stream of the broadcaster uses the FR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 4: The audio stream of the broadcaster uses the BL audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. - - 5: The audio stream of the broadcaster uses the BR audio channel. If the upstream of the broadcaster uses multiple audio channels, these channels are mixed into mono first. + - 0: (Default) Supports dual channels at most, depending on the upstream of the host. + - 1: The host's audio uses the FL audio channel. If the host's upstream uses multiple audio channels, these channels are mixed into mono first. + - 2: The host's audio uses the FC audio channel. If the host's upstream uses multiple audio channels, these channels are mixed into mono first. + - 3: The host's audio uses the FR audio channel. If the host's upstream uses multiple audio channels, these channels are mixed into mono first. + - 4: The host's audio uses the BL audio channel. If the host's upstream uses multiple audio channels, these channels are mixed into mono first. + - 5: The host's audio uses the BR audio channel. If the host's upstream uses multiple audio channels, these channels are mixed into mono first. + - `0xFF` or a value greater than `5`: The host's audio is muted. The Agora server removes the host's audio. - @note If your setting is not 0, you may need a specialized player. + @note If the value is not `0`, a special player is required. */ int audioChannel; TranscodingUser() @@ -1998,35 +2593,61 @@ typedef struct RtcImage { width(0), height(0) {} - /** HTTP/HTTPS URL address of the image on the broadcasting video. The maximum length of this parameter is 1024 bytes. */ + /** HTTP/HTTPS URL address of the image on the live video. The maximum length of this parameter is 1024 bytes. */ const char* url; - /** Horizontal position of the image from the upper left of the broadcasting video. */ + /** Horizontal position of the image from the upper left of the live video. */ int x; - /** Vertical position of the image from the upper left of the broadcasting video. */ + /** Vertical position of the image from the upper left of the live video. */ int y; - /** Width of the image on the broadcasting video. */ + /** Width of the image on the live video. */ int width; - /** Height of the image on the broadcasting video. */ + /** Height of the image on the live video. */ int height; } RtcImage; +/// @cond +/** The configuration for advanced features of the RTMP or RTMPS streaming with transcoding. + */ +typedef struct LiveStreamAdvancedFeature { + LiveStreamAdvancedFeature() : featureName(NULL) , opened(false) { + } + /** The advanced feature for high-quality video with a lower bitrate. */ + const char* LBHQ = "lbhq"; + /** The advanced feature for the optimized video encoder. */ + const char* VEO = "veo"; + + /** The name of the advanced feature. It contains LBHQ and VEO. + */ + const char* featureName; + + /** Whether to enable the advanced feature: + * - true: Enable the advanced feature. + * - false: (Default) Disable the advanced feature. + */ + bool opened; +} LiveStreamAdvancedFeature; +/// @endcond /** A struct for managing CDN live audio/video transcoding settings. */ typedef struct LiveTranscoding { - /** Width of the video. The default value is 360. The minimum value of width × height is 16 × 16. - */ + /** The width of the video in pixels. The default value is 360. + * - When pushing video streams to the CDN, ensure that `width` is at least 64; otherwise, the Agora server adjusts the value to 64. + * - When pushing audio streams to the CDN, set `width` and `height` as 0. + */ int width; - /** Height of the video. The default value is 640. The minimum value of width × height is 16 × 16. + /** The height of the video in pixels. The default value is 640. + * - When pushing video streams to the CDN, ensure that `height` is at least 64; otherwise, the Agora server adjusts the value to 64. + * - When pushing audio streams to the CDN, set `width` and `height` as 0. */ int height; /** Bitrate of the CDN live output video stream. The default value is 400 Kbps. - Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. + Set this parameter according to the Video Bitrate Table. If you set a bitrate beyond the proper range, the SDK automatically adapts it to a value within the range. */ int videoBitrate; - /** Frame rate of the output video stream set for the CDN live broadcast. The default value is 15 fps. + /** Frame rate of the output video stream set for the CDN live streaming. The default value is 15 fps, and the value range is (0,30]. - @note Agora adjusts all values over 30 to 30. + @note The Agora server adjusts any value over 30 to 30. */ int videoFramerate; @@ -2042,17 +2663,17 @@ typedef struct LiveTranscoding { int videoGop; /** Self-defined video codec profile: #VIDEO_CODEC_PROFILE_TYPE. - @note If you set this parameter to other values, Agora adjusts it to the default value of 100. + @note If you set this parameter to other values, Agora adjusts it to the default value of 100. */ VIDEO_CODEC_PROFILE_TYPE videoCodecProfile; - /** The background color in RGB hex value. Value only, do not include a #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). + /** The background color in RGB hex value. Value only. Do not include a preceeding #. For example, 0xFFB6C1 (light pink). The default value is 0x000000 (black). */ unsigned int backgroundColor; /** video codec type */ - VIDEO_CODEC_TRANSCODING_TYPE videoCodecType; + VIDEO_CODEC_TYPE_FOR_STREAM videoCodecType; - /** The number of users in the live broadcast. + /** The number of users in the interactive live streaming. */ unsigned int userCount; /** TranscodingUser @@ -2060,16 +2681,16 @@ typedef struct LiveTranscoding { TranscodingUser *transcodingUsers; /** Reserved property. Extra user-defined information to send SEI for the H.264/H.265 video stream to the CDN live client. Maximum length: 4096 Bytes. - For more information on SEI frame, see [SEI-related questions](https://docs.agora.io/cn/Agora%20Platform/live_related_faq?platform=%E7%9B%B4%E6%92%AD%E7%9B%B8%E5%85%B3#sei). + For more information on SEI frame, see [SEI-related questions](https://docs.agora.io/en/faq/sei). */ const char *transcodingExtraInfo; - /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or FLV metadata. + /** **DEPRECATED** The metadata sent to the CDN live client defined by the RTMP or HTTP-FLV metadata. */ const char *metadata; /** The watermark image added to the CDN live publishing stream. - Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. + Ensure that the format of the image is PNG. Once a watermark image is added, the audience of the CDN live publishing stream can see the watermark image. See RtcImage. */ RtcImage* watermark; /** The background image added to the CDN live publishing stream. @@ -2083,21 +2704,29 @@ typedef struct LiveTranscoding { /** Bitrate of the CDN live audio output stream. The default value is 48 Kbps, and the highest value is 128. */ int audioBitrate; - /** Agora's self-defined audio-channel types. We recommend choosing option 1 or 2. A special player is required if you choose option 3, 4, or 5: + /** The numbder of audio channels for the CDN live stream. Agora recommends choosing 1 (mono), or 2 (stereo) audio channels. Special players are required if you choose option 3, 4, or 5: - - 1: (Default) Mono - - 2: Two-channel stereo - - 3: Three-channel stereo - - 4: Four-channel stereo - - 5: Five-channel stereo + - 1: (Default) Mono. + - 2: Stereo. + - 3: Three audio channels. + - 4: Four audio channels. + - 5: Five audio channels. */ int audioChannels; /** Self-defined audio codec profile: #AUDIO_CODEC_PROFILE_TYPE. */ AUDIO_CODEC_PROFILE_TYPE audioCodecProfile; + /// @cond + /** Advanced features of the RTMP or RTMPS streaming with transcoding. See LiveStreamAdvancedFeature. + * + * @since v3.1.0 + */ + LiveStreamAdvancedFeature* advancedFeatures; - + /** The number of enabled advanced features. The default value is 0. */ + unsigned int advancedFeatureCount; + /// @endcond LiveTranscoding() : width(360) , height(640) @@ -2107,7 +2736,7 @@ typedef struct LiveTranscoding { , videoGop(30) , videoCodecProfile(VIDEO_CODEC_PROFILE_HIGH) , backgroundColor(0x000000) - , videoCodecType(VIDEO_CODEC_H264_TRANSCODING) + , videoCodecType(VIDEO_CODEC_H264_FOR_STREAM) , userCount(0) , transcodingUsers(NULL) , transcodingExtraInfo(NULL) @@ -2118,6 +2747,8 @@ typedef struct LiveTranscoding { , audioBitrate(48) , audioChannels(1) , audioCodecProfile(AUDIO_CODEC_PROFILE_LC_AAC) + , advancedFeatures(NULL) + , advancedFeatureCount(0) {} } LiveTranscoding; @@ -2125,41 +2756,105 @@ typedef struct LiveTranscoding { */ struct CameraCapturerConfiguration{ - /** Camera capturer preference settings.See: #CAPTURER_OUTPUT_PREFERENCE. */ + /** Camera capturer preference settings. See: #CAPTURER_OUTPUT_PREFERENCE. */ CAPTURER_OUTPUT_PREFERENCE preference; + /** The width (px) of the video image captured by the local camera. + * To customize the width of the video image, set `preference` as #CAPTURER_OUTPUT_PREFERENCE_MANUAL (3) first, + * and then use `captureWidth`. + * + * @since v3.3.0 + */ + int captureWidth; + /** The height (px) of the video image captured by the local camera. + * To customize the height of the video image, set `preference` as #CAPTURER_OUTPUT_PREFERENCE_MANUAL (3) first, + * and then use `captureHeight`. + * + * @since v3.3.0 + */ + int captureHeight; + #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** Camera direction settings (for Android/iOS only). See: #CAMERA_DIRECTION. */ + CAMERA_DIRECTION cameraDirection; + #endif + + CameraCapturerConfiguration() + :preference(CAPTURER_OUTPUT_PREFERENCE_AUTO) + ,captureWidth(640) + ,captureHeight(480) + {} + + CameraCapturerConfiguration(int width, int height) + :preference(CAPTURER_OUTPUT_PREFERENCE_MANUAL) + ,captureWidth(width) + ,captureHeight(height) + {} }; - -/** Configuration of the imported live broadcast voice or video stream. +/** The configurations for the data stream. + * + * @since v3.3.0 + * + * |`syncWithAudio` |`ordered`| SDK behaviors| + * |--------------|--------|-------------| + * | false | false |The SDK triggers the `onStreamMessage` callback immediately after the receiver receives a data packet | + * | true | false |

If the data packet delay is within the audio delay, the SDK triggers the `onStreamMessage` callback when the synchronized audio packet is played out.

If the data packet delay exceeds the audio delay, the SDK triggers the `onStreamMessage` callback as soon as the data packet is received. In this case, the data packet is not synchronized with the audio packet.

| + * | false | true |

If the delay of a data packet is within five seconds, the SDK corrects the order of the data packet.

If the delay of a data packet exceeds five seconds, the SDK discards the data packet.

| + * | true | true |

If the delay of a data packet is within the audio delay, the SDK corrects the order of the data packet.

If the delay of a data packet exceeds the audio delay, the SDK discards this data packet.

| + */ +struct DataStreamConfig { + /** Whether to synchronize the data packet with the published audio packet. + * + * - true: Synchronize the data packet with the audio packet. + * - false: Do not synchronize the data packet with the audio packet. + * + * When you set the data packet to synchronize with the audio, then if the data + * packet delay is within the audio delay, the SDK triggers the `onStreamMessage` callback when + * the synchronized audio packet is played out. Do not set this parameter as `true` if you + * need the receiver to receive the data packet immediately. Agora recommends that you set + * this parameter to `true` only when you need to implement specific functions, for example + * lyric synchronization. + */ + bool syncWithAudio; + /** Whether the SDK guarantees that the receiver receives the data in the sent order. + * + * - true: Guarantee that the receiver receives the data in the sent order. + * - false: Do not guarantee that the receiver receives the data in the sent order. + * + * Do not set this parameter to `true` if you need the receiver to receive the data immediately. + */ + bool ordered; +}; +/** Configuration of the injected media stream. */ struct InjectStreamConfig { - /** Width of the added stream in the live broadcast. The default value is 0 (same width as the original stream). + /** Width of the injected stream in the interactive live streaming. The default value is 0 (same width as the original stream). */ int width; - /** Height of the added stream in the live broadcast. The default value is 0 (same height as the original stream). + /** Height of the injected stream in the interactive live streaming. The default value is 0 (same height as the original stream). */ int height; - /** Video GOP of the added stream in the live broadcast in frames. The default value is 30 fps. + /** Video GOP (in frames) of the injected stream in the interactive live streaming. The default value is 30 fps. */ int videoGop; - /** Video frame rate of the added stream in the live broadcast. The default value is 15 fps. + /** Video frame rate of the injected stream in the interactive live streaming. The default value is 15 fps. */ int videoFramerate; - /** Video bitrate of the added stream in the live broadcast. The default value is 400 Kbps. + /** Video bitrate of the injected stream in the interactive live streaming. The default value is 400 Kbps. @note The setting of the video bitrate is closely linked to the resolution. If the video bitrate you set is beyond a reasonable range, the SDK sets it within a reasonable range. */ int videoBitrate; - /** Audio-sample rate of the added stream in the live broadcast: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. + /** Audio-sample rate of the injected stream in the interactive live streaming: #AUDIO_SAMPLE_RATE_TYPE. The default value is 48000 Hz. @note We recommend setting the default value. */ AUDIO_SAMPLE_RATE_TYPE audioSampleRate; - /** Audio bitrate of the added stream in the live broadcast. The default value is 48. + /** Audio bitrate of the injected stream in the interactive live streaming. The default value is 48. @note We recommend setting the default value. */ int audioBitrate; - /** Audio channels in the live broadcast. + /** Audio channels in the interactive live streaming. + - 1: (Default) Mono - 2: Two-channel stereo @@ -2183,50 +2878,45 @@ struct InjectStreamConfig { /** The definition of ChannelMediaInfo. */ struct ChannelMediaInfo { - /** The channel name. The default value is NULL, which means that the SDK - * applies the current channel name. + /** The channel name. */ - const char* channelName; - /** The token that enables the user to join the channel. The default value - * is NULL, which means that the SDK applies the current token. + const char* channelName; + /** The token that enables the user to join the channel. */ - const char* token; + const char* token; /** The user ID. - * - * @note - * String user accounts are not supported in media stream relay. */ - uid_t uid; + uid_t uid; }; /** The definition of ChannelMediaRelayConfiguration. */ struct ChannelMediaRelayConfiguration { - /** Pointer to the source channel: ChannelMediaInfo. - * - * @note - * - `uid`: ID of the user whose media stream you want to relay. We - * recommend setting it as 0, which means that the SDK relays the media - * stream of the current broadcaster. - * - If you do not use a token, we recommend using the default values of - * the parameters in ChannelMediaInfo. - * - If you use a token, set uid as 0, and ensure that the token is - * generated with the uid set as 0. - */ - ChannelMediaInfo *srcInfo; - /** Pointer to the destination channel: ChannelMediaInfo. If you want to - * relay the media stream to multiple channels, define as many - * ChannelMediaInfo structs (at most four). - * - * @note `uid`: ID of the user who is in the source channel. - */ - ChannelMediaInfo *destInfos; + /** Pointer to the information of the source channel: ChannelMediaInfo. It contains the following members: + * - `channelName`: The name of the source channel. The default value is `NULL`, which means the SDK applies the name of the current channel. + * - `uid`: The unique ID to identify the relay stream in the source channel. The default value is 0, which means the SDK generates a random UID. You must set it as 0. + * - `token`: The token for joining the source channel. It is generated with the `channelName` and `uid` you set in `srcInfo`. + * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. + * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`, and the `uid` must be set as 0. + */ + ChannelMediaInfo *srcInfo; + /** Pointer to the information of the destination channel: ChannelMediaInfo. It contains the following members: + * - `channelName`: The name of the destination channel. + * - `uid`: The unique ID to identify the relay stream in the destination channel. The value ranges from 0 to (232-1). + * To avoid UID conflicts, this `uid` must be different from any other UIDs in the destination channel. The default + * value is 0, which means the SDK generates a random UID. Do not set this parameter as the `uid` of the host in + * the destination channel, and ensure that this `uid` is different from any other `uid` in the channel. + * - `token`: The token for joining the destination channel. It is generated with the `channelName` and `uid` you set in `destInfos`. + * - If you have not enabled the App Certificate, set this parameter as the default value `NULL`, which means the SDK applies the App ID. + * - If you have enabled the App Certificate, you must use the `token` generated with the `channelName` and `uid`. + */ + ChannelMediaInfo *destInfos; /** The number of destination channels. The default value is 0, and the - * value range is [0,4). Ensure that the value of this parameter + * value range is [0,4]. Ensure that the value of this parameter * corresponds to the number of ChannelMediaInfo structs you define in * `destInfos`. */ - int destCount; + int destCount; ChannelMediaRelayConfiguration() : srcInfo(nullptr) @@ -2241,10 +2931,10 @@ enum RTMP_STREAM_LIFE_CYCLE_TYPE { /** Bind to the channel lifecycle. If all hosts leave the channel, the CDN live streaming stops after 30 seconds. */ - RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, + RTMP_STREAM_LIFE_CYCLE_BIND2CHANNEL = 1, /** Bind to the owner of the RTMP stream. If the owner leaves the channel, the CDN live streaming stops immediately. */ - RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, + RTMP_STREAM_LIFE_CYCLE_BIND2OWNER = 2, }; /** Content hints for screen sharing. @@ -2262,8 +2952,8 @@ enum VideoContentHint CONTENT_HINT_DETAILS }; - /** The relative location of the region to the screen or window. - */ +/** The relative location of the region to the screen or window. + */ struct Rectangle { /** The horizontal offset from the top-left corner. @@ -2302,63 +2992,119 @@ typedef struct Rect { Rect(int t, int l, int b, int r): top(t), left(l), bottom(b), right(r) {} } Rect; +/** The options of the watermark image to be added. */ +typedef struct WatermarkOptions { + /** Sets whether or not the watermark image is visible in the local video preview: + * - true: (Default) The watermark image is visible in preview. + * - false: The watermark image is not visible in preview. + */ + bool visibleInPreview; + /** + * The watermark position in the landscape mode. See Rectangle. + * For detailed information on the landscape mode, see the advanced guide *Video Rotation*. + */ + Rectangle positionInLandscapeMode; + /** + * The watermark position in the portrait mode. See Rectangle. + * For detailed information on the portrait mode, see the advanced guide *Video Rotation*. + */ + Rectangle positionInPortraitMode; + + WatermarkOptions() + : visibleInPreview(true) + , positionInLandscapeMode(0, 0, 0, 0) + , positionInPortraitMode(0, 0, 0, 0) + {} +} WatermarkOptions; + /** Screen sharing encoding parameters. */ struct ScreenCaptureParameters { - /** The maximum encoding dimensions of the shared region in terms of width × height. + /** The maximum encoding dimensions of the shared region in terms of width * height. - The default value is 1920 × 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. + The default value is 1920 * 1080 pixels, that is, 2073600 pixels. Agora uses the value of this parameter to calculate the charges. - If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: + If the aspect ratio is different between the encoding dimensions and screen dimensions, Agora applies the following algorithms for encoding. Suppose the encoding dimensions are 1920 x 1080: - - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 × 1000, the SDK uses 1000 × 1000 for encoding. - - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 × 1500, the SDK uses the maximum value under 1920 × 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 × 1080. + - If the value of the screen dimensions is lower than that of the encoding dimensions, for example, 1000 * 1000, the SDK uses 1000 * 1000 for encoding. + - If the value of the screen dimensions is higher than that of the encoding dimensions, for example, 2000 * 1500, the SDK uses the maximum value under 1920 * 1080 with the aspect ratio of the screen dimension (4:3) for encoding, that is, 1440 * 1080. */ VideoDimensions dimensions; /** The frame rate (fps) of the shared region. - The default value is 5. We do not recommend setting this to a value greater than 15. + The default value is 5. We do not recommend setting this to a value greater than 15. */ int frameRate; /** The bitrate (Kbps) of the shared region. - The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). + The default value is 0 (the SDK works out a bitrate according to the dimensions of the current screen). */ int bitrate; /** Sets whether or not to capture the mouse for screen sharing: - - true: (Default) Capture the mouse. - - false: Do not capture the mouse. + - true: (Default) Capture the mouse. + - false: Do not capture the mouse. */ bool captureMouseCursor; + /** Whether to bring the window to the front when calling \ref IRtcEngine::startScreenCaptureByWindowId "startScreenCaptureByWindowId" to share the window: + * - true: Bring the window to the front. + * - false: (Default) Do not bring the window to the front. + */ + bool windowFocus; + /** A list of IDs of windows to be blocked. + * + * When calling \ref IRtcEngine::startScreenCaptureByScreenRect "startScreenCaptureByScreenRect" to start screen sharing, you can use this parameter to block the specified windows. + * When calling \ref IRtcEngine::updateScreenCaptureParameters "updateScreenCaptureParameters" to update the configuration for screen sharing, you can use this parameter to dynamically block the specified windows during screen sharing. + */ + view_t* excludeWindowList; + /** The number of windows to be blocked. + */ + int excludeWindowCount; - ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true) {} - ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c) {} - ScreenCaptureParameters(int width, int height, int f, int b, bool c) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c) {} + ScreenCaptureParameters() : dimensions(1920, 1080), frameRate(5), bitrate(STANDARD_BITRATE), captureMouseCursor(true), windowFocus(false), excludeWindowList(NULL), excludeWindowCount(0) {} + ScreenCaptureParameters(const VideoDimensions& d, int f, int b, bool c, bool focus, view_t *ex = NULL, int cnt = 0) : dimensions(d), frameRate(f), bitrate(b), captureMouseCursor(c), windowFocus(focus), excludeWindowList(ex), excludeWindowCount(cnt) {} + ScreenCaptureParameters(int width, int height, int f, int b, bool c, bool focus, view_t *ex = NULL, int cnt = 0) : dimensions(width, height), frameRate(f), bitrate(b), captureMouseCursor(c), windowFocus(focus), excludeWindowList(ex), excludeWindowCount(cnt) {} }; /** Video display settings of the VideoCanvas class. */ struct VideoCanvas { - /** Video display window (view). - */ + /** Video display window (view). + */ view_t view; - /** Video display mode: #RENDER_MODE_TYPE. - */ + /** The rendering mode of the video view. See #RENDER_MODE_TYPE + */ int renderMode; - /** Channel ID of the User ID. If NULL, it means the default channelId joined. + /** The unique channel name for the AgoraRTC session in the string format. The string length must be less than 64 bytes. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + + @note + - The default value is the empty string "". Use the default value if the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IRtcEngine class. The `VideoCanvas` struct defines the video canvas of the user in the channel. + - If the user joins the channel using the \ref IRtcEngine::joinChannel "joinChannel" method in the IChannel class, set this parameter as the `channelId` of the `IChannel` object. The `VideoCanvas` struct defines the video canvas of the user in the channel with the specified channel ID. */ char channelId[MAX_CHANNEL_ID_LENGTH]; + /** The user ID. */ uid_t uid; void *priv; // private data (underlying video engine denotes it) + /** The mirror mode of the video view. See VIDEO_MIRROR_MODE_TYPE + @note + - For the mirror mode of the local video view: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. + - For the mirror mode of the remote video view: The SDK disables the mirror mode by default. + */ + VIDEO_MIRROR_MODE_TYPE mirrorMode; VideoCanvas() : view(NULL) , renderMode(RENDER_MODE_HIDDEN) , uid(0) , priv(NULL) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) { channelId[0] = '\0'; } @@ -2367,19 +3113,38 @@ struct VideoCanvas , renderMode(m) , uid(u) , priv(NULL) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) { channelId[0] = '\0'; } VideoCanvas(view_t v, int m, const char *ch, uid_t u) - : view(v) - , renderMode(m) - , uid(u) - , priv(NULL) + : view(v) + , renderMode(m) + , uid(u) + , priv(NULL) + , mirrorMode(VIDEO_MIRROR_MODE_AUTO) + { + strncpy(channelId, ch, MAX_CHANNEL_ID_LENGTH); + channelId[MAX_CHANNEL_ID_LENGTH - 1] = '\0'; + } + VideoCanvas(view_t v, int rm, uid_t u, VIDEO_MIRROR_MODE_TYPE mm) + : view(v) + , renderMode(rm) + , uid(u) + , priv(NULL) + , mirrorMode(mm) { - if (strlen(ch) >= MAX_CHANNEL_ID_LENGTH) - return; - memcpy(channelId, ch, strlen(ch)); - channelId[strlen(ch)] = '\0'; + channelId[0] = '\0'; + } + VideoCanvas(view_t v, int rm, const char *ch, uid_t u, VIDEO_MIRROR_MODE_TYPE mm) + : view(v) + , renderMode(rm) + , uid(u) + , priv(NULL) + , mirrorMode(mm) + { + strncpy(channelId, ch, MAX_CHANNEL_ID_LENGTH); + channelId[MAX_CHANNEL_ID_LENGTH - 1] = '\0'; } }; @@ -2426,8 +3191,17 @@ BeautyOptions() lighteningContrastLevel(LIGHTENING_CONTRAST_NORMAL) {} }; +/** + * The UserInfo struct. + */ struct UserInfo { + /** + * The user ID. + */ uid_t uid; + /** + * The user account. + */ char userAccount[MAX_USER_ACCOUNT_LENGTH]; UserInfo() : uid(0) { @@ -2435,6 +3209,52 @@ struct UserInfo { } }; +/** + * Regions for connetion. + */ +enum AREA_CODE { + /** + * Mainland China. + */ + AREA_CODE_CN = 0x00000001, + /** + * North America. + */ + AREA_CODE_NA = 0x00000002, + /** + * Europe. + */ + AREA_CODE_EU = 0x00000004, + /** + * Asia, excluding Mainland China. + */ + AREA_CODE_AS = 0x00000008, + /** + * Japan. + */ + AREA_CODE_JP = 0x00000010, + /** + * India. + */ + AREA_CODE_IN = 0x00000020, + /** + * (Default) Global. + */ + AREA_CODE_GLOB = 0xFFFFFFFF +}; + +enum ENCRYPTION_CONFIG { + /** + * - 1: Force set master key and mode; + * - 0: Not force set, checking whether encryption plugin exists + */ + ENCRYPTION_FORCE_SETTING = (1 << 0), + /** + * - 1: Force not encrypting packet; + * - 0: Not force encrypting; + */ + ENCRYPTION_FORCE_DISABLE_PACKET = (1 << 1) +}; /** Definition of IPacketObserver. */ class IPacketObserver @@ -2442,48 +3262,162 @@ class IPacketObserver public: /** Definition of Packet. */ - struct Packet - { + struct Packet + { /** Buffer address of the sent or received data. + * @note Agora recommends that the value of buffer is more than 2048 bytes, otherwise, you may meet undefined behaviors such as a crash. */ - const unsigned char* buffer; + const unsigned char* buffer; /** Buffer size of the sent or received data. */ - unsigned int size; - }; - /** Occurs when the local user sends an audio packet. + unsigned int size; + }; + /** Occurs when the local user sends an audio packet. @param packet The sent audio packet. See Packet. @return - true: The audio packet is sent successfully. - false: The audio packet is discarded. */ - virtual bool onSendAudioPacket(Packet& packet) = 0; - /** Occurs when the local user sends a video packet. + virtual bool onSendAudioPacket(Packet& packet) = 0; + /** Occurs when the local user sends a video packet. @param packet The sent video packet. See Packet. @return - true: The video packet is sent successfully. - false: The video packet is discarded. */ - virtual bool onSendVideoPacket(Packet& packet) = 0; - /** Occurs when the local user receives an audio packet. + virtual bool onSendVideoPacket(Packet& packet) = 0; + /** Occurs when the local user receives an audio packet. @param packet The received audio packet. See Packet. @return - true: The audio packet is received successfully. - false: The audio packet is discarded. - */ - virtual bool onReceiveAudioPacket(Packet& packet) = 0; - /** Occurs when the local user receives a video packet. + */ + virtual bool onReceiveAudioPacket(Packet& packet) = 0; + /** Occurs when the local user receives a video packet. @param packet The received video packet. See Packet. @return - true: The video packet is received successfully. - false: The video packet is discarded. - */ - virtual bool onReceiveVideoPacket(Packet& packet) = 0; + */ + virtual bool onReceiveVideoPacket(Packet& packet) = 0; +}; + + +#if defined(_WIN32) +/** The capture type of the custom video source. + */ +enum VIDEO_CAPTURE_TYPE { + /** Unknown type. + */ + VIDEO_CAPTURE_UNKNOWN, + /** (Default) Video captured by the camera. + */ + VIDEO_CAPTURE_CAMERA, + /** Video for screen sharing. + */ + VIDEO_CAPTURE_SCREEN, +}; + +/** The IVideoFrameConsumer class. The SDK uses it to receive the video frame that you capture. + */ +class IVideoFrameConsumer { +public: + /** Receives the raw video frame. + * + * @note Ensure that the video frame type that you specify in this method is the same as that in the \ref agora::rtc::IVideoSource::getBufferType "getBufferType" callback. + * + * @param buffer The video buffer. + * @param frameType The video frame type. See \ref agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT "VIDEO_PIXEL_FORMAT". + * @param width The width (px) of the video frame. + * @param height The height (px) of the video frame. + * @param rotation The angle (degree) at which the video frame rotates clockwise. If you set the rotation angle, the + * SDK rotates the video frame after receiving it. You can set the rotation angle as `0`, `90`, `180`, and `270`. + * @param timestamp The Unix timestamp (ms) of the video frame. You must set a timestamp for each video frame. + */ + virtual void consumeRawVideoFrame(const unsigned char *buffer, agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT frameType, int width, int height, int rotation, long timestamp) = 0; +}; + +/** The IVideoSource class. You can use it to customize the video source. + */ +class IVideoSource { +public: + /** Notification for initializing the custom video source. + * + * The SDK triggers this callback to remind you to initialize the custom video source. After receiving this callback, + * you can do some preparation, such as enabling the camera, and then use the return value to tell the SDK whether the + * custom video source is prepared. + * + * @param consumer An IVideoFrameConsumer object that the SDK passes to you. You need to reserve this object and use it + * to send the video frame to the SDK once the custom video source is started. See IVideoFrameConsumer. + * + * @return + * - true: The custom video source is initialized. + * - false: The custom video source is not ready or fails to initialize. The SDK stops and reports the error. + */ + virtual bool onInitialize(IVideoFrameConsumer *consumer) = 0; + + /** Notification for disabling the custom video source. + * + * The SDK triggers this callback to remind you to disable the custom video source device. This callback tells you + * that the SDK is about to release the IVideoFrameConsumer object. Ensure that you no longer use IVideoFrameConsumer + * after receiving this callback. + */ + virtual void onDispose() = 0; + + /** Notification for starting the custom video source. + * + * The SDK triggers this callback to remind you to start the custom video source for capturing video. The SDK uses + * IVideoFrameConsumer to receive the video frame that you capture after the video source is started. You must use + * the return value to tell the SDK whether the custom video source is started. + * + * @return + * - true: The custom video source is started. + * - false: The custom video source fails to start. The SDK stops and reports the error. + */ + virtual bool onStart() = 0; + + /** Notification for stopping capturing video. + * + * The SDK triggers this callback to remind you to stop capturing video. This callback tells you that the SDK is about + * to stop using IVideoFrameConsumer to receive the video frame that you capture. + */ + virtual void onStop() = 0; + + /** Gets the video frame type. + * + * Before you initialize the custom video source, the SDK triggers this callback to query the video frame type. You + * must specify the video frame type in the return value and then pass it to the SDK. + * + * @note Ensure that the video frame type that you specify in this callback is the same as that in the \ref agora::rtc::IVideoFrameConsumer::consumeRawVideoFrame "consumeRawVideoFrame" method. + * + * @return \ref agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT "VIDEO_PIXEL_FORMAT" + */ + virtual agora::media::ExternalVideoFrame::VIDEO_PIXEL_FORMAT getBufferType() = 0; + /** Gets the capture type of the custom video source. + * + * Before you initialize the custom video source, the SDK triggers this callback to query the capture type of the video source. + * You must specify the capture type in the return value and then pass it to the SDK. The SDK enables the corresponding video + * processing algorithm according to the capture type after receiving the video frame. + * + * @return #VIDEO_CAPTURE_TYPE + */ + virtual VIDEO_CAPTURE_TYPE getVideoCaptureType() = 0; + /** Gets the content hint of the custom video source. + * + * If you specify the custom video source as a screen-sharing video, the SDK triggers this callback to query the + * content hint of the video source before you initialize the video source. You must specify the content hint in the + * return value and then pass it to the SDK. The SDK enables the corresponding video processing algorithm according + * to the content hint after receiving the video frame. + * + * @return \ref agora::rtc::VideoContentHint "VideoContentHint" + */ + virtual VideoContentHint getVideoContentHint() = 0; }; +#endif /** The SDK uses the IRtcEngineEventHandler interface class to send callbacks to the application. The application inherits the methods of this interface class to retrieve these callbacks. @@ -2520,7 +3454,7 @@ class IRtcEngineEventHandler (void)msg; } - /** Occurs when a user joins a specified channel. + /** Occurs when a user joins a channel. This callback notifies the application that a user joins a specified channel when the application calls the \ref IRtcEngine::joinChannel "joinChannel" method. @@ -2564,7 +3498,7 @@ class IRtcEngineEventHandler (void)stats; } - /** Occurs when the user role switches in a live broadcast. For example, from a host to an audience or vice versa. + /** Occurs when the user role switches in the interactive live streaming. For example, from a host to an audience or vice versa. This callback notifies the application of a user role switch when the application calls the \ref IRtcEngine::setClientRole "setClientRole" method. @@ -2575,10 +3509,10 @@ class IRtcEngineEventHandler virtual void onClientRoleChanged(CLIENT_ROLE_TYPE oldRole, CLIENT_ROLE_TYPE newRole) { } - /** Occurs when a user or host joins the channel. + /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) joins the channel. - - Communication profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. - - Live-broadcast profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. + - `COMMUNICATION` profile: This callback notifies the application that another user joins the channel. If other users are already in the channel, the SDK also reports to the application on the existing users. + - `LIVE_BROADCASTING` profile: This callback notifies the application that the host joins the channel. If other hosts are already in the channel, the SDK also reports to the application on the existing hosts. We recommend limiting the number of hosts to 17. The SDK triggers this callback under one of the following circumstances: - A remote user/host joins the channel by calling the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. @@ -2586,7 +3520,7 @@ class IRtcEngineEventHandler - A remote user/host rejoins the channel after a network interruption. - The host injects an online media stream into the channel by calling the \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method. - @note In the Live-broadcast profile: + @note In the `LIVE_BROADCASTING` profile: - The host receives this callback when another host joins the channel. - The audience in the channel receives this callback when a new host joins the channel. - When a web application joins the channel, the SDK triggers this callback as long as the web application publishes streams. @@ -2599,12 +3533,12 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a remote user (Communication)/host (Live Broadcast) leaves the channel. + /** Occurs when a remote user (`COMMUNICATION`)/ host (`LIVE_BROADCASTING`) leaves the channel. Reasons why the user is offline: - Leave the channel: When the user/host leaves the channel, the user/host sends a goodbye message. When the message is received, the SDK assumes that the user/host leaves the channel. - - Drop offline: When no data packet of the user or host is received for a certain period of time (20 seconds for the Communication profile, and more for the Live-broadcast profile), the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using a signaling system for more reliable offline detection. + - Drop offline: When no data packet of the user or host is received for a certain period of time, the SDK assumes that the user/host drops offline. Unreliable network connections may lead to false detections, so we recommend using the Agora RTM SDK for more reliable offline detection. @param uid User ID of the user leaving the channel or going offline. @param reason Reason why the user is offline: #USER_OFFLINE_REASON_TYPE. @@ -2646,7 +3580,7 @@ class IRtcEngineEventHandler - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. - For both callbacks, the SDK tries to reconnect to the server until the application calls the \ref IRtcEngine::leaveChannel "leaveChannel" method. + If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. */ virtual void onConnectionInterrupted() {} @@ -2660,7 +3594,7 @@ class IRtcEngineEventHandler - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionInterrupted "onConnectionInterrupted" callback when it loses connection with the server for more than four seconds after it successfully joins the channel. - The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onConnectionLost "onConnectionLost" callback when it loses connection with the server for more than 10 seconds, whether or not it joins the channel. - For both callbacks, the SDK tries to reconnect to the server until the application calls the \ref IRtcEngine::leaveChannel "leaveChannel" method. + If the SDK fails to rejoin the channel 20 minutes after being disconnected from Agora's edge server, the SDK stops rejoining the channel. */ virtual void onConnectionLost() {} @@ -2685,9 +3619,12 @@ class IRtcEngineEventHandler /** Occurs when the token expires. - After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses connection with the Agora server due to network issues, the token may expire after a certain period of time and a new token may be required to reconnect to the server. + After a token is specified by calling the \ref IRtcEngine::joinChannel "joinChannel" method, if the SDK losses + connection with the Agora server due to network issues, the token may expire after a certain period of time and a + new token may be required to reconnect to the server. - This callback notifies the application to generate a new token. Call the \ref IRtcEngine::renewToken "renewToken" method to renew the token. + Once you receive this callback, generate a new token on your app server, and call + \ref agora::rtc::IRtcEngine::renewToken "renewToken" to pass the new token to the SDK. */ virtual void onRequestToken() { } @@ -2720,10 +3657,11 @@ class IRtcEngineEventHandler (void)lost; } - /** Reports the statistics of the current call session once every two - * seconds. - * - * @param stats Pointer to the RTC engine statistics: RtcStats. + /** Reports the statistics of the current call. + + The SDK triggers this callback once every two seconds after the user joins the channel. + + @param stats Statistics of the IRtcEngine: RtcStats. */ virtual void onRtcStats(const RtcStats& stats) { (void)stats; @@ -2734,7 +3672,7 @@ class IRtcEngineEventHandler Last mile refers to the connection between the local device and Agora's edge server. This callback reports once every two seconds the last mile network conditions of each user in the channel. If a channel includes multiple users, the SDK triggers this callback as many times. @param uid User ID. The network quality of the user with this @p uid is reported. If @p uid is 0, the local network quality is reported. - @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 × 480 and a frame rate of 15 fps in the Live-broadcast profile, but may be inadequate for resolutions higher than 1280 × 720. See #QUALITY_TYPE. + @param txQuality Uplink transmission quality rating of the user in terms of the transmission bitrate, packet loss rate, average RTT (Round-Trip Time), and jitter of the uplink network. @p txQuality is a quality rating helping you understand how well the current uplink network conditions can support the selected VideoEncoderConfiguration. For example, a 1000 Kbps uplink network may be adequate for video frames with a resolution of 640 * 480 and a frame rate of 15 fps in the `LIVE_BROADCASTING` profile, but may be inadequate for resolutions higher than 1280 * 720. See #QUALITY_TYPE. @param rxQuality Downlink network quality rating of the user in terms of the packet loss rate, average RTT, and jitter of the downlink network. See #QUALITY_TYPE. */ virtual void onNetworkQuality(uid_t uid, int txQuality, int rxQuality) { @@ -2743,21 +3681,22 @@ class IRtcEngineEventHandler (void)rxQuality; } - /** Reports the statistics of the local video streams. + /** Reports the statistics of the local video stream. * * The SDK triggers this callback once every two seconds for each * user/host. If there are multiple users/hosts in the channel, the SDK * triggers this callback as many times. * * @note - * If you have called the \ref agora::rtc::IRtcEngine::enableDualStream - * "enableDualStream" method, the \ref onLocalVideoStats() - * "onLocalVideoStats" callback reports the statistics of the high-video + * If you have called the + * \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" + * method, the \ref onLocalVideoStats() "onLocalVideoStats" callback + * reports the statistics of the high-video * stream (high bitrate, and high-resolution video stream). * * @param stats Statistics of the local video stream. See LocalVideoStats. */ - virtual void onLocalVideoStats(const LocalVideoStats& stats) { + virtual void onLocalVideoStats(const LocalVideoStats& stats) { (void)stats; } @@ -2798,9 +3737,8 @@ class IRtcEngineEventHandler } /** Occurs when the local audio state changes. - * * This callback indicates the state change of the local audio stream, - * including the state of the audio recording and encoding, and allows + * including the state of the audio capturing and encoding, and allows * you to troubleshoot issues when exceptions occur. * * @note @@ -2817,17 +3755,18 @@ class IRtcEngineEventHandler } /** Occurs when the remote audio state changes. - * - * This callback indicates the state change of the remote audio stream. - * - * @param uid ID of the remote user whose audio state changes. - * @param state State of the remote audio. See #REMOTE_AUDIO_STATE. - * @param reason The reason of the remote audio state change. - * See #REMOTE_AUDIO_STATE_REASON. - * @param elapsed Time elapsed (ms) from the local user calling the - * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK - * triggers this callback. - */ + + This callback indicates the state change of the remote audio stream. + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param uid ID of the remote user whose audio state changes. + @param state State of the remote audio. See #REMOTE_AUDIO_STATE. + @param reason The reason of the remote audio state change. + See #REMOTE_AUDIO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref IRtcEngine::joinChannel "joinChannel" method until the SDK + triggers this callback. + */ virtual void onRemoteAudioStateChanged(uid_t uid, REMOTE_AUDIO_STATE state, REMOTE_AUDIO_STATE_REASON reason, int elapsed) { (void)uid; (void)state; @@ -2835,21 +3774,55 @@ class IRtcEngineEventHandler (void)elapsed; } - virtual void onAudioPublishStateChange(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + /** Occurs when the audio publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local audio stream. + * + * @param channel The channel name. + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioPublishStateChanged(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)channel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - virtual void onVideoPublishStateChange(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { + /** Occurs when the video publishing state changes. + * + * @since v3.1.0 + * + * This callback indicates the publishing state change of the local video stream. + * + * @param channel The channel name. + * @param oldState The previous publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param newState The current publishing state. For details, see #STREAM_PUBLISH_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoPublishStateChanged(const char* channel, STREAM_PUBLISH_STATE oldState, STREAM_PUBLISH_STATE newState, int elapseSinceLastState) { (void)channel; (void)oldState; (void)newState; (void)elapseSinceLastState; } - virtual void onAudioSubscribeStateChange(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote audio stream. + * + * @param channel The channel name. + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onAudioSubscribeStateChanged(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)channel; (void)uid; (void)oldState; @@ -2857,7 +3830,19 @@ class IRtcEngineEventHandler (void)elapseSinceLastState; } - virtual void onVideoSubscribeStateChange(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { + /** Occurs when the audio subscribing state changes. + * + * @since v3.1.0 + * + * This callback indicates the subscribing state change of a remote video stream. + * + * @param channel The channel name. + * @param uid The ID of the remote user. + * @param oldState The previous subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param newState The current subscribing state. For details, see #STREAM_SUBSCRIBE_STATE. + * @param elapseSinceLastState The time elapsed (ms) from the previous state to the current state. + */ + virtual void onVideoSubscribeStateChanged(const char* channel, uid_t uid, STREAM_SUBSCRIBE_STATE oldState, STREAM_SUBSCRIBE_STATE newState, int elapseSinceLastState) { (void)channel; (void)uid; (void)oldState; @@ -2865,27 +3850,37 @@ class IRtcEngineEventHandler (void)elapseSinceLastState; } - /** Reports which users are speaking and the speakers' volume. - - This callback reports the ID and volume of the loudest speakers at the moment in the channel. - - This callback is disabled by default and can be enabled by the \ref IRtcEngine::enableAudioVolumeIndication "enableAudioVolumeIndication" method. - - The local user has a dedicated *onAudioVolumeIndication* callback; all remote speakers share a separate *onAudioVolumeIndication* callback. - - For the local user's callback, the @p speakers array has @p uid = 0 and @p volume = @p totalVolume. @p speakerNumber = 1 whether or not the local user speaks. - - For the remote speakers' callback, the @p speakers array includes the user ID and volume of the loudest speakers in the channel. - - The audio volume returned in this callback includes the voice volume and audio-mixing volume of the remote user. - - @note - - Calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method affects the SDK's behavior: - - If the local user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method, the SDK stops triggering the local user's callback. - - 15 seconds after a remote speaker calls the *muteLocalAudioStream* method, the remote speakers' callback excludes this remote user's information; 15 seconds after all remote users call the *muteLocalAudioStream* method, the SDK stops triggering the remote speakers' callback. - - An empty @p speakers array in the *onAudioVolumeIndication* callback suggests that no remote user is speaking at the moment. - - @param speakers A pointer to AudioVolumeInfo, a struct containing each speaker's user ID and volume information. - @param speakerNumber Total number of speakers. - @param totalVolume Total volume after audio mixing. The value ranges between 0 (lowest volume) and 255 (highest volume). + /** Reports the volume information of users. + * + * By default, this callback is disabled. You can enable it by calling \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication". + * Once this callback is enabled and users send streams in the channel, the SDK triggers the `onAudioVolumeIndication` callback + * at the time interval set in `enableAudioVolumeIndication`. + * + * The SDK triggers two independent `onAudioVolumeIndication` callbacks simultaneously, which separately report the + * volume information of the local user who sends a stream and the remote users (up to three) whose instantaneous + * volumes are the highest. + * + * @note After you enable this callback, calling \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" + * affects the SDK's behavior as follows: + * - If the local user calls `muteLocalAudioStream`, the SDK stops triggering the local user's callback. + * - 20 seconds after a remote user whose volume is one of the three highest calls `muteLocalAudioStream`, the + * remote users' callback excludes this remote user's information; 20 seconds after all remote users call + * `muteLocalAudioStream`, the SDK stops triggering the remote users' callback. + * + * @param speakers The volume information of users. See AudioVolumeInfo. + * + * An empty speakers array in the callback indicates that no remote user is in the channel or sending a stream at the moment. + * @param speakerNumber Total number of users. + * - In the local user's callback, when the local user sends a stream, `speakerNumber = 1`. + * - In the remote users' callback, the value ranges between 0 and 3. If the number of remote users who send + * streams is greater than or equal to three, `speakerNumber = 3`. + * @param totalVolume Total volume after audio mixing. The value ranges between 0 (lowest volume) and 255 (highest volume). + * - In the local user's callback, totalVolume is the volume of the local user who sends a stream. + * - In the remote users' callback, totalVolume is the sum of the volume of all remote users (up to three) whose + * instantaneous volumes are the highest. + * + * If the user calls \ref agora::rtc::IRtcEngine::startAudioMixing "startAudioMixing", `totalVolume` is the sum of + * the voice volume and audio-mixing volume. */ virtual void onAudioVolumeIndication(const AudioVolumeInfo* speakers, unsigned int speakerNumber, int totalVolume) { (void)speakers; @@ -2893,15 +3888,17 @@ class IRtcEngineEventHandler (void)totalVolume; } - /** Reports which user is the loudest speaker. + /** Occurs when the most active speaker is detected. - If the user enables the audio volume indication by calling the \ref IRtcEngine::enableAudioVolumeIndication "enableAudioVolumeIndication" method, this callback returns the @p uid of the active speaker detected by the audio volume detection module of the SDK. + After a successful call of \ref IRtcEngine::enableAudioVolumeIndication(int, int, bool) "enableAudioVolumeIndication", + the SDK continuously detects which remote user has the loudest volume. During the current period, the remote user, + who is detected as the loudest for the most times, is the most active user. - @note - - To receive this callback, you need to call the \ref IRtcEngine::enableAudioVolumeIndication "enableAudioVolumeIndication" method. - - This callback returns the user ID of the user with the highest voice volume during a period of time, instead of at the moment. + When the number of user is no less than two and an active speaker exists, the SDK triggers this callback and reports the `uid` of the most active speaker. + - If the most active speaker is always the same user, the SDK triggers this callback only once. + - If the most active speaker changes to another user, the SDK triggers this callback again and reports the `uid` of the new active speaker. - @param uid User ID of the active speaker. A @p uid of 0 represents the local user. + @param uid The user ID of the most active speaker. */ virtual void onActiveSpeaker(uid_t uid) { (void)uid; @@ -2911,14 +3908,14 @@ class IRtcEngineEventHandler The application can use this callback to change the configuration of the view (for example, displaying other pictures in the view) after the video stops playing. - Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_STOPPED(0) in the agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. + Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_STOPPED(0) in the \ref agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. */ virtual void onVideoStopped() {} - /** Occurs when the engine receives and renders the first local video frame on the video window. + /** Occurs when the first local video frame is displayed/rendered on the local video view. - @param width Width (pixels) of the first local video frame. - @param height Height (pixels) of the first local video frame. + @param width Width (px) of the first local video frame. + @param height Height (px) of the first local video frame. @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. If you call the \ref IRtcEngine::startPreview "startPreview" method before calling the *joinChannel* method, then @p elapsed is the time elapsed from calling the *startPreview* method until the SDK triggers this callback. */ @@ -2928,9 +3925,25 @@ class IRtcEngineEventHandler (void)elapsed; } + /** Occurs when the first video frame is published. + * + * @since v3.1.0 + * + * The SDK triggers this callback under one of the following circumstances: + * - The local client enables the video module and calls \ref IRtcEngine::joinChannel "joinChannel" successfully. + * - The local client calls \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(true)" and \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream(false)" in sequence. + * - The local client calls \ref IRtcEngine::disableVideo "disableVideo" and \ref IRtcEngine::enableVideo "enableVideo" in sequence. + * + * @param elapsed The time elapsed (ms) from the local client calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ + virtual void onFirstLocalVideoFramePublished(int elapsed) { + (void)elapsed; + } + /** Occurs when the first remote video frame is received and decoded. * - * @deprecated + * @deprecated v2.9.0 + * * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -2954,8 +3967,8 @@ class IRtcEngineEventHandler * The application can configure the user view settings in this callback. * * @param uid User ID of the remote user sending the video stream. - * @param width Width (pixels) of the video stream. - * @param height Height (pixels) of the video stream. + * @param width Width (px) of the video stream. + * @param height Height (px) of the video stream. * @param elapsed Time elapsed (ms) from the local user calling the * \ref IRtcEngine::joinChannel "joinChannel" method until the SDK * triggers this callback. @@ -2968,13 +3981,12 @@ class IRtcEngineEventHandler } /** Occurs when the first remote video frame is rendered. + The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. - The SDK triggers this callback when the first frame of the remote video is displayed in the user's video window. The application can retrieve the time elapsed from a user joining the channel until the first video frame is displayed. - - @param uid User ID of the remote user sending the video stream. - @param width Width (pixels) of the video frame. - @param height Height (pixels) of the video stream. - @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. + @param uid User ID of the remote user sending the video stream. + @param width Width (px) of the video frame. + @param height Height (px) of the video stream. + @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. */ virtual void onFirstRemoteVideoFrame(uid_t uid, int width, int height, int elapsed) { (void)uid; @@ -2983,10 +3995,13 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a remote user's audio stream is muted/unmuted. + /** @deprecated This method is deprecated from v3.0.0, use the \ref agora::rtc::IRtcEngineEventHandler::onRemoteAudioStateChanged "onRemoteAudioStateChanged" callback instead. + + Occurs when a remote user's audio stream playback pauses/resumes. - The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. - @note This callback returns invalid when the number of users in a channel exceeds 20. + The SDK triggers this callback when the remote user stops or resumes sending the audio stream by calling the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method. + + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. @param uid User ID of the remote user. @param muted Whether the remote user's audio stream is muted/unmuted: @@ -3000,8 +4015,7 @@ class IRtcEngineEventHandler /** Occurs when a remote user's video stream playback pauses/resumes. * - * @deprecated - * This callback is deprecated and replaced by the + * You can also use the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: * - #REMOTE_VIDEO_STATE_STOPPED (0) and @@ -3014,8 +4028,7 @@ class IRtcEngineEventHandler * \ref agora::rtc::IRtcEngine::muteLocalVideoStream * "muteLocalVideoStream" method. * - * @note This callback returns invalid when the number of users in a - * channel exceeds 20. + * @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. * * @param uid User ID of the remote user. * @param muted Whether the remote user's video stream playback is @@ -3031,7 +4044,8 @@ class IRtcEngineEventHandler /** Occurs when a specific remote user enables/disables the video * module. * - * @deprecated + * @deprecated v2.9.0 + * * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -3096,13 +4110,16 @@ class IRtcEngineEventHandler If the camera fails to turn on, fix the error reported in the \ref IRtcEngineEventHandler::onError "onError" callback. - Deprecated as of v2.4.1. Use LOCAL_VIDEO_STREAM_STATE_CAPTURING(1) in the agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. + Deprecated as of v2.4.1. Use #LOCAL_VIDEO_STREAM_STATE_CAPTURING (1) in the \ref agora::rtc::IRtcEngineEventHandler::onLocalVideoStateChanged "onLocalVideoStateChanged" callback instead. */ virtual void onCameraReady() {} /** Occurs when the camera focus area changes. - The SDK triggers this callback when the local user changes the camera focus position by calling the setCameraFocusPositionInPreview method. + The SDK triggers this callback when the local user changes the camera focus position by calling the setCameraFocusPositionInPreview method. + + @note This callback is for Android and iOS only. + @param x x coordinate of the changed camera focus area. @param y y coordinate of the changed camera focus area. @param width Width of the changed camera focus area. @@ -3114,10 +4131,47 @@ class IRtcEngineEventHandler (void)width; (void)height; } - +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** + * Reports the face detection result of the local user. Applies to Android and iOS only. + * @since v3.0.1 + * + * Once you enable face detection by calling \ref IRtcEngine::enableFaceDetection "enableFaceDetection"(true), you can get the following information on the local user in real-time: + * - The width and height of the local video. + * - The position of the human face in the local video. + * - The distance between the human face and the device screen. This value is based on the fitting calculation of the local video size and the position of the human face. + * + * @note + * - If the SDK does not detect a face, it reduces the frequency of this callback to reduce power consumption on the local device. + * - The SDK stops triggering this callback when a human face is in close proximity to the screen. + * - On Android, the `distance` value reported in this callback may be slightly different from the actual distance. Therefore, Agora does not recommend using it for + * accurate calculation. + * @param imageWidth The width (px) of the local video. + * @param imageHeight The height (px) of the local video. + * @param vecRectangle The position and size of the human face on the local video: + * - `x`: The x coordinate (px) of the human face in the local video. Taking the top left corner of the captured video as the origin, + * the x coordinate represents the relative lateral displacement of the top left corner of the human face to the origin. + * - `y`: The y coordinate (px) of the human face in the local video. Taking the top left corner of the captured video as the origin, + * the y coordinate represents the relative longitudinal displacement of the top left corner of the human face to the origin. + * - `width`: The width (px) of the human face in the captured video. + * - `height`: The height (px) of the human face in the captured video. + * @param vecDistance The distance (cm) between the human face and the screen. + * @param numFaces The number of faces detected. If the value is 0, it means that no human face is detected. + */ + virtual void onFacePositionChanged(int imageWidth, int imageHeight, Rectangle* vecRectangle, int* vecDistance, int numFaces){ + (void)imageWidth; + (void)imageHeight; + (void)vecRectangle; + (void)vecDistance; + (void)numFaces; + } +#endif /** Occurs when the camera exposure area changes. The SDK triggers this callback when the local user changes the camera exposure position by calling the setCameraExposurePosition method. + + @note This callback is for Android and iOS only. + @param x x coordinate of the changed camera exposure area. @param y y coordinate of the changed camera exposure area. @param width Width of the changed camera exposure area. @@ -3144,13 +4198,14 @@ class IRtcEngineEventHandler /** Occurs when the state of the local user's audio mixing file changes. - - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. - - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. - - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. + When you call the \ref IRtcEngine::startAudioMixing "startAudioMixing" method and the state of audio mixing file changes, the SDK triggers this callback. + - When the audio mixing file plays, pauses playing, or stops playing, this callback returns 710, 711, or 713 in @p state, and 0 in @p errorCode. + - When exceptions occur during playback, this callback returns 714 in @p state and an error in @p errorCode. + - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - @param state The state code. See #AUDIO_MIXING_STATE_TYPE. - @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. - */ + @param state The state code. See #AUDIO_MIXING_STATE_TYPE. + @param errorCode The error code. See #AUDIO_MIXING_ERROR_TYPE. + */ virtual void onAudioMixingStateChanged(AUDIO_MIXING_STATE_TYPE state, AUDIO_MIXING_ERROR_TYPE errorCode){ } /** Occurs when a remote user starts audio mixing. @@ -3177,14 +4232,18 @@ class IRtcEngineEventHandler /** Occurs when the SDK decodes the first remote audio frame for playback. + @deprecated v3.0.0 + + This callback is deprecated. Use `onRemoteAudioStateChanged` instead. + This callback is triggered in either of the following scenarios: - The remote user joins the channel and sends the audio stream. - The remote user stops sending the audio stream and re-sends it after 15 seconds. Reasons for such an interruption include: - - The remote user leaves channel. - - The remote user drops offline. - - The remote user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method to stop sending the local audio stream. - - The remote user calls the \ref agora::rtc::IRtcEngine::disableAudio "disableAudio" method to disable audio. + - The remote user leaves channel. + - The remote user drops offline. + - The remote user calls the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method to stop sending the local audio stream. + - The remote user calls the \ref agora::rtc::IRtcEngine::disableAudio "disableAudio" method to disable audio. @param uid User ID of the remote user sending the audio stream. @param elapsed Time elapsed (ms) from the local user calling the \ref IRtcEngine::joinChannel "joinChannel" method until the SDK triggers this callback. @@ -3209,11 +4268,22 @@ class IRtcEngineEventHandler } /** Occurs when the local video stream state changes. - - @note This callback indicates the state of the local video stream, including camera capturing and video encoding, and allows you to troubleshoot issues when exceptions occur. - - @param localVideoState State type #LOCAL_VIDEO_STREAM_STATE. When the state is LOCAL_VIDEO_STREAM_STATE_FAILED (3), see the *error* parameter for details. - @param error The detailed error information. code #LOCAL_VIDEO_STREAM_ERROR. + * + * This callback indicates the state of the local video stream, including camera capturing and video encoding, and allows you to troubleshoot issues when exceptions occur. + * + * The SDK triggers the `onLocalVideoStateChanged(LOCAL_VIDEO_STREAM_STATE_FAILED，LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE)` callback in the following situations: + * - The application exits to the background, and the system recycles the camera. + * - The camera starts normally, but the captured video is not output for four seconds. + * + * When the camera outputs the captured video frames, if all the video frames are the same for 15 consecutive frames, the SDK triggers the + * `onLocalVideoStateChanged(LOCAL_VIDEO_STREAM_STATE_CAPTURING，LOCAL_VIDEO_STREAM_ERROR_CAPTURE_FAILURE)` callback. Note that the + * video frame duplication detection is only available for video frames with a resolution greater than 200 × 200, a frame rate greater than or equal to 10 fps, + * and a bitrate less than 20 Kbps. + * + * @note For some device models, the SDK will not trigger this callback when the state of the local video changes while the local video capturing device is in use, so you have to make your own timeout judgment. + * + * @param localVideoState State type #LOCAL_VIDEO_STREAM_STATE. + * @param error The detailed error information: #LOCAL_VIDEO_STREAM_ERROR. */ virtual void onLocalVideoStateChanged(LOCAL_VIDEO_STREAM_STATE localVideoState, LOCAL_VIDEO_STREAM_ERROR error) { (void)localVideoState; @@ -3234,14 +4304,15 @@ class IRtcEngineEventHandler (void)rotation; } /** Occurs when the remote video state changes. - * - * @param uid ID of the remote user whose video state changes. - * @param state State of the remote video. See #REMOTE_VIDEO_STATE. - * @param reason The reason of the remote video state change. See - * #REMOTE_VIDEO_STATE_REASON. - * @param elapsed Time elapsed (ms) from the local user calling the - * \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the - * SDK triggers this callback. + @note This callback does not work properly when the number of users (in the `COMMUNICATION` profile) or hosts (in the `LIVE_BROADCASTING` profile) in the channel exceeds 17. + + @param uid ID of the remote user whose video state changes. + @param state State of the remote video. See #REMOTE_VIDEO_STATE. + @param reason The reason of the remote video state change. See + #REMOTE_VIDEO_STATE_REASON. + @param elapsed Time elapsed (ms) from the local user calling the + \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method until the + SDK triggers this callback. */ virtual void onRemoteVideoStateChanged(uid_t uid, REMOTE_VIDEO_STATE state, REMOTE_VIDEO_STATE_REASON reason, int elapsed) { (void)uid; @@ -3250,10 +4321,11 @@ class IRtcEngineEventHandler (void)elapsed; } - /** Occurs when a specified remote user enables/disables the local video + /** Occurs when a specified remote user enables/disables the local video * capturing function. * - * @deprecated + * @deprecated v2.9.0 + * * This callback is deprecated and replaced by the * \ref onRemoteVideoStateChanged() "onRemoteVideoStateChanged" callback * with the following parameters: @@ -3302,7 +4374,7 @@ class IRtcEngineEventHandler /** Occurs when the local user does not receive the data stream from the remote user within five seconds. - The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. + The SDK triggers this callback when the local user fails to receive the stream message that the remote user sends by calling the \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method. @param uid User ID of the remote user sending the message. @param streamId Stream ID. @param code Error code: #ERROR_CODE_TYPE. @@ -3323,6 +4395,27 @@ class IRtcEngineEventHandler /** Occurs when the media engine call starts.*/ virtual void onMediaEngineStartCallSuccess() { } + /// @cond + /** Reports whether the super-resolution algorithm is enabled. + * + * @since v3.2.0 + * + * After calling \ref IRtcEngine::enableRemoteSuperResolution "enableRemoteSuperResolution", the SDK triggers this + * callback to report whether the super-resolution algorithm is successfully enabled. If not successfully enabled, + * you can use reason for troubleshooting. + * + * @param uid The ID of the remote user. + * @param enabled Whether the super-resolution algorithm is successfully enabled: + * - true: The super-resolution algorithm is successfully enabled. + * - false: The super-resolution algorithm is not successfully enabled. + * @param reason The reason why the super-resolution algorithm is not successfully enabled. See #SUPER_RESOLUTION_STATE_REASON. + */ + virtual void onUserSuperResolutionEnabled(uid_t uid, bool enabled, SUPER_RESOLUTION_STATE_REASON reason) { + (void)uid; + (void)enabled; + (void)reason; + } + /// @endcond /** Occurs when the state of the media stream relay changes. * @@ -3344,14 +4437,35 @@ class IRtcEngineEventHandler /** Occurs when the engine sends the first local audio frame. - @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. - */ + @deprecated Deprecated as of v3.1.0. Use the \ref IRtcEngineEventHandler::onFirstLocalAudioFramePublished "onFirstLocalAudioFramePublished" callback instead. + + @param elapsed Time elapsed (ms) from the local user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ virtual void onFirstLocalAudioFrame(int elapsed) { (void)elapsed; } + /** Occurs when the first audio frame is published. + * + * @since v3.1.0 + * + * The SDK triggers this callback under one of the following circumstances: + * - The local client enables the audio module and calls \ref IRtcEngine::joinChannel "joinChannel" successfully. + * - The local client calls \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(true)" and \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream(false)" in sequence. + * - The local client calls \ref IRtcEngine::disableAudio "disableAudio" and \ref IRtcEngine::enableAudio "enableAudio" in sequence. + * + * @param elapsed The time elapsed (ms) from the local client calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. + */ + virtual void onFirstLocalAudioFramePublished(int elapsed) { + (void)elapsed; + } + /** Occurs when the engine receives the first audio frame from a specific remote user. + @deprecated v3.0.0 + + This callback is deprecated. Use `onRemoteAudioStateChanged` instead. + @param uid User ID of the remote user. @param elapsed Time elapsed (ms) from the remote user calling \ref IRtcEngine::joinChannel "joinChannel" until the SDK triggers this callback. */ @@ -3361,32 +4475,46 @@ class IRtcEngineEventHandler } /** - Occurs when the state of the RTMP streaming changes. + Occurs when the state of the RTMP or RTMPS streaming changes. The SDK triggers this callback to report the result of the local user calling the \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" or \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. - This callback indicates the state of the RTMP streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. + This callback indicates the state of the RTMP or RTMPS streaming. When exceptions occur, you can troubleshoot issues by referring to the detailed error descriptions in the *errCode* parameter. - @param url The RTMP URL address. - @param state The RTMP streaming state. See: #RTMP_STREAM_PUBLISH_STATE. + @param url The CDN streaming URL. + @param state The RTMP or RTMPS streaming state. See: #RTMP_STREAM_PUBLISH_STATE. @param errCode The detailed error information for streaming. See: #RTMP_STREAM_PUBLISH_ERROR. */ virtual void onRtmpStreamingStateChanged(const char *url, RTMP_STREAM_PUBLISH_STATE state, RTMP_STREAM_PUBLISH_ERROR errCode) { (void) url; - (RTMP_STREAM_PUBLISH_STATE) state; - (RTMP_STREAM_PUBLISH_ERROR) errCode; + (void) state; + (void) errCode; } - /** Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) + /** Reports events during the RTMP or RTMPS streaming. + * + * @since v3.1.0 + * + * @param url The RTMP or RTMPS streaming URL. + * @param eventCode The event code. See #RTMP_STREAMING_EVENT + */ + virtual void onRtmpStreamingEvent(const char* url, RTMP_STREAMING_EVENT eventCode) { + (void) url; + (void) eventCode; + } + + /** @deprecated This method is deprecated, use the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback instead. + + Reports the result of calling the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method. (CDN live only.) - @param url The RTMP URL address. + @param url The CDN streaming URL. @param error Error code: #ERROR_CODE_TYPE. Main errors include: - #ERR_OK (0): The publishing succeeds. - #ERR_FAILED (1): The publishing fails. - - #ERR_INVALID_ARGUMENT (2): Invalid argument used. If, for example, you did not call \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" to configure LiveTranscoding before calling \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl", the SDK reports #ERR_INVALID_ARGUMENT. - - #ERR_TIMEDOUT (10): The publishing timed out. - - #ERR_ALREADY_IN_USE (19): The chosen URL address is already in use for CDN live streaming. - - #ERR_RESOURCE_LIMITED (22): The backend system does not have enough resources for the CDN live streaming. + - #ERR_INVALID_ARGUMENT (-2): Invalid argument used. If, for example, you did not call \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" to configure LiveTranscoding before calling \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl", the SDK reports #ERR_INVALID_ARGUMENT. + - #ERR_TIMEDOUT (-10): The publishing timed out. + - #ERR_ALREADY_IN_USE (-19): The chosen URL address is already in use for CDN live streaming. + - #ERR_RESOURCE_LIMITED (-22): The backend system does not have enough resources for the CDN live streaming. - #ERR_ENCRYPTED_STREAM_NOT_ALLOWED_PUBLISH (130): You cannot publish an encrypted stream. - #ERR_PUBLISH_STREAM_CDN_ERROR (151) - #ERR_PUBLISH_STREAM_NUM_REACH_LIMIT (152) @@ -3398,19 +4526,27 @@ class IRtcEngineEventHandler (void)url; (void)error; } - /** Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) + /** @deprecated This method is deprecated, use the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback instead. - This callback indicates whether you have successfully removed an RTMP stream from the CDN. + Reports the result of calling the \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. (CDN live only.) - @param url The RTMP URL address. + This callback indicates whether you have successfully removed an RTMP or RTMPS stream from the CDN. + + @param url The CDN streaming URL. */ virtual void onStreamUnpublished(const char *url) { (void)url; } -/** Occurs when the publisher's transcoding is updated. */ + /** Occurs when the publisher's transcoding is updated. + * + * When the `LiveTranscoding` class in the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method updates, the SDK triggers the `onTranscodingUpdated` callback to report the update information to the local host. + * + * @note If you call the `setLiveTranscoding` method to set the LiveTranscoding class for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + * + */ virtual void onTranscodingUpdated() { } - /** Occurs when a voice or video stream URL address is added to a live broadcast. + /** Occurs when a voice or video stream URL address is added to the interactive live streaming. @param url Pointer to the URL address of the externally injected stream. @param uid User ID. @@ -3423,24 +4559,21 @@ class IRtcEngineEventHandler } /** Occurs when the local audio route changes. - - The SDK triggers this callback when the local audio route switches to an earpiece, speakerphone, headset, or Bluetooth device. - - @note This callback is for Android and iOS only. - - @param routing Audio output routing. See: #AUDIO_ROUTE_TYPE. + @param routing The current audio routing. See: #AUDIO_ROUTE_TYPE. */ virtual void onAudioRouteChanged(AUDIO_ROUTE_TYPE routing) { - (void)routing; - } + (void)routing; + } - /** Occurs when the locally published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. + /** Occurs when the published media stream falls back to an audio-only stream due to poor network conditions or switches back to the video after the network conditions improve. - If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the locally published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + If you call \ref IRtcEngine::setLocalPublishFallbackOption "setLocalPublishFallbackOption" and set *option* as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK triggers this callback when the + published stream falls back to audio-only mode due to poor uplink conditions, or when the audio stream switches back to the video after the uplink network condition improves. + @note If the local stream fallbacks to the audio-only stream, the remote user receives the \ref IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback. - @param isFallbackOrRecover Whether the locally published stream falls back to audio-only or switches back to the video: - - true: The locally published stream falls back to audio-only due to poor network conditions. - - false: The locally published stream switches back to the video after the network conditions improve. + @param isFallbackOrRecover Whether the published stream falls back to audio-only or switches back to the video: + - true: The published stream falls back to audio-only due to poor network conditions. + - false: The published stream switches back to the video after the network conditions improve. */ virtual void onLocalPublishFallbackToAudioOnly(bool isFallbackOrRecover) { (void)isFallbackOrRecover; @@ -3529,7 +4662,9 @@ class IRtcEngineEventHandler (void)rxKBitRate; } - /** **DEPRECATED** Occurs when the microphone is enabled/disabled. + /** Occurs when the microphone is enabled/disabled. + * + * @deprecated v2.9.0 * * The \ref onMicrophoneEnabled() "onMicrophoneEnabled" callback is * deprecated. Use #LOCAL_AUDIO_STREAM_STATE_STOPPED (0) or @@ -3539,7 +4674,7 @@ class IRtcEngineEventHandler * * The SDK triggers this callback when the local user resumes or stops * capturing the local audio stream by calling the - * \ref agora::rtc::IRtcEngine::enableLocalAudio "enbaleLocalAudio" method. + * \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio" method. * * @param enabled Whether the microphone is enabled/disabled: * - true: Enabled. @@ -3561,7 +4696,7 @@ class IRtcEngineEventHandler /** Occurs when the local network type changes. - When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. + When the network connection is interrupted, this callback indicates whether the interruption is caused by a network type change or poor network conditions. @param type See #NETWORK_TYPE. */ @@ -3589,6 +4724,27 @@ class IRtcEngineEventHandler (void)uid; (void)info; } + /// @cond + /** Reports the result of uploading the SDK log files. + * + * @since v3.3.0 + * + * After the method call of \ref IRtcEngine::uploadLogFile "uploadLogFile", the SDK triggers this callback to report the + * result of uploading the log files. If the upload fails, refer to the `reason` parameter to troubleshoot. + * + * @param requestId The request ID. This request ID is the same as `requestId` returned by \ref IRtcEngine::uploadLogFile "uploadLogFile", + * and you can use `requestId` to match a specific upload with a callback. + * @param success Whether the log files are successfully uploaded. + * - true: Successfully uploads the log files. + * - false: Fails to upload the log files. For details, see the `reason` parameter. + * @param reason The reason for the upload failure. See #UPLOAD_ERROR_REASON. + */ + virtual void onUploadLogResult(const char* requestId, bool success, UPLOAD_ERROR_REASON reason) { + (void)requestId; + (void)success; + (void)reason; + } + /// @endcond }; /** @@ -3644,7 +4800,9 @@ class IVideoDeviceManager /** Enumerates the video devices. - This method returns an IVideoDeviceCollection object including all video devices in the system. With the IVideoDeviceCollection object, the application can enumerate the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. + This method returns an IVideoDeviceCollection object including all video devices + in the system. With the IVideoDeviceCollection object, the application can enumerate + the video devices. The application must call the \ref IVideoDeviceCollection::release "release" method to release the returned object after using it. @return - An IVideoDeviceCollection object including all video devices in the system: Success. @@ -3708,11 +4866,11 @@ class IAudioDeviceCollection virtual ~IAudioDeviceCollection(){} public: - /** Retrieves the total number of audio playback or audio recording devices. + /** Retrieves the total number of audio playback or audio capturing devices. - @note You must first call the \ref IAudioDeviceManager::enumeratePlaybackDevices "enumeratePlaybackDevices" or \ref IAudioDeviceManager::enumerateRecordingDevices "enumerateRecordingDevices" method before calling this method to return the number of audio playback or audio recording devices. + @note You must first call the \ref IAudioDeviceManager::enumeratePlaybackDevices "enumeratePlaybackDevices" or \ref IAudioDeviceManager::enumerateRecordingDevices "enumerateRecordingDevices" method before calling this method to return the number of audio playback or audio capturing devices. - @return Number of audio playback or audio recording devices. + @return Number of audio playback or audio capturing devices. */ virtual int getCount() = 0; @@ -3766,7 +4924,7 @@ class IAudioDeviceCollection - < 0: Failure. */ virtual int setApplicationMute(bool mute) = 0; - /** Retrieves the mute status of the application. + /** Gets the mute state of the application. @param mute Pointer to whether the application is muted/unmuted. - true: The application is muted. @@ -3804,14 +4962,14 @@ class IAudioDeviceManager */ virtual IAudioDeviceCollection* enumeratePlaybackDevices() = 0; - /** Enumerates the audio recording devices. + /** Enumerates the audio capturing devices. - This method returns an IAudioDeviceCollection object that includes all audio recording devices in the system. With the IAudioDeviceCollection object, the application can enumerate the audio recording devices. + This method returns an IAudioDeviceCollection object that includes all audio capturing devices in the system. With the IAudioDeviceCollection object, the application can enumerate the audio capturing devices. @note The application needs to call the \ref IAudioDeviceCollection::release "release" method to release the returned object after using it. @return - - Returns an IAudioDeviceCollection object that includes all audio recording devices in the system: Success. + - Returns an IAudioDeviceCollection object that includes all audio capturing devices in the system: Success. - Returns NULL: Failure. */ virtual IAudioDeviceCollection* enumerateRecordingDevices() = 0; @@ -3828,9 +4986,9 @@ class IAudioDeviceManager */ virtual int setPlaybackDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; - /** Sets the audio recording device using the device ID. + /** Sets the audio capturing device using the device ID. - @param deviceId Device ID of the audio recording device, retrieved by calling the \ref IAudioDeviceManager::enumerateRecordingDevices "enumerateRecordingDevices" method. + @param deviceId Device ID of the audio capturing device, retrieved by calling the \ref IAudioDeviceManager::enumerateRecordingDevices "enumerateRecordingDevices" method. @note Plugging or unplugging the audio device does not change the device ID. @@ -3841,16 +4999,25 @@ class IAudioDeviceManager virtual int setRecordingDevice(const char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; /** Starts the audio playback device test. - - This method tests if the playback device works properly. In the test, the SDK plays an audio file specified by the user. If the user can hear the audio, the playback device works properly. - - @param testAudioFilePath Pointer to the path of the audio file for the audio playback device test in UTF-8: - - Supported file formats: wav, mp3, m4a, and aac. - - Supported file sample rates: 8000, 16000, 32000, 44100, and 48000 Hz. - - @return - - 0: Success, and you can hear the sound of the specified audio file. - - < 0: Failure. + * + * This method tests if the audio playback device works properly. Once a user starts the test, the SDK plays an + * audio file specified by the user. If the user can hear the audio, the playback device works properly. + * + * After calling this method, the SDK triggers the + * \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback every 100 ms, which + * reports `uid = 1` and the volume of the playback device. + * + * @note + * - Call this method before joining a channel. + * - This method is for Windows and macOS only. + * + * @param testAudioFilePath Pointer to the path of the audio file for the audio playback device test in UTF-8: + * - Supported file formats: wav, mp3, m4a, and aac. + * - Supported file sample rates: 8000, 16000, 32000, 44100, and 48000 Hz. + * + * @return + * - 0: Success, and you can hear the sound of the specified audio file. + * - < 0: Failure. */ virtual int startPlaybackDeviceTest(const char* testAudioFilePath) = 0; @@ -3946,11 +5113,21 @@ class IAudioDeviceManager */ virtual int getRecordingDeviceMute(bool *mute) = 0; - /** Starts the microphone test. + /** Starts the audio capturing device test. + + This method tests whether the audio sampling device works properly. - This method tests whether the microphone works properly. Once the test starts, the SDK uses the \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback to notify the application with the volume information. + After calling this method, the SDK triggers the + \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the time interval set + in this method, which reports `uid = 0` and the volume of the sampling device. + + @note + - Call this method before joining a channel. + - This method is for Windows and macOS only. - @param indicationInterval Interval period (ms) of the \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback cycle. + @param indicationInterval The time interval (ms) at which the `onAudioVolumeIndication` callback returns. We + recommend a setting greater than 200 ms. This value must not be less than 10 ms; otherwise, you can not receive + the `onAudioVolumeIndication` callback. @return - 0: Success. @@ -3987,36 +5164,47 @@ class IAudioDeviceManager */ virtual int getPlaybackDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH]) = 0; - /** Retrieves the audio recording device associated with the device ID. + /** Retrieves the audio capturing device associated with the device ID. - @param deviceId Pointer to the device ID of the audio recording device. + @param deviceId Pointer to the device ID of the audio capturing device. @return - 0: Success. - < 0: Failure. */ virtual int getRecordingDevice(char deviceId[MAX_DEVICE_ID_LENGTH]) = 0; - /** Retrieves the audio recording device information associated with the device ID and device name. + /** Retrieves the audio capturing device information associated with the device ID and device name. - @param deviceId Pointer to the device ID of the recording audio device. - @param deviceName Pointer to the device name of the recording audio device. + @param deviceId Pointer to the device ID of the audio capturing device. + @param deviceName Pointer to the device name of the audio capturing device. @return - 0: Success. - < 0: Failure. */ virtual int getRecordingDeviceInfo(char deviceId[MAX_DEVICE_ID_LENGTH], char deviceName[MAX_DEVICE_ID_LENGTH]) = 0; - /** Starts the audio device loopback test. - - This method tests whether the local audio devices are working properly. After calling this method, the microphone captures the local audio and plays it through the speaker. The \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback returns the local audio volume information at the set interval. - - @note This method tests the local audio devices and does not report the network conditions. - - @param indicationInterval The time interval (ms) at which the \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback returns. - - @return - - 0: Success. - - < 0: Failure. + /** Starts the audio device loopback test. + * + * This method tests whether the local audio sampling device and playback device are working properly. After calling + * this method, the audio sampling device samples the local audio, and the audio playback device plays the sampled + * audio. The SDK triggers two independent + * \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callbacks at the time interval set + * in this method, which reports the following information: + * - `uid = 0` and the volume information of the sampling device. + * - `uid = 1` and the volume information of the playback device. + * + * @note + * - Call this method before joining a channel. + * - This method tests local audio devices and does not report the network conditions. + * - This method is for Windows and macOS only. + * + * @param indicationInterval The time interval (ms) at which the `onAudioVolumeIndication` callback returns. We + * recommend a setting greater than 200 ms. This value must not be less than 10 ms; otherwise, you can not receive + * the `onAudioVolumeIndication` callback. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int startAudioDeviceLoopbackTest(int indicationInterval) = 0; @@ -4035,29 +5223,85 @@ class IAudioDeviceManager virtual void release() = 0; }; +/** The configuration of the log files. + * + * @since v3.3.0 + */ +struct LogConfig +{ + /** The absolute path of log files. + * + * The default file path is: + * - Android: `/storage/emulated/0/Android/data//files/agorasdk.log` + * - iOS: `App Sandbox/Library/caches/agorasdk.log` + * - macOS: + * - Sandbox enabled: `App Sandbox/Library/Logs/agorasdk.log`, such as `/Users//Library/Containers//Data/Library/Logs/agorasdk.log`. + * - Sandbox disabled: `～/Library/Logs/agorasdk.log`. + * - Windows: `C:\Users\\AppData\Local\Agora\\agorasdk.log` + * + * Ensure that the directory for the log files exists and is writable. You can use this parameter to rename the log files. + */ + const char* filePath; + /** The size (KB) of a log file. The default value is 1024 KB. If you set `fileSize` to 1024 KB, the SDK outputs at most 5 MB log files; + * if you set it to less than 1024 KB, the setting is invalid, and the maximum size of a log file is still 1024 KB. + */ + int fileSize; + /** The output log level of the SDK. See #LOG_LEVEL. + * + * For example, if you set the log level to WARN, the SDK outputs the logs within levels FATAL, ERROR, and WARN. + */ + LOG_LEVEL level; + LogConfig() + :filePath(NULL) + ,fileSize(-1) + ,level(LOG_LEVEL::LOG_LEVEL_INFO) + {} +}; + /** Definition of RtcEngineContext. */ struct RtcEngineContext { + /** The IRtcEngineEventHandler object. + */ IRtcEngineEventHandler* eventHandler; - /** App ID issued to you by Agora. Apply for a new App ID from Agora if - * it is missing from your kit. + /** + * The App ID issued to you by Agora. See [How to get the App ID](https://docs.agora.io/en/Agora%20Platform/token#get-an-app-id). + * Only users in apps with the same App ID can join the same channel and communicate with each other. Use an App ID to create only + * one `IRtcEngine` instance. To change your App ID, call `release` to destroy the current `IRtcEngine` instance and then call `createAgoraRtcEngine` + * and `initialize` to create an `IRtcEngine` instance with the new App ID. */ const char* appId; // For android, it the context(Activity or Application - // for windows,Video hot plug device - void* context; - RtcEngineContext() - /** The IRtcEngineEventHandler object. - */ - :eventHandler(NULL) - /** The App ID issued to your project by Agora. - */ - ,appId(NULL) + // for windows,Video hot plug device /** The video window handle. Once set, this parameter enables you to plug * or unplug the video devices while they are powered. */ + void* context; + /** + * The region for connection. This advanced feature applies to scenarios that have regional restrictions. + * + * For the regions that Agora supports, see #AREA_CODE. After specifying the region, the SDK connects to the Agora servers within that region. + * + * @note The SDK supports specify only one region. + */ + unsigned int areaCode; + /** The configuration of the log files that the SDK outputs. See LogConfig. + * + * @since v3.3.0 + * + * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with + * a default size of 1024 KB. These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is + * full, the SDK deletes the log file with the earliest modification time among the other four, renames `agorasdk.log` to the name of the + * deleted log file, and creates a new `agorasdk.log` to record latest logs. + * + */ + LogConfig logConfig; + RtcEngineContext() + :eventHandler(NULL) + ,appId(NULL) ,context(NULL) + ,areaCode(rtc::AREA_CODE_GLOB) {} }; @@ -4093,7 +5337,7 @@ class IMetadataObserver /** Buffer address of the sent or received Metadata. */ unsigned char *buffer; - /** Time statmp of the frame following the metadata. + /** Timestamp (ms) of the frame following the metadata. */ long long timeStampMs; }; @@ -4106,7 +5350,7 @@ class IMetadataObserver - `uid`: ID of the user who sends the metadata. - `size`: The size of the sent or received metadata. - `buffer`: The sent or received metadata. - - `timeStampMs`: The timestamp of the metadata. + - `timeStampMs`: The timestamp (ms) of the metadata. The SDK triggers this callback after you successfully call the \ref agora::rtc::IRtcEngine::registerMediaMetadataObserver "registerMediaMetadataObserver" method. You need to specify the maximum size of the metadata in the return value of this callback. @@ -4132,6 +5376,92 @@ class IMetadataObserver virtual void onMetadataReceived(const Metadata &metadata) = 0; }; +/** Encryption mode. +*/ +enum ENCRYPTION_MODE +{ + /** 1: (Default) 128-bit AES encryption, XTS mode. + */ + AES_128_XTS = 1, + /** 2: 128-bit AES encryption, ECB mode. + */ + AES_128_ECB = 2, + /** 3: 256-bit AES encryption, XTS mode. + */ + AES_256_XTS = 3, + /// @cond + /** 4: 128-bit SM4 encryption, ECB mode. + */ + SM4_128_ECB = 4, + /// @endcond + /** Enumerator boundary. + */ + MODE_END, +}; + +/** Configurations of built-in encryption schemas. */ +struct EncryptionConfig{ + /** + * Encryption mode. The default encryption mode is `AES_128_XTS`. See #ENCRYPTION_MODE. + */ + ENCRYPTION_MODE encryptionMode; + /** + * Encryption key in string type. + * + * @note If you do not set an encryption key or set it as NULL, you cannot use the built-in encryption, and the SDK returns #ERR_INVALID_ARGUMENT (-2). + */ + const char* encryptionKey; + + EncryptionConfig() { + encryptionMode = AES_128_XTS; + encryptionKey = nullptr; + } + + /// @cond + const char* getEncryptionString() const { + switch(encryptionMode) + { + case AES_128_XTS: + return "aes-128-xts"; + case AES_128_ECB: + return "aes-128-ecb"; + case AES_256_XTS: + return "aes-256-xts"; + case SM4_128_ECB: + return "sm4-128-ecb"; + default: + return "aes-128-xts"; + } + return "aes-128-xts"; + } + /// @endcond +}; + +/** The channel media options. + */ +struct ChannelMediaOptions { + /** Determines whether to automatically subscribe to all remote audio streams when the user joins a channel: + - true: (Default) Subscribe. + - false: Do not subscribe. + + This member serves a similar function to the `muteAllRemoteAudioStreams` method. After joining the channel, + you can call the `muteAllRemoteAudioStreams` method to set whether to subscribe to audio streams in the channel. + */ + bool autoSubscribeAudio; + /** Determines whether to subscribe to video streams when the user joins the channel: + - true: (Default) Subscribe. + - false: Do not subscribe. + + This member serves a similar function to the `muteAllRemoteVideoStreams` method. After joining the channel, + you can call the `muteAllRemoteVideoStreams` method to set whether to subscribe to video streams in the channel. + */ + bool autoSubscribeVideo; + ChannelMediaOptions() + : autoSubscribeAudio(true) + , autoSubscribeVideo(true) + {} +}; + /** IRtcEngine is the base interface class of the Agora SDK that provides the main Agora SDK methods invoked by your application. Enable the Agora SDK's communication functionality through the creation of an IRtcEngine object, then call the methods of this object. @@ -4142,64 +5472,127 @@ class IRtcEngine virtual ~IRtcEngine() {} public: - /** Initializes the Agora SDK service. + /** Initializes the Agora service. * - * Ensure that you call the + * Unless otherwise specified, all the methods provided by the IRtcEngine class are executed asynchronously. Agora recommends calling these methods in the same thread. + * + * @note Ensure that you call the * \ref agora::rtc::IRtcEngine::createAgoraRtcEngine * "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize - * "initialize" methods before calling any other API. + * "initialize" methods before calling any other APIs. * * @param context Pointer to the RTC engine context. See RtcEngineContext. * * @return - * - 0: Success. + * - 0(ERR_OK): Success. * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): No `IRtcEngineEventHandler` object is specified. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Check whether `context` is properly set. + * - -22(ERR_RESOURCE_LIMITED): The resource is limited. The app uses too much of the system resource and fails to allocate any resources. + * - -101(ERR_INVALID_APP_ID): The App ID is invalid. */ virtual int initialize(const RtcEngineContext& context) = 0; /** Releases all IRtcEngine resources. - - @param sync - - true: (Synchronous call) The result returns after the IRtcEngine resources are released. The application should not call this method in the SDK generated callbacks. Otherwise, the SDK must wait for the callbacks to return to recover the associated IRtcEngine resources, resulting in a deadlock. The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to take additional time. - - false: (Asynchronous call) The result returns immediately, even when the IRtcEngine resources have not been released. The SDK releases all resources. - - @note Do not immediately uninstall the SDK's dynamic library after the call, or it may cause a crash due to the SDK clean-up thread not quitting. - */ - virtual void release(bool sync=false) = 0; - - /** Sets the channel profile. - - The SDK needs to know the application scenario to set the appropriate channel profile to apply different optimization methods. - - @note - - Users in the same channel must use the same channel profile. - - Before calling this method to set a new channel profile, \ref IRtcEngine::release "release" the current engine and create a new engine using createAgoraRtcEngine() and \ref IRtcEngine::initialize "initialize". - - Call this method before a user \ref IRtcEngine::joinChannel "joins a channel" because you cannot configure the channel profile when the channel is in use. - - In the Communication profile, the Agora SDK supports encoding only in raw data, not in texture. - - @param profile Sets the channel profile. See #CHANNEL_PROFILE_TYPE. - @return - - 0: Success. - - < 0: Failure. + * + * Use this method for apps in which users occasionally make voice or video calls. When users do not make calls, you + * can free up resources for other operations. Once you call `release` to destroy the created `IRtcEngine` instance, + * you cannot use any method or callback in the SDK any more. If you want to use the real-time communication functions + * again, you must call \ref createAgoraRtcEngine "createAgoraRtcEngine" and \ref agora::rtc::IRtcEngine::initialize "initialize" + * to create a new `IRtcEngine` instance. + * + * @note If you want to create a new `IRtcEngine` instance after destroying the current one, ensure that you wait + * till the `release` method completes executing. + * + * @param sync + * - true: Synchronous call. Agora suggests calling this method in a sub-thread to avoid congestion in the main thread + * because the synchronous call and the app cannot move on to another task until the execution completes. + * Besides, you **cannot** call this method in any method or callback of the SDK. Otherwise, the SDK cannot release the + * resources occupied by the `IRtcEngine` instance until the callbacks return results, which may result in a deadlock. + * The SDK automatically detects the deadlock and converts this method into an asynchronous call, causing the test to + * take additional time. + * - false: Asynchronous call. Do not immediately uninstall the SDK's dynamic library after the call, or it may cause + * a crash due to the SDK clean-up thread not quitting. + */ + AGORA_CPP_API static void release (bool sync = false); + + /** Sets the channel profile of the Agora IRtcEngine. + * + * The Agora IRtcEngine differentiates channel profiles and applies optimization algorithms accordingly. + * For example, it prioritizes smoothness and low latency for a video call, and prioritizes video quality for the interactive live video streaming. + * + * @warning + * - To ensure the quality of real-time communication, we recommend that all users in a channel use the same channel profile. + * - Call this method before calling \ref IRtcEngine::joinChannel "joinChannel" . You cannot set the channel profile once you have joined the channel. + * - The default audio route and video encoding bitrate are different in different channel profiles. For details, see + * \ref IRtcEngine::setDefaultAudioRouteToSpeakerphone "setDefaultAudioRouteToSpeakerphone" and \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration". + * + * @param profile The channel profile of the Agora IRtcEngine. See #CHANNEL_PROFILE_TYPE + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -2 (ERR_INVALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int setChannelProfile(CHANNEL_PROFILE_TYPE profile) = 0; - /** Sets the role of the user, such as a host or an audience (default), before joining a channel in a live broadcast. - - This method can be used to switch the user role in a live broadcast after the user joins a channel. - - In the Live Broadcast profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: - - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) - - @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. - @return - - 0: Success. - - < 0: Failure. + /** Sets the role of the user, such as a host or an audience (default), before joining a channel in the interactive live streaming. + * + * This method can be used to switch the user role in the interactive live streaming after the user joins a channel. + * + * In the `LIVE_BROADCASTING` profile, when a user switches user roles after joining a channel, a successful \ref agora::rtc::IRtcEngine::setClientRole "setClientRole" method call triggers the following callbacks: + * - The local client: \ref agora::rtc::IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged" + * - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" or \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" (BECOME_AUDIENCE) + * + * @note + * This method applies only to the `LIVE_BROADCASTING` profile. + * + * @param role Sets the role of the user. See #CLIENT_ROLE_TYPE. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int setClientRole(CLIENT_ROLE_TYPE role) = 0; - /** Allows a user to join a channel. + /** Sets the role of a user in interactive live streaming. + * + * @since v3.2.0 + * + * You can call this method either before or after joining the channel to set the user role as audience or host. If + * you call this method to switch the user role after joining the channel, the SDK triggers the following callbacks: + * - The local client: \ref IRtcEngineEventHandler::onClientRoleChanged "onClientRoleChanged". + * - The remote client: \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" + * or \ref IRtcEngineEventHandler::onUserOffline "onUserOffline". + * + * @note + * - This method applies to the `LIVE_BROADCASTING` profile only (when the `profile` parameter in + * \ref IRtcEngine::setChannelProfile "setChannelProfile" is set as `CHANNEL_PROFILE_LIVE_BROADCASTING`). + * - The difference between this method and \ref IRtcEngine::setClientRole(CLIENT_ROLE_TYPE) "setClientRole" [1/2] is that + * this method can set the user level in addition to the user role. + * - The user role determines the permissions that the SDK grants to a user, such as permission to send local + * streams, receive remote streams, and push streams to a CDN address. + * - The user level determines the level of services that a user can enjoy within the permissions of the user's + * role. For example, an audience can choose to receive remote streams with low latency or ultra low latency. Levels + * affect prices. + * + * @param role The role of a user in interactive live streaming. See #CLIENT_ROLE_TYPE. + * @param options The detailed options of a user, including user level. See ClientRoleOptions. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + */ + virtual int setClientRole(CLIENT_ROLE_TYPE role, const ClientRoleOptions& options) = 0; + + /** Joins a channel with the user ID. Users in the same channel can talk to each other, and multiple users in the same channel can start a group chat. Users with different App IDs cannot call each other. @@ -4207,71 +5600,177 @@ class IRtcEngine You must call the \ref IRtcEngine::leaveChannel "leaveChannel" method to exit the current call before entering another channel. A successful \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method call triggers the following callbacks: - - The local client: \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + - The local client: \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess". + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. When the connection between the client and Agora's server is interrupted due to poor network conditions, the SDK tries reconnecting to the server. When the local client successfully rejoins the channel, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRejoinChannelSuccess "onRejoinChannelSuccess" callback on the local client. + Once the user joins the channel, the user subscribes to the audio and video streams of all the other users in the channel by default, giving rise to usage and billing calculation. If you do not want to subscribe to a specified stream or all remote streams, call the `mute` methods accordingly. + @note A channel does not accept duplicate uids, such as two users with the same @p uid. If you set @p uid as 0, the system automatically assigns a @p uid. If you want to join a channel from different devices, ensure that each device has a different uid. @warning Ensure that the App ID used for creating the token is the same App ID used by the \ref IRtcEngine::initialize "initialize" method for initializing the RTC engine. Otherwise, the CDN live streaming may fail. - @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a Channel Key. + @param token Pointer to the token generated by the application server. In most circumstances, a static App ID suffices. For added security, use a token. - If the user uses a static App ID, *token* is optional and can be set as NULL. - - If the user uses a Channel Key, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. + - If the user uses a token, Agora issues an additional App Certificate for you to generate a user key based on the algorithm and App Certificate for user authentication on the server. @param channelId Pointer to the unique channel name for the Agora RTC session in the string format smaller than 64 bytes. Supported characters: - - The 26 lowercase English letters: a to z - - The 26 uppercase English letters: A to Z - - The 10 numbers: 0 to 9 - - The space - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", "," + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @param info (Optional) Pointer to additional information about the channel. This parameter can be set to NULL or contain channel related information. Other users in the channel will not receive this message. - @param uid (Optional) User ID. A 32-bit unsigned integer with a value ranging from 1 to 232-1. The @p uid must be unique. If a @p uid is not assigned (or set to 0), the SDK assigns and returns a @p uid in the \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. Your application must record and maintain the returned *uid* since the SDK does not do so. + @param uid (Optional) User ID. A 32-bit unsigned integer with a value ranging from 1 to 232-1. The @p uid must be unique. If a @p uid is not assigned (or set to 0), the SDK assigns and returns a @p uid in the \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. Your application must record and maintain the returned `uid`, because the SDK does not do so. @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. - - #ERR_INVALID_ARGUMENT (-2) - - #ERR_NOT_READY (-3) - - #ERR_REFUSED (-5) + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. + - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: + - You have created an IChannel object with the same channel name. + - You have joined and published a stream in a channel created by the IChannel object. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized before calling this method. */ virtual int joinChannel(const char* token, const char* channelId, const char* info, uid_t uid) = 0; - /** Switches to a different channel. + /** Joins a channel with the user ID, and configures whether to automatically subscribe to the audio or video streams. * - * This method allows the audience of a Live-broadcast channel to switch - * to a different channel. + * @since v3.3.0 * - * After the user successfully switches to another channel, the - * \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" - * and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess - * "onJoinChannelSuccess" callbacks are triggered to indicate that the + * Users in the same channel can talk to each other, and multiple users in the same channel can start a group chat. Users with different App IDs cannot call each other. + * + * You must call the \ref IRtcEngine::leaveChannel "leaveChannel" method to exit the current call before entering another channel. + * + * A successful \ref IRtcEngine::joinChannel "joinChannel" method call triggers the following callbacks: + * - The local client: \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess". + * - The remote client: \ref IRtcEngineEventHandler::onUserJoined "onUserJoined", if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. + * + * When the connection between the client and the Agora server is interrupted due to poor network conditions, the SDK tries reconnecting to the server. + * When the local client successfully rejoins the channel, the SDK triggers the \ref IRtcEngineEventHandler::onRejoinChannelSuccess "onRejoinChannelSuccess" callback on the local client. + * + * @note + * - Compared with \ref IRtcEngine::joinChannel(const char* token, const char* channelId, const char* info, uid_t uid) "joinChannel" [1/2], this method + * has the options parameter which configures whether the user automatically subscribes to all remote audio and video streams in the channel when + * joining the channel. By default, the user subscribes to the audio and video streams of all the other users in the channel, thus incurring all + * associated usage costs. To unsubscribe, set the `options` parameter or call the `mute` methods accordingly. + * - Ensure that the App ID used for generating the token is the same App ID used in the \ref IRtcEngine::initialize "initialize" method for + * creating an `IRtcEngine` object. + * + * @param token The token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=Windows). + * @param channelId Pointer to the unique channel name for the Agora RTC session in the string format smaller than 64 bytes. Supported characters: + * - All lowercase English letters: a to z. + * - All uppercase English letters: A to Z. + * - All numeric characters: 0 to 9. + * - The space character. + * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * @param info (Optional) Reserved for future use. + * @param uid (Optional) User ID. A 32-bit unsigned integer with a value ranging from 1 to 232-1. The @p uid must be unique. If a @p uid is + * not assigned (or set to 0), the SDK assigns and returns a @p uid in the \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callback. + * Your application must record and maintain the returned `uid`, because the SDK does not do so. **Note**: The ID of each user in the channel should be unique. + * If you want to join the same channel from different devices, ensure that the user IDs in all devices are different. + * @param options The channel media options: ChannelMediaOptions. + @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -3(ERR_NOT_READY): The SDK fails to be initialized. You can try re-initializing the SDK. + * - -5(ERR_REFUSED): The request is rejected. This may be caused by the following: + * - You have created an IChannel object with the same channel name. + * - You have joined and published a stream in a channel created by the IChannel object. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized before calling this method. + */ + virtual int joinChannel(const char* token, + const char* channelId, + const char* info, + uid_t uid, + const ChannelMediaOptions& options) = 0; + /** Switches to a different channel. + * + * This method allows the audience of a `LIVE_BROADCASTING` channel to switch + * to a different channel. + * + * After the user successfully switches to another channel, the + * \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" + * and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess + * "onJoinChannelSuccess" callbacks are triggered to indicate that the * user has left the original channel and joined a new one. * + * Once the user switches to another channel, the user subscribes to the + * audio and video streams of all the other users in the channel by + * default, giving rise to usage and billing calculation. If you do not + * want to subscribe to a specified stream or all remote streams, call + * the `mute` methods accordingly. + * * @note - * This method applies to the audience role in a Live-broadcast channel + * This method applies to the audience role in a `LIVE_BROADCASTING` channel * only. * * @param token The token generated at your server: * - For low-security requirements: You can use the temporary token - * generated in Dashboard. For details, see - * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-temporary-token). + * generated in Console. For details, see + * [Get a temporary token](https://docs.agora.io/en/Agora%20Platform/token?platform=All%20Platforms#generate-a-token). * - For high-security requirements: Use the token generated at your * server. For details, see - * [Get a token](https://docs.agora.io/en/Agora%20Platform/token?platfor%20*%20m=All%20Platforms#get-a-token). + * [Get a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=All%20Platforms). * @param channelId Unique channel name for the AgoraRTC session in the * string format. The string length must be less than 64 bytes. Supported * character scopes are: - * - The 26 lowercase English letters: a to z. - * - The 26 uppercase English letters: A to Z. - * - The 10 numbers: 0 to 9. - * - The space. - * - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", - * ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * - All lowercase English letters: a to z. + * - All uppercase English letters: A to Z. + * - All numeric characters: 0 to 9. + * - The space character. + * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". * * @return - * - 0: Success. - * - <0: Failure. + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -5(ERR_REFUSED): The request is rejected, probably because the user is not an audience. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + * - -102(ERR_INVALID_CHANNEL_NAME): The channel name is invalid. + * - -113(ERR_NOT_IN_CHANNEL): The user is not in the channel. */ virtual int switchChannel(const char* token, const char* channelId) = 0; + /** Switches to a different channel, and configures whether to automatically subscribe to audio or video streams in the target channel. + * + * @since v3.3.0 + * + * This method allows the audience of a `LIVE_BROADCASTING` channel to switch to a different channel. + * + * After the user successfully switches to another channel, the \ref IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" + * and \ref IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" callbacks are triggered to indicate that + * the user has left the original channel and joined a new one. + * + * @note + * - This method applies to the audience role in a `LIVE_BROADCASTING` channel only. + * - The difference between this method and \ref IRtcEngine::switchChannel(const char* token, const char* channelId) "switchChannel[1/2]" + * is that the former adds the options parameter to configure whether the user automatically subscribes to all remote audio and video streams in the target channel. + * By default, the user subscribes to the audio and video streams of all the other users in the target channel, thus incurring all associated usage costs. + * To unsubscribe, set the `options` parameter or call the `mute` methods accordingly. + * + * @param token The token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=Windows). + * @param channelId Unique channel name for the AgoraRTC session in the + * string format. The string length must be less than 64 bytes. Supported + * character scopes are: + * - All lowercase English letters: a to z. + * - All uppercase English letters: A to Z. + * - All numeric characters: 0 to 9. + * - The space character. + * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * @param options The channel media options: ChannelMediaOptions. + * + * @return + * - 0(ERR_OK): Success. + * - < 0: Failure. + * - -1(ERR_FAILED): A general error occurs (no specified reason). + * - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + * - -5(ERR_REFUSED): The request is rejected, probably because the user is not an audience. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. + * - -102(ERR_INVALID_CHANNEL_NAME): The channel name is invalid. + * - -113(ERR_NOT_IN_CHANNEL): The user is not in the channel. + */ + virtual int switchChannel(const char* token, const char* channelId, const ChannelMediaOptions& options) = 0; /** Allows a user to leave a channel, such as hanging up or exiting a call. @@ -4283,31 +5782,38 @@ class IRtcEngine A successful \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method call triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" - - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the Communication channel, or is a BROADCASTER in the Live Broadcast profile. + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserOffline "onUserOffline" , if the user leaving the channel is in the `COMMUNICATION` channel, or is a host in the `LIVE_BROADCASTING` profile. @note - If you call the \ref IRtcEngine::release "release" method immediately after the *leaveChannel* method, the *leaveChannel* process interrupts, and the \ref IRtcEngineEventHandler::onLeaveChannel "onLeaveChannel" callback is not triggered. - If you call the *leaveChannel* method during a CDN live streaming, the SDK triggers the \ref IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method. @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int leaveChannel() = 0; /** Gets a new token when the current token expires after a period of time. - The *token* expires after a period of time once the token schema is enabled when: + The `token` expires after a period of time once the token schema is enabled when: - The SDK triggers the \ref IRtcEngineEventHandler::onTokenPrivilegeWillExpire "onTokenPrivilegeWillExpire" callback, or - The \ref IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" reports CONNECTION_CHANGED_TOKEN_EXPIRED(9). - The application should call this method to get the new *token*. Failure to do so will result in the SDK disconnecting from the server. + The application should call this method to get the new `token`. Failure to do so will result in the SDK disconnecting from the server. @param token Pointer to the new token. + @return - - 0: Success. + - 0(ERR_OK): Success. - < 0: Failure. + - -1(ERR_FAILED): A general error occurs (no specified reason). + - -2(ERR_INALID_ARGUMENT): The parameter is invalid. + - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. */ virtual int renewToken(const char* token) = 0; @@ -4341,12 +5847,12 @@ class IRtcEngine - To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. @param appId The App ID of your project. - @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that the user account is unique and do not set it as null. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @return - 0: Success. @@ -4359,34 +5865,81 @@ class IRtcEngine After the user successfully joins the channel, the SDK triggers the following callbacks: - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the Communication profile, or is a BROADCASTER in the Live Broadcast profile. + - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. + + Once the user joins the channel, the user subscribes to the audio and video streams of all the other users in the channel by default, giving rise to usage and billing calculation. If you do not want to subscribe to a specified stream or all remote streams, call the `mute` methods accordingly. @note To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the uid of the user is set to the same parameter type. @param token The token generated at your server: - - For low-security requirements: You can use the temporary token generated at Dashboard. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). + - For low-security requirements: You can use the temporary token generated at Console. For details, see [Get a temporary toke](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-temporary-token). - For high-security requirements: Set it as the token generated at your server. For details, see [Get a token](https://docs.agora.io/en/Voice/token?platform=All%20Platforms#get-a-token). @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". - @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that you set this parameter and do not set it as null. Supported character scopes are: - - The 26 lowercase English letters: a to z. - - The 26 uppercase English letters: A to Z. - - The 10 numbers: 0 to 9. - - The space. - - "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that the user account is unique and do not set it as null. Supported character scopes are: + - All lowercase English letters: a to z. + - All uppercase English letters: A to Z. + - All numeric characters: 0 to 9. + - The space character. + - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". @return - 0: Success. - < 0: Failure. + - #ERR_INVALID_ARGUMENT (-2) + - #ERR_NOT_READY (-3) + - #ERR_REFUSED (-5) */ virtual int joinChannelWithUserAccount(const char* token, const char* channelId, const char* userAccount) = 0; + /** Joins the channel with a user account, and configures whether to automatically subscribe to audio or video streams after joining the channel. + * + * @since v3.3.0 + * + * After the user successfully joins the channel, the SDK triggers the following callbacks: + * - The local client: \ref agora::rtc::IRtcEngineEventHandler::onLocalUserRegistered "onLocalUserRegistered" and \ref agora::rtc::IRtcEngineEventHandler::onJoinChannelSuccess "onJoinChannelSuccess" . + * - The remote client: \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" and \ref agora::rtc::IRtcEngineEventHandler::onUserInfoUpdated "onUserInfoUpdated" , if the user joining the channel is in the `COMMUNICATION` profile, or is a host in the `LIVE_BROADCASTING` profile. + * + * @note + * - Compared with \ref IRtcEngine::joinChannelWithUserAccount(const char* token, const char* channelId, const char* userAccount) "joinChannelWithUserAccount" [1/2], + * this method has the options parameter to configure whether the end user automatically subscribes to all remote audio and video streams in a + * channel when joining the channel. By default, the user subscribes to the audio and video streams of all the other users in the channel, thus + * incurring all associated usage costs. To unsubscribe, set the `options` parameter or call the `mute` methods accordingly. + * - To ensure smooth communication, use the same parameter type to identify the user. For example, if a user joins the channel with a user ID, then ensure all + * the other users use the user ID too. The same applies to the user account. If a user joins the channel with the Agora Web SDK, ensure that the + * uid of the user is set to the same parameter type. + * + * @param token The token generated at your server. For details, see [Generate a token](https://docs.agora.io/en/Interactive%20Broadcast/token_server?platform=Windows). + * @param channelId The channel name. The maximum length of this parameter is 64 bytes. Supported character scopes are: + * - All lowercase English letters: a to z. + * - All uppercase English letters: A to Z. + * - All numeric characters: 0 to 9. + * - The space character. + * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * @param userAccount The user account. The maximum length of this parameter is 255 bytes. Ensure that the user account is unique and do not set it as null. Supported character scopes are: + * - All lowercase English letters: a to z. + * - All uppercase English letters: A to Z. + * - All numeric characters: 0 to 9. + * - The space character. + * - Punctuation characters and other symbols, including: "!", "#", "$", "%", "&", "(", ")", "+", "-", ":", ";", "<", "=", ".", ">", "?", "@", "[", "]", "^", "_", " {", "}", "|", "~", ",". + * @param options The channel media options: ChannelMediaOptions. + * @return + * - 0: Success. + * - < 0: Failure. + * - #ERR_INVALID_ARGUMENT (-2) + * - #ERR_NOT_READY (-3) + * - #ERR_REFUSED (-5) + */ + virtual int joinChannelWithUserAccount(const char* token, + const char* channelId, + const char* userAccount, + const ChannelMediaOptions& options) = 0; /** Gets the user information by passing in the user account. @@ -4397,7 +5950,7 @@ class IRtcEngine remote user from the `userInfo` object by passing in the user account. @param userAccount The user account of the user. Ensure that you set this parameter. - @param[in/out] userInfo A userInfo object that identifies the user: + @param [in,out] userInfo A userInfo object that identifies the user: - Input: A userInfo object. - Output: A userInfo object that contains the user account and user ID of the user. @@ -4415,7 +5968,7 @@ class IRtcEngine from the `userInfo` object by passing in the user ID. @param uid The user ID of the remote user. Ensure that you set this parameter. - @param[in/out] userInfo A userInfo object that identifies the user: + @param[in,out] userInfo A userInfo object that identifies the user: - Input: A userInfo object. - Output: A userInfo object that contains the user account and user ID of the user. @@ -4438,7 +5991,7 @@ class IRtcEngine @note - After calling this method, always call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the application cannot run the next echo test. - - In the Live-broadcast profile, only the hosts can call this method. If the user switches from the Communication to Live-broadcast profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. + - In the `LIVE_BROADCASTING` profile, only the hosts can call this method. If the user switches from the `COMMUNICATION` to`LIVE_BROADCASTING` profile, the user must call the \ref IRtcEngine::setClientRole "setClientRole" method to change the user role from the audience (default) to the host before calling this method. @return - 0: Success. @@ -4455,7 +6008,7 @@ class IRtcEngine @note - Call this method before joining a channel. - After calling this method, call the \ref IRtcEngine::stopEchoTest "stopEchoTest" method to end the test. Otherwise, the app cannot run the next echo test, or call the \ref IRtcEngine::joinChannel "joinChannel" method. - - In the Live-broadcast profile, only a host can call this method. + - In the `LIVE_BROADCASTING` profile, only a host can call this method. @param intervalInSeconds The time interval (s) between when you speak and when the recording plays back. @return @@ -4471,7 +6024,32 @@ class IRtcEngine - < 0: Failure. */ virtual int stopEchoTest() = 0; - + /** Sets the Agora cloud proxy service. + * + * @since v3.3.0 + * + * When the user's firewall restricts the IP address and port, refer to *Use Cloud Proxy* to add the specific + * IP addresses and ports to the firewall whitelist; then, call this method to enable the cloud proxy and set + * the `proxyType` parameter as `UDP_PROXY(1)`, which is the cloud proxy for the UDP protocol. + * + * After a successfully cloud proxy connection, the SDK triggers the \ref IRtcEngineEventHandler::onConnectionStateChanged "onConnectionStateChanged" (CONNECTION_STATE_CONNECTING, CONNECTION_CHANGED_SETTING_PROXY_SERVER) callback. + * + * To disable the cloud proxy that has been set, call `setCloudProxy(NONE_PROXY)`. To change the cloud proxy type that has been set, + * call `setCloudProxy(NONE_PROXY)` first, and then call `setCloudProxy`, and pass the value that you expect in `proxyType`. + * + * @note + * - Agora recommends that you call this method before joining the channel or after leaving the channel. + * - When you use the cloud proxy for the UDP protocol, the services for pushing streams to CDN and co-hosting across channels are not available. + * + * @param proxyType The cloud proxy type, see #CLOUD_PROXY_TYPE. This parameter is required, and the SDK reports an error if you do not pass in a value. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - `-2（ERR_INVALID_ARGUMENT)`: The parameter is invalid. + * - `-7(ERR_NOT_INITIALIZED)`: The SDK is not initialized. + */ + virtual int setCloudProxy(CLOUD_PROXY_TYPE proxyType) = 0; /** Enables the video module. Call this method either before joining a channel or during a call. If this method is called before joining a channel, the call starts in the video mode. If this method is called during an audio call, the audio mode switches to the video mode. To disable the video module, call the \ref IRtcEngine::disableVideo "disableVideo" method. @@ -4517,6 +6095,7 @@ class IRtcEngine Each video profile includes a set of parameters, such as the resolution, frame rate, and bitrate. If the camera device does not support the specified resolution, the SDK automatically chooses a suitable camera resolution, keeping the encoder resolution specified by the *setVideoProfile* method. @note + - You can call this method either before or after joining a channel. - If you do not need to set the video profile after joining the channel, call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. - Always set the video profile before calling the \ref IRtcEngine::joinChannel "joinChannel" or \ref IRtcEngine::startPreview "startPreview" method. @@ -4539,7 +6118,9 @@ class IRtcEngine The parameters specified in this method are the maximum values under ideal network conditions. If the video engine cannot render the video using the specified parameters due to poor network conditions, the parameters further down the list are considered until a successful configuration is found. - @note If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. + @note + - You can call this method either before or after joining a channel. + - If you do not need to set the video encoder configuration after joining the channel, you can call this method before the \ref IRtcEngine::enableVideo "enableVideo" method to reduce the render time of the first video frame. @param config Sets the local video encoder configuration. See VideoEncoderConfiguration. @return @@ -4549,11 +6130,12 @@ class IRtcEngine virtual int setVideoEncoderConfiguration(const VideoEncoderConfiguration& config) = 0; /** Sets the camera capture configuration. - For a video call or live broadcast, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: + For a video call or the interactive live video streaming, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: - - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to avoid such problems. - - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to optimize CPU and RAM usage. - - If you want better quality for the local video preview, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PREVIEW = 2. + - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as #CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE (1) to avoid such problems. + - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as #CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE (1) to optimize CPU and RAM usage. + - If you want better quality for the local video preview, we recommend setting config as #CAPTURER_OUTPUT_PREFERENCE_PREVIEW (2). + - To customize the width and height of the video image captured by the local camera, set the camera capture configuration as #CAPTURER_OUTPUT_PREFERENCE_MANUAL (3). @note Call this method before enabling the local camera. That said, you can call this method before calling \ref agora::rtc::IRtcEngine::joinChannel "joinChannel", \ref agora::rtc::IRtcEngine::enableVideo "enableVideo", or \ref IRtcEngine::enableLocalVideo "enableLocalVideo", depending on which method you use to turn on your local camera. @@ -4565,9 +6147,16 @@ class IRtcEngine */ virtual int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) = 0; - /** Sets the local video view and configures the video display settings on the local machine. + /** Initializes the local video view. + + This method initializes the video view of a local stream on the local device. It affects only the video view that the local user sees, not the published local video stream. - The application calls this method to bind each video window (view) of the local video streams and configures the video display settings. Call this method after initialization to configure the local video display settings before joining a channel. The binding is still valid after the user leaves the channel, which means that the window still displays. To unbind the view, set the *view* in VideoCanvas to NULL. + Call this method to bind the local video stream to a video view and to set the rendering and mirror modes of the video view. + The binding is still valid after the user leaves the channel, which means that the window still displays. To unbind the view, set the *view* in VideoCanvas to NULL. + + @note + - You can call this method either before or after joining a channel. + - During a call, you can call this method as many times as necessary to update the display mode of the local video view. @param canvas Pointer to the local video view and settings. See VideoCanvas. @return @@ -4576,18 +6165,18 @@ class IRtcEngine */ virtual int setupLocalVideo(const VideoCanvas& canvas) = 0; - /** Sets the remote video view. + /** Initializes the video view of a remote user. - This method binds the remote user to the video display window (sets the view for the remote user by the specified uid in VideoCanvas). + This method initializes the video view of a remote stream on the local device. It affects only the video view that the local user sees. - The application specifies the uid of the remote video in this method before the remote user joins the channel. - - If the remote uid is unknown to the application, set it after the application receives the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. + Call this method to bind the remote video stream to a video view and to set the rendering and mirror modes of the video view. + The application specifies the uid of the remote video in this method before the remote user joins the channel. If the remote uid is unknown to the application, set it after the application receives the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. If the Video Recording function is enabled, the Video Recording Service joins the channel as a dummy client, causing other clients to also receive the \ref IRtcEngineEventHandler::onUserJoined "onUserJoined" callback. Do not bind the dummy client to the application view because the dummy client does not send any video streams. If your application does not recognize the dummy client, bind the remote user to the view when the SDK triggers the \ref IRtcEngineEventHandler::onFirstRemoteVideoDecoded "onFirstRemoteVideoDecoded" callback. - To unbind the remote user from the view, set the view in VideoCanvas to NULL. Once the remote user leaves the channel, the SDK unbinds the remote user. + @note To update the rendering or mirror mode of the remote video view during a call, use the \ref IRtcEngine::setRemoteRenderMode "setRemoteRenderMode" method. + @param canvas Pointer to the remote video view and settings. See VideoCanvas. @return - 0: Success. @@ -4611,17 +6200,19 @@ class IRtcEngine virtual int startPreview() = 0; /** Prioritizes a remote user's stream. - - Use this method with the \ref IRtcEngine::setRemoteSubscribeFallbackOption "setRemoteSubscribeFallbackOption" method. If the fallback function is enabled for a subscribed stream, the SDK ensures the high-priority user gets the best possible stream quality. - - @note The Agora SDK supports setting @p userPriority as high for one user only. - - @param uid The ID of the remote user. - @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. - - @return - - 0: Success. - - < 0: Failure. + * + * The SDK ensures the high-priority user gets the best possible stream quality. + * + * @note + * - The Agora SDK supports setting @p userPriority as high for one user only. + * - Ensure that you call this method before joining a channel. + * + * @param uid The ID of the remote user. + * @param userPriority Sets the priority of the remote user. See #PRIORITY_TYPE. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int setRemoteUserPriority(uid_t uid, PRIORITY_TYPE userPriority) = 0; @@ -4638,8 +6229,8 @@ class IRtcEngine The audio mode is enabled by default. @note - - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. You can call this method either before or after joining a channel. - - This method resets the internal engine and takes some time to take effect. We recommend using the following API methods to control the audio engine modules separately: + - This method affects the audio module and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. You can call this method either before or after joining a channel. + - This method enables the audio module and takes some time to take effect. Agora recommends using the following API methods to control the audio module separately: - \ref IRtcEngine::enableLocalAudio "enableLocalAudio": Whether to enable the microphone to create the local audio stream. - \ref IRtcEngine::muteLocalAudioStream "muteLocalAudioStream": Whether to publish the local audio stream. - \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream": Whether to subscribe to and play the remote audio stream. @@ -4653,18 +6244,20 @@ class IRtcEngine /** Disables/Re-enables the local audio function. - The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. + The audio function is enabled by default. This method disables or re-enables the local audio function, that is, to stop or restart local audio capturing. - This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to receive remote audio streams without sending any audio stream to other users in the channel. + This method does not affect receiving or playing the remote audio streams,and enableLocalAudio(false) is applicable to scenarios where the user wants to + receive remote audio streams without sending any audio stream to other users in the channel. - The SDK triggers the \ref IRtcEngineEventHandler::onMicrophoneEnabled "onMicrophoneEnabled" callback once the local audio function is disabled or enabled. + Once the local audio function is disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalAudioStateChanged "onLocalAudioStateChanged" callback, + which reports `LOCAL_AUDIO_STREAM_STATE_STOPPED(0)` or `LOCAL_AUDIO_STREAM_STATE_RECORDING(1)`. @note - - Call this method after the \ref IRtcEngine::joinChannel "joinChannel" method. - This method is different from the \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method: - - \ref agora::rtc::IRtcEngine::enableLocalAudio "enableLocalAudio": Disables/Re-enables the local audio capturing and processing. + If you disable or re-enable local audio capturing using the `enableLocalAudio` method, the local user may hear a pause in the remote audio playback. - \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream": Sends/Stops sending the local audio streams. + - You can call this method either before or after joining a channel. @param enabled Sets whether to disable/re-enable the local audio function: - true: (Default) Re-enable the local audio function, that is, to start the local audio capturing device (for example, the microphone). @@ -4688,96 +6281,156 @@ class IRtcEngine */ virtual int disableAudio() = 0; - /** Sets the audio parameters and application scenarios. + /** Sets the audio parameters and application scenarios. @note - - The *setAudioProfile* method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. - - In the Communication and Live-broadcast profiles, the bitrate may be different from your settings due to network self-adaptation. - - In scenarios involving music education, we recommend setting profile as #AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) and scenario as #AUDIO_SCENARIO_GAME_STREAMING (3). + - The `setAudioProfile` method must be called before the \ref IRtcEngine::joinChannel "joinChannel" method. + - In the `COMMUNICATION` and `LIVE_BROADCASTING` profiles, the bitrate may be different from your settings due to network self-adaptation. + - In scenarios requiring high-quality audio, for example, a music teaching scenario, we recommend setting profile as AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) and scenario as AUDIO_SCENARIO_GAME_STREAMING (3). @param profile Sets the sample rate, bitrate, encoding mode, and the number of channels. See #AUDIO_PROFILE_TYPE. - @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. Under different audio scenarios, the device uses different volume tracks, i.e. either the in-call volume or the media volume. For details, see [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). + @param scenario Sets the audio application scenario. See #AUDIO_SCENARIO_TYPE. + Under different audio scenarios, the device uses different volume types. For details, see + [What is the difference between the in-call volume and the media volume?](https://docs.agora.io/en/faq/system_volume). @return - 0: Success. - < 0: Failure. */ virtual int setAudioProfile(AUDIO_PROFILE_TYPE profile, AUDIO_SCENARIO_TYPE scenario) = 0; - /** Stops/Resumes sending the local audio stream. - - A successful \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteAudio "onUserMuteAudio" callback on the remote client. - @note When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. - - @param mute Sets whether to send/stop sending the local audio stream: - - true: Stops sending the local audio stream. - - false: (Default) Sends the local audio stream. - - @return - - 0: Success. - - < 0: Failure. + /** + * Stops or resumes publishing the local audio stream. + * + * A successful \ref agora::rtc::IRtcEngine::muteLocalAudioStream "muteLocalAudioStream" method call + * triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteAudio "onUserMuteAudio" callback on the remote client. + * + * @note + * - When @p mute is set as @p true, this method does not affect any ongoing audio recording, because it does not disable the microphone. + * - You can call this method either before or after joining a channel. If you call \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" + * after this method, the SDK resets whether or not to stop publishing the local audio according to the channel profile and user role. + * Therefore, we recommend calling this method after the `setChannelProfile` method. + * + * @param mute Sets whether to stop publishing the local audio stream. + * - true: Stop publishing the local audio stream. + * - false: (Default) Resumes publishing the local audio stream. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int muteLocalAudioStream(bool mute) = 0; - /** Stops/Resumes receiving all remote users' audio streams. - - @param mute Sets whether to receive/stop receiving all remote users' audio streams. - - true: Stops receiving all remote users' audio streams. - - false: (Default) Receives all remote users' audio streams. - - @return - - 0: Success. - - < 0: Failure. + /** + * Stops or resumes subscribing to the audio streams of all remote users. + * + * As of v3.3.0, after successfully calling this method, the local user stops or resumes + * subscribing to the audio streams of all remote users, including all subsequent users. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param mute Sets whether to stop subscribing to the audio streams of all remote users. + * - true: Stop subscribing to the audio streams of all remote users. + * - false: (Default) Resume subscribing to the audio streams of all remote users. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int muteAllRemoteAudioStreams(bool mute) = 0; - /** Stops/Resumes receiving all remote users' audio streams by default. - - @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: - - true: Stops receiving all remote users' audio streams by default. - - false: (Default) Receives all remote users' audio streams by default. - - @return - - 0: Success. - - < 0: Failure. + virtual int muteAllRemoteAudioStreams(bool mute) = 0; + /** Stops or resumes subscribing to the audio streams of all remote users by default. + * + * @deprecated This method is deprecated from v3.3.0. + * + * + * Call this method after joining a channel. After successfully calling this method, the + * local user stops or resumes subscribing to the audio streams of all subsequent users. + * + * @note If you need to resume subscribing to the audio streams of remote users in the + * channel after calling \ref IRtcEngine::setDefaultMuteAllRemoteAudioStreams "setDefaultMuteAllRemoteAudioStreams" (true), do the following: + * - If you need to resume subscribing to the audio stream of a specified user, call \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream" (false), and specify the user ID. + * - If you need to resume subscribing to the audio streams of multiple remote users, call \ref IRtcEngine::muteRemoteAudioStream "muteRemoteAudioStream" (false) multiple times. + * + * @param mute Sets whether to stop subscribing to the audio streams of all remote users by default. + * - true: Stop subscribing to the audio streams of all remote users by default. + * - false: (Default) Resume subscribing to the audio streams of all remote users by default. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - /** Stops/Resumes receiving a specified remote user's audio stream. - - @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. + virtual int setDefaultMuteAllRemoteAudioStreams(bool mute) = 0; - @param userId User ID of the specified remote user sending the audio. - @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: - - true: Stops receiving the specified remote user's audio stream. - - false: (Default) Receives the specified remote user's audio stream. - - @return - - 0: Success. - - < 0: Failure. + /** Adjusts the playback signal volume of a specified remote user. - */ - virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; - /** Stops/Resumes sending the local video stream. + You can call this method as many times as necessary to adjust the playback volume of different remote users, or to repeatedly adjust the playback volume of the same remote user. - A successful \ref agora::rtc::IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback on the remote client. - @note When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. + @note + - Call this method after joining a channel. + - The playback volume here refers to the mixed volume of a specified remote user. + - This method can only adjust the playback volume of one specified remote user at a time. To adjust the playback volume of different remote users, call the method as many times, once for each remote user. - @param mute Sets whether to send/stop sending the local video stream: - - true: Stop sending the local video stream. - - false: (Default) Send the local video stream. + @param uid The ID of the remote user. + @param volume The playback volume of the specified remote user. The value ranges from 0 to 100: + - 0: Mute. + - 100: Original volume. @return - 0: Success. - < 0: Failure. */ - virtual int muteLocalVideoStream(bool mute) = 0; - /** Disables/Re-enables the local video. + virtual int adjustUserPlaybackSignalVolume(unsigned int uid, int volume) = 0; + /** + * Stops or resumes subscribing to the audio stream of a specified user. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param userId The user ID of the specified remote user. + * @param mute Sets whether to stop subscribing to the audio stream of a specified user. + * - true: Stop subscribing to the audio stream of a specified user. + * - false: (Default) Resume subscribing to the audio stream of a specified user. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int muteRemoteAudioStream(uid_t userId, bool mute) = 0; + /** Stops or resumes publishing the local video stream. + * + * A successful \ref agora::rtc::IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" method call + * triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserMuteVideo "onUserMuteVideo" callback on + * the remote client. + * + * @note + * - This method executes faster than the \ref IRtcEngine::enableLocalVideo "enableLocalVideo" method, + * which controls the sending of the local video stream. + * - When `mute` is set as `true`, this method does not affect any ongoing video recording, because it does not disable the camera. + * - You can call this method either before or after joining a channel. If you call \ref IRtcEngine::setChannelProfile "setChannelProfile" + * after this method, the SDK resets whether or not to stop publishing the local video according to the channel profile and user role. + * Therefore, Agora recommends calling this method after the `setChannelProfile` method. + * + * @param mute Sets whether to stop publishing the local video stream. + * - true: Stop publishing the local video stream. + * - false: (Default) Resumes publishing the local video stream. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int muteLocalVideoStream(bool mute) = 0; + /** Enables/Disables the local video capture. - This method disables/re-enables the local video and enableLocalVideo(false) is only applicable when the user wants to watch the remote video without sending any video stream to the other user. + This method disables or re-enables the local video capturer, and does not affect receiving the remote video stream. - Call this method after calling the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method. Otherwise, this method may not work properly. + After you call the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method, the local video capturer is enabled by default. You can call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(false)" to disable the local video capturer. If you want to re-enable it, call \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo(true)". - After the *enableVideo* method is called, the local video is enabled by default. This method is used to disable/re-enable the local video while the remote video remains unaffected. + After the local video capturer is successfully disabled or re-enabled, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableLocalVideo "onUserEnableLocalVideo" callback on the remote client. - A successful \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onUserEnableLocalVideo "onUserEnableLocalVideo" callback on the remote client. - @note This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. + @note + - You can call this method either before or after joining a channel. + - This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. @param enabled Sets whether to disable/re-enable the local video, including the capturer, renderer, and sender: - true: (Default) Re-enable the local video. @@ -4787,52 +6440,83 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int enableLocalVideo(bool enabled) = 0; - /** Stops/Resumes receiving all remote users' video streams. - - @param mute Sets whether to receive/stop receiving all remote users' video streams: - - true: Stop receiving all remote users' video streams. - - false: (Default) Receive all remote users' video streams. - - @return - - 0: Success. - - < 0: Failure. + virtual int enableLocalVideo(bool enabled) = 0; + /** + * Stops or resumes subscribing to the video streams of all remote users. + * + * As of v3.3.0, after successfully calling this method, the local user stops or resumes + * subscribing to the video streams of all remote users, including all subsequent users. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param mute Sets whether to stop subscribing to the video streams of all remote users. + * - true: Stop subscribing to the video streams of all remote users. + * - false: (Default) Resume subscribing to the video streams of all remote users. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int muteAllRemoteVideoStreams(bool mute) = 0; - /** Stops/Resumes receiving all remote users' video streams by default. - - @param mute Sets whether to receive/stop receiving all remote users' video streams by default: - - true: Stop receiving all remote users' video streams by default. - - false: (Default) Receive all remote users' video streams by default. - - @return - - 0: Success. - - < 0: Failure. + virtual int muteAllRemoteVideoStreams(bool mute) = 0; + /** Stops or resumes subscribing to the video streams of all remote users by default. + * + * @deprecated This method is deprecated from v3.3.0. + * + * Call this method after joining a channel. After successfully calling this method, the + * local user stops or resumes subscribing to the video streams of all subsequent users. + * + * @note If you need to resume subscribing to the video streams of remote users in the + * channel after calling \ref IRtcEngine::setDefaultMuteAllRemoteVideoStreams "setDefaultMuteAllRemoteVideoStreams" (true), do the following: + * - If you need to resume subscribing to the video stream of a specified user, call \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream" (false), and specify the user ID. + * - If you need to resume subscribing to the video streams of multiple remote users, call \ref IRtcEngine::muteRemoteVideoStream "muteRemoteVideoStream" (false) multiple times. + * + * @param mute Sets whether to stop subscribing to the video streams of all remote users by default. + * - true: Stop subscribing to the video streams of all remote users by default. + * - false: (Default) Resume subscribing to the video streams of all remote users by default. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; - /** Stops/Resumes receiving a specified remote user's video stream. - - @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. + virtual int setDefaultMuteAllRemoteVideoStreams(bool mute) = 0; + /** + * Stops or resumes subscribing to the video stream of a specified user. + * + * @note + * - Call this method after joining a channel. + * - See recommended settings in *Set the Subscribing State*. + * + * @param userId The user ID of the specified remote user. + * @param mute Sets whether to stop subscribing to the video stream of a specified user. + * - true: Stop subscribing to the video stream of a specified user. + * - false: (Default) Resume subscribing to the video stream of a specified user. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; + /** Sets the stream type of the remote video. - @param userId User ID of the specified remote user. - @param mute Sets whether to receive/stop receiving the specified remote user's video stream: - - true: Stop receiving the specified remote user's video stream. - - false: (Default) Receive the specified remote user's video stream. + Under limited network conditions, if the publisher has not disabled the dual-stream mode using `enableDualStreamMode(false)`, + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). - @return - - 0: Success. - - < 0: Failure. - */ - virtual int muteRemoteVideoStream(uid_t userId, bool mute) = 0; - /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. - This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. + The aspect ratio of the low-video stream is the same as the high-quality video stream. Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. - - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the SDK receives the high-stream video by default. - - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. - By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. + @note You can call this method either before or after joining a channel. If you call both + \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" and + \ref IRtcEngine::setRemoteDefaultVideoStreamType "setRemoteDefaultVideoStreamType", the SDK applies the settings in + the \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" method. @param userId ID of the remote user sending the video stream. @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -4840,13 +6524,25 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. + virtual int setRemoteVideoStreamType(uid_t userId, REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + /** Sets the default stream type of remote videos. - - If the dual-stream mode is enabled by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the user receives the high-stream video by default. The @p setRemoteDefaultVideoStreamType method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. - - If the dual-stream mode is not enabled, the user receives the high-stream video by default. + Under limited network conditions, if the publisher has not disabled the dual-stream mode using `enableDualStreamMode(false)`, + the receiver can choose to receive either the high-quality video stream (the high resolution, and high bitrate video stream) or + the low-video stream (the low resolution, and low bitrate video stream). - The result after calling this method is returned in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. + By default, users receive the high-quality video stream. Call this method if you want to switch to the low-video stream. + This method allows the app to adjust the corresponding video stream type based on the size of the video window to + reduce the bandwidth and resources. The aspect ratio of the low-video stream is the same as the high-quality video stream. + Once the resolution of the high-quality video + stream is set, the system automatically sets the resolution, frame rate, and bitrate of the low-video stream. + + The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. + + @note You can call this method either before or after joining a channel. If you call both + \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" and + \ref IRtcEngine::setRemoteDefaultVideoStreamType "setRemoteDefaultVideoStreamType", the SDK applies the settings in + the \ref IRtcEngine::setRemoteVideoStreamType "setRemoteVideoStreamType" method. @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. @@ -4854,29 +6550,41 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; + virtual int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) = 0; - /** Enables the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at a set time interval to report on which users are speaking and the speakers' volume. + /** Enables the reporting of users' volume indication. - Once this method is enabled, the SDK returns the volume indication in the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the set time interval, whether or not any user is speaking in the channel. + This method enables the SDK to regularly report the volume information of the local user who sends a stream and + remote users (up to three) whose instantaneous volumes are the highest to the app. Once you call this method and + users send streams in the channel, the SDK triggers the + \ref IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the time interval set + in this method. + + @note You can call this method either before or after joining a channel. @param interval Sets the time interval between two consecutive volume indications: - ≤ 0: Disables the volume indication. - > 0: Time interval (ms) between two consecutive volume indications. We recommend setting @p interval > 200 ms. Do not set @p interval < 10 ms, or the *onAudioVolumeIndication* callback will not be triggered. - @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. - + @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. + @param report_vad + - true: Enable the voice activity detection of the local user. Once it is enabled, the `vad` parameter of the `onAudioVolumeIndication` callback reports the voice activity status of the local user. + - false: (Default) Disable the voice activity detection of the local user. Once it is disabled, the `vad` parameter of the `onAudioVolumeIndication` callback does not report the voice activity status of the local user, except for the scenario where the engine automatically detects the voice activity of the local user. @return - 0: Success. - < 0: Failure. */ - virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; + virtual int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) = 0; /** Starts an audio recording. + @deprecated Use \ref IRtcEngine::startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) "startAudioRecording" [2/2] instead. + The SDK allows recording during a call. Supported formats: - .wav: Large file size with high fidelity. - .aac: Small file size with low fidelity. + This method has a fixed sample rate of 32 kHz. + Ensure that the directory to save the recording file exists and is writable. This method is usually called after the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. The recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. @@ -4888,7 +6596,33 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + virtual int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; + + /** Starts an audio recording on the client. + * + * The SDK allows recording during a call. After successfully calling this method, you can record the audio of all the users in the channel and get an audio recording file. + * Supported formats of the recording file are as follows: + * - .wav: Large file size with high fidelity. + * - .aac: Small file size with low fidelity. + * + * @note + * - Ensure that the directory you use to save the recording file exists and is writable. + * - This method is usually called after the `joinChannel` method. The recording automatically stops when you call the `leaveChannel` method. + * - For better recording effects, set quality as #AUDIO_RECORDING_QUALITY_MEDIUM or #AUDIO_RECORDING_QUALITY_HIGH when `sampleRate` is 44.1 kHz or 48 kHz. + * + * @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8, such as c:/music/audio.aac. + * @param sampleRate Sample rate (kHz) of the recording file. Supported values are as follows: + * - 16 + * - (Default) 32 + * - 44.1 + * - 48 + * @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) = 0; /** Stops an audio recording on the client. You can call this method before calling the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method else, the recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. @@ -4897,7 +6631,7 @@ class IRtcEngine - 0: Success - < 0: Failure. */ - virtual int stopAudioRecording() = 0; + virtual int stopAudioRecording() = 0; /** Starts playing and mixing the music file. This method mixes the specified local audio file with the audio stream from the microphone, or replaces the microphone's audio stream with the specified local audio file. You can choose whether the other user can hear the local audio playback and specify the number of playback loops. This method also supports online music playback. @@ -4908,25 +6642,25 @@ class IRtcEngine When the audio mixing file playback finishes, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingStateChanged "onAudioMixingStateChanged" (STOPPED) callback on the local client. @note - - Call this method when you are in a channel. + - Call this method after joining a channel, otherwise issues may occur. - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - - @param filePath Pointer to the absolute path of the local or online audio file to mix. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). + - If you want to play an online music file, ensure that the time interval between calling this method is more than 100 ms, or the AUDIO_MIXING_ERROR_TOO_FREQUENT_CALL(702) error code occurs. + @param filePath Pointer to the absolute path (including the suffixes of the filename) of the local or online audio file to mix, for example, c:/music/audio.mp4. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MP4, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). @param loopback Sets which user can hear the audio mixing: - true: Only the local user can hear the audio mixing. - false: Both users can hear the audio mixing. @param replace Sets the audio mixing content: - - true: Only the specified audio file is published; the audio stream received by the microphone is not published. + - true: Only publish the specified audio file. The audio stream from the microphone is not published. - false: The local audio file is mixed with the audio stream from the microphone. @param cycle Sets the number of playback loops: - Positive integer: Number of playback loops. - - -1: Infinite playback loops. + - `-1`: Infinite playback loops. @return - 0: Success. - < 0: Failure. */ - virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; + virtual int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) = 0; /** Stops playing and mixing the music file. Call this method when you are in a channel. @@ -4935,7 +6669,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int stopAudioMixing() = 0; + virtual int stopAudioMixing() = 0; /** Pauses playing and mixing the music file. Call this method when you are in a channel. @@ -4944,7 +6678,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int pauseAudioMixing() = 0; + virtual int pauseAudioMixing() = 0; /** Resumes playing and mixing the music file. Call this method when you are in a channel. @@ -4953,10 +6687,33 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int resumeAudioMixing() = 0; + virtual int resumeAudioMixing() = 0; + /** **DEPRECATED** Agora does not recommend using this method. + + Sets the high-quality audio preferences. Call this method and set all parameters before joining a channel. + + Do not call this method again after joining a channel. + + @param fullband Sets whether to enable/disable full-band codec (48-kHz sample rate). Not compatible with SDK versions before v1.7.4: + - true: Enable full-band codec. + - false: Disable full-band codec. + @param stereo Sets whether to enable/disable stereo codec. Not compatible with SDK versions before v1.7.4: + - true: Enable stereo codec. + - false: Disable stereo codec. + @param fullBitrate Sets whether to enable/disable high-bitrate mode. Recommended in voice-only mode: + - true: Enable high-bitrate mode. + - false: Disable high-bitrate mode. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) = 0; /** Adjusts the volume during audio mixing. - Call this method when you are in a channel. + @note + - Calling this method does not affect the volume of audio effect file playback invoked by the \ref agora::rtc::IRtcEngine::playEffect "playEffect" method. + - Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". @param volume Audio mixing volume. The value ranges between 0 and 100 (default). @@ -4964,10 +6721,10 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int adjustAudioMixingVolume(int volume) = 0; + virtual int adjustAudioMixingVolume(int volume) = 0; /** Adjusts the audio mixing volume for local playback. - @note Call this method when you are in a channel. + @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". @param volume Audio mixing volume for local playback. The value ranges between 0 and 100 (default). @@ -4989,7 +6746,7 @@ class IRtcEngine virtual int getAudioMixingPlayoutVolume() = 0; /** Adjusts the audio mixing volume for publishing (for remote users). - @note Call this method when you are in a channel. + @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". @param volume Audio mixing volume for publishing. The value ranges between 0 and 100 (default). @@ -5018,7 +6775,7 @@ class IRtcEngine - ≥ 0: The audio mixing duration, if this method call succeeds. - < 0: Failure. */ - virtual int getAudioMixingDuration() = 0; + virtual int getAudioMixingDuration() = 0; /** Retrieves the playback position (ms) of the music file. Call this method when you are in a channel. @@ -5027,37 +6784,63 @@ class IRtcEngine - ≥ 0: The current playback position of the audio mixing, if this method call succeeds. - < 0: Failure. */ - virtual int getAudioMixingCurrentPosition() = 0; + virtual int getAudioMixingCurrentPosition() = 0; /** Sets the playback position of the music file to a different starting position (the default plays from the beginning). + @note Ensure that this method is called after \ref IRtcEngine::startAudioMixing "startAudioMixing". + @param pos The playback starting position (ms) of the music file. @return - 0: Success. - < 0: Failure. */ - virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; + virtual int setAudioMixingPosition(int pos /*in ms*/) = 0; + /** Sets the pitch of the local music file. + * @since v3.0.1 + * + * When a local music file is mixed with a local human voice, call this method to set the pitch of the local music file only. + * + * @note + * Call this method after calling `startAudioMixing`. + * + * @param pitch Sets the pitch of the local music file by chromatic scale. The default value is 0, + * which means keeping the original pitch. The value ranges from -12 to 12, and the pitch value between + * consecutive values is a chromatic value. The greater the absolute value of this parameter, the + * higher or lower the pitch of the local music file. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setAudioMixingPitch(int pitch) = 0; /** Retrieves the volume of the audio effects. The value ranges between 0.0 and 100.0. + @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". + @return - ≥ 0: Volume of the audio effects, if this method call succeeds. - < 0: Failure. */ - virtual int getEffectsVolume() = 0; + virtual int getEffectsVolume() = 0; /** Sets the volume of the audio effects. + @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". + @param volume Sets the volume of the audio effects. The value ranges between 0 and 100 (default). @return - 0: Success. - < 0: Failure. */ - virtual int setEffectsVolume(int volume) = 0; + virtual int setEffectsVolume(int volume) = 0; /** Sets the volume of a specified audio effect. + @note Ensure that this method is called after \ref IRtcEngine::playEffect "playEffect". + @param soundId ID of the audio effect. Each audio effect has a unique ID. @param volume Sets the volume of the specified audio effect. The value ranges between 0 and 100 (default). @@ -5065,21 +6848,47 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setVolumeOfEffect(int soundId, int volume) = 0; - - /** Plays a specified local or online audio effect file. + virtual int setVolumeOfEffect(int soundId, int volume) = 0; - This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. - - To play multiple audio effect files simultaneously, call this method multiple times with different soundIds and filePaths. We recommend playing no more than three audio effect files at the same time. - - @param soundId ID of the specified audio effect. Each audio effect has a unique ID. - - @note - - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. +#if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) + /** + * Enables/Disables face detection for the local user. + * + * @since v3.0.1 + * + * @note + * - Applies to Android and iOS only. + * - You can call this method either before or after joining a channel. + * + * Once face detection is enabled, the SDK triggers the \ref IRtcEngineEventHandler::onFacePositionChanged "onFacePositionChanged" callback + * to report the face information of the local user, which includes the following aspects: + * - The width and height of the local video. + * - The position of the human face in the local video. + * - The distance between the human face and the device screen. + * + * @param enable Determines whether to enable the face detection function for the local user: + * - true: Enable face detection. + * - false: (Default) Disable face detection. + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableFaceDetection(bool enable) = 0; +#endif + /** Plays a specified local or online audio effect file. + + This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. + + To play multiple audio effect files simultaneously, call this method multiple times with different soundIds and filePaths. We recommend playing no more than three audio effect files at the same time. + + @param soundId ID of the specified audio effect. Each audio effect has a unique ID. + + @note + - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. - Playing multiple online audio effect files simultaneously is not supported on macOS and Windows. + - Ensure that you call this method after joining a channel. - @param filePath The absolute path to the local audio effect file or the URL of the online audio effect file. + @param filePath Specifies the absolute path (including the suffixes of the filename) to the local audio effect file or the URL of the online audio effect file, for example, c:/music/audio.mp4. Supported audio formats: mp3, mp4, m4a, aac, 3gp, mkv and wav. @param loopCount Sets the number of times the audio effect loops: - 0: Play the audio effect once. - 1: Play the audio effect twice. @@ -5098,7 +6907,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false, int startPos = 0) = 0; + virtual int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) = 0; /** Stops playing a specified audio effect. @param soundId ID of the audio effect to stop playing. Each audio effect has a unique ID. @@ -5107,14 +6916,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int stopEffect(int soundId) = 0; + virtual int stopEffect(int soundId) = 0; /** Stops playing all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int stopAllEffects() = 0; + virtual int stopAllEffects() = 0; /** Preloads a specified audio effect file into the memory. @@ -5131,7 +6940,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int preloadEffect(int soundId, const char* filePath) = 0; + virtual int preloadEffect(int soundId, const char* filePath) = 0; /** Releases a specified preloaded audio effect from the memory. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -5139,7 +6948,7 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int unloadEffect(int soundId) = 0; + virtual int unloadEffect(int soundId) = 0; /** Pauses a specified audio effect. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -5147,14 +6956,14 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int pauseEffect(int soundId) = 0; + virtual int pauseEffect(int soundId) = 0; /** Pauses all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int pauseAllEffects() = 0; + virtual int pauseAllEffects() = 0; /** Resumes playing a specified audio effect. @param soundId ID of the audio effect. Each audio effect has a unique ID. @@ -5162,14 +6971,56 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int resumeEffect(int soundId) = 0; + virtual int resumeEffect(int soundId) = 0; /** Resumes playing all audio effects. @return - 0: Success. - < 0: Failure. */ - virtual int resumeAllEffects() = 0; + virtual int resumeAllEffects() = 0; + /** Enables or disables deep-learning noise reduction. + * + * The SDK enables traditional noise reduction mode by default to reduce most of the stationary background noise. + * If you need to reduce most of the non-stationary background noise, Agora recommends enabling deep-learning + * noise reduction as follows: + * + * 1. Integrate the dynamical library under the libs folder to your project: + * - Android: `libagora_ai_denoise_extension.so` + * - iOS: `AgoraAIDenoiseExtension.xcframework` + * - macOS: `AgoraAIDenoiseExtension.framework` + * - Windows: `libagora_ai_denoise_extension.dll` + * 2. Call `enableDeepLearningDenoise(true)`. + * + * Deep-learning noise reduction requires high-performance devices. For example, the following devices and later + * models are known to support deep-learning noise reduction: + * - iPhone 6S + * - MacBook Pro 2015 + * - iPad Pro (2nd generation) + * - iPad mini (5th generation) + * - iPad Air (3rd generation) + * + * After successfully enabling deep-learning noise reduction, if the SDK detects that the device performance + * is not sufficient, it automatically disables deep-learning noise reduction and enables traditional noise reduction. + * + * If you call `enableDeepLearningDenoise(false)` or the SDK automatically disables deep-learning noise reduction + * in the channel, when you need to re-enable deep-learning noise reduction, you need to call \ref IRtcEngine::leaveChannel "leaveChannel" + * first, and then call `enableDeepLearningDenoise(true)`. + * + * @note + * - This method dynamically loads the library, so Agora recommends calling this method before joining a channel. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * + * @param enable Sets whether to enable deep-learning noise reduction. + * - true: (Default) Enables deep-learning noise reduction. + * - false: Disables deep-learning noise reduction. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - -157 (ERR_MODULE_NOT_FOUND): The dynamical library for enabling deep-learning noise reduction is not integrated. + */ + virtual int enableDeepLearningDenoise(bool enable) = 0; /** Enables/Disables stereo panning for remote users. Ensure that you call this method before joinChannel to enable stereo panning for remote users so that the local user can track the position of a remote user by calling \ref agora::rtc::IRtcEngine::setRemoteVoicePosition "setRemoteVoicePosition". @@ -5190,6 +7041,7 @@ class IRtcEngine @note - For this method to work, enable stereo panning for remote users by calling the \ref agora::rtc::IRtcEngine::enableSoundPositionIndication "enableSoundPositionIndication" method before joining a channel. - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. + - Ensure that you call this method after joining a channel. @param uid The ID of the remote user. @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: @@ -5206,26 +7058,32 @@ class IRtcEngine /** Changes the voice pitch of the local speaker. + @note You can call this method either before or after joining a channel. + @param pitch Sets the voice pitch. The value ranges between 0.5 and 2.0. The lower the value, the lower the voice pitch. The default value is 1.0 (no change to the local voice pitch). @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVoicePitch(double pitch) = 0; + virtual int setLocalVoicePitch(double pitch) = 0; /** Sets the local voice equalization effect. - @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. + @note You can call this method either before or after joining a channel. + + @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 250, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. @param bandGain Sets the gain of each band in dB. The value ranges between -15 and 15. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; + virtual int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) = 0; /** Sets the local voice reverberation. v2.4.0 adds the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, a more user-friendly method for setting the local voice reverberation. You can use this method to set the local reverberation effect, such as pop music, R&B, rock music, and hip-hop. + @note You can call this method either before or after joining a channel. + @param reverbKey Sets the reverberation key. See #AUDIO_REVERB_TYPE. @param value Sets the value of the reverberation key. @@ -5233,107 +7091,365 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; + virtual int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) = 0; /** Sets the local voice changer option. - @note Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, because the method called later overrides the one called earlier. + @deprecated Deprecated from v3.2.0. Use \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" or + \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" instead. - @param voiceChanger Sets the local voice changer option. See #VOICE_CHANGER_PRESET. + This method can be used to set the local voice effect for users in a `COMMUNICATION` channel or hosts in a `LIVE_BROADCASTING` channel. + Voice changer options include the following voice effects: - @return - - 0: Success. - - < 0: Failure. - */ - virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; - /** Sets the preset local voice reverberation effect. + - `VOICE_CHANGER_XXX`: Changes the local voice to an old man, a little boy, or the Hulk. Applies to the voice talk scenario. + - `VOICE_BEAUTY_XXX`: Beautifies the local voice by making it sound more vigorous, resounding, or adding spacial resonance. Applies to the voice talk and singing scenario. + - `GENERAL_VOICE_BEAUTY_XXX`: Adds gender-based beautification effect to the local voice. Applies to the voice talk scenario. + - For a male voice: Adds magnetism to the voice. + - For a female voice: Adds freshness or vitality to the voice. @note - - Do not use this method together with \ref agora::rtc::IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb". - - Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" method, because the method called later overrides the one called earlier. + - To achieve better voice effect quality, Agora recommends setting the profile parameter in \ref IRtcEngine::setAudioProfile "setAudioProfile" as #AUDIO_PROFILE_MUSIC_HIGH_QUALITY (4) or #AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO (5) + - This method works best with the human voice, and Agora does not recommend using it for audio containing music and a human voice. + - Do not use this method with \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" , because the method called later overrides the one called earlier. For detailed considerations, see the advanced guide *Voice Changer and Reverberation*. + - You can call this method either before or after joining a channel. - @param reverbPreset Sets the preset audio reverberation configuration. See #AUDIO_REVERB_PRESET. + @param voiceChanger Sets the local voice changer option. The default value is #VOICE_CHANGER_OFF, which means the original voice. See details in #VOICE_CHANGER_PRESET + Gender-based beatification effect works best only when assigned a proper gender: + - For male: #GENERAL_BEAUTY_VOICE_MALE_MAGNETIC + - For female: #GENERAL_BEAUTY_VOICE_FEMALE_FRESH or #GENERAL_BEAUTY_VOICE_FEMALE_VITALITY + Failure to do so can lead to voice distortion. @return - 0: Success. - - < 0: Failure. + - < 0: Failure. Check if the enumeration is properly set. + */ + virtual int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) = 0; + /** Sets the local voice reverberation option, including the virtual stereo. + * + * @deprecated Deprecated from v3.2.0. Use \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" or + * \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" instead. + * + * This method sets the local voice reverberation for users in a `COMMUNICATION` channel or hosts in a `LIVE_BROADCASTING` channel. + * After successfully calling this method, all users in the channel can hear the voice with reverberation. + * + * @note + * - When calling this method with enumerations that begin with `AUDIO_REVERB_FX`, ensure that you set profile in `setAudioProfile` as + * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`; otherwise, this methods cannot set the corresponding voice reverberation option. + * - When calling this method with `AUDIO_VIRTUAL_STEREO`, Agora recommends setting the `profile` parameter in `setAudioProfile` as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. + * - This method works best with the human voice, and Agora does not recommend using it for audio containing music and a human voice. + * - Do not use this method with `setLocalVoiceChanger`, because the method called later overrides the one called earlier. + * For detailed considerations, see the advanced guide *Voice Changer and Reverberation*. + * - You can call this method either before or after joining a channel. + * + * @param reverbPreset The local voice reverberation option. The default value is `AUDIO_REVERB_OFF`, + * which means the original voice. See #AUDIO_REVERB_PRESET. + * To achieve better voice effects, Agora recommends the enumeration whose name begins with `AUDIO_REVERB_FX`. + * + * @return + * - 0: Success. + * - < 0: Failure. */ virtual int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) = 0; - - /** Specifies an SDK output log file. - - The log file records all SDK operations during runtime. If it does not exist, the SDK creates one. - - @note - - The default log file is located at: C:\Users\\AppData\Local\Agora\. - - Ensure that you call this method immediately after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method, otherwise the output log may not be complete. - - @param filePath File path of the log file. The string of the log file is in UTF-8. - - @return - - 0: Success. - - < 0: Failure. + /** Sets an SDK preset voice beautifier effect. + * + * @since v3.2.0 + * + * Call this method to set an SDK preset voice beautifier effect for the local user who sends an audio stream. After + * setting a voice beautifier effect, all users in the channel can hear the effect. + * + * You can set different voice beautifier effects for different scenarios. See *Set the Voice Beautifier and Audio Effects*. + * + * To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" and + * setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` and the `profile` parameter to + * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before calling this method. + * + * @note + * - You can call this method either before or after joining a channel. + * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" to `AUDIO_PROFILE_SPEECH_STANDARD(1)` + * or `AUDIO_PROFILE_IOT(6)`; otherwise, this method call fails. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - After calling this method, Agora recommends not calling the following methods, because they can override \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset": + * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" + * - \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * - \ref IRtcEngine::setVoiceBeautifierParameters "setVoiceBeautifierParameters" + * + * @param preset The options for SDK preset voice beautifier effects: #VOICE_BEAUTIFIER_PRESET. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setLogFile(const char* filePath) = 0; - - /** Specifies an SDK external log writer. - - The external log writer output all SDK operations during runtime if it exist. - - @note - - Ensure that you call this method after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method. - - @param pLogWriter . - - @return - - 0: Success. - - < 0: Failure. + virtual int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) = 0; + /** Sets an SDK preset audio effect. + * + * @since v3.2.0 + * + * Call this method to set an SDK preset audio effect for the local user who sends an audio stream. This audio effect + * does not change the gender characteristics of the original voice. After setting an audio effect, all users in the + * channel can hear the effect. + * + * You can set different audio effects for different scenarios. See *Set the Voice Beautifier and Audio Effects*. + * + * To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` before calling this method. + * + * @note + * - You can call this method either before or after joining a channel. + * - Do not set the profile `parameter` of `setAudioProfile` to `AUDIO_PROFILE_SPEECH_STANDARD(1)` or `AUDIO_PROFILE_IOT(6)`; + * otherwise, this method call fails. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - If you call this method and set the `preset` parameter to enumerators except `ROOM_ACOUSTICS_3D_VOICE` or `PITCH_CORRECTION`, + * do not call \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters"; otherwise, `setAudioEffectParameters` + * overrides this method. + * - After calling this method, Agora recommends not calling the following methods, because they can override `setAudioEffectPreset`: + * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * - \ref IRtcEngine::setVoiceBeautifierParameters "setVoiceBeautifierParameters" + * + * @param preset The options for SDK preset audio effects. See #AUDIO_EFFECT_PRESET. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setLogWriter(agora::commons::ILogWriter* pLogWriter) = 0; - - /** Set the value of external log writer to null - @note - - Ensure that you call this method after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method. - - @return - - 0: Success. - - < 0: Failure. + virtual int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset) = 0; + /** Sets parameters for SDK preset audio effects. + * + * @since v3.2.0 + * + * Call this method to set the following parameters for the local user who send an audio stream: + * - 3D voice effect: Sets the cycle period of the 3D voice effect. + * - Pitch correction effect: Sets the basic mode and tonic pitch of the pitch correction effect. Different songs + * have different modes and tonic pitches. Agora recommends bounding this method with interface elements to enable + * users to adjust the pitch correction interactively. + * + * After setting parameters, all users in the channel can hear the relevant effect. + * + * You can call this method directly or after \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset". If you + * call this method after \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset", ensure that you set the preset + * parameter of `setAudioEffectPreset` to `ROOM_ACOUSTICS_3D_VOICE` or `PITCH_CORRECTION` and then call this method + * to set the same enumerator; otherwise, this method overrides `setAudioEffectPreset`. + * + * @note + * - You can call this method either before or after joining a channel. + * - To achieve better audio effect quality, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile" + * and setting the `scenario` parameter to `AUDIO_SCENARIO_GAME_STREAMING(3)` before calling this method. + * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" to `AUDIO_PROFILE_SPEECH_STANDARD(1)` or + * `AUDIO_PROFILE_IOT(6)`; otherwise, this method call fails. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - After calling this method, Agora recommends not calling the following methods, because they can override `setAudioEffectParameters`: + * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" + * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * - \ref IRtcEngine::setVoiceBeautifierParameters "setVoiceBeautifierParameters" + * @param preset The options for SDK preset audio effects: + * - 3D voice effect: `ROOM_ACOUSTICS_3D_VOICE`. + * - Call \ref IRtcEngine::setAudioProfile "setAudioProfile" and set the `profile` parameter to `AUDIO_PROFILE_MUSIC_STANDARD_STEREO(3)` + * or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator; otherwise, the enumerator setting does not take effect. + * - If the 3D voice effect is enabled, users need to use stereo audio playback devices to hear the anticipated voice effect. + * - Pitch correction effect: `PITCH_CORRECTION`. To achieve better audio effect quality, Agora recommends calling + * \ref IRtcEngine::setAudioProfile "setAudioProfile" and setting the `profile` parameter to `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or + * `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)` before setting this enumerator. + * @param param1 + * - If you set `preset` to `ROOM_ACOUSTICS_3D_VOICE`, the `param1` sets the cycle period of the 3D voice effect. + * The value range is [1,60] and the unit is a second. The default value is 10 seconds, indicating that the voice moves + * around you every 10 seconds. + * - If you set `preset` to `PITCH_CORRECTION`, `param1` sets the basic mode of the pitch correction effect: + * - `1`: (Default) Natural major scale. + * - `2`: Natural minor scale. + * - `3`: Japanese pentatonic scale. + * @param param2 + * - If you set `preset` to `ROOM_ACOUSTICS_3D_VOICE`, you need to set `param2` to `0`. + * - If you set `preset` to `PITCH_CORRECTION`, `param2` sets the tonic pitch of the pitch correction effect: + * - `1`: A + * - `2`: A# + * - `3`: B + * - `4`: (Default) C + * - `5`: C# + * - `6`: D + * - `7`: D# + * - `8`: E + * - `9`: F + * - `10`: F# + * - `11`: G + * - `12`: G# + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2) = 0; + /** Sets parameters for SDK preset voice beautifier effects. + * + * @since v3.3.0 + * + * Call this method to set a gender characteristic and a reverberation effect for the singing beautifier effect. This method sets parameters for the local user who sends an audio stream. + * + * After you call this method successfully, all users in the channel can hear the relevant effect. + * + * To achieve better audio effect quality, before you call this method, Agora recommends calling \ref IRtcEngine::setAudioProfile "setAudioProfile", and setting the `scenario` parameter + * as `AUDIO_SCENARIO_GAME_STREAMING(3)` and the `profile` parameter as `AUDIO_PROFILE_MUSIC_HIGH_QUALITY(4)` or `AUDIO_PROFILE_MUSIC_HIGH_QUALITY_STEREO(5)`. + * + * @note + * - You can call this method either before or after joining a channel. + * - Do not set the `profile` parameter of \ref IRtcEngine::setAudioProfile "setAudioProfile" as `AUDIO_PROFILE_SPEECH_STANDARD(1)` or `AUDIO_PROFILE_IOT(6)`; otherwise, this method call does not take effect. + * - This method works best with the human voice. Agora does not recommend using this method for audio containing music. + * - After you call this method, Agora recommends not calling the following methods, because they can override `setVoiceBeautifierParameters`: + * - \ref IRtcEngine::setAudioEffectPreset "setAudioEffectPreset" + * - \ref IRtcEngine::setAudioEffectParameters "setAudioEffectParameters" + * - \ref IRtcEngine::setVoiceBeautifierPreset "setVoiceBeautifierPreset" + * - \ref IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" + * - \ref IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" + * - \ref IRtcEngine::setLocalVoicePitch "setLocalVoicePitch" + * - \ref IRtcEngine::setLocalVoiceEqualization "setLocalVoiceEqualization" + * - \ref IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb" + * + * @param preset The options for SDK preset voice beautifier effects: + * - `SINGING_BEAUTIFIER`: Singing beautifier effect. + * @param param1 The gender characteristics options for the singing voice: + * - `1`: A male-sounding voice. + * - `2`: A female-sounding voice. + * @param param2 The reverberation effects options: + * - `1`: The reverberation effect sounds like singing in a small room. + * - `2`: The reverberation effect sounds like singing in a large room. + * - `3`: The reverberation effect sounds like singing in a hall. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setVoiceBeautifierParameters(VOICE_BEAUTIFIER_PRESET preset, int param1, int param2) = 0; + /** Sets the log files that the SDK outputs. + * + * @deprecated This method is deprecated from v3.3.0. Use `logConfig` in the \ref IRtcEngine::initialize "initialize" method instead. + * + * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with a default size of 1024 KB. + * These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is full, the SDK deletes the log file with the earliest + * modification time among the other four, renames `agorasdk.log` to the name of the deleted log file, and create a new `agorasdk.log` to record latest logs. + * + * @note Ensure that you call this method immediately after calling \ref agora::rtc::IRtcEngine::initialize "initialize" , otherwise the output logs may not be complete. + * + * @see \ref IRtcEngine::setLogFileSize "setLogFileSize" + * @see \ref IRtcEngine::setLogFilter "setLogFilter" + * + * @param filePath The absolute path of log files. The default file path is `C: \Users\\AppData\Local\Agora\\agorasdk.log`. + * Ensure that the directory for the log files exists and is writable. You can use this parameter to rename the log files. + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int releaseLogWriter() = 0; - + virtual int setLogFile(const char* filePath) = 0; /** Sets the output log level of the SDK. + @deprecated This method is deprecated from v3.3.0. Use `logConfig` in the \ref IRtcEngine::initialize "initialize" method instead. + You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. + @see \ref IRtcEngine::setLogFile "setLogFile" + @see \ref IRtcEngine::setLogFileSize "setLogFileSize" + @param filter Sets the log filter level. See #LOG_FILTER_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setLogFilter(unsigned int filter) = 0; - /** Sets the log file size (KB). + virtual int setLogFilter(unsigned int filter) = 0; + /** Sets the size of a log file that the SDK outputs. + * + * @deprecated This method is deprecated from v3.3.0. Use `logConfig` in the \ref IRtcEngine::initialize "initialize" method instead. + * + * @note If you want to set the log file size, ensure that you call + * this method before \ref IRtcEngine::setLogFile "setLogFile", or the logs are cleared. + * + * By default, the SDK outputs five log files, `agorasdk.log`, `agorasdk_1.log`, `agorasdk_2.log`, `agorasdk_3.log`, `agorasdk_4.log`, each with a default size of 1024 KB. + * These log files are encoded in UTF-8. The SDK writes the latest logs in `agorasdk.log`. When `agorasdk.log` is full, the SDK deletes the log file with the earliest + * modification time among the other four, renames `agorasdk.log` to the name of the deleted log file, and create a new `agorasdk.log` to record latest logs. + * + * @see \ref IRtcEngine::setLogFile "setLogFile" + * @see \ref IRtcEngine::setLogFilter "setLogFilter" + * + * @param fileSizeInKBytes The size (KB) of a log file. The default value is 1024 KB. If you set `fileSizeInKByte` to 1024 KB, + * the SDK outputs at most 5 MB log files; if you set it to less than 1024 KB, the maximum size of a log file is still 1024 KB. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; + /// @cond + /** Uploads all SDK log files. + * + * @since v3.3.0 + * + * Uploads all SDK log files from the client to the Agora server. + * After a successful method call, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onUploadLogResult "onUploadLogResult" callback + * to report whether the log files are successfully uploaded to the Agora server. + * + * + * For easier debugging, Agora recommends that you bind this method to the UI element of your App, so as to instruct the + * user to upload a log file when a quality issue occurs. + * + * @note Do not call this method more than once per minute, otherwise the SDK reports #ERR_TOO_OFTEN (12). + * + * @param[out] requestId The request ID. This request ID is the same as requestId in the \ref IRtcEngineEventHandler::onUploadLogResult "onUploadLogResult" callback, + * and you can use the request ID to match a specific upload with a callback. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - -12(ERR_TOO_OFTEN): The call frequency exceeds the limit. + */ + virtual int uploadLogFile(agora::util::AString& requestId) = 0; + /// @endcond + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" [2/2] method instead. + Sets the local video display mode. - The SDK has two log files, each with a default size of 512 KB. If you set @p fileSizeInBytes as 1024 KB, the SDK outputs log files with a total maximum size of 2 MB. If the total size of the log files exceed the set value, the new output log files overwrite the old output log files. + This method can be called multiple times during a call to change the display mode. - @param fileSizeInKBytes The SDK log file size (KB). + @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. @return - 0: Success. - - <0: Failure. + - < 0: Failure. */ - virtual int setLogFileSize(unsigned int fileSizeInKBytes) = 0; - /** Sets the local video display mode. + virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; + /** Updates the display mode of the local video view. - This method can be called multiple times during a call to change the display mode. + @since v3.0.0 - @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. + After initializing the local video view, you can call this method to update its rendering and mirror modes. It affects only the video view that the local user sees, not the published local video stream. + + @note + - Ensure that you have called the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view before calling this method. + - During a call, you can call this method as many times as necessary to update the display mode of the local video view. + @param renderMode The rendering mode of the local video view. See #RENDER_MODE_TYPE. + @param mirrorMode + - The mirror mode of the local video view. See #VIDEO_MIRROR_MODE_TYPE. + - **Note**: If you use a front camera, the SDK enables the mirror mode by default; if you use a rear camera, the SDK disables the mirror mode by default. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode) = 0; - /** Sets the video display mode of a specified remote user. + virtual int setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setRemoteRenderMode" [2/2] method instead. + Sets the video display mode of a specified remote user. This method can be called multiple times during a call to change the display mode. @@ -5343,38 +7459,70 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; - /** Sets the local video mirror mode. + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode) = 0; + /** Updates the display mode of the video view of a remote user. + + @since v3.0.0 + After initializing the video view of a remote user, you can call this method to update its rendering and mirror modes. This method affects only the video view that the local user sees. + + @note + - Ensure that you have called the \ref IRtcEngine::setupRemoteVideo "setupRemoteVideo" method to initialize the remote video view before calling this method. + - During a call, you can call this method as many times as necessary to update the display mode of the video view of a remote user. + + @param userId The ID of the remote user. + @param renderMode The rendering mode of the remote video view. See #RENDER_MODE_TYPE. + @param mirrorMode + - The mirror mode of the remote video view. See #VIDEO_MIRROR_MODE_TYPE. + - **Note**: The SDK disables the mirror mode by default. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setRemoteRenderMode(uid_t userId, RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** + @deprecated This method is deprecated, use the \ref IRtcEngine::setupLocalVideo "setupLocalVideo" + or \ref IRtcEngine::setLocalRenderMode(RENDER_MODE_TYPE renderMode, VIDEO_MIRROR_MODE_TYPE mirrorMode) "setLocalRenderMode" method instead. + + Sets the local video mirror mode. - You must call this method before calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, otherwise the mirror mode will not work. + @warning Call this method after calling the \ref agora::rtc::IRtcEngine::setupLocalVideo "setupLocalVideo" method to initialize the local video view. @param mirrorMode Sets the local video mirror mode. See #VIDEO_MIRROR_MODE_TYPE. @return - 0: Success. - < 0: Failure. */ - virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; - /** Sets the stream mode to the single-stream (default) or dual-stream mode. (Live broadcast only.) + virtual int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) = 0; + /** Sets the stream mode to the single-stream (default) or dual-stream mode. (`LIVE_BROADCASTING` only.) If the dual-stream mode is enabled, the receiver can choose to receive the high stream (high-resolution and high-bitrate video stream), or the low stream (low-resolution and low-bitrate video stream). + @note You can call this method either before or after joining a channel. + @param enabled Sets the stream mode: - true: Dual-stream mode. - - false: (Default) Single-stream mode. + - false: Single-stream mode. */ - virtual int enableDualStreamMode(bool enabled) = 0; - /** Sets the external audio source. Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel". + virtual int enableDualStreamMode(bool enabled) = 0; + /** Sets the external audio source. + + @note Please call this method before \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" + and \ref IRtcEngine::startPreview "startPreview". @param enabled Sets whether to enable/disable the external audio source: - true: Enables the external audio source. - false: (Default) Disables the external audio source. - @param sampleRate Sets the sample rate of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param channels Sets the audio channels of the external audio source (two channels maximum). + @param sampleRate Sets the sample rate (Hz) of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. + @param channels Sets the number of audio channels of the external audio source: + - 1: Mono. + - 2: Stereo. + @return - 0: Success. - < 0: Failure. */ - virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; + virtual int setExternalAudioSource(bool enabled, int sampleRate, int channels) = 0; /** Sets the external audio sink. * This method applies to scenarios where you want to use external audio * data for playback. After enabling the external audio sink, you can call @@ -5382,15 +7530,15 @@ class IRtcEngine * it, and play it with the audio effects that you want. * * @note - * Once you enable the external audio sink, the app will not retrieve any + * - Once you enable the external audio sink, the app will not retrieve any * audio data from the * \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + * - Ensure that you call this method before joining a channel. * * @param enabled * - true: Enables the external audio sink. * - false: (Default) Disables the external audio sink. - * @param sampleRate Sets the sample rate of the external audio sink. You - * can set this parameter as 8000, 16000, 32000, 44100 or 48000. + * @param sampleRate Sets the sample rate (Hz) of the external audio sink, which can be set as 16000, 32000, 44100 or 48000. * @param channels Sets the number of audio channels of the external * audio sink: * - 1: Mono. @@ -5403,76 +7551,99 @@ class IRtcEngine virtual int setExternalAudioSink(bool enabled, int sampleRate, int channels) = 0; /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. + @note Ensure that you call this method before joining a channel. + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onRecordAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param channel Sets the number of audio channels (@p channels) returned in the *onRecordAudioFrame* callback: - 1: Mono - 2: Stereo @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onRecordAudioFrame* callback. - @param samplesPerCall Sets the sample points (@p samples) returned in the *onRecordAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. + @param samplesPerCall Sets the number of samples returned in the *onRecordAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP or RTMPS streaming. + - samplesPerCall = (int)(samplesPerSec × sampleInterval × numChannels), where sampleInterval ≥ 0.01 in seconds. + @note The SDK triggers the `onRecordAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). @return - 0: Success. - < 0: Failure. */ - virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + virtual int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; /** Sets the audio playback format for the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. + @note Ensure that you call this method before joining a channel. + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onPlaybackAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. @param channel Sets the number of channels (@p channels) returned in the *onPlaybackAudioFrame* callback: - 1: Mono - 2: Stereo @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onPlaybackAudioFrame* callback. - @param samplesPerCall Sets the sample points (*samples*) returned in the *onPlaybackAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. + @param samplesPerCall Sets the number of samples returned in the *onPlaybackAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP or RTMPS streaming. - samplesPerCall = (int)(samplesPerSec × sampleInterval × numChannels), where sampleInterval ≥ 0.01 in seconds. + @note The SDK triggers the `onPlaybackAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channel`). @return - 0: Success. - < 0: Failure. */ - virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; + virtual int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) = 0; /** Sets the mixed audio format for the \ref agora::media::IAudioFrameObserver::onMixedAudioFrame "onMixedAudioFrame" callback. + @note Ensure that you call this method before joining a channel. + @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onMixedAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param samplesPerCall Sets the sample points (@p samples) returned in the *onMixedAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. + @param samplesPerCall Sets the number of samples (`samples`) returned in the *onMixedAudioFrame* callback. `samplesPerCall` is usually set as 1024 for RTMP or RTMPS streaming. - samplesPerCall = (int)(samplesPerSec × sampleInterval × numChannels), where sampleInterval ≥ 0.01 in seconds. + @note The SDK triggers the `onMixedAudioFrame` callback according to the sample interval. Ensure that the sample interval ≥ 0.01 (s). And, Sample interval (sec) = `samplePerCall`/(`sampleRate` × `channels`). @return - 0: Success. - < 0: Failure. */ - virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; - /** Adjusts the recording volume. + virtual int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) = 0; + /** Adjusts the capturing signal volume. - @param volume Recording volume. The value ranges between 0 and 400: + @note You can call this method either before or after joining a channel. + + @param volume Volume. To avoid echoes and + improve call quality, Agora recommends setting the value of volume between + 0 and 100. If you need to set the value higher than 100, contact + support@agora.io first. - 0: Mute. - 100: Original volume. - - 400: (Maximum) Four times the original volume with signal clipping protection. + @return - 0: Success. - < 0: Failure. */ - virtual int adjustRecordingSignalVolume(int volume) = 0; - /** Adjusts the playback volume. + virtual int adjustRecordingSignalVolume(int volume) = 0; + /** Adjusts the playback signal volume of all remote users. - @param volume Playback volume. The value ranges between 0 and 400: + @note + - This method adjusts the playback volume that is the mixed volume of all remote users. + - You can call this method either before or after joining a channel. + - (Since v2.3.2) To mute the local audio playback, call both the `adjustPlaybackSignalVolume` and \ref IRtcEngine::adjustAudioMixingVolume "adjustAudioMixingVolume" methods and set the volume as `0`. + + @param volume The playback volume of all remote users. To avoid echoes and + improve call quality, Agora recommends setting the value of volume between + 0 and 100. If you need to set the value higher than 100, contact + support@agora.io first. - 0: Mute. - 100: Original volume. - - 400: (Maximum) Four times the original volume with signal clipping protection. @return - 0: Success. - < 0: Failure. */ - virtual int adjustPlaybackSignalVolume(int volume) = 0; + virtual int adjustPlaybackSignalVolume(int volume) = 0; - /** Enables interoperability with the Agora Web SDK. + /** + @deprecated This method is deprecated. As of v3.0.0, the Native SDK automatically enables interoperability with the Web SDK, so you no longer need to call this method. + Enables interoperability with the Agora Web SDK. - @note This method applies only to the Live-broadcast profile. In the Communication profile, interoperability with the Agora Web SDK is enabled by default. + @note + - This method applies only to the `LIVE_BROADCASTING` profile. In the `COMMUNICATION` profile, interoperability with the Agora Web SDK is enabled by default. + - If the channel has Web SDK users, ensure that you call this method, or the video of the Native user will be a black screen for the Web user. @param enabled Sets whether to enable/disable interoperability with the Agora Web SDK: - true: Enable. @@ -5482,21 +7653,38 @@ class IRtcEngine - 0: Success. - < 0: Failure. */ - virtual int enableWebSdkInteroperability(bool enabled) = 0; - /** Sets the fallback option for the locally published video stream based on the network conditions. + virtual int enableWebSdkInteroperability(bool enabled) = 0; + //only for live broadcast + /** **DEPRECATED** Sets the preferences for the high-quality video. (`LIVE_BROADCASTING` only). + + This method is deprecated as of v2.4.0. - The default setting for @p option is #STREAM_FALLBACK_OPTION_DISABLED, where there is no fallback behavior for the locally published video stream when the uplink network conditions are poor. + @param preferFrameRateOverImageQuality Sets the video quality preference: + - true: Frame rate over image quality. + - false: (Default) Image quality over frame rate. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setVideoQualityParameters(bool preferFrameRateOverImageQuality) = 0; + /** Sets the fallback option for the published video stream based on the network conditions. - If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK will: + If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK will: - - Disable the upstream video but enable audio only when the network conditions worsen and cannot support both video and audio. + - Disable the upstream video but enable audio only when the network conditions deteriorate and cannot support both video and audio. - Re-enable the video when the network conditions improve. - When the locally published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. + When the published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. - @note Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the locally publish stream falls back to audio-only. + @note + - Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the published video stream falls back to audio only. + - Ensure that you call this method before joining a channel. + + @param option Sets the fallback option for the published video stream: + - #STREAM_FALLBACK_OPTION_DISABLED (0): (Default) No fallback behavior for the published video stream when the uplink network condition is poor. The stream quality is not guaranteed. + - #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2): The published video stream falls back to audio only when the uplink network condition is poor. - @param option Sets the fallback option for the locally published video stream. See #STREAM_FALLBACK_OPTIONS. @return - 0: Success. - < 0: Failure. @@ -5504,12 +7692,14 @@ class IRtcEngine virtual int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; /** Sets the fallback option for the remotely subscribed video stream based on the network conditions. - The default setting for @p option is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW, where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. + The default setting for `option` is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW (1), where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. - If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. + If `option` is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY (2), the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. When the remotely subscribed video stream falls back to audio only or when the audio-only stream switches back to the video stream, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRemoteSubscribeFallbackToAudioOnly "onRemoteSubscribeFallbackToAudioOnly" callback. + @note Ensure that you call this method before joining a channel. + @param option Sets the fallback option for the remotely subscribed video stream. See #STREAM_FALLBACK_OPTIONS. @return - 0: Success. @@ -5518,41 +7708,62 @@ class IRtcEngine virtual int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) = 0; #if defined(__ANDROID__) || (defined(__APPLE__) && TARGET_OS_IOS) - /** Switches between front and rear cameras. + /** Switches between front and rear cameras. - @note This method is for Android and iOS only. + @note + - This method is for Android and iOS only. + - Ensure that you call this method after the camera starts, for example, by + calling \ref IRtcEngine::startPreview "startPreview" or \ref IRtcEngine::joinChannel "joinChannel". @return - 0: Success. - < 0: Failure. */ virtual int switchCamera() = 0; + /// @cond + /** Switches between front and rear cameras. + + @note This method is for Android and iOS only. + @note This method is private. + + @param direction Sets the camera to be used: + - CAMERA_DIRECTION.CAMERA_REAR: Use the rear camera. + - CAMERA_DIRECTION.CAMERA_FRONT: Use the front camera. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int switchCamera(CAMERA_DIRECTION direction) = 0; + /// @endcond /** Sets the default audio playback route. This method sets whether the received audio is routed to the earpiece or speakerphone by default before joining a channel. If a user does not call this method, the audio is routed to the earpiece by default. If you need to change the default audio route after joining a channel, call the \ref IRtcEngine::setEnableSpeakerphone "setEnableSpeakerphone" method. - The default setting for each mode: - - Voice: Earpiece. - - Video: Speakerphone. If a user who is in the Communication profile calls the \ref IRtcEngine::disableVideo "disableVideo" method or if the user calls the \ref IRtcEngine::muteLocalVideoStream "muteLocalVideoStream" and \ref IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the default audio route switches back to the earpiece automatically. - - Live Broadcast: Speakerphone. - - Gaming Voice: Speakerphone. + The default setting for each profile: + - `COMMUNICATION`: In a voice call, the default audio route is the earpiece. In a video call, the default audio route is the speakerphone. If a user who is in the `COMMUNICATION` profile calls + the \ref IRtcEngine.disableVideo "disableVideo" method or if the user calls + the \ref IRtcEngine.muteLocalVideoStream "muteLocalVideoStream" and + \ref IRtcEngine.muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" methods, the + default audio route switches back to the earpiece automatically. + - `LIVE_BROADCASTING`: Speakerphone. @note - This method is for Android and iOS only. - - This method only works in audio mode. + - This method is applicable only to the `COMMUNICATION` profile. + - For iOS, this method only works in a voice call. - Call this method before calling the \ref IRtcEngine::joinChannel "joinChannel" method. - - Regardless of whether the audio is routed to the speakerphone or earpiece by default, once a headset is plugged in or Bluetooth device is connected, the default audio route changes. The default audio route switches to the earpiece once removing the headset or disconnecting the Bluetooth device. @param defaultToSpeaker Sets the default audio route: - - true: Speakerphone. - - false: (Default) Earpiece. + - true: Route the audio to the speakerphone. If the playback device connects to the earpiece or Bluetooth, the audio cannot be routed to the speakerphone. + - false: (Default) Route the audio to the earpiece. If a headset is plugged in, the audio is routed to the headset. @return - 0: Success. - < 0: Failure. */ - virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; + virtual int setDefaultAudioRouteToSpeakerphone(bool defaultToSpeaker) = 0; /** Enables/Disables the audio playback route to the speakerphone. This method sets whether the audio is routed to the speakerphone or earpiece. @@ -5564,30 +7775,57 @@ class IRtcEngine - Ensure that you have successfully called the \ref IRtcEngine::joinChannel "joinChannel" method before calling this method. - After calling this method, the SDK returns the \ref IRtcEngineEventHandler::onAudioRouteChanged "onAudioRouteChanged" callback to indicate the changes. - This method does not take effect if a headset is used. + - Settings of \ref IRtcEngine::setAudioProfile "setAudioProfile" and \ref IRtcEngine::setChannelProfile "setChannelProfile" affect the call + result of `setEnableSpeakerphone`. The following are scenarios where `setEnableSpeakerphone` does not take effect: + - If you set `scenario` as `AUDIO_SCENARIO_GAME_STREAMING`, no user can change the audio playback route. + - If you set `scenario` as `AUDIO_SCENARIO_DEFAULT` or `AUDIO_SCENARIO_SHOWROOM`, the audience cannot change + the audio playback route. If there is only one broadcaster is in the channel, the broadcaster cannot change + the audio playback route either. + - If you set `scenario` as `AUDIO_SCENARIO_EDUCATION`, the audience cannot change the audio playback route. @param speakerOn Sets whether to route the audio to the speakerphone or earpiece: - - true: Route the audio to the speakerphone. - - false: Route the audio to the earpiece. + - true: Route the audio to the speakerphone. If the playback device connects to the earpiece or Bluetooth, the audio cannot be routed to the speakerphone. + - false: Route the audio to the earpiece. If a headset is plugged in, the audio is routed to the headset. @return - 0: Success. - < 0: Failure. */ - virtual int setEnableSpeakerphone(bool speakerOn) = 0; + virtual int setEnableSpeakerphone(bool speakerOn) = 0; + /** Enables in-ear monitoring (for Android and iOS only). + * + * @note + * - Users must use wired earphones to hear their own voices. + * - You can call this method either before or after joining a channel. + * + * @param enabled Determines whether to enable in-ear monitoring. + * - true: Enable. + * - false: (Default) Disable. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableInEarMonitoring(bool enabled) = 0; /** Sets the volume of the in-ear monitor. - - @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). - - @note This method is for Android and iOS only. - - @return - - 0: Success. - - < 0: Failure. + * + * @note + * - This method is for Android and iOS only. + * - Users must use wired earphones to hear their own voices. + * - You can call this method either before or after joining a channel. + * + * @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). + * + * @return + * - 0: Success. + * - < 0: Failure. */ - virtual int setInEarMonitoringVolume(int volume) = 0; + virtual int setInEarMonitoringVolume(int volume) = 0; /** Checks whether the speakerphone is enabled. - @note This method is for Android and iOS only. + @note + - This method is for Android and iOS only. + - You can call this method either before or after joining a channel. @return - 0: Success. @@ -5606,6 +7844,7 @@ class IRtcEngine @note - This method is for iOS only. - This method restricts the SDK’s manipulation of the audio session. Any operation to the audio session relies solely on the app, other apps, or third-party components. + - You can call this method either before or after joining a channel. @param restriction The operational restriction (bit mask) of the SDK on the audio session. See #AUDIO_SESSION_OPERATION_RESTRICTION. @@ -5617,74 +7856,202 @@ class IRtcEngine #endif #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) || defined(_WIN32) - /** Enables loopback recording. + /** Enables loopback audio capturing. + + If you enable loopback audio capturing, the output of the sound card is mixed into the audio stream sent to the other end. - If you enable loopback recording, the output of the sound card is mixed into the audio stream sent to the other end. + @note You can call this method either before or after joining a channel. - @param enabled Sets whether to enable/disable loopback recording. - - true: Enable loopback recording. - - false: (Default) Disable loopback recording. + @param enabled Sets whether to enable/disable loopback capturing. + - true: Enable loopback capturing. + - false: (Default) Disable loopback capturing. @param deviceName Pointer to the device name of the sound card. The default value is NULL (the default sound card). @note - This method is for macOS and Windows only. - - macOS does not support loopback recording of the default sound card. If you need to use this method, please use a virtual sound card and pass its name to the deviceName parameter. Agora has tested and recommends using soundflower. + - macOS does not support loopback capturing of the default sound card. If you need to use this method, please use a virtual sound card and pass its name to the deviceName parameter. Agora has tested and recommends using soundflower. */ virtual int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) = 0; #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) /** Shares the whole or part of a screen by specifying the display ID. - - @note This method is for macOS and Windows only. - - @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. - @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. - @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. - - - @return - - 0: Success. - - < 0: Failure: - - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call \ref IRtcEngine::stopScreenCapture "stopScreenCapture" to stop the current screen sharing. - - ERR_INVALID_ARGUMENT: the argument is invalid. + * + * @note + * - This method is for macOS only. + * - Ensure that you call this method after joining a channel. + * + * @param displayId The display ID of the screen to be shared. This parameter specifies which screen you want to share. + * @param regionRect (Optional) Sets the relative location of the region to the screen. NIL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + * @param captureParams The screen sharing encoding parameters. The default video dimension is 1920 x 1080, that is, 2,073,600 pixels. Agora uses the value of `videoDimension` to calculate the charges. + * For details, see descriptions in ScreenCaptureParameters. + * + * + * @return + * - 0: Success. + * - < 0: Failure: + * - #ERR_INVALID_ARGUMENT: The argument is invalid. */ virtual int startScreenCaptureByDisplayId(unsigned int displayId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; #endif #if defined(_WIN32) /** Shares the whole or part of a screen by specifying the screen rect. - - @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see [Share the Screen]. - @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. - @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. - - @return - - 0: Success. - - < 0: Failure: - - ERR_INVALID_STATE: the screen sharing state is invalid, probably because another screen or window is being shared. Call stopScreenCapture to stop the current screen sharing. - - ERR_INVALID_ARGUMENT: the argument is invalid. + * + * @note + * - Ensure that you call this method after joining a channel. + * - Applies to the Windows platform only. + * + * @param screenRect Sets the relative location of the screen to the virtual screen. For information on how to get screenRect, see the advanced guide *Share Screen*. + * @param regionRect (Optional) Sets the relative location of the region to the screen. NULL means sharing the whole screen. See Rectangle. If the specified region overruns the screen, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole screen. + * @param captureParams The screen sharing encoding parameters. The default video dimension is 1920 x 1080, that is, 2,073,600 pixels. + * Agora uses the value of `videoDimension` to calculate the charges. For details, see descriptions in ScreenCaptureParameters. + * + * @return + * - 0: Success. + * - < 0: Failure: + * - #ERR_INVALID_ARGUMENT : The argument is invalid. */ virtual int startScreenCaptureByScreenRect(const Rectangle& screenRect, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; #endif /** Shares the whole or part of a window by specifying the window ID. - - @param windowId The ID of the window to be shared. For information on how to get the windowId, see [Share the Window]. - @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. - @param captureParams Window sharing encoding parameters. See ScreenCaptureParameters. - - @return - - 0: Success. - - < 0: Failure: - - ERR_INVALID_STATE: the window sharing state is invalid, probably because another screen or window is being shared. Call stopScreenCapture to stop sharing the current window. - - ERR_INVALID_ARGUMENT: the argument is invalid. + * + * @note + * - Ensure that you call this method after joining a channel. + * - Applies to the macOS and Windows platforms only. + * + * Since v3.0.0, this method supports window sharing of UWP (Universal Windows Platform) applications. + * + * Agora tests the mainstream UWP applications by using the lastest SDK, see details as follows: + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + * + *
OS versionSoftwareSoftware nameWhether support
win10Chrome76.0.3809.100No
Office Word18.1903.1152.0Yes
Office ExcelNo
Office PPTYes
WPS Word11.1.0.9145Yes
WPS Excel
WPS PPT
Media Player (come with the system)AllYes
win8ChromeAllYes
Office WordAllYes
Office Excel
Office PPT
WPS Word11.1.0.9098Yes
WPS Excel
WPS PPT
Media Player(come with the system)AllYes
win7Chrome73.0.3683.103No
Office WordAllYes
Office Excel
Office PPT
WPS Word11.1.0.9098No
WPS Excel
WPS PPT11.1.0.9098Yes
Media Player(come with the system)AllNo
+ * @param windowId The ID of the window to be shared. For information on how to get the windowId, see the advanced guide *Share Screen*. + * @param regionRect (Optional) The relative location of the region to the window. NULL/NIL means sharing the whole window. See Rectangle. If the specified region overruns the window, the SDK shares only the region within it; if you set width or height as 0, the SDK shares the whole window. + * @param captureParams The screen sharing encoding parameters. The default video dimension is 1920 x 1080, that is, 2,073,600 pixels. Agora uses the value of `videoDimension` to calculate the charges. For details, see descriptions in ScreenCaptureParameters. + * + * @return + * - 0: Success. + * - < 0: Failure: + * - #ERR_INVALID_ARGUMENT: The argument is invalid. */ virtual int startScreenCaptureByWindowId(view_t windowId, const Rectangle& regionRect, const ScreenCaptureParameters& captureParams) = 0; /** Sets the content hint for screen sharing. - A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. + A content hint suggests the type of the content being shared, so that the SDK applies different optimization algorithm to different types of content. + + @note You can call this method either before or after you start screen sharing. @param contentHint Sets the content hint for screen sharing. See VideoContentHint. @@ -5696,12 +8063,14 @@ class IRtcEngine /** Updates the screen sharing parameters. - @param captureParams Sets the screen sharing encoding parameters. See ScreenCaptureParameters. + @param captureParams The screen sharing encoding parameters. The default video dimension is 1920 x 1080, that is, + 2,073,600 pixels. Agora uses the value of `videoDimension` to calculate the charges. For details, + see descriptions in ScreenCaptureParameters. @return - 0: Success. - < 0: Failure: - - ERR_NOT_READY: no screen or windows is being shared. + - #ERR_NOT_READY: no screen or windows is being shared. */ virtual int updateScreenCaptureParameters(const ScreenCaptureParameters& captureParams) = 0; @@ -5712,7 +8081,7 @@ class IRtcEngine @return - 0: Success. - < 0: Failure: - - ERR_NOT_READY: no screen or window is being shared. + - #ERR_NOT_READY: no screen or window is being shared. */ virtual int updateScreenCaptureRegion(const Rectangle& regionRect) = 0; @@ -5766,6 +8135,25 @@ class IRtcEngine - < 0: Failure. */ virtual int updateScreenCaptureRegion(const Rect *rect) = 0; + +#endif + +#if defined(_WIN32) + /** Sets a custom video source. + * + * During real-time communication, the Agora SDK enables the default video input device, that is, the built-in camera to + * capture video. If you need a custom video source, implement the IVideoSource class first, and call this method to add + * the custom video source to the SDK. + * + * @note You can call this method either before or after joining a channel. + * + * @param source The custom video source. See IVideoSource. + * + * @return + * - true: The custom video source is added to the SDK. + * - false: The custom video source is not added to the SDK. + */ + virtual bool setVideoSource(IVideoSource *source) = 0; #endif /** Retrieves the current call ID. @@ -5774,6 +8162,8 @@ class IRtcEngine The \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods require the @p callId parameter retrieved from the *getCallId* method during a call. @p callId is passed as an argument into the \ref IRtcEngine::rate "rate" and \ref IRtcEngine::complain "complain" methods after the call ends. + @note Ensure that you call this method after joining a channel. + @param callId Pointer to the current call ID. @return @@ -5784,6 +8174,8 @@ class IRtcEngine /** Allows a user to rate a call after the call ends. + @note Ensure that you call this method after joining a channel. + @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. @param rating Rating of the call. The value is between 1 (lowest score) and 5 (highest score). If you set a value out of this range, the #ERR_INVALID_ARGUMENT (2) error returns. @param description (Optional) Pointer to the description of the rating, with a string length of less than 800 bytes. @@ -5796,6 +8188,8 @@ class IRtcEngine /** Allows a user to complain about the call quality after a call ends. + @note Ensure that you call this method after joining a channel. + @param callId Pointer to the ID of the call, retrieved from the \ref IRtcEngine::getCallId "getCallId" method. @param description (Optional) Pointer to the description of the complaint, with a string length of less than 800 bytes. @@ -5826,6 +8220,7 @@ class IRtcEngine @note - Do not call any other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" callback. Otherwise, the callback may be interrupted by other methods, and hence may not be triggered. - A host should not call this method after joining a channel (when in a call). + - If you call this method to test the last mile network quality, the SDK consumes the bandwidth of a video stream, whose bitrate corresponds to the bitrate you set in the \ref agora::rtc::IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method. After you join the channel, whether you have called the `disableLastmileTest` method or not, the SDK automatically stops consuming the bandwidth. @return - 0: Success. @@ -5843,7 +8238,7 @@ class IRtcEngine /** Starts the last-mile network probe test. - This method starts the last-mile network probe test before joining a channel to get the uplink and downlink last-mile network statistics, including the bandwidth, packet loss, jitter, and round-trip time (RTT). + This method starts the last-mile network probe test before joining a channel to get the uplink and downlink last mile network statistics, including the bandwidth, packet loss, jitter, and round-trip time (RTT). Call this method to check the uplink network quality before users join a channel or before an audience switches to a host. Once this method is enabled, the SDK returns the following callbacks: @@ -5853,7 +8248,7 @@ class IRtcEngine @note - This method consumes extra network traffic and may affect communication quality. We do not recommend calling this method together with enableLastmileTest. - Do not call other methods before receiving the \ref IRtcEngineEventHandler::onLastmileQuality "onLastmileQuality" and \ref IRtcEngineEventHandler::onLastmileProbeResult "onLastmileProbeResult" callbacks. Otherwise, the callbacks may be interrupted. - - In the Live-broadcast profile, a host should not call this method after joining a channel. + - In the `LIVE_BROADCASTING` profile, a host should not call this method after joining a channel. @param config Sets the configurations of the last-mile network probe test. See LastmileProbeConfig. @@ -5868,11 +8263,15 @@ class IRtcEngine /** Retrieves the warning or error description. - @return code #WARN_CODE_TYPE or #ERROR_CODE_TYPE returned in the \ref IRtcEngineEventHandler::onWarning "onWarning" or \ref IRtcEngineEventHandler::onError "onError" callback. + @param code Warning code or error code returned in the \ref agora::rtc::IRtcEngineEventHandler::onWarning "onWarning" or \ref agora::rtc::IRtcEngineEventHandler::onError "onError" callback. + + @return #WARN_CODE_TYPE or #ERROR_CODE_TYPE. */ virtual const char* getErrorDescription(int code) = 0; - /** Enables built-in encryption with an encryption password before users join a channel. + /** **DEPRECATED** Enables built-in encryption with an encryption password before users join a channel. + + Deprecated as of v3.1.0. Use the \ref agora::rtc::IRtcEngine::enableEncryption "enableEncryption" instead. All users in a channel must use the same encryption password. The encryption password is automatically cleared once a user leaves the channel. @@ -5890,7 +8289,9 @@ class IRtcEngine */ virtual int setEncryptionSecret(const char* secret) = 0; - /** Sets the built-in encryption mode. + /** **DEPRECATED** Sets the built-in encryption mode. + + @deprecated Deprecated as of v3.1.0. Use the \ref agora::rtc::IRtcEngine::enableEncryption "enableEncryption" instead. The Agora SDK supports built-in encryption, which is set to the @p aes-128-xts mode by default. Call this method to use other encryption modes. @@ -5912,10 +8313,42 @@ class IRtcEngine */ virtual int setEncryptionMode(const char* encryptionMode) = 0; + /** Enables/Disables the built-in encryption. + * + * @since v3.1.0 + * + * In scenarios requiring high security, Agora recommends calling this method to enable the built-in encryption before joining a channel. + * + * All users in the same channel must use the same encryption mode and encryption key. Once all users leave the channel, the encryption key of this channel is automatically cleared. + * + * @note + * - If you enable the built-in encryption, you cannot use the RTMP or RTMPS streaming function. + * - You need to add an external encryption library when integrating the Android and iOS SDK. See the advanced guide *Channel Encryption*. + * + * @param enabled Whether to enable the built-in encryption: + * - true: Enable the built-in encryption. + * - false: Disable the built-in encryption. + * @param config Configurations of built-in encryption schemas. See EncryptionConfig. + * + * @return + * - 0: Success. + * - < 0: Failure. + * - -2(ERR_INVALID_ARGUMENT): An invalid parameter is used. Set the parameter with a valid value. + * - -4(ERR_NOT_SUPPORTED): The encryption mode is incorrect or the SDK fails to load the external encryption library. Check the enumeration or reload the external encryption library. + * - -7(ERR_NOT_INITIALIZED): The SDK is not initialized. Initialize the `IRtcEngine` instance before calling this method. + */ + virtual int enableEncryption(bool enabled, const EncryptionConfig& config) = 0; + /** Registers a packet observer. The Agora SDK allows your application to register a packet observer to receive callbacks for voice or video packet transmission. + @note + - The size of the packet sent to the network after processing should not exceed 1200 bytes, otherwise, the packet may fail to be sent. + - Ensure that both receivers and senders call this method, otherwise, you may meet undefined behaviors such as no voice and black screen. + - When you use CDN live streaming, recording or storage functions, Agora doesn't recommend calling this method. + - Call this method before joining a channel. + @param observer Pointer to the registered packet observer. See IPacketObserver. @return @@ -5926,11 +8359,15 @@ class IRtcEngine /** Creates a data stream. - Each user can create up to five data streams during the lifecycle of the RtcEngine. + @deprecated This method is deprecated from v3.3.0. Use the \ref IRtcEngine::createDataStream(int* streamId, DataStreamConfig& config) "createDataStream" [2/2] method instead. - @note Set both the @p reliable and @p ordered parameters to true or false. Do not set one as true and the other as false. + Each user can create up to five data streams during the lifecycle of the IRtcEngine. - @param streamId Pointer to the ID of the created data stream. + @note + - Do not set `reliable` as `true` while setting `ordered` as `false`. + - Ensure that you call this method after joining a channel. + + @param[out] streamId Pointer to the ID of the created data stream. @param reliable Sets whether or not the recipients are guaranteed to receive the data stream from the sender within five seconds: - true: The recipients receive the data stream from the sender within five seconds. If the recipient does not receive the data stream within five seconds, an error is reported to the application. - false: There is no guarantee that the recipients receive the data stream within five seconds and no error message is reported for any delay or missing data stream. @@ -5939,10 +8376,27 @@ class IRtcEngine - false: The recipients do not receive the data stream in the sent order. @return - - Returns 0: Success. + - 0: Success. - < 0: Failure. */ virtual int createDataStream(int* streamId, bool reliable, bool ordered) = 0; + /** Creates a data stream. + * + * @since v3.3.0 + * + * Each user can create up to five data streams in a single channel. + * + * This method does not support data reliability. If the receiver receives a data packet five + * seconds or more after it was sent, the SDK directly discards the data. + * + * @param[out] streamId The ID of the created data stream. + * @param config The configurations for the data stream: DataStreamConfig. + * + * @return + * - 0: Creates the data stream successfully. + * - < 0: Fails to create the data stream. + */ + virtual int createDataStream(int* streamId, DataStreamConfig& config) = 0; /** Sends data stream messages to all users in a channel. @@ -5951,11 +8405,12 @@ class IRtcEngine - Each client can send up to 6 kB of data per second. - Each user can have up to five data streams simultaneously. - A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. - - A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onStreamMessageError "onStreamMessage" callback on the remote client. - @note This method applies only to the Communication profile or to the hosts in the Live-broadcast profile. If an audience in the Live-broadcast profile calls this method, the audience may be switched to a host. + A successful \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the + \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client, from which the remote user gets the stream message. + A failed \ref agora::rtc::IRtcEngine::sendStreamMessage "sendStreamMessage" method call triggers the + \ref agora::rtc::IRtcEngineEventHandler::onStreamMessage "onStreamMessage" callback on the remote client. + @note This method applies only to the `COMMUNICATION` profile or to the hosts in the `LIVE_BROADCASTING` profile. If an audience in the `LIVE_BROADCASTING` profile calls this method, the audience may be switched to a host. @param streamId ID of the sent data stream, returned in the \ref IRtcEngine::createDataStream "createDataStream" method. @param data Pointer to the sent data. @param length Length of the sent data. @@ -5966,41 +8421,42 @@ class IRtcEngine */ virtual int sendStreamMessage(int streamId, const char* data, size_t length) = 0; - /** Publishes the local stream to a specified CDN live RTMP address. (CDN live only.) + /** Publishes the local stream to a specified CDN live address. (CDN live only.) The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback. The \ref agora::rtc::IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of adding a local stream to the CDN. @note - Ensure that the user joins the channel before calling this method. - - This method adds only one stream RTMP URL address each time it is called. - - The RTMP URL address must not contain special characters, such as Chinese language characters. - - This method applies to Live Broadcast only. + - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. + - This method adds only one stream CDN streaming URL each time it is called. + - This method applies to `LIVE_BROADCASTING` only. - @param url The CDN streaming URL in the RTMP format. The maximum length of this parameter is 1024 bytes. + @param url The CDN streaming URL in the RTMP or RTMPS format. The maximum length of this parameter is 1024 bytes. The CDN streaming URL must not contain special characters, such as Chinese language characters. @param transcodingEnabled Sets whether transcoding is enabled/disabled: - - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. + - true: Enable transcoding. To [transcode](https://docs.agora.io/en/Agora%20Platform/terms?platform=All%20Platforms#transcoding) the audio or video streams when publishing them to CDN live, often used for combining the audio and video streams of multiple hosts in CDN live. If you set this parameter as `true`, ensure that you call the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method before this method. - false: Disable transcoding. @return - 0: Success. - < 0: Failure. - - #ERR_INVALID_ARGUMENT (2): The RTMP URL address is NULL or has a string length of 0. - - #ERR_NOT_INITIALIZED (7): You have not initialized the RTC engine when publishing the stream. + - #ERR_INVALID_ARGUMENT (-2): The CDN streaming URL is NULL or has a string length of 0. + - #ERR_NOT_INITIALIZED (-7): You have not initialized the RTC engine when publishing the stream. */ virtual int addPublishStreamUrl(const char *url, bool transcodingEnabled) = 0; - /** Removes an RTMP stream from the CDN. (CDN live only.) + /** Removes an RTMP or RTMPS stream from the CDN. (CDN live only.) - This method removes the RTMP URL address (added by the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamUnpublished "onStreamUnpublished" callback. + This method removes the CDN streaming URL (added by the \ref IRtcEngine::addPublishStreamUrl "addPublishStreamUrl" method) from a CDN live stream. The SDK returns the result of this method call in the \ref IRtcEngineEventHandler::onStreamUnpublished "onStreamUnpublished" callback. + + The \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP or RTMPS stream from the CDN. - The \ref agora::rtc::IRtcEngine::removePublishStreamUrl "removePublishStreamUrl" method call triggers the \ref agora::rtc::IRtcEngineEventHandler::onRtmpStreamingStateChanged "onRtmpStreamingStateChanged" callback on the local client to report the state of removing an RTMP stream from the CDN. @note - - This method removes only one RTMP URL address each time it is called. - - The RTMP URL address must not contain special characters, such as Chinese language characters. - - This method applies to Live Broadcast only. + - This method removes only one CDN streaming URL each time it is called. + - The CDN streaming URL must not contain special characters, such as Chinese language characters. + - This method applies to `LIVE_BROADCASTING` only. - @param url The RTMP URL address to be removed. The maximum length of this parameter is 1024 bytes. + @param url The CDN streaming URL to be removed. The maximum length of this parameter is 1024 bytes. @return - 0: Success. @@ -6009,7 +8465,15 @@ class IRtcEngine virtual int removePublishStreamUrl(const char *url) = 0; /** Sets the video layout and audio settings for CDN live. (CDN live only.) - @note This method applies to Live Broadcast only. + + The SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onTranscodingUpdated "onTranscodingUpdated" callback when you call the `setLiveTranscoding` method to update the transcoding setting. + + @note + - This method applies to `LIVE_BROADCASTING` only. + - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. + - If you call the `setLiveTranscoding` method to update the transcoding setting for the first time, the SDK does not trigger the `onTranscodingUpdated` callback. + - Ensure that you call this method after joining a channel. + - Agora supports pushing media streams in RTMPS protocol to the CDN only when you enable transcoding. @param transcoding Sets the CDN live audio/video transcoding settings. See LiveTranscoding. @@ -6019,9 +8483,11 @@ class IRtcEngine */ virtual int setLiveTranscoding(const LiveTranscoding &transcoding) = 0; - /** Adds a watermark image to the local video or CDN live stream. + /** **DEPRECATED** Adds a watermark image to the local video or CDN live stream. - This method adds a PNG watermark image to the local video stream for the recording device, channel audience, and CDN live audience to view and capture. + This method is deprecated from v2.9.1. Use \ref agora::rtc::IRtcEngine::addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) "addVideoWatermark" [2/2] instead. + + This method adds a PNG watermark image to the local video stream for the capturing device, channel audience, and CDN live audience to view and capture. To add the PNG file to the CDN live publishing stream, see the \ref IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. @@ -6029,8 +8495,8 @@ class IRtcEngine @note - The URL descriptions are different for the local video and CDN live streams: - - In a local video stream, @p url in RtcImage refers to the absolute path of the added watermark image file in the local video stream. - - In a CDN live stream, @p url in RtcImage refers to the URL address of the added watermark image in the CDN live broadcast. + - In a local video stream, `url` in RtcImage refers to the absolute path of the added watermark image file in the local video stream. + - In a CDN live stream, `url` in RtcImage refers to the URL address of the added watermark image in the CDN live streaming. - The source file of the watermark image must be in the PNG file format. If the width and height of the PNG file differ from your settings in this method, the PNG file will be cropped to conform to your settings. - The Agora SDK supports adding only one watermark image onto a local video or CDN live stream. The newly added watermark image replaces the previous one. @@ -6040,31 +8506,56 @@ class IRtcEngine */ virtual int addVideoWatermark(const RtcImage& watermark) = 0; - /** Removes the watermark image from the video stream added by the \ref IRtcEngine::addVideoWatermark "addVideoWatermark" method. + /** Adds a watermark image to the local video. + + This method adds a PNG watermark image to the local video in the live streaming. Once the watermark image is added, all the audience in the channel (CDN audience included), + and the capturing device can see and capture it. Agora supports adding only one watermark image onto the local video, and the newly watermark image replaces the previous one. + + The watermark position depends on the settings in the \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration" method: + - If the orientation mode of the encoding video is #ORIENTATION_MODE_FIXED_LANDSCAPE, or the landscape mode in #ORIENTATION_MODE_ADAPTIVE, the watermark uses the landscape orientation. + - If the orientation mode of the encoding video is #ORIENTATION_MODE_FIXED_PORTRAIT, or the portrait mode in #ORIENTATION_MODE_ADAPTIVE, the watermark uses the portrait orientation. + - When setting the watermark position, the region must be less than the dimensions set in the `setVideoEncoderConfiguration` method. Otherwise, the watermark image will be cropped. + + @note + - Ensure that you have called the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method to enable the video module before calling this method. + - If you only want to add a watermark image to the local video for the audience in the CDN live streaming channel to see and capture, you can call this method or the \ref agora::rtc::IRtcEngine::setLiveTranscoding "setLiveTranscoding" method. + - This method supports adding a watermark image in the PNG file format only. Supported pixel formats of the PNG image are RGBA, RGB, Palette, Gray, and Alpha_gray. + - If the dimensions of the PNG image differ from your settings in this method, the image will be cropped or zoomed to conform to your settings. + - If you have enabled the local video preview by calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, you can use the `visibleInPreview` member in the WatermarkOptions class to set whether or not the watermark is visible in preview. + - If you have enabled the mirror mode for the local video, the watermark on the local video is also mirrored. To avoid mirroring the watermark, Agora recommends that you do not use the mirror and watermark functions for the local video at the same time. You can implement the watermark function in your application layer. + + @param watermarkUrl The local file path of the watermark image to be added. This method supports adding a watermark image from the local absolute or relative file path. + @param options Pointer to the watermark's options to be added. See WatermarkOptions for more infomation. @return - 0: Success. - < 0: Failure. */ - virtual int clearVideoWatermarks() = 0; + virtual int addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) = 0; + + /** Removes the watermark image from the video stream added by the \ref agora::rtc::IRtcEngine::addVideoWatermark(const char* watermarkUrl, const WatermarkOptions& options) "addVideoWatermark" method. - /** **Supports Android and iOS only!** Enables/Disables image enhancement and sets the options. + @return + - 0: Success. + - < 0: Failure. + */ + virtual int clearVideoWatermarks() = 0; - @param enabled Sets whether or not to enable image enhancement: - - true: enables image enhancement. - - false: disables image enhancement. - @param options Sets the image enhancement option. See BeautyOptions. + /** Enables/Disables image enhancement and sets the options. + * + * @note Call this method after calling the \ref IRtcEngine::enableVideo "enableVideo" method. + * + * @param enabled Sets whether or not to enable image enhancement: + * - true: enables image enhancement. + * - false: disables image enhancement. + * @param options Sets the image enhancement option. See BeautyOptions. */ virtual int setBeautyEffectOptions(bool enabled, BeautyOptions options) = 0; - /** Adds a voice or video stream URL address to a live broadcast. + /** Adds a voice or video stream URL address to the live streaming. The \ref IRtcEngineEventHandler::onStreamPublished "onStreamPublished" callback returns the inject status. If this method call is successful, the server pulls the voice or video stream and injects it into a live channel. This is applicable to scenarios where all audience members in the channel can watch a live show and interact with each other. - @note - - Contact support@agora.io to enable the CDN streaming function before calling this method. - - This method applies to the Native SDK v2.4.1 and later. - The \ref agora::rtc::IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method call triggers the following callbacks: - The local client: - \ref agora::rtc::IRtcEngineEventHandler::onStreamInjectedStatus "onStreamInjectedStatus" , with the state of the injecting the online stream. @@ -6072,18 +8563,25 @@ class IRtcEngine - The remote client: - \ref agora::rtc::IRtcEngineEventHandler::onUserJoined "onUserJoined" (uid: 666), if the method call is successful and the online media stream is injected into the channel. - @param url Pointer to the URL address to be added to the ongoing live broadcast. Valid protocols are RTMP, HLS, and FLV. - - Supported FLV audio codec type: AAC. - - Supported FLV video codec type: H264 (AVC). + @note + - Ensure that you enable the RTMP Converter service before using this function. See *Prerequisites* in the advanced guide *Push Streams to CDN*. + - This method applies to the Native SDK v2.4.1 and later. + - This method applies to the `LIVE_BROADCASTING` profile only. + - You can inject only one media stream into the channel at the same time. + - Ensure that you call this method after joining a channel. + + @param url Pointer to the URL address to be added to the ongoing streaming. Valid protocols are RTMP, HLS, and HTTP-FLV. + - Supported audio codec type: AAC. + - Supported video codec type: H264 (AVC). @param config Pointer to the InjectStreamConfig object that contains the configuration of the added voice or video stream. @return - 0: Success. - < 0: Failure. - - #ERR_INVALID_ARGUMENT (2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. - - #ERR_NOT_READY (3): The user is not in the channel. - - #ERR_NOT_SUPPORTED (4): The channel profile is not live broadcast. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to live broadcast before calling this method. - - #ERR_NOT_INITIALIZED (7): The SDK is not initialized. Ensure that the IRtcEngine object is initialized before calling this method. + - #ERR_INVALID_ARGUMENT (-2): The injected URL does not exist. Call this method again to inject the stream and ensure that the URL is valid. + - #ERR_NOT_READY (-3): The user is not in the channel. + - #ERR_NOT_SUPPORTED (-4): The channel profile is not `LIVE_BROADCASTING`. Call the \ref agora::rtc::IRtcEngine::setChannelProfile "setChannelProfile" method and set the channel profile to `LIVE_BROADCASTING` before calling this method. + - #ERR_NOT_INITIALIZED (-7): The SDK is not initialized. Ensure that the IRtcEngine object is initialized before calling this method. */ virtual int addInjectStreamUrl(const char* url, const InjectStreamConfig& config) = 0; /** Starts to relay media streams across channels. @@ -6097,10 +8595,10 @@ class IRtcEngine * - If the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged * "onChannelMediaRelayStateChanged" callback returns - * #RELAY_STATE_RUNNING (1) and #RELAY_OK (0), and the + * #RELAY_STATE_RUNNING (2) and #RELAY_OK (0), and the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent * "onChannelMediaRelayEvent" callback returns - * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the broadcaster starts + * #RELAY_EVENT_PACKET_SENT_TO_DEST_CHANNEL (4), the host starts * sending data to the destination channel. * - If the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged @@ -6110,12 +8608,14 @@ class IRtcEngine * * @note * - Call this method after the \ref joinChannel() "joinChannel" method. - * - This method takes effect only when you are a broadcaster in a - * Live-broadcast channel. + * - This method takes effect only when you are a host in a + * `LIVE_BROADCASTING` channel. * - After a successful method call, if you want to call this method * again, ensure that you call the * \ref stopChannelMediaRelay() "stopChannelMediaRelay" method to quit the * current relay. + * - Contact sales-us@agora.io before implementing this function. + * - We do not support string user accounts in this API. * * @param configuration The configuration of the media stream relay: * ChannelMediaRelayConfiguration. @@ -6124,7 +8624,7 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + virtual int startChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Updates the channels for media stream relay. After a successful * \ref startChannelMediaRelay() "startChannelMediaRelay" method call, if * you want to relay the media stream to more channels, or leave the @@ -6132,8 +8632,8 @@ class IRtcEngine * \ref updateChannelMediaRelay() "updateChannelMediaRelay" method. * * After a successful method call, the SDK triggers the - * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged - * "onChannelMediaRelayStateChanged" callback with the + * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayEvent + * "onChannelMediaRelayEvent" callback with the * #RELAY_EVENT_PACKET_UPDATE_DEST_CHANNEL (7) state code. * * @note @@ -6148,16 +8648,16 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; + virtual int updateChannelMediaRelay(const ChannelMediaRelayConfiguration &configuration) = 0; /** Stops the media stream relay. * - * Once the relay stops, the broadcaster quits all the destination + * Once the relay stops, the host quits all the destination * channels. * * After a successful method call, the SDK triggers the * \ref agora::rtc::IRtcEngineEventHandler::onChannelMediaRelayStateChanged * "onChannelMediaRelayStateChanged" callback. If the callback returns - * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the broadcaster successfully + * #RELAY_STATE_IDLE (0) and #RELAY_OK (0), the host successfully * stops the relay. * * @note @@ -6173,40 +8673,104 @@ class IRtcEngine * - 0: Success. * - < 0: Failure. */ - virtual int stopChannelMediaRelay() = 0; + virtual int stopChannelMediaRelay() = 0; - /** Removes the voice or video stream URL address from a live broadcast. + /** Removes the voice or video stream URL address from the live streaming. - This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live broadcast. + This method removes the URL address (added by the \ref IRtcEngine::addInjectStreamUrl "addInjectStreamUrl" method) from the live streaming. @note If this method is called successfully, the SDK triggers the \ref IRtcEngineEventHandler::onUserOffline "onUserOffline" callback and returns a stream uid of 666. - @param url Pointer to the URL address of the added stream to be removed. + @param url Pointer to the URL address of the injected stream to be removed. @return - 0: Success. - < 0: Failure. */ virtual int removeInjectStreamUrl(const char* url) = 0; - virtual bool registerEventHandler(IRtcEngineEventHandler *eventHandler) = 0; virtual bool unregisterEventHandler(IRtcEngineEventHandler *eventHandler) = 0; + /** Agora supports reporting and analyzing customized messages. + * + * @since v3.1.0 + * + * This function is in the beta stage with a free trial. The ability provided in its beta test version is reporting a maximum of 10 message pieces within 6 seconds, with each message piece not exceeding 256 bytes and each string not exceeding 100 bytes. + * To try out this function, contact [support@agora.io](mailto:support@agora.io) and discuss the format of customized messages with us. + */ virtual int sendCustomReportMessage(const char *id, const char* category, const char* event, const char* label, int value) = 0; + /** Gets the current connection state of the SDK. - /** Gets the connection state of the SDK. + @note You can call this method either before or after joining a channel. @return #CONNECTION_STATE_TYPE. */ virtual CONNECTION_STATE_TYPE getConnectionState() = 0; + /// @cond + /** Enables/Disables the super-resolution algorithm for a remote user's video stream. + * + * @since v3.2.0 + * + * The algorithm effectively improves the resolution of the specified remote user's video stream. When the original + * resolution of the remote video stream is a × b pixels, you can receive and render the stream at a higher + * resolution (2a × 2b pixels) by enabling the algorithm. + * + * After calling this method, the SDK triggers the + * \ref IRtcEngineEventHandler::onUserSuperResolutionEnabled "onUserSuperResolutionEnabled" callback to report + * whether you have successfully enabled the super-resolution algorithm. + * + * @warning The super-resolution algorithm requires extra system resources. + * To balance the visual experience and system usage, the SDK poses the following restrictions: + * - The algorithm can only be used for a single user at a time. + * - On the Android platform, the original resolution of the remote video must not exceed 640 × 360 pixels. + * - On the iOS platform, the original resolution of the remote video must not exceed 640 × 480 pixels. + * If you exceed these limitations, the SDK triggers the \ref IRtcEngineEventHandler::onWarning "onWarning" + * callback with the corresponding warning codes: + * - #WARN_SUPER_RESOLUTION_STREAM_OVER_LIMITATION (1610): The origin resolution of the remote video is beyond the range where the super-resolution algorithm can be applied. + * - #WARN_SUPER_RESOLUTION_USER_COUNT_OVER_LIMITATION (1611): Another user is already using the super-resolution algorithm. + * - #WARN_SUPER_RESOLUTION_DEVICE_NOT_SUPPORTED (1612): The device does not support the super-resolution algorithm. + * + * @note + * - This method applies to Android and iOS only. + * - Requirements for the user's device: + * - Android: The following devices are known to support the method: + * - VIVO: V1821A, NEX S, 1914A, 1916A, and 1824BA + * - OPPO: PCCM00 + * - OnePlus: A6000 + * - Xiaomi: Mi 8, Mi 9, MIX3, and Redmi K20 Pro + * - SAMSUNG: SM-G9600, SM-G9650, SM-N9600, SM-G9708, SM-G960U, and SM-G9750 + * - HUAWEI: SEA-AL00, ELE-AL00, VOG-AL00, YAL-AL10, HMA-AL00, and EVR-AN00 + * - iOS: This method is supported on devices running iOS 12.0 or later. The following + * device models are known to support the method: + * - iPhone XR + * - iPhone XS + * - iPhone XS Max + * - iPhone 11 + * - iPhone 11 Pro + * - iPhone 11 Pro Max + * - iPad Pro 11-inch (3rd Generation) + * - iPad Pro 12.9-inch (3rd Generation) + * - iPad Air 3 (3rd Generation) + * + * @param userId The ID of the remote user. + * @param enable Whether to enable the super-resolution algorithm: + * - true: Enable the super-resolution algorithm. + * - false: Disable the super-resolution algorithm. + * + * @return + * - 0: Success. + * - < 0: Failure. + */ + virtual int enableRemoteSuperResolution(uid_t userId, bool enable) = 0; + /// @endcond /** Registers the metadata observer. Registers the metadata observer. You need to implement the IMetadataObserver class and specify the metadata type in this method. A successful call of this method triggers the \ref agora::rtc::IMetadataObserver::getMaxMetadataSize "getMaxMetadataSize" callback. - This method enables you to add synchronized metadata in the video stream for more diversified live broadcast interactions, such as sending shopping links, digital coupons, and online quizzes. + This method enables you to add synchronized metadata in the video stream for more diversified interactive live streaming, such as sending shopping links, digital coupons, and online quizzes. @note - Call this method before the joinChannel method. - - This method applies to the Live-broadcast channel profile. + - This method applies to the `LIVE_BROADCASTING` channel profile. @param observer The IMetadataObserver class. See the definition of IMetadataObserver for details. @param type See \ref IMetadataObserver::METADATA_TYPE "METADATA_TYPE". The SDK supports VIDEO_METADATA (0) only for now. @@ -6216,12 +8780,24 @@ class IRtcEngine - < 0: Failure. */ virtual int registerMediaMetadataObserver(IMetadataObserver *observer, IMetadataObserver::METADATA_TYPE type) = 0; + /** Provides technical preview functionalities or special customizations by configuring the SDK with JSON options. + + The JSON options are not public by default. Agora is working on making commonly used JSON options public in a standard way. + + @param parameters Sets the parameter as a JSON string in the specified format. + + @return + - 0: Success. + - < 0: Failure. + */ + virtual int setParameters(const char* parameters) = 0; }; class IRtcEngineParameter { public: + virtual ~IRtcEngineParameter () {} /** * Releases all IRtcEngineParameter resources. */ @@ -6389,7 +8965,7 @@ class IRtcEngineParameter */ virtual int setProfile(const char* profile, bool merge) = 0; - virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; + virtual int convertPath(const char* filePath, agora::util::AString& value) = 0; }; class AAudioDeviceManager : public agora::util::AutoPtr @@ -6397,7 +8973,7 @@ class AAudioDeviceManager : public agora::util::AutoPtr public: AAudioDeviceManager(IRtcEngine* engine) { - queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); + queryInterface(engine, AGORA_IID_AUDIO_DEVICE_MANAGER); } }; @@ -6406,7 +8982,7 @@ class AVideoDeviceManager : public agora::util::AutoPtr public: AVideoDeviceManager(IRtcEngine* engine) { - queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); + queryInterface(engine, AGORA_IID_VIDEO_DEVICE_MANAGER); } }; @@ -6425,8 +9001,7 @@ class AParameter : public agora::util::AutoPtr return p != NULL; } }; -/** The RtcEngineParameters class is an auxiliary class setting parameters for the SDK. - +/** **DEPRECATED** The RtcEngineParameters class is deprecated, use the IRtcEngine class instead. */ class RtcEngineParameters { @@ -6436,122 +9011,44 @@ class RtcEngineParameters RtcEngineParameters(IRtcEngine* engine) :m_parameter(engine){} - /** Disables/Re-enables the local video. - - This method is only applicable when the user wants to watch the remote video without sending any video stream to the other user. - - Call this method after calling the \ref agora::rtc::IRtcEngine::enableVideo "enableVideo" method. Otherwise, this method may not work properly. - - After the *enableVideo* method is called, the local video is enabled by default. This method is used to disable/re-enable the local video while the remote video remains unaffected. - - @note This method affects the internal engine and can be called after the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method. - - @param enabled Sets whether to disable/re-enable the local video, including the capturer, renderer, and sender: - - true: (Default) Re-enable the local video. - - false: Disable the local video. Once the local video is disabled, the remote users can no longer receive the video stream of this user, while this user can still receive the video streams of the other remote users. - @return - - 0: Success. - - < 0: Failure. - */ int enableLocalVideo(bool enabled) { return setParameters("{\"rtc.video.capture\":%s,\"che.video.local.capture\":%s,\"che.video.local.render\":%s,\"che.video.local.send\":%s}", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false", enabled ? "true" : "false"); } - /** Stops/Resumes sending the local video stream. - - @note When set to *true*, this method does not disable the camera which does not affect the retrieval of the local video streams. This method executes faster than the \ref agora::rtc::IRtcEngine::enableLocalVideo "enableLocalVideo" method which controls the sending of the local video stream. - @param mute Sets whether to send/stop sending the local video stream: - - true: Stop sending the local video stream. - - false: (Default) Send the local video stream. - - @return - - 0: Success. - - < 0: Failure. - */ int muteLocalVideoStream(bool mute) { return setParameters("{\"rtc.video.mute_me\":%s,\"che.video.local.send\":%s}", mute ? "true" : "false", mute ? "false" : "true"); } - /** Stops/Resumes receiving all remote users' video streams. - - @param mute Sets whether to receive/stop receiving all remote users' video streams: - - true: Stop receiving all remote users' video streams. - - false: (Default) Receive all remote users' video streams. - @return - - 0: Success. - - < 0: Failure. - */ int muteAllRemoteVideoStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.video.mute_peers", mute) : -ERR_NOT_INITIALIZED; } - /** Stops/Resumes receiving all remote users' video streams by default. - @param mute Sets whether to receive/stop receiving all remote users' video streams by default: - - true: Stop receiving all remote users' video streams by default. - - false: (Default) Receive all remote users' video streams by default. - - @return - - 0: Success. - - < 0: Failure. - */ int setDefaultMuteAllRemoteVideoStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.video.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; } - /** Stops/Resumes receiving a specified remote user's video stream. - - @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteVideoStreams "muteAllRemoteVideoStreams" method and set @p mute as @p true to stop receiving all remote video streams, call the *muteAllRemoteVideoStreams* method and set @p mute as @p false before calling this method. - @param uid User ID of the specified remote user. - @param mute Sets whether to receive/stop receiving the specified remote user's video stream: - - true: Stop receiving the specified remote user's video stream. - - false: (Default) Receive the specified remote user's video stream. - - @return - - 0: Success. - - < 0: Failure. - */ int muteRemoteVideoStream(uid_t uid, bool mute) { return setObject("rtc.video.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute ? "true" : "false"); } - /** **DEPRECATED** Use \ref agora::rtc::IAudioDeviceManager::setPlaybackDeviceVolume "setPlaybackDeviceVolume" instead. Sets the playback device volume. - - @param volume Sets the volume of the playback device. The value ranges between 0 and 255. - @return - - 0: Success. - - < 0: Failure. - */ int setPlaybackDeviceVolume(int volume) {// [0,255] return m_parameter ? m_parameter->setInt("che.audio.output.volume", volume) : -ERR_NOT_INITIALIZED; } - /** Starts an audio recording. - - The SDK allows recording during a call. Supported formats: - - - .wav: Large file size with high fidelity. - - .aac: Small file size with low fidelity. - - Ensure that the directory to save the recording file exists and is writable. - This method is usually called after the \ref agora::rtc::IRtcEngine::joinChannel "joinChannel" method. - The recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. - - @param filePath Pointer to the absolute file path of the recording file. The string of the file name is in UTF-8. - @param quality Sets the audio recording quality. See #AUDIO_RECORDING_QUALITY_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ int startAudioRecording(const char* filePath, AUDIO_RECORDING_QUALITY_TYPE quality) { + return startAudioRecording(filePath, 32000, quality); + } + + int startAudioRecording(const char* filePath, int sampleRate, AUDIO_RECORDING_QUALITY_TYPE quality) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) util::AString path; @@ -6560,46 +9057,15 @@ class RtcEngineParameters else return -ERR_INVALID_ARGUMENT; #endif - return setObject("che.audio.start_recording", "{\"filePath\":\"%s\",\"quality\":%d}", filePath, quality); + return setObject("che.audio.start_recording", "{\"filePath\":\"%s\",\"sampleRate\":%d,\"quality\":%d}", filePath, sampleRate, quality); } - /** Stops an audio recording on the client. - - You can call this method before calling the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method else, the recording automatically stops when the \ref agora::rtc::IRtcEngine::leaveChannel "leaveChannel" method is called. - @return - - 0: Success - - < 0: Failure. - */ int stopAudioRecording() { return m_parameter ? m_parameter->setBool("che.audio.stop_recording", true) : -ERR_NOT_INITIALIZED; } - /** Starts playing and mixing the music file. - - This method mixes the specified local audio file with the audio stream from the microphone, or replaces the microphone's audio stream with the specified local audio file. You can choose whether the other user can hear the local audio playback and specify the number of playback loops. This method also supports online music playback. - - When the audio mixing file playback finishes after calling this method, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onAudioMixingFinished "onAudioMixingFinished" callback. - - @note - - Call this method when you are in a channel. - - If the local audio mixing file does not exist, or if the SDK does not support the file format or cannot access the music file URL, the SDK returns WARN_AUDIO_MIXING_OPEN_ERROR = 701. - - @param filePath Pointer to the absolute path of the local or online audio file to mix. Supported audio formats: 3GP, ASF, ADTS, AVI, MP3, MPEG-4, SAMI, and WAVE. For more information, see [Supported Media Formats in Media Foundation](https://docs.microsoft.com/en-us/windows/desktop/medfound/supported-media-formats-in-media-foundation). - @param loopback Sets which user can hear the audio mixing: - - true: Only the local user can hear the audio mixing. - - false: Both users can hear the audio mixing. - @param replace Sets the audio mixing content: - - true: Only the specified audio file is published; the audio stream received by the microphone is not published. - - false: The local audio file is mixed with the audio stream from the microphone. - @param cycle Sets the number of playback loops: - - Positive integer: Number of playback loops. - - -1: Infinite playback loops. - @return - - 0: Success. - - < 0: Failure. - */ int startAudioMixing(const char* filePath, bool loopback, bool replace, int cycle) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) @@ -6616,52 +9082,22 @@ class RtcEngineParameters cycle); } - /** Stops playing and mixing the music file. - - Call this method when you are in a channel. - @return - - 0: Success. - - < 0: Failure. - */ int stopAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.stop_file_as_playout", true) : -ERR_NOT_INITIALIZED; } - /** Pauses playing and mixing the music file. - - Call this method when you are in a channel. - @return - - 0: Success. - - < 0: Failure. - */ int pauseAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", true) : -ERR_NOT_INITIALIZED; } - /** Resumes playing and mixing the music file. - - Call this method when you are in a channel. - @return - - 0: Success. - - < 0: Failure. - */ int resumeAudioMixing() { return m_parameter ? m_parameter->setBool("che.audio.pause_file_as_playout", false) : -ERR_NOT_INITIALIZED; } - /** Adjusts the volume during audio mixing. - - Call this method when you are in a channel. - - @param volume Audio mixing volume. The value ranges between 0 and 100 (default). - @return - - 0: Success. - - < 0: Failure. - */ int adjustAudioMixingVolume(int volume) { int ret = adjustAudioMixingPlayoutVolume(volume); if (ret == 0) { @@ -6670,30 +9106,12 @@ class RtcEngineParameters return ret; } - /** Adjusts the audio mixing volume for local playback. - - @note Call this method when you are in a channel. - - @param volume Audio mixing volume for local playback. The value ranges between 0 and 100 (default). - @return - - 0: Success. - - < 0: Failure. - */ int adjustAudioMixingPlayoutVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; } - /** Retrieves the audio mixing volume for local playback. - - This method helps troubleshoot audio volume related issues. - - @note Call this method when you are in a channel. - @return - - ≥ 0: The audio mixing volume, if this method call succeeds. The value range is [0,100]. - - < 0: Failure. - */ int getAudioMixingPlayoutVolume() { int volume = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_volume", volume) : -ERR_NOT_INITIALIZED; @@ -6702,30 +9120,12 @@ class RtcEngineParameters return r; } - /** Adjusts the audio mixing volume for publishing (for remote users). - @note Call this method when you are in a channel. + int adjustAudioMixingPublishVolume(int volume) { + return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; + } - @param volume Audio mixing volume for publishing. The value ranges between 0 and 100 (default). - @return - - 0: Success. - - < 0: Failure. - */ - int adjustAudioMixingPublishVolume(int volume) { - return m_parameter ? m_parameter->setInt("che.audio.set_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; - } - - /** Retrieves the audio mixing volume for publishing. - - This method helps troubleshoot audio volume related issues. - - @note Call this method when you are in a channel. - - @return - - ≥ 0: The audio mixing volume for publishing, if this method call succeeds. The value range is [0,100]. - - < 0: Failure. - */ int getAudioMixingPublishVolume() { int volume = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_file_as_playout_publish_volume", volume) : -ERR_NOT_INITIALIZED; @@ -6734,14 +9134,7 @@ class RtcEngineParameters return r; } - /** Retrieves the duration (ms) of the music file. - - Call this method when you are in a channel. - @return - - ≥ 0: The audio mixing duration, if this method call succeeds. - - < 0: Failure. - */ int getAudioMixingDuration() { int duration = 0; int r = m_parameter ? m_parameter->getInt("che.audio.get_mixing_file_length_ms", duration) : -ERR_NOT_INITIALIZED; @@ -6750,14 +9143,7 @@ class RtcEngineParameters return r; } - /** Retrieves the playback position (ms) of the music file. - - Call this method when you are in a channel. - @return - 0: The current playback position of the audio mixing, if this method call succeeds. - < 0: Failure. - */ int getAudioMixingCurrentPosition() { if (!m_parameter) return -ERR_NOT_INITIALIZED; int pos = 0; @@ -6766,27 +9152,21 @@ class RtcEngineParameters r = pos; return r; } - /** Sets the playback position of the music file to a different starting position (the default plays from the beginning). - - @param pos The playback starting position (ms) of the music file. - @return - - 0: Success. - - < 0: Failure. - */ int setAudioMixingPosition(int pos /*in ms*/) { return m_parameter ? m_parameter->setInt("che.audio.mixing.file.position", pos) : -ERR_NOT_INITIALIZED; } - /** Retrieves the volume of the audio effects. - - The value ranges between 0.0 and 100.0. - - @return - - ≥ 0: Volume of the audio effects, if this method call succeeds. + int setAudioMixingPitch(int pitch) { + if (!m_parameter) { + return -ERR_NOT_INITIALIZED; + } + if (pitch > 12 || pitch < -12) { + return -ERR_INVALID_ARGUMENT; + } + return m_parameter->setInt("che.audio.set_playout_file_pitch_semitones", pitch); + } - - < 0: Failure. - */ int getEffectsVolume() { if (!m_parameter) return -ERR_NOT_INITIALIZED; int volume = 0; @@ -6796,27 +9176,12 @@ class RtcEngineParameters return r; } - /** Sets the volume of the audio effects. - @param volume Sets the volume of the audio effects. The value ranges between 0 and 100 (default). - - @return - - 0: Success. - - < 0: Failure. - */ int setEffectsVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.game_set_effects_volume", volume) : -ERR_NOT_INITIALIZED; } - /** Sets the volume of a specified audio effect. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @param volume Sets the volume of the specified audio effect. The value ranges between 0.0 and 100.0 (default). - @return - - 0: Success. - - < 0: Failure. - */ int setVolumeOfEffect(int soundId, int volume) { return setObject( "che.audio.game_adjust_effect_volume", @@ -6824,40 +9189,8 @@ class RtcEngineParameters soundId, volume); } - /** Plays a specified local or online audio effect file. - - This method allows you to set the loop count, pitch, pan, and gain of the audio effect file, as well as whether the remote user can hear the audio effect. - - To play multiple audio effect files simultaneously, call this method multiple times with different soundIds and filePaths. We recommend playing no more than three audio effect files at the same time. - - When the audio effect file playback finishes, the SDK returns the \ref IRtcEngineEventHandler::onAudioEffectFinished "onAudioEffectFinished" callback. - - @param soundId ID of the specified audio effect. Each audio effect has a unique ID. - - @note - - If the audio effect is preloaded into the memory through the \ref IRtcEngine::preloadEffect "preloadEffect" method, the value of @p soundID must be the same as that in the *preloadEffect* method. - - Playing multiple online audio effect files simultaneously is not supported on macOS and Windows. - @param filePath The absolute path to the local audio effect file or the URL of the online audio effect file. - @param loopCount Sets the number of times the audio effect loops: - - 0: Play the audio effect once. - - 1: Play the audio effect twice. - - -1: Play the audio effect in an indefinite loop until the \ref IRtcEngine::stopEffect "stopEffect" or \ref IRtcEngine::stopAllEffects "stopAllEffects" method is called. - @param pitch Sets the pitch of the audio effect. The value ranges between 0.5 and 2. The default value is 1 (no change to the pitch). The lower the value, the lower the pitch. - @param pan Sets the spatial position of the audio effect. The value ranges between -1.0 and 1.0: - - 0.0: The audio effect displays ahead. - - 1.0: The audio effect displays to the right. - - -1.0: The audio effect displays to the left. - @param gain Sets the volume of the audio effect. The value ranges between 0.0 and 100.0 (default). The lower the value, the lower the volume of the audio effect. - @param publish Sets whether or not to publish the specified audio effect to the remote stream: - - true: The locally played audio effect is published to the Agora Cloud and the remote users can hear it. - - false: The locally played audio effect is not published to the Agora Cloud and the remote users cannot hear it. - - @return - - 0: Success. - - < 0: Failure. - */ - int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false, int startPos = 0) { + int playEffect(int soundId, const char* filePath, int loopCount, double pitch, double pan, int gain, bool publish = false) { #if defined(_WIN32) util::AString path; if (!m_parameter->convertPath(filePath, path)) @@ -6867,49 +9200,23 @@ class RtcEngineParameters #endif return setObject( "che.audio.game_play_effect", - "{\"soundId\":%d,\"filePath\":\"%s\",\"loopCount\":%d, \"pitch\":%lf,\"pan\":%lf,\"gain\":%d, \"send2far\":%d, \"startPos\":%d}", - soundId, filePath, loopCount, pitch, pan, gain, publish, startPos); + "{\"soundId\":%d,\"filePath\":\"%s\",\"loopCount\":%d, \"pitch\":%lf,\"pan\":%lf,\"gain\":%d, \"send2far\":%d}", + soundId, filePath, loopCount, pitch, pan, gain, publish); } - /** Stops playing a specified audio effect. - - @param soundId ID of the audio effect to stop playing. Each audio effect has a unique ID. - @return - - 0: Success. - - < 0: Failure. - */ int stopEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_stop_effect", soundId) : -ERR_NOT_INITIALIZED; } - /** Stops playing all audio effects. - @return - - 0: Success. - - < 0: Failure. - */ int stopAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_stop_all_effects", true) : -ERR_NOT_INITIALIZED; } - /** Preloads a specified audio effect file into the memory. - - @note This method does not support online audio effect files. - - To ensure smooth communication, limit the size of the audio effect file. We recommend using this method to preload the audio effect before calling the \ref IRtcEngine::joinChannel "joinChannel" method. - - Supported audio formats: mp3, aac, m4a, 3gp, and wav. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @param filePath Pointer to the absolute path of the audio effect file. - @return - - 0: Success. - - < 0: Failure. - */ int preloadEffect(int soundId, char* filePath) { return setObject( "che.audio.game_preload_effect", @@ -6917,267 +9224,61 @@ class RtcEngineParameters soundId, filePath); } - /** Releases a specified preloaded audio effect from the memory. - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @return - - 0: Success. - - < 0: Failure. - */ int unloadEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_unload_effect", soundId) : -ERR_NOT_INITIALIZED; } - /** Pauses a specified audio effect. - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @return - - 0: Success. - - < 0: Failure. - */ int pauseEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_pause_effect", soundId) : -ERR_NOT_INITIALIZED; } - /** Pauses all audio effects. - @return - - 0: Success. - - < 0: Failure. - */ int pauseAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_pause_all_effects", true) : -ERR_NOT_INITIALIZED; } - /** Resumes playing a specified audio effect. - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @return - - 0: Success. - - < 0: Failure. - */ int resumeEffect(int soundId) { return m_parameter ? m_parameter->setInt( "che.audio.game_resume_effect", soundId) : -ERR_NOT_INITIALIZED; } - /** Resumes playing all audio effects. - @return - - 0: Success. - - < 0: Failure. - */ int resumeAllEffects() { return m_parameter ? m_parameter->setBool( "che.audio.game_resume_all_effects", true) : -ERR_NOT_INITIALIZED; } - /** Retrieves the playback position (ms) of specified audio effect. - - Call this method when you are in a channel. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - - @return >= 0: The current playback position of the audio effect, if this method call is successful. - < 0: Failure. - */ - int getEffectCurrentPosition(int soundId) { - int position = 0; - char key[512]; - sprintf(key, "che.audio.get_effect_file_position:%d", soundId); - int r = m_parameter ? m_parameter->getInt(key, position) : -ERR_NOT_INITIALIZED; - if (r == 0) - r = position; - return r; - } - - /** Sets the instantaneous playback position of specified audio effect file. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @param pos The instantaneous playback position (ms) of the audio effect file. - - @return * 0: Success. - * < 0: Failure. - */ - int setEffectPosition(int soundId, int pos) { - return setObject( - "che.audio.set_effect_file_position", - "{\"soundId\":%d, \"effectPos\":%d}", - soundId, pos); - } - - /** Adjusts the volume of specified audio effect for local playback.. - Call this method when you are in a channel. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @param volume Volume of specified audio effect for local playback. The value ranges between 0 and 100 (default). - - @return * 0: Success. - * < 0: Failure. - */ - int adjustEffectPlayoutVolume(int soundId, int volume) { - return setObject( - "che.audio.set_effect_file_playout_volume", - "{\"soundId\":%d, \"effectPlayoutVolume\":%d}", - soundId, volume); - } - - /** Adjusts the volume of specified audio effect for publishing (sending to other users). - - Call this method when you are in a channel. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - @param volume Volume of specified audio effect for publishing. The value ranges between 0 and 100 (default). - - @return * 0: Success. - * < 0: Failure. - */ - int adjustEffectPublishVolume(int soundId, int volume) { - return setObject( - "che.audio.set_effect_file_publish_volume", - "{\"soundId\":%d, \"effectPublishVolume\":%d}", - soundId, volume); - } - - /** Retrieves the volume of specified audio effect for local playback. - - Call this method when you are in a channel. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - - @return >= 0: The current local playback volume of specified audio effect, if this method call is successful. - * < 0: Failure. - */ - int getEffectPlayoutVolume(int soundId) { - int volume = 0; - char key[512]; - sprintf(key, "che.audio.get_effect_file_playout_volume:%d", soundId); - int r = m_parameter ? m_parameter->getInt(key, volume) : -ERR_NOT_INITIALIZED; - if (r == 0) - r = volume; - return r; - } - - /** Retrieves the volume of specified audio effect for publishing (sending to other users). - - Call this method when you are in a channel. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - - @return >= 0: The current publish volume of specified audio effect, if this method call is successful. - * < 0: Failure. - */ - int getEffectPublishVolume(int soundId) { - int volume = 0; - char key[512]; - sprintf(key, "che.audio.get_effect_file_publish_volume:%d", soundId); - int r = m_parameter ? m_parameter->getInt(key, volume) : -ERR_NOT_INITIALIZED; - if (r == 0) - r = volume; - return r; - } - - /** Retrieves the duration (ms) of specified audio effect. - - Call this method when you are in a channel. - - @param soundId ID of the audio effect. Each audio effect has a unique ID. - - @return >= 0: The duration (ms) of specified audio effect, if this method call is successful. - * < 0: Failure. - */ - int getEffectDuration(const char* filePath) { - int duration = 0; - char key[512]; - sprintf(key, "che.audio.get_effect_file_duration:%s", filePath); - int r = m_parameter ? m_parameter->getInt(key, duration) : -ERR_NOT_INITIALIZED; - if (r == 0) - r = duration; - return r; - } - - /** Enables/Disables stereo panning for remote users. - - Ensure that you call this method before joinChannel to enable stereo panning for remote users so that the local user can track the position of a remote user by calling \ref agora::rtc::IRtcEngine::setRemoteVoicePosition "setRemoteVoicePosition". - - @param enabled Sets whether or not to enable stereo panning for remote users: - - true: enables stereo panning. - - false: disables stereo panning. - - @return - - 0: Success. - - < 0: Failure. - */ int enableSoundPositionIndication(bool enabled) { return m_parameter ? m_parameter->setBool( "che.audio.enable_sound_position", enabled) : -ERR_NOT_INITIALIZED; } - /** Sets the sound position and gain of a remote user. - - When the local user calls this method to set the sound position of a remote user, the sound difference between the left and right channels allows the local user to track the real-time position of the remote user, creating a real sense of space. This method applies to massively multiplayer online games, such as Battle Royale games. - - @note - - For this method to work, enable stereo panning for remote users by calling enableSoundPositionIndication before joining a channel. - - This method requires hardware support. For the best sound positioning, we recommend using a stereo speaker. - - @param uid The ID of the remote user. - @param pan The sound position of the remote user. The value ranges from -1.0 to 1.0: - - 0.0: the remote sound comes from the front. - - -1.0: the remote sound comes from the left. - - 1.0: the remote sound comes from the right. - @param gain Gain of the remote user. The value ranges from 0.0 to 100.0. The default value is 100.0 (the original gain of the remote user). The smaller the value, the less the gain. - @return - - 0: Success. - - < 0: Failure. - */ int setRemoteVoicePosition(uid_t uid, double pan, double gain) { return setObject("che.audio.game_place_sound_position", "{\"uid\":%u,\"pan\":%lf,\"gain\":%lf}", uid, pan, gain); } - /** Changes the voice pitch of the local speaker. - @param pitch Sets the voice pitch. The value ranges between 0.5 and 2.0. The lower the value, the lower the voice pitch. The default value is 1.0 (no change to the local voice pitch). - @return - - 0: Success. - - < 0: Failure. - */ int setLocalVoicePitch(double pitch) { return m_parameter ? m_parameter->setInt( "che.audio.morph.pitch_shift", static_cast(pitch * 100)) : -ERR_NOT_INITIALIZED; } - /** Sets the local voice equalization effect. - - @param bandFrequency Sets the band frequency. The value ranges between 0 and 9, representing the respective 10-band center frequencies of the voice effects, including 31, 62, 125, 500, 1k, 2k, 4k, 8k, and 16k Hz. See #AUDIO_EQUALIZATION_BAND_FREQUENCY. - @param bandGain Sets the gain of each band in dB. The value ranges between -15 and 15. - @return - - 0: Success. - - < 0: Failure. - */ int setLocalVoiceEqualization(AUDIO_EQUALIZATION_BAND_FREQUENCY bandFrequency, int bandGain) { return setObject( "che.audio.morph.equalization", "{\"index\":%d,\"gain\":%d}", static_cast(bandFrequency), bandGain); } - /** Sets the local voice reverberation. - - v2.4.0 adds the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, a more user-friendly method for setting the local voice reverberation. You can use this method to set the local reverberation effect, such as pop music, R&B, rock music, and hip-hop. - - @param reverbKey Sets the reverberation key. See #AUDIO_REVERB_TYPE. - @param value Sets the value of the reverberation key. - @return - - 0: Success. - - < 0: Failure. - */ int setLocalVoiceReverb(AUDIO_REVERB_TYPE reverbKey, int value) { return setObject( "che.audio.morph.reverb", @@ -7185,38 +9286,180 @@ class RtcEngineParameters static_cast(reverbKey), value); } - /** Sets the local voice changer option. - @note Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceReverbPreset "setLocalVoiceReverbPreset" method, because the method called later overrides the one called earlier. + int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) { + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(voiceChanger == 0x00000000) { + return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)); + } + else if(voiceChanger > 0x00000000 && voiceChanger < 0x00100000) { + return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)); + } + else if(voiceChanger > 0x00100000 && voiceChanger < 0x00200000) { + return m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger - 0x00100000 + 6)); + } + else if(voiceChanger > 0x00200000 && voiceChanger < 0x00300000) { + return m_parameter->setInt("che.audio.morph.beauty_voice", static_cast(voiceChanger - 0x00200000)); + } + else { + return -ERR_INVALID_ARGUMENT; + } + } + + int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) { + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(reverbPreset == 0x00000000) { + return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)); + } + else if(reverbPreset > 0x00000000 && reverbPreset < 0x00100000) { + return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset + 8)); + } + else if(reverbPreset > 0x00100000 && reverbPreset < 0x00200000) { + return m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset - 0x00100000)); + } + else if(reverbPreset > 0x00200000 && reverbPreset < 0x00200002) { + return m_parameter->setInt("che.audio.morph.virtual_stereo", static_cast(reverbPreset - 0x00200000)); + } + else if (reverbPreset > (AUDIO_REVERB_PRESET) 0x00300000 && reverbPreset < (AUDIO_REVERB_PRESET) 0x00300002) + return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", 1, 4); + else if (reverbPreset > (AUDIO_REVERB_PRESET) 0x00400000 && reverbPreset < (AUDIO_REVERB_PRESET) 0x00400002) + return m_parameter->setInt("che.audio.morph.threedim_voice", 10); + else { + return -ERR_INVALID_ARGUMENT; + } + } - @param voiceChanger Sets the local voice changer option. See #VOICE_CHANGER_PRESET. + int setAudioEffectPreset(AUDIO_EFFECT_PRESET preset){ + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == AUDIO_EFFECT_OFF) { + return m_parameter->setInt("che.audio.morph.voice_changer", 0); + } + if(preset == ROOM_ACOUSTICS_KTV){ + return m_parameter->setInt("che.audio.morph.reverb_preset", 1); + } + if(preset == ROOM_ACOUSTICS_VOCAL_CONCERT) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 2); + } + if(preset == ROOM_ACOUSTICS_STUDIO) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 5); + } + if(preset == ROOM_ACOUSTICS_PHONOGRAPH) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 8); + } + if(preset == ROOM_ACOUSTICS_VIRTUAL_STEREO) { + return m_parameter->setInt("che.audio.morph.virtual_stereo", 1); + } + if(preset == ROOM_ACOUSTICS_SPACIAL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 15); + } + if(preset == ROOM_ACOUSTICS_ETHEREAL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 5); + } + if(preset == ROOM_ACOUSTICS_3D_VOICE) { + return m_parameter->setInt("che.audio.morph.threedim_voice", 10); + } + if(preset == VOICE_CHANGER_EFFECT_UNCLE) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 3); + } + if(preset == VOICE_CHANGER_EFFECT_OLDMAN) { + return m_parameter->setInt("che.audio.morph.voice_changer", 1); + } + if(preset == VOICE_CHANGER_EFFECT_BOY) { + return m_parameter->setInt("che.audio.morph.voice_changer", 2); + } + if(preset == VOICE_CHANGER_EFFECT_SISTER) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 4); + } + if(preset == VOICE_CHANGER_EFFECT_GIRL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 3); + } + if(preset == VOICE_CHANGER_EFFECT_PIGKING) { + return m_parameter->setInt("che.audio.morph.voice_changer", 4); + } + if(preset == VOICE_CHANGER_EFFECT_HULK) { + return m_parameter->setInt("che.audio.morph.voice_changer", 6); + } + if(preset == STYLE_TRANSFORMATION_RNB) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 7); + } + if(preset == STYLE_TRANSFORMATION_POPULAR) { + return m_parameter->setInt("che.audio.morph.reverb_preset", 6); + } + if(preset == PITCH_CORRECTION) { + return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", 1, 4); + } + return -ERR_INVALID_ARGUMENT; + } - @return - - 0: Success. - - < 0: Failure. - */ - int setLocalVoiceChanger(VOICE_CHANGER_PRESET voiceChanger) { - return m_parameter ? m_parameter->setInt("che.audio.morph.voice_changer", static_cast(voiceChanger)) : -ERR_NOT_INITIALIZED; + int setVoiceBeautifierPreset(VOICE_BEAUTIFIER_PRESET preset) { + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == VOICE_BEAUTIFIER_OFF) { + return m_parameter->setInt("che.audio.morph.voice_changer", 0); + } + if(preset == CHAT_BEAUTIFIER_MAGNETIC) { + return m_parameter->setInt("che.audio.morph.beauty_voice", 1); + } + if(preset == CHAT_BEAUTIFIER_FRESH) { + return m_parameter->setInt("che.audio.morph.beauty_voice", 2); + } + if(preset == CHAT_BEAUTIFIER_VITALITY) { + return m_parameter->setInt("che.audio.morph.beauty_voice", 3); + } + if(preset == SINGING_BEAUTIFIER) { + return setObject( "che.audio.morph.beauty_sing", "{\"key\":%d,\"value\":%d}", 1, 1); + } + if(preset == TIMBRE_TRANSFORMATION_VIGOROUS) { + return m_parameter->setInt("che.audio.morph.voice_changer", 7); + } + if(preset == TIMBRE_TRANSFORMATION_DEEP) { + return m_parameter->setInt("che.audio.morph.voice_changer", 8); + } + if(preset == TIMBRE_TRANSFORMATION_MELLOW) { + return m_parameter->setInt("che.audio.morph.voice_changer", 9); + } + if(preset == TIMBRE_TRANSFORMATION_FALSETTO) { + return m_parameter->setInt("che.audio.morph.voice_changer", 10); + } + if(preset == TIMBRE_TRANSFORMATION_FULL) { + return m_parameter->setInt("che.audio.morph.voice_changer", 11); + } + if(preset == TIMBRE_TRANSFORMATION_CLEAR) { + return m_parameter->setInt("che.audio.morph.voice_changer", 12); + } + if(preset == TIMBRE_TRANSFORMATION_RESOUNDING) { + return m_parameter->setInt("che.audio.morph.voice_changer", 13); + } + if(preset == TIMBRE_TRANSFORMATION_RINGING) { + return m_parameter->setInt("che.audio.morph.voice_changer", 14); + } + return -ERR_INVALID_ARGUMENT; } - /** Sets the preset local voice reverberation effect. - - @note - - Do not use this method together with \ref agora::rtc::IRtcEngine::setLocalVoiceReverb "setLocalVoiceReverb". - - Do not use this method together with the \ref agora::rtc::IRtcEngine::setLocalVoiceChanger "setLocalVoiceChanger" method, because the method called later overrides the one called earlier. - - - @param reverbPreset Sets the preset audio reverberation configuration. See #AUDIO_REVERB_PRESET. - - @return - - 0: Success. - - < 0: Failure. - */ - int setLocalVoiceReverbPreset(AUDIO_REVERB_PRESET reverbPreset) { - return m_parameter ? m_parameter->setInt("che.audio.morph.reverb_preset", static_cast(reverbPreset)) : -ERR_NOT_INITIALIZED; + int setAudioEffectParameters(AUDIO_EFFECT_PRESET preset, int param1, int param2){ + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == PITCH_CORRECTION){ + return setObject( "che.audio.morph.electronic_voice", "{\"key\":%d,\"value\":%d}", param1, param2); + } + if(preset == ROOM_ACOUSTICS_3D_VOICE){ + return m_parameter->setInt("che.audio.morph.threedim_voice", param1); + } + return -ERR_INVALID_ARGUMENT; } + int setVoiceBeautifierParameters(VOICE_BEAUTIFIER_PRESET preset, int param1, int param2){ + if(!m_parameter) + return -ERR_NOT_INITIALIZED; + if(preset == SINGING_BEAUTIFIER){ + return setObject( "che.audio.morph.beauty_sing", "{\"key\":%d,\"value\":%d}", param1, param2); + } + return -ERR_INVALID_ARGUMENT; + } /** **DEPRECATED** Use \ref IRtcEngine::disableAudio "disableAudio" instead. Disables the audio function in the channel. @@ -7228,52 +9471,17 @@ class RtcEngineParameters return m_parameter ? m_parameter->setBool("che.pause.audio", true) : -ERR_NOT_INITIALIZED; } - /** **DEPRECATED** Use the \ref IRtcEngine::enableAudio "enableAudio" method instead. - Resumes playing the audio in the channel. - @return - - 0: Success. - - < 0: Failure. - */ int resumeAudio() { return m_parameter ? m_parameter->setBool("che.pause.audio", false) : -ERR_NOT_INITIALIZED; } - /** **DEPRECATED** Agora does not recommend using this method. - - Sets the high-quality audio preferences. Call this method and set all parameters before joining a channel. - - Do not call this method again after joining a channel. - - @param fullband Sets whether to enable/disable full-band codec (48-kHz sample rate). Not compatible with SDK versions before v1.7.4: - - true: Enable full-band codec. - - false: Disable full-band codec. - @param stereo Sets whether to enable/disable stereo codec. Not compatible with SDK versions before v1.7.4: - - true: Enable stereo codec. - - false: Disable stereo codec. - @param fullBitrate Sets whether to enable/disable high-bitrate mode. Recommended in voice-only mode: - - true: Enable high-bitrate mode. - - false: Disable high-bitrate mode. - @return - - 0: Success. - - < 0: Failure. - */ int setHighQualityAudioParameters(bool fullband, bool stereo, bool fullBitrate) { return setObject("che.audio.codec.hq", "{\"fullband\":%s,\"stereo\":%s,\"fullBitrate\":%s}", fullband ? "true" : "false", stereo ? "true" : "false", fullBitrate ? "true" : "false"); } - /** Adjusts the recording volume. - - @param volume Recording volume. The value ranges between 0 and 400: - - 0: Mute. - - 100: Original volume. - - 400: (Maximum) Four times the original volume with signal clipping protection. - @return - - 0: Success. - - < 0: Failure. - */ int adjustRecordingSignalVolume(int volume) {//[0, 400]: e.g. 50~0.5x 100~1x 400~4x if (volume < 0) volume = 0; @@ -7282,17 +9490,7 @@ class RtcEngineParameters return m_parameter ? m_parameter->setInt("che.audio.record.signal.volume", volume) : -ERR_NOT_INITIALIZED; } - /** Adjusts the playback volume. - - @param volume Playback volume. The value ranges between 0 and 400: - - 0: Mute. - - 100: Original volume. - - 400: (Maximum) Four times the original volume with signal clipping protection. - @return - - 0: Success. - - < 0: Failure. - */ int adjustPlaybackSignalVolume(int volume) {//[0, 400] if (volume < 0) volume = 0; @@ -7301,99 +9499,35 @@ class RtcEngineParameters return m_parameter ? m_parameter->setInt("che.audio.playout.signal.volume", volume) : -ERR_NOT_INITIALIZED; } - /** Enables the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at a set time interval to report on which users are speaking and the speakers' volume. - - Once this method is enabled, the SDK returns the volume indication in the \ref agora::rtc::IRtcEngineEventHandler::onAudioVolumeIndication "onAudioVolumeIndication" callback at the set time interval, whether or not any user is speaking in the channel. - - @param interval Sets the time interval between two consecutive volume indications: - - ≤ 0: Disables the volume indication. - - > 0: Time interval (ms) between two consecutive volume indications. We recommend setting @p interval > 200 ms. Do not set @p interval < 10 ms, or the *onAudioVolumeIndication* callback will not be triggered. - @param smooth Smoothing factor sets the sensitivity of the audio volume indicator. The value ranges between 0 and 10. The greater the value, the more sensitive the indicator. The recommended value is 3. - @return - - 0: Success. - - < 0: Failure. - */ int enableAudioVolumeIndication(int interval, int smooth, bool report_vad) { // in ms: <= 0: disable, > 0: enable, interval in ms if (interval < 0) interval = 0; - return setObject("che.audio.volume_indication", "{\"interval\":%d,\"smooth\":%d,\"vad\":%d}", interval, smooth, (int)report_vad); + return setObject("che.audio.volume_indication", "{\"interval\":%d,\"smooth\":%d,\"vad\":%d}", interval, smooth, report_vad); } - /** Stops/Resumes sending the local audio stream. - - @note When @p mute is set as @p true, this method does not disable the microphone, which does not affect any ongoing recording. - - @param mute Sets whether to send/stop sending the local audio stream: - - true: Stops sending the local audio stream. - - false: (Default) Sends the local audio stream. - @return - - 0: Success. - - < 0: Failure. - */ int muteLocalAudioStream(bool mute) { return setParameters("{\"rtc.audio.mute_me\":%s,\"che.audio.mute_me\":%s}", mute ? "true" : "false", mute ? "true" : "false"); } // mute/unmute all peers. unmute will clear all muted peers specified mutePeer() interface - /** Stops/Resumes receiving a specified remote user's audio stream. - - @note If you called the \ref agora::rtc::IRtcEngine::muteAllRemoteAudioStreams "muteAllRemoteAudioStreams" method and set @p mute as @p true to stop receiving all remote users' audio streams, call the *muteAllRemoteAudioStreams* method and set @p mute as @p false before calling this method. The *muteAllRemoteAudioStreams* method sets all remote audio streams, while the *muteRemoteAudioStream* method sets a specified remote audio stream. - - @param uid User ID of the specified remote user sending the audio. - @param mute Sets whether to receive/stop receiving a specified remote user's audio stream: - - true: Stops receiving the specified remote user's audio stream. - - false: (Default) Receives the specified remote user's audio stream. - - @return - - 0: Success. - - < 0: Failure. - */ int muteRemoteAudioStream(uid_t uid, bool mute) { return setObject("rtc.audio.mute_peer", "{\"uid\":%u,\"mute\":%s}", uid, mute?"true":"false"); } - /** Stops/Resumes receiving all remote users' audio streams. - - @param mute Sets whether to receive/stop receiving all remote users' audio streams. - - true: Stops receiving all remote users' audio streams. - - false: (Default) Receives all remote users' audio streams. - @return - - 0: Success. - - < 0: Failure. - */ int muteAllRemoteAudioStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.audio.mute_peers", mute) : -ERR_NOT_INITIALIZED; } - /** Stops/Resumes receiving all remote users' audio streams by default. - @param mute Sets whether to receive/stop receiving all remote users' audio streams by default: - - true: Stops receiving all remote users' audio streams by default. - - false: (Default) Receives all remote users' audio streams by default. - - @return - - 0: Success. - - < 0: Failure. - */ int setDefaultMuteAllRemoteAudioStreams(bool mute) { return m_parameter ? m_parameter->setBool("rtc.audio.set_default_mute_peers", mute) : -ERR_NOT_INITIALIZED; } - /** Sets the external audio source. - @param enabled Sets whether to enable/disable the external audio source: - - true: Enables the external audio source. - - false: (Default) Disables the external audio source. - @param sampleRate Sets the sample rate of the external audio source, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param channels Sets the audio channels of the external audio source (two channels maximum). - @return - - 0: Success. - - < 0: Failure. - */ int setExternalAudioSource(bool enabled, int sampleRate, int channels) { if (enabled) return setParameters("{\"che.audio.external_capture\":true,\"che.audio.external_capture.push\":true,\"che.audio.set_capture_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_WRITE); @@ -7401,21 +9535,7 @@ class RtcEngineParameters return setParameters("{\"che.audio.external_capture\":false,\"che.audio.external_capture.push\":false}"); } - /** Sets the external audio sink. - - If you enable the external audio sink, you can pull the audio frame by periodically calling the \ref agora::media::IMediaEngine::pullAudioFrame "pullAudioFrame" method. - - @param enabled - - true: Enables the external audio sink. - - false: Disables the external audio sink. - @param sampleRate Sets the sample rate of the external audio sink, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param channels Sets the audio channels of the external audio sink (two channels maximum). - @note Enabling the external audio sink disables the "Raw Audio Data" method, and the application will not retrieve the audio frame from the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. - @return - - 0: Success. - - < 0: Failure. - */ int setExternalAudioSink(bool enabled, int sampleRate, int channels) { if (enabled) return setParameters("{\"che.audio.external_render\":true,\"che.audio.external_render.pull\":true,\"che.audio.set_render_raw_audio_format\":{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d}}", sampleRate, channels, RAW_AUDIO_FRAME_OP_MODE_TYPE::RAW_AUDIO_FRAME_OP_MODE_READ_ONLY); @@ -7423,20 +9543,7 @@ class RtcEngineParameters return setParameters("{\"che.audio.external_render\":false,\"che.audio.external_render.pull\":false}"); } - /** Specifies an SDK output log file. - - The log file records all SDK operations during runtime. If it does not exist, the SDK creates one. - - @note - - The default log file is located at: C:\Users\\AppData\Local\Agora\. - - Ensure that you call this method immediately after calling the \ref agora::rtc::IRtcEngine::initialize "initialize" method, otherwise the output log may not be complete. - - @param filePath File path of the log file. The string of the log file is in UTF-8. - @return - - 0: Success. - - < 0: Failure. - */ int setLogFile(const char* filePath) { if (!m_parameter) return -ERR_NOT_INITIALIZED; #if defined(_WIN32) @@ -7449,226 +9556,77 @@ class RtcEngineParameters return m_parameter->setString("rtc.log_file", filePath); } - /** Sets the output log level of the SDK. - - You can use one or a combination of the log filter levels. The log level follows the sequence of OFF, CRITICAL, ERROR, WARNING, INFO, and DEBUG. Choose a level to see the logs preceding that level. - - If you set the log level to WARNING, you see the logs within levels CRITICAL, ERROR, and WARNING. - - @param filter Sets the log filter level. See #LOG_FILTER_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ int setLogFilter(unsigned int filter) { return m_parameter ? m_parameter->setUInt("rtc.log_filter", filter&LOG_FILTER_MASK) : -ERR_NOT_INITIALIZED; } - /** Sets the log file size (KB). - - The SDK has two log files, each with a default size of 512 KB. If you set @p fileSizeInBytes as 1024 KB, the SDK outputs log files with a total maximum size of 2 MB. If the total size of the log files exceed the set value, the new output log files overwrite the old output log files. - @param fileSizeInKBytes The SDK log file size (KB). - @return - - 0: Success. - - <0: Failure. - */ int setLogFileSize(unsigned int fileSizeInKBytes) { return m_parameter ? m_parameter->setUInt("rtc.log_size", fileSizeInKBytes) : -ERR_NOT_INITIALIZED; } - /** Sets the local video display mode. - - This method can be called multiple times during a call to change the display mode. - @param renderMode Sets the local video display mode. See #RENDER_MODE_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ int setLocalRenderMode(RENDER_MODE_TYPE renderMode) { return setRemoteRenderMode(0, renderMode); } - /** Sets the video display mode of a specified remote user. - - This method can be called multiple times during a call to change the display mode. - @param uid ID of the remote user. - @param renderMode Sets the video display mode. See #RENDER_MODE_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ int setRemoteRenderMode(uid_t uid, RENDER_MODE_TYPE renderMode) { - return setObject("che.video.render_mode", "{\"uid\":%u,\"mode\":%d}", uid, renderMode); + return setParameters("{\"che.video.render_mode\":[{\"uid\":%u,\"renderMode\":%d}]}", uid, renderMode); } - /** Sets the camera capturer configuration. - - For a video call or live broadcast, generally the SDK controls the camera output parameters. When the default camera capturer settings do not meet special requirements or cause performance problems, we recommend using this method to set the camera capturer configuration: - - - If the resolution or frame rate of the captured raw video data are higher than those set by \ref IRtcEngine::setVideoEncoderConfiguration "setVideoEncoderConfiguration", processing video frames requires extra CPU and RAM usage and degrades performance. We recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to avoid such problems. - - If you do not need local video preview or are willing to sacrifice preview quality, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PERFORMANCE = 1 to optimize CPU and RAM usage. - - If you want better quality for the local video preview, we recommend setting config as CAPTURER_OUTPUT_PREFERENCE_PREVIEW = 2. - - @note Call this method before enabling the local camera. That said, you can call this method before calling \ref agora::rtc::IRtcEngine::joinChannel "joinChannel", \ref agora::rtc::IRtcEngine::enableVideo "enableVideo", or \ref IRtcEngine::enableLocalVideo "enableLocalVideo", depending on which method you use to turn on your local camera. - @param config Sets the camera capturer configuration. See CameraCapturerConfiguration. - - @return - - 0: Success. - - < 0: Failure. - */ int setCameraCapturerConfiguration(const CameraCapturerConfiguration& config) { if (!m_parameter) return -ERR_NOT_INITIALIZED; + if (config.preference == CAPTURER_OUTPUT_PREFERENCE_MANUAL) { + m_parameter->setInt("che.video.capture_width", config.captureWidth); + m_parameter->setInt("che.video.capture_height", config.captureHeight); + } return m_parameter->setInt("che.video.camera_capture_mode", (int)config.preference); } - /** Sets the stream mode to the single-stream (default) or dual-stream mode. (Live broadcast only.) - - If the dual-stream mode is enabled, the receiver can choose to receive the high stream (high-resolution and high-bitrate video stream), or the low stream (low-resolution and low-bitrate video stream). - @param enabled Sets the stream mode: - - true: Dual-stream mode. - - false: (Default) Single-stream mode. - */ int enableDualStreamMode(bool enabled) { return setParameters("{\"rtc.dual_stream_mode\":%s,\"che.video.enableLowBitRateStream\":%d}", enabled ? "true" : "false", enabled ? 1 : 0); } - /** Sets the remote user's video stream type received by the local user when the remote user sends dual streams. - - This method allows the application to adjust the corresponding video-stream type based on the size of the video window to reduce the bandwidth and resources. - - If the remote user enables the dual-stream mode by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the SDK receives the high-stream video by default. - - If the dual-stream mode is not enabled, the SDK receives the high-stream video by default. - - The method result returns in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users may use this method to switch to the low-stream video. - By default, the aspect ratio of the low-stream video is the same as the high-stream video. Once the resolution of the high-stream video is set, the system automatically sets the resolution, frame rate, and bitrate of the low-stream video. - - @param uid ID of the remote user sending the video stream. - @param streamType Sets the video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ int setRemoteVideoStreamType(uid_t uid, REMOTE_VIDEO_STREAM_TYPE streamType) { return setParameters("{\"rtc.video.set_remote_video_stream\":{\"uid\":%u,\"stream\":%d}, \"che.video.setstream\":{\"uid\":%u,\"stream\":%d}}", uid, streamType, uid, streamType); // return setObject("rtc.video.set_remote_video_stream", "{\"uid\":%u,\"stream\":%d}", uid, streamType); } - /** Sets the default video-stream type for the video received by the local user when the remote user sends dual streams. - - - If the dual-stream mode is enabled by calling the \ref agora::rtc::IRtcEngine::enableDualStreamMode "enableDualStreamMode" method, the user receives the high-stream video by default. The @p setRemoteDefaultVideoStreamType method allows the application to adjust the corresponding video-stream type according to the size of the video window, reducing the bandwidth and resources. - - If the dual-stream mode is not enabled, the user receives the high-stream video by default. - The result after calling this method is returned in the \ref agora::rtc::IRtcEngineEventHandler::onApiCallExecuted "onApiCallExecuted" callback. The Agora SDK receives the high-stream video by default to reduce the bandwidth. If needed, users can switch to the low-stream video through this method. - - @param streamType Sets the default video-stream type. See #REMOTE_VIDEO_STREAM_TYPE. - - @return - - 0: Success. - - < 0: Failure. - */ int setRemoteDefaultVideoStreamType(REMOTE_VIDEO_STREAM_TYPE streamType) { return m_parameter ? m_parameter->setInt("rtc.video.set_remote_default_video_stream_type", streamType) : -ERR_NOT_INITIALIZED; } - /** Sets the audio recording format for the \ref agora::media::IAudioFrameObserver::onRecordAudioFrame "onRecordAudioFrame" callback. - - @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onRecordAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param channel Sets the number of audio channels (@p channels) returned in the *onRecordAudioFrame* callback: - - 1: Mono - - 2: Stereo - @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onRecordAudioFrame* callback. - @param samplesPerCall Sets the sample points (@p samples) returned in the *onRecordAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. - - samplesPerCall = (int)(sampleRate × sampleInterval), where sampleInterval ≥ 0.01 in seconds. - @return - - 0: Success. - - < 0: Failure. - */ int setRecordingAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { return setObject("che.audio.set_capture_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); } - /** Sets the audio playback format for the \ref agora::media::IAudioFrameObserver::onPlaybackAudioFrame "onPlaybackAudioFrame" callback. - - @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onPlaybackAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param channel Sets the number of channels (@p channels) returned in the *onPlaybackAudioFrame* callback: - - 1: Mono - - 2: Stereo - @param mode Sets the use mode (see #RAW_AUDIO_FRAME_OP_MODE_TYPE) of the *onPlaybackAudioFrame* callback. - @param samplesPerCall Sets the sample points (*samples*) returned in the *onPlaybackAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. - samplesPerCall = (int)(sampleRate × sampleInterval), where sampleInterval ≥ 0.01 in seconds. - - @return - - 0: Success. - - < 0: Failure. - */ int setPlaybackAudioFrameParameters(int sampleRate, int channel, RAW_AUDIO_FRAME_OP_MODE_TYPE mode, int samplesPerCall) { return setObject("che.audio.set_render_raw_audio_format", "{\"sampleRate\":%d,\"channelCnt\":%d,\"mode\":%d,\"samplesPerCall\":%d}", sampleRate, channel, mode, samplesPerCall); } - /** Sets the mixed audio format for the \ref agora::media::IAudioFrameObserver::onMixedAudioFrame "onMixedAudioFrame" callback. - @param sampleRate Sets the sample rate (@p samplesPerSec) returned in the *onMixedAudioFrame* callback, which can be set as 8000, 16000, 32000, 44100, or 48000 Hz. - @param samplesPerCall Sets the sample points (@p samples) returned in the *onMixedAudioFrame* callback. @p samplesPerCall is usually set as 1024 for stream pushing. - - samplesPerCall = (int)(sampleRate × sampleInterval), where sampleInterval ≥ 0.01 in seconds. - - @return - - 0: Success. - - < 0: Failure. - */ int setMixedAudioFrameParameters(int sampleRate, int samplesPerCall) { return setObject("che.audio.set_mixed_raw_audio_format", "{\"sampleRate\":%d,\"samplesPerCall\":%d}", sampleRate, samplesPerCall); } - /** Enables interoperability with the Agora Web SDK. - - @note This method applies only to the Live-broadcast profile. In the Communication profile, interoperability with the Agora Web SDK is enabled by default. - @param enabled Sets whether to enable/disable interoperability with the Agora Web SDK: - - true: Enable. - - false: (Default) Disable. - - @return - - 0: Success. - - < 0: Failure. - */ int enableWebSdkInteroperability(bool enabled) {//enable interoperability with zero-plugin web sdk return setParameters("{\"rtc.video.web_h264_interop_enable\":%s,\"che.video.web_h264_interop_enable\":%s}", enabled ? "true" : "false", enabled ? "true" : "false"); } //only for live broadcast - /** **DEPRECATED** Sets the preferences for the high-quality video. (Live broadcast only). - This method is deprecated as of v2.4.0. - - @param preferFrameRateOverImageQuality Sets the video quality preference: - - true: Frame rate over image quality. - - false: (Default) Image quality over frame rate. - - @return - - 0: Success. - - < 0: Failure. - */ int setVideoQualityParameters(bool preferFrameRateOverImageQuality) { return setParameters("{\"rtc.video.prefer_frame_rate\":%s,\"che.video.prefer_frame_rate\":%s}", preferFrameRateOverImageQuality ? "true" : "false", preferFrameRateOverImageQuality ? "true" : "false"); } - /** Sets the local video mirror mode. - You must call this method before calling the \ref agora::rtc::IRtcEngine::startPreview "startPreview" method, otherwise the mirror mode will not work. - - @param mirrorMode Sets the local video mirror mode. See #VIDEO_MIRROR_MODE_TYPE. - @return - - 0: Success. - - < 0: Failure. - */ int setLocalVideoMirrorMode(VIDEO_MIRROR_MODE_TYPE mirrorMode) { if (!m_parameter) return -ERR_NOT_INITIALIZED; const char *value; @@ -7688,57 +9646,18 @@ class RtcEngineParameters return m_parameter->setString("che.video.localViewMirrorSetting", value); } - /** Sets the fallback option for the locally published video stream based on the network conditions. - The default setting for @p option is #STREAM_FALLBACK_OPTION_DISABLED, where there is no fallback behavior for the locally published video stream when the uplink network conditions are poor. - - If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK will: - - - Disable the upstream video but enable audio only when the network conditions worsen and cannot support both video and audio. - - Re-enable the video when the network conditions improve. - - When the locally published video stream falls back to audio only or when the audio-only stream switches back to the video, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onLocalPublishFallbackToAudioOnly "onLocalPublishFallbackToAudioOnly" callback. - - @note Agora does not recommend using this method for CDN live streaming, because the remote CDN live user will have a noticeable lag when the locally publish stream falls back to audio-only. - - @param option Sets the fallback option for the locally published video stream. See #STREAM_FALLBACK_OPTIONS. - @return - - 0: Success. - - < 0: Failure. - */ int setLocalPublishFallbackOption(STREAM_FALLBACK_OPTIONS option) { return m_parameter ? m_parameter->setInt("rtc.local_publish_fallback_option", option) : -ERR_NOT_INITIALIZED; } - /** Sets the fallback option for the remotely subscribed video stream based on the network conditions. - - The default setting for @p option is #STREAM_FALLBACK_OPTION_VIDEO_STREAM_LOW, where the remotely subscribed video stream falls back to the low-stream video (low resolution and low bitrate) under poor downlink network conditions. - If *option* is set as #STREAM_FALLBACK_OPTION_AUDIO_ONLY, the SDK automatically switches the video from a high-stream to a low-stream, or disables the video when the downlink network conditions cannot support both audio and video to guarantee the quality of the audio. The SDK monitors the network quality and restores the video stream when the network conditions improve. - - When the remotely subscribed video stream falls back to audio only or when the audio-only stream switches back to the video stream, the SDK triggers the \ref agora::rtc::IRtcEngineEventHandler::onRemoteSubscribeFallbackToAudioOnly "onRemoteSubscribeFallbackToAudioOnly" callback. - - @param option Sets the fallback option for the remotely subscribed video stream. See #STREAM_FALLBACK_OPTIONS. - @return - - 0: Success. - - < 0: Failure. - */ int setRemoteSubscribeFallbackOption(STREAM_FALLBACK_OPTIONS option) { return m_parameter ? m_parameter->setInt("rtc.remote_subscribe_fallback_option", option) : -ERR_NOT_INITIALIZED; } #if (defined(__APPLE__) && TARGET_OS_MAC && !TARGET_OS_IPHONE) || defined(_WIN32) - /** Enables loopback recording. - @param enabled Sets whether to enable/disable loopback recording: - - true: Enables loopback recording. - - false: (Default) Disables loopback recording. - @param deviceName Pointer to the device name of the sound card. The default value is NULL (the default sound card). - If you use a virtual sound card like "Soundflower", set this parameter as the name of the sound card, "Soundflower", and the SDK will find the corresponding sound card and start capturing. - @return - - 0: Success. - - < 0: Failure. - */ int enableLoopbackRecording(bool enabled, const char* deviceName = NULL) { if (!deviceName) { return setParameters("{\"che.audio.loopback.recording\":%s}", enabled ? "true" : "false"); @@ -7749,14 +9668,7 @@ class RtcEngineParameters } #endif - /** Sets the volume of the in-ear monitor. - - @param volume Sets the volume of the in-ear monitor. The value ranges between 0 and 100 (default). - @return - - 0: Success. - - < 0: Failure. - */ int setInEarMonitoringVolume(int volume) { return m_parameter ? m_parameter->setInt("che.audio.headset.monitoring.parameter", volume) : -ERR_NOT_INITIALIZED; } @@ -7791,11 +9703,7 @@ class RtcEngineParameters } //namespace rtc } // namespace agora -/** Retrieves the SDK version number. - @param build Build number of the Agora SDK. - @return String of the SDK version. - */ #define getAgoraRtcEngineVersion getAgoraSdkVersion //////////////////////////////////////////////////////// @@ -7804,9 +9712,11 @@ class RtcEngineParameters */ //////////////////////////////////////////////////////// -/** Creates the RtcEngine object and returns the pointer. - - @return Pointer to the RtcEngine object. +/** Creates the IRtcEngine object and returns the pointer. + * + * @note The Agora RTC Native SDK supports creating only one `IRtcEngine` object for an app for now. + * + * @return Pointer to the IRtcEngine object. */ AGORA_API agora::rtc::IRtcEngine* AGORA_CALL createAgoraRtcEngine(); diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h index a607ed3..299158c 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/cpp/include/IAgoraService.h @@ -25,11 +25,12 @@ class IAgoraService { protected: virtual ~IAgoraService(){} + public: - virtual void release() = 0; + AGORA_CPP_API static void release (); /** Initializes the engine. - + @param context RtcEngine context. @return - 0: Success. @@ -50,7 +51,7 @@ class IAgoraService } // namespace agora /** Gets the SDK version number. - + @param build Build number of the Agora SDK. @return - 0: Success. diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java index 50a983f..06f0104 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/RtcChannelPublishHelper/src/main/java/io/agora/MediaVideoSource.java @@ -52,6 +52,16 @@ public int getBufferType() { return MediaIO.BufferType.BYTE_ARRAY.intValue(); } + @Override + public int getCaptureType() { + return 0; + } + + @Override + public int getContentHint() { + return 0; + } + /* @Override public int getCaptureType() { diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle index ed5cf64..c1c1acb 100644 --- a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle +++ b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/build.gradle @@ -46,9 +46,9 @@ android { dependencies { implementation fileTree(include: ['*.jar'], dir: 'libs') - implementation(name: 'RtcChannelPublishHelper', ext: 'aar') - // api project(':RtcChannelPublishHelper') - implementation 'io.agora.rtc:full-sdk:2.9.0.107' + // implementation(name: 'RtcChannelPublishHelper', ext: 'aar') + api project(':RtcChannelPublishHelper') + implementation 'io.agora.rtc:full-sdk:3.3.0' //implementation files('lib/AgoraMediaPlayer.jar') //implementation files('lib/agora-rtc-sdk.jar') implementation 'io.agora:agoraplayer:1.2.2' diff --git a/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar b/MediaPlayer/samples/android/AgoraPlayer_Quickstart/app/lib/RtcChannelPublishHelper.aar deleted file mode 100644 index f16758d0ea8be4adfc396ddb9856b507117fb21d..0000000000000000000000000000000000000000 GIT binary patch literal 0 HcmV?d00001 literal 89087 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