LiteAVSDK
腾讯云音视频 SDK ,服务于数万家企业客户的高可用组件,致力于最大限度地节省您的研发成本。
TRTCCloud

详细描述

腾讯云 TRTC 主功能接口


结构体说明

◆ com::tencent::trtc::TRTCCloud::TRTCViewMargin

class com::tencent::trtc::TRTCCloud::TRTCViewMargin

Public 成员函数

 TRTCViewMargin (float leftMargin, float rightMargin, float topMargin, float bottomMargin)
 

成员变量

float leftMargin = 0.0f
 
float topMargin = 0.0f
 
float rightMargin = 0.0f
 
float bottomMargin = 0.0f
 

构造及析构函数说明

◆ TRTCViewMargin()

TRTCViewMargin ( float  leftMargin,
float  rightMargin,
float  topMargin,
float  bottomMargin 
)
inline

结构体成员变量说明

◆ bottomMargin

float bottomMargin = 0.0f

◆ leftMargin

float leftMargin = 0.0f

◆ rightMargin

float rightMargin = 0.0f

◆ topMargin

float topMargin = 0.0f

◆ com::tencent::trtc::TRTCCloud::BGMNotify

interface com::tencent::trtc::TRTCCloud::BGMNotify

Public 成员函数

void onBGMStart (int errCode)
 
void onBGMProgress (long progress, long duration)
 
void onBGMComplete (int err)
 

成员函数说明

◆ onBGMComplete()

void onBGMComplete ( int  err)

◆ onBGMProgress()

void onBGMProgress ( long  progress,
long  duration 
)

◆ onBGMStart()

void onBGMStart ( int  errCode)

◆ com::tencent::trtc::TRTCCloud

class com::tencent::trtc::TRTCCloud

创建实例和事件回调

static TRTCCloud sharedInstance (Context context)
 
static void destroySharedInstance ()
 
abstract void setListener (TRTCCloudListener listener)
 
abstract void setListenerHandler (Handler listenerHandler)
 

房间相关接口函数

abstract void enterRoom (TRTCCloudDef.TRTCParams param, int scene)
 
abstract void exitRoom ()
 
abstract void switchRole (int role)
 
abstract void switchRoom (final TRTCCloudDef.TRTCSwitchRoomConfig config)
 
abstract void ConnectOtherRoom (String param)
 
abstract void DisconnectOtherRoom ()
 
abstract void setDefaultStreamRecvMode (boolean autoRecvAudio, boolean autoRecvVideo)
 
abstract TRTCCloud createSubCloud ()
 
abstract void destroySubCloud (final TRTCCloud subCloud)
 
abstract void startPublishing (final String streamId, final int streamType)
 
abstract void stopPublishing ()
 
abstract void startPublishCDNStream (TRTCCloudDef.TRTCPublishCDNParam param)
 
abstract void stopPublishCDNStream ()
 
abstract void setMixTranscodingConfig (TRTCCloudDef.TRTCTranscodingConfig config)
 

视频相关接口函数

abstract void startLocalPreview (boolean frontCamera, TXCloudVideoView view)
 
abstract void updateLocalView (TXCloudVideoView view)
 
abstract void stopLocalPreview ()
 
abstract void muteLocalVideo (int streamType, boolean mute)
 
abstract void setVideoMuteImage (Bitmap image, int fps)
 
abstract void startRemoteView (String userId, int streamType, TXCloudVideoView view)
 
abstract void updateRemoteView (String userId, int streamType, TXCloudVideoView view)
 
abstract void stopRemoteView (String userId, int streamType)
 
abstract void stopAllRemoteView ()
 
abstract void muteRemoteVideoStream (String userId, int streamType, boolean mute)
 
abstract void muteAllRemoteVideoStreams (boolean mute)
 
abstract void setVideoEncoderParam (TRTCCloudDef.TRTCVideoEncParam param)
 
abstract void setNetworkQosParam (TRTCCloudDef.TRTCNetworkQosParam param)
 
abstract void setLocalRenderParams (TRTCCloudDef.TRTCRenderParams params)
 
abstract void setRemoteRenderParams (String userId, int streamType, TRTCCloudDef.TRTCRenderParams params)
 
abstract void setVideoEncoderRotation (int rotation)
 
abstract void setVideoEncoderMirror (boolean mirror)
 
abstract void setGSensorMode (int mode)
 
abstract int enableEncSmallVideoStream (boolean enable, TRTCCloudDef.TRTCVideoEncParam smallVideoEncParam)
 
abstract int setRemoteVideoStreamType (String userId, int streamType)
 
abstract void snapshotVideo (String userId, int streamType, TRTCCloudListener.TRTCSnapshotListener listener)
 

音频相关接口函数

abstract void startLocalAudio (int quality)
 
abstract void stopLocalAudio ()
 
abstract void muteLocalAudio (boolean mute)
 
abstract void muteRemoteAudio (String userId, boolean mute)
 
abstract void muteAllRemoteAudio (boolean mute)
 
abstract void setAudioRoute (int route)
 
abstract void setRemoteAudioVolume (String userId, int volume)
 
abstract void setAudioCaptureVolume (int volume)
 
abstract int getAudioCaptureVolume ()
 
abstract void setAudioPlayoutVolume (int volume)
 
abstract int getAudioPlayoutVolume ()
 
abstract void enableAudioVolumeEvaluation (int interval)
 
abstract int startAudioRecording (TRTCCloudDef.TRTCAudioRecordingParams param)
 
abstract void stopAudioRecording ()
 
abstract void startLocalRecording (TRTCCloudDef.TRTCLocalRecordingParams params)
 
abstract void stopLocalRecording ()
 
abstract int checkAudioCapabilitySupport (int capabilityType)
 
abstract void setRemoteAudioParallelParams (TRTCCloudDef.TRTCAudioParallelParams params)
 

设备管理相关接口

abstract TXDeviceManager getDeviceManager ()
 

美颜特效和图像水印

abstract TXBeautyManager getBeautyManager ()
 
abstract void setWatermark (Bitmap image, int streamType, float x, float y, float width)
 

背景音乐和声音特效

abstract TXAudioEffectManager getAudioEffectManager ()
 

屏幕分享相关接口

abstract void startScreenCapture (int streamType, TRTCCloudDef.TRTCVideoEncParam encParams, TRTCCloudDef.TRTCScreenShareParams shareParams)
 
abstract void stopScreenCapture ()
 
abstract void pauseScreenCapture ()
 
abstract void resumeScreenCapture ()
 
abstract void setSubStreamEncoderParam (TRTCCloudDef.TRTCVideoEncParam param)
 

自定义采集和自定义渲染

abstract void enableCustomVideoCapture (int streamType, boolean enable)
 
abstract void sendCustomVideoData (int streamType, TRTCCloudDef.TRTCVideoFrame frame)
 
abstract void enableCustomAudioCapture (boolean enable)
 
abstract void sendCustomAudioData (TRTCCloudDef.TRTCAudioFrame frame)
 
abstract void enableMixExternalAudioFrame (boolean enablePublish, boolean enablePlayout)
 
abstract int mixExternalAudioFrame (TRTCCloudDef.TRTCAudioFrame frame)
 
abstract void setMixExternalAudioVolume (int publishVolume, int playoutVolume)
 
abstract long generateCustomPTS ()
 
abstract int setLocalVideoProcessListener (int pixelFormat, int bufferType, TRTCCloudListener.TRTCVideoFrameListener listener)
 
abstract int setLocalVideoRenderListener (int pixelFormat, int bufferType, TRTCCloudListener.TRTCVideoRenderListener listener)
 
abstract int setRemoteVideoRenderListener (String userId, int pixelFormat, int bufferType, TRTCCloudListener.TRTCVideoRenderListener listener)
 
abstract void setAudioFrameListener (TRTCCloudListener.TRTCAudioFrameListener listener)
 
abstract int setCapturedRawAudioFrameCallbackFormat (TRTCCloudDef.TRTCAudioFrameCallbackFormat format)
 
abstract int setLocalProcessedAudioFrameCallbackFormat (TRTCCloudDef.TRTCAudioFrameCallbackFormat format)
 
abstract int setMixedPlayAudioFrameCallbackFormat (TRTCCloudDef.TRTCAudioFrameCallbackFormat format)
 
abstract void enableCustomAudioRendering (boolean enable)
 
abstract void getCustomAudioRenderingFrame (final TRTCCloudDef.TRTCAudioFrame audioFrame)
 

自定义消息发送接口

abstract boolean sendCustomCmdMsg (int cmdID, byte[] data, boolean reliable, boolean ordered)
 
abstract boolean sendSEIMsg (byte[] data, int repeatCount)
 

网络测试接口

abstract int startSpeedTest (TRTCCloudDef.TRTCSpeedTestParams params)
 
abstract void stopSpeedTest ()
 

调试相关接口

static String getSDKVersion ()
 
static void setLogLevel (int level)
 
static void setConsoleEnabled (boolean enabled)
 
static void setLogCompressEnabled (boolean enabled)
 
static void setLogDirPath (String path)
 
static void setLogListener (final TRTCCloudListener.TRTCLogListener logListener)
 
static native void setNetEnv (int env)
 
abstract void showDebugView (int showType)
 
abstract void setDebugViewMargin (String userId, TRTCViewMargin margin)
 
abstract void callExperimentalAPI (String jsonStr)
 

弃用接口(建议使用对应的新接口)

abstract void setMicVolumeOnMixing (int volume)
 
abstract void setBeautyStyle (int beautyStyle, int beautyLevel, int whitenessLevel, int ruddinessLevel)
 
abstract void setEyeScaleLevel (int eyeScaleLevel)
 
abstract void setFaceSlimLevel (int faceScaleLevel)
 
abstract void setFaceVLevel (int faceVLevel)
 
abstract void setChinLevel (int chinLevel)
 
abstract void setFaceShortLevel (int faceShortlevel)
 
abstract void setNoseSlimLevel (int noseSlimLevel)
 
abstract void selectMotionTmpl (String motionPath)
 
abstract void setMotionMute (boolean motionMute)
 
abstract void setFilter (Bitmap image)
 
abstract void setFilterConcentration (float concentration)
 
abstract boolean setGreenScreenFile (String file)
 
abstract void playBGM (String path, BGMNotify notify)
 
abstract void stopBGM ()
 
abstract void pauseBGM ()
 
abstract void resumeBGM ()
 
abstract int getBGMDuration (String path)
 
abstract int setBGMPosition (int pos)
 
abstract void setBGMVolume (int volume)
 
abstract void setBGMPlayoutVolume (int volume)
 
abstract void setBGMPublishVolume (int volume)
 
abstract void setReverbType (int reverbType)
 
abstract boolean setVoiceChangerType (int voiceChangerType)
 
abstract void playAudioEffect (TRTCCloudDef.TRTCAudioEffectParam effect)
 
abstract void setAudioEffectVolume (int effectId, int volume)
 
abstract void stopAudioEffect (int effectId)
 
abstract void stopAllAudioEffects ()
 
abstract void setAllAudioEffectsVolume (int volume)
 
abstract void pauseAudioEffect (int effectId)
 
abstract void resumeAudioEffect (int effectId)
 
abstract void enableAudioEarMonitoring (boolean enable)
 
abstract void startRemoteView (String userId, TXCloudVideoView view)
 
abstract void stopRemoteView (String userId)
 
abstract void setRemoteViewFillMode (String userId, int mode)
 
abstract void setRemoteViewRotation (String userId, int rotation)
 
abstract void setLocalViewFillMode (int mode)
 
abstract void setLocalViewRotation (int rotation)
 
abstract void setLocalViewMirror (int mirrorType)
 
abstract void startRemoteSubStreamView (String userId, TXCloudVideoView view)
 
abstract void stopRemoteSubStreamView (String userId)
 
abstract void setRemoteSubStreamViewFillMode (String userId, int mode)
 
abstract void setRemoteSubStreamViewRotation (final String userId, final int rotation)
 
abstract int setPriorRemoteVideoStreamType (int streamType)
 
abstract void setAudioQuality (int quality)
 
abstract void startLocalAudio ()
 
abstract void switchCamera ()
 
abstract boolean isCameraZoomSupported ()
 
abstract void setZoom (int distance)
 
abstract boolean isCameraTorchSupported ()
 
abstract boolean enableTorch (boolean enable)
 
abstract boolean isCameraFocusPositionInPreviewSupported ()
 
abstract void setFocusPosition (int x, int y)
 
abstract boolean isCameraAutoFocusFaceModeSupported ()
 
abstract void setSystemVolumeType (int type)
 
abstract void enableCustomVideoCapture (boolean enable)
 
abstract void sendCustomVideoData (TRTCCloudDef.TRTCVideoFrame frame)
 
abstract void startScreenCapture (TRTCCloudDef.TRTCVideoEncParam encParams, TRTCCloudDef.TRTCScreenShareParams shareParams)
 
abstract void muteLocalVideo (boolean mute)
 
abstract void muteRemoteVideoStream (String userId, boolean mute)
 
abstract void startSpeedTest (int sdkAppId, String userId, String userSig)
 

成员函数说明

◆ callExperimentalAPI()

abstract void callExperimentalAPI ( String  jsonStr)
abstract

调用实验性接口

◆ checkAudioCapabilitySupport()

abstract int checkAudioCapabilitySupport ( int  capabilityType)
abstract

查询是否支持音频某种能力(仅适用于Android)

参数
capabilityType音频能力类型.
返回
0:不支持此能力;1:支持此能力。

◆ ConnectOtherRoom()

abstract void ConnectOtherRoom ( String  param)
abstract

请求跨房通话

默认情况下,只有同一个房间中的用户之间可以进行音视频通话,不同的房间之间的音视频流是相互隔离的。 但您可以通过调用该接口,将另一个房间中某个主播音视频流发布到自己所在的房间中,与此同时,该接口也会将自己的音视频流发布到目标主播的房间中。 也就是说,您可以使用该接口让身处两个不同房间中的主播进行跨房间的音视频流分享,从而让每个房间中的观众都能观看到这两个主播的音视频。该功能可以用来实现主播之间的 PK 功能。 跨房通话的请求结果会通过 TRTCCloudDelegate 中的 onConnectOtherRoom() 回调通知给您。 例如:当房间“101”中的主播 A 通过 connectOtherRoom() 跟房间“102”中的主播 B 建立跨房通话后,

  • 房间“101”中的用户都会收到主播 B 的 onRemoteUserEnterRoom(B) 和 onUserVideoAvailable(B,true) 这两个事件回调,即房间“101”中的用户都可以订阅主播 B 的音视频。
  • 房间“102”中的用户都会收到主播 A 的 onRemoteUserEnterRoom(A) 和 onUserVideoAvailable(A,true) 这两个事件回调,即房间“102”中的用户都可以订阅主播 A 的音视频。
                房间 101                     房间 102
              -------------               ------------
 跨房通话前:| 主播 A      |             | 主播 B     |
             | 观众 U V W  |             | 观众 X Y Z |
              -------------               ------------
                房间 101                     房间 102
              -------------               ------------
 跨房通话后:| 主播 A B    |             | 主播 B A   |
             | 观众 U V W  |             | 观众 X Y Z |
              -------------               ------------

跨房通话的参数考虑到后续扩展字段的兼容性问题,暂时采用了 JSON 格式的参数:

【情况一:数字房间号】 如果房间“101”中的主播 A 要跟房间“102”中的主播 B 连麦,那么主播 A 调用该接口时需要传入:{"roomId": 102, "userId": "userB"} 示例代码如下:

  JSONObject jsonObj = new JSONObject();
  jsonObj.put("roomId", 102);
  jsonObj.put("userId", "userB");
  trtc.ConnectOtherRoom(jsonObj.toString());

【情况二:字符串房间号】 如果您使用的是字符串房间号,务必请将 json 中的 “roomId” 替换成 “strRoomId”: {"strRoomId": "102", "userId": "userB"} 示例代码如下:

  JSONObject jsonObj = new JSONObject();
  jsonObj.put("strRoomId", "102");
  jsonObj.put("userId", "userB");
  trtc.ConnectOtherRoom(jsonObj.toString());
参数
param需要你传入 JSON 格式的字符串参数,roomId 代表数字格式的房间号,strRoomId 代表字符串格式的房间号,userId 代表目标主播的用户ID。

◆ createSubCloud()

abstract TRTCCloud createSubCloud ( )
abstract

创建子房间示例(用于多房间并发观看)

TRTCCloud 一开始被设计成单例模式,限制了多房间并发观看的能力。 通过调用该接口,您可以创建出多个 TRTCCloud 实例,以便同时进入多个不同的房间观看音视频流。 但需要注意的是,由于摄像头和麦克风还是只有一份,因此您只能同时在一个 TRTCCloud 实例中以“主播”的身份存在,也就是您只能同时在一个 TRTCCloud 实例中发布自己的音视频流。 该功能主要用于在线教育场景中一种被称为“超级小班课”的业务场景中,用于解决“每个 TRTC 的房间中最多只能有 50 人同时发布自己音视频流”的限制。 示例代码如下:

    TRTCCloud mainCloud = TRTCCloud.sharedInstance(mContext);
    mainCloud.enterRoom(params1, TRTCCloudDef.TRTC_APP_SCENE_LIVE);
    //...
    //Switch the role from "anchor" to "audience" in your own room
    mainCloud.switchRole(TRTCCloudDef.TRTCRoleAudience);
    mainCloud.muteLocalVideo(true);
    mainCloud.muteLocalAudio(true);
    //...
    //Use subcloud to enter another room and switch the role from "audience" to "anchor"
    TRTCCloud subCloud = mainCloud.createSubCloud();
    subCloud.enterRoom(params2, TRTCCloudDef.TRTC_APP_SCENE_LIVE);
    subCloud.switchRole(TRTCCloudDef.TRTCRoleAnchor);
    subCloud.muteLocalVideo(false);
    subCloud.muteLocalAudio(false);
    //...
    //Exit from new room and release it.
    subCloud.exitRoom();
    mainCloud.destroySubCloud(subCloud);
注意
  • 同一个用户,可以使用同一个 userId 进入多个不同 roomId 的房间。
  • 两台不同的终端设备不可以同时使用同一个 userId 进入同一个 roomId 的房间。
  • 同一个用户,同时只能在一个 TRTCCloud 实例中推流,在不同房间同时推流会引发云端的状态混乱,导致各种 bug。
  • 通过 createSubCloud 接口创建出来的 TRTCCloud 实例有一个能力限制:不能调用子实例中与本地音视频相关的接口(除 switchRole、muteLocalVideo 和 muteLocalAudio 之外), 设置美颜等接口请使用原 TRTCCloud 实例对象。
返回
子 TRTCCloud 实例

◆ destroySharedInstance()

static void destroySharedInstance ( )
inlinestatic

销毁 TRTCCloud 实例(单例模式)

◆ destroySubCloud()

abstract void destroySubCloud ( final TRTCCloud  subCloud)
abstract

销毁子房间示例

参数
subCloud

◆ DisconnectOtherRoom()

abstract void DisconnectOtherRoom ( )
abstract

退出跨房通话

退出结果会通过 TRTCCloudDelegate 中的 onDisconnectOtherRoom() 回调通知给您。

◆ enableAudioEarMonitoring()

abstract void enableAudioEarMonitoring ( boolean  enable)
abstract

开启(或关闭)耳返

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setVoiceEarMonitor 替代之。

◆ enableAudioVolumeEvaluation()

abstract void enableAudioVolumeEvaluation ( int  interval)
abstract

启用音量大小提示

开启此功能后,SDK 会在 TRTCCloudDelegate 中的 onUserVoiceVolume 回调中反馈远端音频的音量大小。

注意
如需打开此功能,请在 startLocalAudio 之前调用才可以生效。
参数
interval设置 onUserVoiceVolume 回调的触发间隔,单位为ms,最小间隔为100ms,如果小于等于 0 则会关闭回调,建议设置为300ms;

◆ enableCustomAudioCapture()

abstract void enableCustomAudioCapture ( boolean  enable)
abstract

启用音频自定义采集模式

开启该模式后,SDK 不在运行原有的音频采集流程,即不再继续从麦克风采集音频数据,而是只保留音频编码和发送能力。 您需要通过 sendCustomAudioData 不断地向 SDK 塞入自己采集的音频数据。

参数
enable是否启用,默认值:false。
注意
由于回声抵消(AEC)需要严格的控制声音采集和播放的时间,所以开启自定义音频采集后,AEC 能力可能会失效。

◆ enableCustomAudioRendering()

abstract void enableCustomAudioRendering ( boolean  enable)
abstract

开启音频自定义播放

如果您需要外接一些特定的音频设备,或者希望自己掌控音频的播放逻辑,您可以通过该接口启用音频自定义播放。 启用音频自定义播放后,SDK 将不再调用系统的音频接口播放数据,您需要通过 getCustomAudioRenderingFrame 获取 SDK 要播放的音频帧并自行播放。

参数
enable是否启用音频自定义播放,默认为关闭状态。
注意
需要您在进入房间前设置才能生效,暂不支持进入房间后再设置。

◆ enableCustomVideoCapture() [1/2]

abstract void enableCustomVideoCapture ( boolean  enable)
abstract

启用视频自定义采集模式

弃用:
v8.5 版本开始不推荐使用,建议使用 enableCustomVideoCapture(streamType,enable) 接口替代之。

◆ enableCustomVideoCapture() [2/2]

abstract void enableCustomVideoCapture ( int  streamType,
boolean  enable 
)
abstract

启用/关闭视频自定义采集模式

开启该模式后,SDK 不在运行原有的视频采集流程,即不再继续从摄像头采集数据和美颜,而是只保留视频编码和发送能力。 您需要通过 sendCustomVideoData 不断地向 SDK 塞入自己采集的视频画面。

参数
streamType用于指定视频流类型,TRTCVideoStreamTypeBig:高清大画面;TRTCVideoStreamTypeSub:辅路画面。
enable是否启用,默认值:false。

◆ enableEncSmallVideoStream()

abstract int enableEncSmallVideoStream ( boolean  enable,
TRTCCloudDef.TRTCVideoEncParam  smallVideoEncParam 
)
abstract

开启大小画面双路编码模式

开启双路编码模式后,当前用户的编码器会同时输出【高清大画面】和【低清小画面】两路视频流(但只有一路音频流)。 如此以来,房间中的其他用户就可以根据自身的网络情况或屏幕大小选择订阅【高清大画面】或是【低清小画面】。

注意
双路编码开启后,会消耗更多的 CPU 和 网络带宽,所以 Mac、Windows 或者高性能 Pad 可以考虑开启,不建议手机端开启。
参数
enable是否开启小画面编码,默认值:false
smallVideoEncParam小流的视频参数
返回
0:成功;-1:当前大画面已被设置为较低画质,开启双路编码已无必要。

◆ enableMixExternalAudioFrame()

abstract void enableMixExternalAudioFrame ( boolean  enablePublish,
boolean  enablePlayout 
)
abstract

启用/关闭自定义音轨

开启后,您可以通过本接口向 SDK 混入一条自定义的音轨。通过两个布尔型参数,您可以控制该音轨是否要在远端和本地播放。

参数
enablePublish控制混入的音轨是否要在远端播放,默认值:false。
enablePlayout控制混入的音轨是否要在本地播放,默认值:false。
注意
如果您指定参数 enablePublish 和 enablePlayout 均为 false,代表完全关闭您的自定义音轨。

◆ enableTorch()

abstract boolean enableTorch ( boolean  enable)
abstract

开关/关闭闪光灯

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 enableCameraTorch 接口替代之。

◆ enterRoom()

abstract void enterRoom ( TRTCCloudDef.TRTCParams  param,
int  scene 
)
abstract

进入房间

TRTC 的所有用户都需要进入房间才能“发布”或“订阅”音视频流,“发布”是指将自己的音频和视频推送到云端,“订阅”是指从云端拉取房间里其他用户的音视频流。 调用该接口时,您需要指定您的应用场景 TRTCAppScene 以获取最佳的音视频传输体验,这些场景可以分成两大类:

【直播场景(Live)】

  • 包括 TRTCAppSceneLIVETRTCAppSceneVoiceChatRoom
  • 此类场景下,每一个房间最多同时容纳 10 万人,但需要您通过 TRTCParams 中的 “role” 字段设定用户是“主播”(TRTCRoleAnchor)还是“观众”(TRTCRoleAudience)。
  • 主播可以“发布”自己的音视频流,观众只能“订阅”别人的音视频流,每一个用户都可以在主播和观众两种角色间通过 switchRole 接口进行切换。
  • 适用于[视频低延时直播]、[十万人互动课堂]、[直播PK]、[音乐直播间]、[在线K歌]、[远程培训]、[超大型会议]等业务形态。

【实时场景(RTC)】

  • 包括 TRTCAppSceneVideoCallTRTCAppSceneAudioCall
  • 此类场景下,每一个房间最多同时容纳 300 人在线,最高支持 50 人同时发言。
  • 适用于 [1对1视频通话]、[300人视频会议]、[在线问诊]、[语音聊天]、[教育小班课]、[远程面试]、[在线狼人杀]等业务形态。

调用该接口后,您会收到来自 TRTCCloudDelegate 中的 onEnterRoom(result) 回调:

  • 如果进房成功,参数 result 会是一个正数(result > 0),表示从函数调用到进入房间所花费的时间,单位是毫秒(ms)。
  • 如果进房失败,参数 result 会是一个负数(result < 0),表示进房失败的错误码
参数
param进房参数,用于指定用户的身份、角色和安全票据等信息,详情请参考 TRTCParams
scene应用场景,用于指定您的业务场景,同一个房间内的所有用户需要设定相同的 TRTCAppScene
注意
  1. 同一个房间内的所有用户需要设定相同的 scene。不同的 scene 会导致偶现的异常问题。
  2. 当您指定参数 scene 为 TRTCAppSceneLIVETRTCAppSceneVoiceChatRoom 时,您必须通过 TRTCParams 中的 “role” 字段为当前用户设定他/她在房间中的角色。
  3. 请您尽量保证 enterRoomexitRoom 前后配对使用,即保证”先退出前一个房间再进入下一个房间”,否则会导致很多异常问题。

◆ exitRoom()

abstract void exitRoom ( )
abstract

离开房间

调用该接口会让用户离开自己所在的音视频房间,并释放摄像头、麦克风、扬声器等设备资源。 等资源释放完毕之后,SDK 会通过 TRTCCloudDelegate 中的 onExitRoom() 回调向您通知。 如果您要再次调用 enterRoom 或者切换到其他的供应商的 SDK,建议等待 onExitRoom() 回调到来之后再执行之后的操作,以避免摄像头或麦克风被占用的问题。

◆ generateCustomPTS()

abstract long generateCustomPTS ( )
abstract

生成自定义采集时的时间戳

本接口仅适用于自定义采集模式,用于解决音视频帧的采集时间(capture time)和投送时间(send time)不一致所导致的音画不同步问题。 当您通过 sendCustomVideoDatasendCustomAudioData 等接口进行自定义视频或音频采集时,请按照如下操作使用该接口:

  1. 首先,在采集到一帧视频或音频帧时,通过调用本接口获得当时的 PTS 时间戳。
  2. 之后可以将该视频或音频帧送入您使用的前处理模块(如第三方美颜组件,或第三方音效组件)。
  3. 在真正调用 sendCustomVideoDatasendCustomAudioData 进行投送时,请将该帧在采集时记录的 PTS 时间戳赋值给 TRTCVideoFrameTRTCAudioFrame 中的 timestamp 字段。
返回
时间戳(单位:ms)

◆ getAudioCaptureVolume()

abstract int getAudioCaptureVolume ( )
abstract

获取本地音频的采集音量

◆ getAudioEffectManager()

abstract TXAudioEffectManager getAudioEffectManager ( )
abstract

获取音效管理类(TXAudioEffectManager)

TXAudioEffectManager 是音效管理接口,您可以通过该接口实现如下功能:

  • 背景音乐:支持在线音乐和本地音乐,支持变速、变调等特效、支持原生和伴奏并播放和循环播放。
  • 耳机耳返:麦克风捕捉的声音实时通过耳机播放,常用于音乐直播。
  • 混响效果:KTV、小房间、大会堂、低沉、洪亮...
  • 变声特效:萝莉、大叔、重金属...
  • 短音效:鼓掌声、欢笑声等简短的音效文件(对于小于10秒的文件,请将 isShortFile 参数设置为 true)。

◆ getAudioPlayoutVolume()

abstract int getAudioPlayoutVolume ( )
abstract

获取远端音频的播放音量

◆ getBeautyManager()

abstract TXBeautyManager getBeautyManager ( )
abstract

获取美颜管理类(TXBeautyManager)

通过美颜管理,您可以使用以下功能:

  • 设置"磨皮"、“美白”、“红润”等美颜特效。
  • 设置“大眼”、“瘦脸”、“V脸”、“下巴”、“短脸”、“小鼻”、“亮眼”、“白牙”、“祛眼袋”、“祛皱纹”、“祛法令纹”等修脸特效。
  • 设置“发际线”、“眼间距”、“眼角”、“嘴形”、“鼻翼”、“鼻子位置”、“嘴唇厚度”、“脸型”等修脸特效。
  • 设置"眼影"、“腮红”等美妆特效。
  • 设置动态贴纸和人脸挂件等动画特效。

◆ getBGMDuration()

abstract int getBGMDuration ( String  path)
abstract

获取背景音乐总时长(单位:毫秒)

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#getMusicDurationInMS 替代之。

◆ getCustomAudioRenderingFrame()

abstract void getCustomAudioRenderingFrame ( final TRTCCloudDef.TRTCAudioFrame  audioFrame)
abstract

获取可播放的音频数据

调用该接口之前,您需要先通过 enableCustomAudioRendering 开启音频自定义播放。 参数 TRTCAudioFrame 推荐下列填写方式(其他字段不需要填写):

  • sampleRate:采样率,必填,支持 16000、24000、32000、44100、48000。
  • channel:声道数,必填,单声道请填1,双声道请填2,双声道时数据是交叉的。
  • data:用于获取音频数据的 buffer。需要您根据一阵音频帧的帧长度分配好 date 的内存大小。 获取的 PCM 数据支持 10ms 或 20ms 两种帧长,推荐使用 20ms 的帧长。 计算公式为:48000采样率、单声道、且播放时长为 20ms 的一帧音频帧的 buffer 大小为 48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节。
参数
audioFrame音频数据帧。
注意
  1. 参数 audioFrame 中的 sampleRate、channel 需提前设置好,同时分配好所需读取帧长的 data 空间。
  2. SDK 内部会根据 sampleRate 和 channel 自动填充 data 数据。
  3. 建议由系统的音频播放线程直接驱动该函数的调用,在播放完一帧音频之后,即调用该接口获取下一帧可播放的音频数据。

◆ getDeviceManager()

abstract TXDeviceManager getDeviceManager ( )
abstract

获取设备管理类(TXDeviceManager)

◆ getSDKVersion()

static String getSDKVersion ( )
inlinestatic

获取 SDK 版本信息

◆ isCameraAutoFocusFaceModeSupported()

abstract boolean isCameraAutoFocusFaceModeSupported ( )
abstract

查询是否支持自动识别人脸位置

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 isAutoFocusEnabled 接口替代之。

◆ isCameraFocusPositionInPreviewSupported()

abstract boolean isCameraFocusPositionInPreviewSupported ( )
abstract

查询摄像头是否支持设置焦点

弃用:
v8.0 版本开始不推荐使用。

◆ isCameraTorchSupported()

abstract boolean isCameraTorchSupported ( )
abstract

查询是否支持开关闪光灯

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 isCameraTorchSupported 接口替代之。

◆ isCameraZoomSupported()

abstract boolean isCameraZoomSupported ( )
abstract

查询当前摄像头是否支持缩放

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 isCameraZoomSupported 接口替代之。

◆ mixExternalAudioFrame()

abstract int mixExternalAudioFrame ( TRTCCloudDef.TRTCAudioFrame  frame)
abstract

向 SDK 混入自定义音轨

调用该接口之前,您需要先通过 enableMixExternalAudioFrame 开启自定义音轨,之后就可以通过本接口将自己的音轨以 PCM 格式混入到 SDK 中。 理想情况下,我们期望您的代码能够以非常均匀的速度向 SDK 提供音轨数据。但我们也非常清楚,完美的调用间隔是一个巨大的挑战。 所以 SDK 内部会开启一个音轨数据的缓冲区,该缓冲区的作用类似一个“蓄水池”,它能够暂存您传入的音轨数据,平抑由于接口调用间隔的抖动问题。 本接口的返回值代表这个音轨缓冲区的大小,单位是毫秒(ms),比如:如果该接口返回 50,则代表当前的音轨缓冲区有 50ms 的音轨数据。因此只要您在 50ms 内再次调用本接口,SDK 就能保证您混入的音轨数据是连续的。 当您调用该接口后,如果发现返回值 > 100ms,则可以等待一帧音频帧的播放时间之后再次调用;如果返回值 < 100ms,则代表缓冲区比较小,您可以再次混入一些音轨数据以确保音轨缓冲区的大小维持在“安全水位”以上。 参数 TRTCAudioFrame 推荐下列填写方式(其他字段不需要填写):

  • data:音频帧 buffer。音频帧数据只支持 PCM 格式,支持[5ms ~ 100ms]帧长,推荐使用 20ms 帧长,长度计算方法:【48000采样率、单声道的帧长度:48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
  • sampleRate:采样率,支持:16000、24000、32000、44100、48000。
  • channel:声道数(如果是立体声,数据是交叉的),单声道:1; 双声道:2。
  • timestamp:时间戳,单位为毫秒(ms),请使用音频帧在采集时被记录下来的时间戳(可以在获得一帧音频帧之后,通过调用 generateCustomPTS 获得时间戳)。
参数
frame音频数据
返回
>= 0 缓冲的长度,单位:ms。< 0 错误(-1 未启用 mixExternalAudioFrame)
注意
请您精准地按每帧时长的间隔调用本接口,数据投送间隔不均匀时极易触发声音卡顿。

◆ muteAllRemoteAudio()

abstract void muteAllRemoteAudio ( boolean  mute)
abstract

暂停/恢复播放所有远端用户的音频流

当您静音所有用户的远端音频时,SDK 会停止播放所有来自远端的音频流,同时也会停止拉取所有用户的音频数据。

参数
mutetrue:静音;false:取消静音。
注意
在进入房间(enterRoom)之前或之后调用本接口均生效,静音状态在退出房间(exitRoom) 之后会被重置为 false。

◆ muteAllRemoteVideoStreams()

abstract void muteAllRemoteVideoStreams ( boolean  mute)
abstract

暂停/恢复订阅所有远端用户的视频流

该接口仅暂停/恢复接收所有用户的视频流,但并不释放显示资源,视频画面会被冻屏在接口调用时的最后一帧。

参数
mute是否暂停接收
注意
该接口支持您在进入房间(enterRoom)前调用,暂停状态会在退出房间(exitRoom)在之后会被重置。

◆ muteLocalAudio()

abstract void muteLocalAudio ( boolean  mute)
abstract

暂停/恢复发布本地的音频流

当您暂停发布本地音频流之后,房间中的其他他用户会收到 onUserAudioAvailable(userId, false) 的通知。 当您恢复发布本地音频流之后,房间中的其他他用户会收到 onUserAudioAvailable(userId, true) 的通知。 与 stopLocalAudio 的不同之处在于,muteLocalAudio(true) 并不会释放麦克风权限,而是继续发送码率极低的静音包。 这对于需要云端录制的场景非常适用,因为 MP4 等格式的视频文件,对于音频数据的连续性要求很高,使用 stopLocalAudio 会导致录制出的 MP4 文件不易播放。 因此在对录制文件的质量要求较高的场景中,建议选择 muteLocalAudio 而不建议使用 stopLocalAudio。

参数
mutetrue:静音;false:恢复。

◆ muteLocalVideo() [1/2]

abstract void muteLocalVideo ( boolean  mute)
abstract

暂停/恢复发布本地的视频流

弃用:
v8.9 版本开始不推荐使用,建议使用 muteLocalVideo(streamType, mute) 接口替代之。

◆ muteLocalVideo() [2/2]

abstract void muteLocalVideo ( int  streamType,
boolean  mute 
)
abstract

暂停/恢复发布本地的视频流

该接口可以暂停(或恢复)发布本地的视频画面,暂停之后,同一房间中的其他用户将无法继续看到自己画面。 该接口在指定 TRTCVideoStreamTypeBig 时等效于 start/stopLocalPreview 这两个接口,但具有更好的响应速度。 因为 start/stopLocalPreview 需要打开和关闭摄像头,而打开和关闭摄像头都是硬件设备相关的操作,非常耗时。 相比之下,muteLocalVideo 只需要在软件层面对数据流进行暂停或者放行即可,因此效率更高,也更适合需要频繁打开关闭的场景。 当暂停/恢复发布指定 TRTCVideoStreamTypeBig 后,同一房间中的其他用户将会收到 onUserVideoAvailable 回调通知。 当暂停/恢复发布指定 TRTCVideoStreamTypeSub 后,同一房间中的其他用户将会收到 onUserSubStreamAvailable 回调通知。

参数
streamType要暂停/恢复的视频流类型(仅支持 TRTCVideoStreamTypeBigTRTCVideoStreamTypeSub
mutetrue:暂停;false:恢复。

◆ muteRemoteAudio()

abstract void muteRemoteAudio ( String  userId,
boolean  mute 
)
abstract

暂停/恢复播放远端的音频流

当您静音某用户的远端音频时,SDK 会停止播放指定用户的声音,同时也会停止拉取该用户的音频数据数据。

参数
userId用于指定远端用户的 ID。
mutetrue:静音;false:取消静音。
注意
在进入房间(enterRoom)之前或之后调用本接口均生效,静音状态在退出房间(exitRoom) 之后会被重置为 false。

◆ muteRemoteVideoStream() [1/2]

abstract void muteRemoteVideoStream ( String  userId,
boolean  mute 
)
abstract

暂停 / 恢复订阅远端用户的视频流

弃用:
v8.9 版本开始不推荐使用,建议使用 muteRemoteVideoStream(userId, streamType, mute) 接口替代之。

◆ muteRemoteVideoStream() [2/2]

abstract void muteRemoteVideoStream ( String  userId,
int  streamType,
boolean  mute 
)
abstract

暂停/恢复订阅远端用户的视频流

该接口仅暂停/恢复接收指定用户的视频流,但并不释放显示资源,视频画面会被冻屏在接口调用时的最后一帧。

参数
userId指定远端用户的 ID。
streamType要暂停/恢复的视频流类型(仅支持 TRTCVideoStreamTypeBigTRTCVideoStreamTypeSub)。
mute是否暂停接收。
注意
该接口支持您在进入房间(enterRoom)前调用,暂停状态会在退出房间(exitRoom)在之后会被重置。

◆ pauseAudioEffect()

abstract void pauseAudioEffect ( int  effectId)
abstract

暂停音效

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#pauseAudioEffect 替代之。

◆ pauseBGM()

abstract void pauseBGM ( )
abstract

停止播放背景音乐

弃用:
v7.3 版本开始不推荐使用,建议使用 getAudioEffectManager 替代之。

◆ pauseScreenCapture()

abstract void pauseScreenCapture ( )
abstract

暂停屏幕分享

◆ playAudioEffect()

abstract void playAudioEffect ( TRTCCloudDef.TRTCAudioEffectParam  effect)
abstract

播放音效

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#startPlayMusic 替代之。

◆ playBGM()

abstract void playBGM ( String  path,
BGMNotify  notify 
)
abstract

启动播放背景音乐

弃用:
v7.3 版本开始不推荐使用,建议使用 getAudioEffectManager 替代之。

◆ resumeAudioEffect()

abstract void resumeAudioEffect ( int  effectId)
abstract

暂停音效

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#resumePlayMusic 替代之。

◆ resumeBGM()

abstract void resumeBGM ( )
abstract

停止播放背景音乐

弃用:
v7.3 版本开始不推荐使用,建议使用 getAudioEffectManager 替代之。

◆ resumeScreenCapture()

abstract void resumeScreenCapture ( )
abstract

恢复屏幕分享

◆ selectMotionTmpl()

abstract void selectMotionTmpl ( String  motionPath)
abstract

设置动效贴纸

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ sendCustomAudioData()

abstract void sendCustomAudioData ( TRTCCloudDef.TRTCAudioFrame  frame)
abstract

向 SDK 投送自己采集的音频数据

参数 TRTCAudioFrame 推荐下列填写方式(其他字段不需要填写):

  • audioFormat:音频数据格式,仅支持 TRTCAudioFrameFormatPCM。
  • data:音频帧 buffer。音频帧数据只支持 PCM 格式,支持[5ms ~ 100ms]帧长,推荐使用 20ms 帧长,长度计算方法:【48000采样率、单声道的帧长度:48000 × 0.02s × 1 × 16bit = 15360bit = 1920字节】。
  • sampleRate:采样率,支持:16000、24000、32000、44100、48000。
  • channel:声道数(如果是立体声,数据是交叉的),单声道:1; 双声道:2。
  • timestamp:时间戳,单位为毫秒(ms),请使用音频帧在采集时被记录下来的时间戳(可以在采集到一帧音频帧之后,通过调用 generateCustomPTS 获取时间戳)。

参考文档:自定义采集和渲染

参数
frame音频数据
注意
请您精准地按每帧时长的间隔调用本接口,数据投送间隔不均匀时极易触发声音卡顿。

◆ sendCustomCmdMsg()

abstract boolean sendCustomCmdMsg ( int  cmdID,
byte[]  data,
boolean  reliable,
boolean  ordered 
)
abstract

使用 UDP 通道发送自定义消息给房间内所有用户

该接口可以让您借助 TRTC 的 UDP 通道,向当前房间里的其他用户广播自定义数据,已达到传输信令的目的。 TRTC 中的 UDP 通道原本设计用来传输音视频数据的,该接口的原理是将您要发送的信令伪装成音视频数据包,与原本要发送的音视频数据一并发送出去。 房间中的其他用户可以通过 TRTCCloudDelegate 中的 onRecvCustomCmdMsg 回调接收消息。

参数
cmdID消息 ID,取值范围为1 - 10。
data待发送的消息,单个消息的最大长度被限制为 1KB。
reliable是否可靠发送,可靠发送可以获得更高的发送成功率,但可靠发送比不可靠发送会带来更大的接收延迟。
ordered是否要求有序,即是否要求接收端的数据包顺序和发送端的数据包顺序一致(这会带来一定的接收延时)。
返回
true:消息已经发出;false:消息发送失败。
注意
  1. 发送消息到房间内所有用户(暂时不支持 Web/小程序端),每秒最多能发送30条消息。
  2. 每个包最大为 1KB,超过则很有可能会被中间路由器或者服务器丢弃。
  3. 每个客户端每秒最多能发送总计 8KB 数据。
  4. 请将 reliable 和 ordered 同时设置为 true 或同时设置为 false,暂不支持交叉设置。
  5. 强烈建议您将不同类型的消息设定为不同的 cmdID,这样可以在要求有序的情况下减小消息时延。

◆ sendCustomVideoData() [1/2]

abstract void sendCustomVideoData ( int  streamType,
TRTCCloudDef.TRTCVideoFrame  frame 
)
abstract

向 SDK 投送自己采集的视频帧

使用此接口可以向 SDK 投送自己采集的视频帧,SDK 会将视频帧进行编码并通过自身的网络模块传输出去。 Android 平台有两种投送方案:

  • 内存传递方案:对接起来比较简单,但是性能较差,不适合分辨率较高的场景。
  • 显存传递方案:对接需要一定的 OpenGL 基础,但是性能较好,640 × 360 以上的分辨率请采用该方案。

参考文档:自定义采集和渲染

参数
streamType用于指定视频流类型,TRTCVideoStreamTypeBig:高清大画面;TRTCVideoStreamTypeSub:辅路画面。
frame视频数据,如果是内存传递方案,请设置 data 字段;如果是显存传递方案,请设置 TRTCTexture 字段。详情请参考 TRTCVideoFrame
注意
  1. 推荐您在采集到的一帧视频帧后,即调用 generateCustomPTS 接口获取该帧的 timestamp 数值,这样可以获得最佳的音画同步效果。
  2. SDK 最终编码出的视频帧率并不是由您调用本接口的频率决定的,而是由您在 setVideoEncoderParam 中所设置的 FPS 决定的。
  3. 请尽量保持本接口的调用间隔是均匀的,否则会导致编码器输出帧率不稳或者音画不同步等问题。

◆ sendCustomVideoData() [2/2]

abstract void sendCustomVideoData ( TRTCCloudDef.TRTCVideoFrame  frame)
abstract

投送自己采集的视频数据

弃用:
v8.5 版本开始不推荐使用,建议使用 sendCustomVideoData(streamType, TRTCVideoFrame) 接口替代之。

◆ sendSEIMsg()

abstract boolean sendSEIMsg ( byte[]  data,
int  repeatCount 
)
abstract

使用 SEI 通道发送自定义消息给房间内所有用户

该接口可以让您借助 TRTC 的 SEI 通道,向当前房间里的其他用户广播自定义数据,已达到传输信令的目的。 视频帧的头部有一个叫做 SEI 的头部数据块,该接口的原理就是利用这个被称为 SEI 的头部数据块,将您要发送的自定义信令嵌入其中,使其同视频帧一并发送出去。 因此,与 sendCustomCmdMsg 相比,SEI 通道传输的信令具有更好的兼容性:信令可以伴随着视频帧一直传输到直播 CDN 上。 不过,由于视频帧头部的数据块不能太大,建议您使用该接口时,尽量将信令控制在几个字节的大小。 最常见的用法是把自定义的时间戳(timestamp)用本接口嵌入视频帧中,实现消息和画面的完美对齐(比如:教育场景下的课件和视频信号的对齐)。 房间中的其他用户可以通过 TRTCCloudDelegate 中的 onRecvSEIMsg 回调接收消息。

参数
data待发送的数据,最大支持 1KB(1000字节)的数据大小
repeatCount发送数据次数
返回
true:消息已通过限制,等待后续视频帧发送;false:消息被限制发送
注意
本接口有以下限制:
  1. 数据在接口调用完后不会被即时发送出去,而是从下一帧视频帧开始带在视频帧中发送。
  2. 发送消息到房间内所有用户,每秒最多能发送 30 条消息(与 sendCustomCmdMsg 共享限制)。
  3. 每个包最大为 1KB,若发送大量数据,会导致视频码率增大,可能导致视频画质下降甚至卡顿(与 sendCustomCmdMsg 共享限制)。
  4. 每个客户端每秒最多能发送总计8KB数据(与 sendCustomCmdMsg 共享限制)。
  5. 若指定多次发送(repeatCount > 1),则数据会被带在后续的连续 repeatCount 个视频帧中发送出去,同样会导致视频码率增大。
  6. 如果 repeatCount > 1,多次发送,接收消息 onRecvSEIMsg 回调也可能会收到多次相同的消息,需要去重。

◆ setAllAudioEffectsVolume()

abstract void setAllAudioEffectsVolume ( int  volume)
abstract

设置所有音效音量

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setMusicPublishVolumeTXAudioEffectManager#setMusicPlayoutVolume 替代之。

◆ setAudioCaptureVolume()

abstract void setAudioCaptureVolume ( int  volume)
abstract

设定本地音频的采集音量

参数
volume音量大小,取值范围为0 - 100;默认值:100
注意
如果将 volume 设置成 100 之后感觉音量还是太小,可以将 volume 最大设置成 150,但超过 100 的 volume 会有爆音的风险,请谨慎操作。

◆ setAudioEffectVolume()

abstract void setAudioEffectVolume ( int  effectId,
int  volume 
)
abstract

设置音效音量

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setMusicPublishVolumeTXAudioEffectManager#setMusicPlayoutVolume 替代之。

◆ setAudioFrameListener()

abstract void setAudioFrameListener ( TRTCCloudListener.TRTCAudioFrameListener  listener)
abstract

设置音频数据自定义回调

设置该回调之后,SDK 内部会把音频数据(PCM 格式)回调出来,包括:

注意
设置回调为空即代表停止自定义音频回调,反之,设置回调不为空则代表启动自定义音频回调。

◆ setAudioPlayoutVolume()

abstract void setAudioPlayoutVolume ( int  volume)
abstract

设定远端音频的播放音量

该接口会控制 SDK 最终交给系统播放的声音音量,调节效果会影响到本地音频录制文件的音量大小,但不会影响到耳返的音量大小。

参数
volume音量大小,取值范围为0 - 100,默认值:100。
注意
如果将 volume 设置成 100 之后感觉音量还是太小,可以将 volume 最大设置成 150,但超过 100 的 volume 会有爆音的风险,请谨慎操作。

◆ setAudioQuality()

abstract void setAudioQuality ( int  quality)
abstract

设置音频质量

弃用:
v8.0 版本开始不推荐使用,建议使用 startLocalAudio:(quality) 替代之。

◆ setAudioRoute()

abstract void setAudioRoute ( int  route)
abstract

设置音频路由

设置“音频路由”,即设置声音是从手机的扬声器还是从听筒中播放出来,因此该接口仅适用于手机等移动端设备。 手机有两个扬声器:一个是位于手机顶部的听筒,一个是位于手机底部的立体声扬声器。 设置音频路由为听筒时,声音比较小,只有将耳朵凑近才能听清楚,隐私性较好,适合用于接听电话。 设置音频路由为扬声器时,声音比较大,不用将手机贴脸也能听清,因此可以实现“免提”的功能。

参数
route音频路由,即声音由哪里输出(扬声器、听筒),默认值:TRTCAudioModeSpeakerphone。

◆ setBeautyStyle()

abstract void setBeautyStyle ( int  beautyStyle,
int  beautyLevel,
int  whitenessLevel,
int  ruddinessLevel 
)
abstract

设置美颜、美白以及红润效果级别

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setBGMPlayoutVolume()

abstract void setBGMPlayoutVolume ( int  volume)
abstract

设置背景音乐的本地播放音量

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setMusicPlayoutVolume 替代之。

◆ setBGMPosition()

abstract int setBGMPosition ( int  pos)
abstract

设置背景音乐的播放进度

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#seekMusicToPosInMS 替代之。

◆ setBGMPublishVolume()

abstract void setBGMPublishVolume ( int  volume)
abstract

设置背景音乐的远端播放音量

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setBGMPublishVolume 替代之。

◆ setBGMVolume()

abstract void setBGMVolume ( int  volume)
abstract

设置背景音乐的音量大小

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setMusicVolume 替代之。

◆ setCapturedRawAudioFrameCallbackFormat()

abstract int setCapturedRawAudioFrameCallbackFormat ( TRTCCloudDef.TRTCAudioFrameCallbackFormat  format)
abstract

设置本地麦克风采集出的原始音频帧回调格式

本接口用于设置 onCapturedRawAudioFrame 回调出来的 AudioFrame 的格式:

  • sampleRate:采样率,支持:16000、32000、44100、48000。
  • channel:声道数(如果是立体声,数据是交叉的),单声道:1; 双声道:2。
  • samplesPerCall:采样点数,定义回调数据帧长。帧长必须为 10ms 的整数倍。

如果希望用毫秒数计算回调帧长,则将毫秒数转换成采样点数的公式为:采样点数 = 毫秒数 * 采样率 / 1000; 举例:48000 采样率希望回调 20ms 帧长的数据,则采样点数应该填: 960 = 20 * 48000 / 1000; 注意,最终回调的帧长度是以字节为单位,采样点数转换成字节数的计算公式为:字节数 = 采样点数 * channel * 2(位宽) 举例:48000 采样率,双声道,20ms 帧长,采样点数为 960,字节数为 3840 = 960 * 2 * 2

参数
format音频数据回调格式。
返回
0:成功;<0:错误

◆ setChinLevel()

abstract void setChinLevel ( int  chinLevel)
abstract

设置下巴拉伸或收缩幅度

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setConsoleEnabled()

static void setConsoleEnabled ( boolean  enabled)
inlinestatic

启用/禁用控制台日志打印

参数
enabled指定是否启用,默认:禁止状态

◆ setDebugViewMargin()

abstract void setDebugViewMargin ( String  userId,
TRTCViewMargin  margin 
)
abstract

◆ setDefaultStreamRecvMode()

abstract void setDefaultStreamRecvMode ( boolean  autoRecvAudio,
boolean  autoRecvVideo 
)
abstract

设置订阅模式(需要在进入房前设置才能生效)

您可以通过该接口在“自动订阅”和“手动订阅”两种模式下进行切换:

  • 自动订阅:默认模式,用户在进入房间后会立刻接收到该房间中的音视频流,音频会自动播放,视频会自动开始解码(依然需要您通过 startRemoteView 接口绑定渲染控件)。
  • 手动订阅:在用户进入房间后,需要手动调用 {@startRemoteView} 接口才能启动视频流的订阅和解码,需要手动调用 {@muteRemoteAudio} (false) 接口才能启动声音的播放。

在绝大多数场景下,用户进入房间后都会订阅房间中所有主播的音视频流,因此 TRTC 默认采用了自动订阅模式,以求得最佳的“秒开体验”。 如果您的应用场景中每个房间同时会有很多路音视频流在发布,而每个用户只想选择性地订阅其中的 1-2 路,则推荐使用“手动订阅”模式以节省流量费用。

参数
autoRecvAudiotrue:自动订阅音频;false:需手动调用 muteRemoteAudio(false) 订阅音频。默认值:true。
autoRecvVideotrue:自动订阅视频;false:需手动调用 startRemoteView 订阅视频。默认值:true。
注意
  1. 需要在进入房间(enterRoom)前调用该接口,设置才能生效。
  2. 在自动订阅模式下,如果用户在进入房间后没有调用 {@startRemoteView} 订阅视频流,SDK 会自动停止订阅视频流,以便达到节省流量的目的。

◆ setEyeScaleLevel()

abstract void setEyeScaleLevel ( int  eyeScaleLevel)
abstract

设置大眼级别

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setFaceShortLevel()

abstract void setFaceShortLevel ( int  faceShortlevel)
abstract

设置短脸级别

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setFaceSlimLevel()

abstract void setFaceSlimLevel ( int  faceScaleLevel)
abstract

设置瘦脸级别

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setFaceVLevel()

abstract void setFaceVLevel ( int  faceVLevel)
abstract

设置 V 脸级别

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setFilter()

abstract void setFilter ( Bitmap  image)
abstract

设置色彩滤镜效果

弃用:
v7.2 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setFilterConcentration()

abstract void setFilterConcentration ( float  concentration)
abstract

设置色彩滤镜浓度

弃用:
v7.2 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setFocusPosition()

abstract void setFocusPosition ( int  x,
int  y 
)
abstract

设置摄像头焦点坐标位置

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 setCameraFocusPosition 接口替代之。

◆ setGreenScreenFile()

abstract boolean setGreenScreenFile ( String  file)
abstract

设置绿幕背景视频

弃用:
v7.2 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setGSensorMode()

abstract void setGSensorMode ( int  mode)
abstract

设置重力感应的适配模式

您可以通过本接口实现如下这种友好的交互体验: 当用户将手机或 Pad 上下颠倒时,由于摄像头的采集方向没有变,所以房间中其他用户所看到的画面会变成上下颠倒的, 在这种情况下,您可以通过调用该接口让 SDK 根据设备陀螺仪的朝向自动调整本地画面和编码器输出画面的旋转方向,以使远端观众可以看到正常朝向的画面。

参数
mode重力感应模式,详情请参考 TRTCGSensorMode,默认值:TRTCGSensorMode_UIAutoLayout。

◆ setListener()

abstract void setListener ( TRTCCloudListener  listener)
abstract

设置 TRTC 事件回调

您可以通过 TRTCCloudDelegate 获得来自 SDK 的各类事件通知(比如:错误码,警告码,音视频状态参数等)。

◆ setListenerHandler()

abstract void setListenerHandler ( Handler  listenerHandler)
abstract

设置驱动 TRTCCloudDelegate 事件回调的队列

如果您不指定自己的 listenerHandler 默认会采用 MainQueue 作为驱动 TRTCCloudDelegate 事件回调的队列。 也就是当您不设置 listenerHandler 属性时,TRTCCloudDelegate 中的所有回调函数都是由 MainQueue 来驱动的。

参数
listenerHandler
注意
如果您指定了自己的 listenerHandler TRTCCloudDelegate 回调函数中操作 UI,否则会引发线程安全问题。

◆ setLocalProcessedAudioFrameCallbackFormat()

abstract int setLocalProcessedAudioFrameCallbackFormat ( TRTCCloudDef.TRTCAudioFrameCallbackFormat  format)
abstract

设置经过前处理后的本地音频帧回调格式

本接口用于设置 onLocalProcessedAudioFrame 回调出来的 AudioFrame 的格式:

  • sampleRate:采样率,支持:16000、32000、44100、48000。
  • channel:声道数(如果是立体声,数据是交叉的),单声道:1; 双声道:2。
  • samplesPerCall:采样点数,定义回调数据帧长。帧长必须为 10ms 的整数倍。

如果希望用毫秒数计算回调帧长,则将毫秒数转换成采样点数的公式为:采样点数 = 毫秒数 * 采样率 / 1000; 举例:48000 采样率希望回调20ms帧长的数据,则采样点数应该填: 960 = 20 * 48000 / 1000; 注意,最终回调的帧长度是以字节为单位,采样点数转换成字节数的计算公式为:字节数 = 采样点数 * channel * 2(位宽) 举例:48000 采样率,双声道,20ms 帧长,采样点数为 960,字节数为 3840 = 960 * 2 * 2

参数
format音频数据回调格式。
返回
0:成功;<0:错误

◆ setLocalRenderParams()

abstract void setLocalRenderParams ( TRTCCloudDef.TRTCRenderParams  params)
abstract

设置本地画面的渲染参数

可设置的参数包括有:画面的旋转角度、填充模式以及左右镜像等。

参数
params画面渲染参数,详情请参考 TRTCRenderParams

◆ setLocalVideoProcessListener()

abstract int setLocalVideoProcessListener ( int  pixelFormat,
int  bufferType,
TRTCCloudListener.TRTCVideoFrameListener  listener 
)
abstract

设置第三方美颜的视频数据回调

设置该回调之后,SDK 会把采集到的视频帧通过您设置的 listener 回调出来,用于第三方美颜组件进行二次处理,之后 SDK 会将处理后的视频帧进行编码和发送。

参数
pixelFormat指定回调的像素格式,目前支持:
bufferType指定回调的数据格式,目前支持
listener自定义预处理回调,详见 TRTCCloudListener.TRTCVideoFrameListener
返回
0:成功;<0:错误

◆ setLocalVideoRenderListener()

abstract int setLocalVideoRenderListener ( int  pixelFormat,
int  bufferType,
TRTCCloudListener.TRTCVideoRenderListener  listener 
)
abstract

设置本地视频自定义渲染回调

设置该回调之后,SDK 内部会跳过原来的渲染流程,并把采集到的数据回调出来,您需要自己完成画面渲染。

  • pixelFormat 指定回调的数据格式,目前支持 Texture2D、I420 和 RGBA 三种格式。
  • bufferType 指定 buffer 的类型,BYTE_BUFFER 适合在 jni 层使用,BYTE_ARRAY 则可用于 Java 层的直接操作。

参考文档:自定义采集和渲染

参数
pixelFormat指定视频帧的像素格式,如:
bufferType指定视频帧的数据结构:
listener自定义视频渲染回调,每一帧视频数据回调一次。
返回
0:成功;<0:错误

◆ setLocalViewFillMode()

abstract void setLocalViewFillMode ( int  mode)
abstract

设置本地图像的渲染模式

弃用:
v8.0 版本开始不推荐使用,建议使用 setLocalRenderParams 替代之。

◆ setLocalViewMirror()

abstract void setLocalViewMirror ( int  mirrorType)
abstract

设置本地摄像头预览画面的镜像模式

弃用:
v8.0 版本开始不推荐使用,建议使用 setLocalRenderParams 替代之。

◆ setLocalViewRotation()

abstract void setLocalViewRotation ( int  rotation)
abstract

设置本地图像的顺时针旋转角度

弃用:
v8.0 版本开始不推荐使用,建议使用 setLocalRenderParams 替代之。

◆ setLogCompressEnabled()

static void setLogCompressEnabled ( boolean  enabled)
inlinestatic

启用/禁用日志的本地压缩

开启压缩后,Log 存储体积明显减小,但需要腾讯云提供的 Python 脚本解压后才能阅读。 禁用压缩后,Log 采用明文存储,可以直接用记事本打开阅读,但占用空间较大。

参数
enabled指定是否启用,默认为启动状态

◆ setLogDirPath()

static void setLogDirPath ( String  path)
inlinestatic

设置本地日志的保存路径

通过该接口您可以更改 SDK 本地日志的默认存储路径,SDK 默认的本地日志的存储位置:

  • Windows 平台:在 C:/Users/[系统用户名]/AppData/Roaming/liteav/log,即 appdata%/liteav/log 下。
  • iOS 或 Mac 平台:在 sandbox Documents/log 下。
  • Android 平台:在 /app私有目录/files/log/liteav/ 下。
注意
请务必在所有其他接口之前调用,并且保证您指定的目录是存在的,并且您的应用程序拥有对该目录的读写权限。
参数
path存储日志的路径

◆ setLogLevel()

static void setLogLevel ( int  level)
inlinestatic

设置 Log 输出级别

参数
level参见 TRTCLogLevel,默认值:TRTCLogLevelNone

◆ setLogListener()

static void setLogListener ( final TRTCCloudListener.TRTCLogListener  logListener)
inlinestatic

设置日志回调

◆ setMicVolumeOnMixing()

abstract void setMicVolumeOnMixing ( int  volume)
abstract

设置麦克风的音量大小

弃用:
v6.9 版本开始不推荐使用,建议使用 setAudioCaptureVolume 替代之。

◆ setMixedPlayAudioFrameCallbackFormat()

abstract int setMixedPlayAudioFrameCallbackFormat ( TRTCCloudDef.TRTCAudioFrameCallbackFormat  format)
abstract

设置最终要由系统播放出的音频帧回调格式

本接口用于设置 onMixedPlayAudioFrame 回调出来的 AudioFrame 的格式:

  • sampleRate:采样率,支持:16000、32000、44100、48000。
  • channel:声道数(如果是立体声,数据是交叉的),单声道:1; 双声道:2。
  • samplesPerCall:采样点数,定义回调数据帧长。帧长必须为 10ms 的整数倍。

如果希望用毫秒数计算回调帧长,则将毫秒数转换成采样点数的公式为:采样点数 = 毫秒数 * 采样率 / 1000; 举例:48000 采样率希望回调20ms帧长的数据,则采样点数应该填: 960 = 20 * 48000 / 1000; 注意,最终回调的帧长度是以字节为单位,采样点数转换成字节数的计算公式为:字节数 = 采样点数 * channel * 2(位宽) 举例:48000 采样率,双声道,20ms 帧长,采样点数为 960,字节数为 3840 = 960 * 2 * 2

参数
format音频数据回调格式。
返回
0:成功;<0:错误

◆ setMixExternalAudioVolume()

abstract void setMixExternalAudioVolume ( int  publishVolume,
int  playoutVolume 
)
abstract

设置推流时混入外部音频的推流音量和播放音量

参数
publishVolume设置的推流音量大小,范围0 - 100, -1表示不改变
playoutVolume设置的播放音量大小,范围0 - 100, -1表示不改变

◆ setMixTranscodingConfig()

abstract void setMixTranscodingConfig ( TRTCCloudDef.TRTCTranscodingConfig  config)
abstract

设置云端混流的排版布局和转码参数

在一个直播间中可能同时会有多个主播发布自己的音视频流,但对于直播 CDN 上的观众而言,只需要观看一条 HTTP-FLV 或 HLS 格式的视频流即可。 当您调用本接口函数时,SDK 会向腾讯云的 TRTC 混流服务器发送一条指令,混流服务器会将房间里的多路音视频流混合成一路。 您可以通过 TRTCTranscodingConfig 参数来调整每一路画面的排版布局,也可以设置混合后的音视频流的各项编码参数。 参考文档:云端混流转码

    【画面1】=> 解码 ====> \
                            \
    【画面2】=> 解码 =>  画面混合 => 编码 => 【混合后的画面】
                            //
    【画面3】=> 解码 ====> //
    【声音1】=> 解码 ====> \
                            \
    【声音2】=> 解码 =>  声音混合 => 编码 => 【混合后的声音】
                            //
    【声音3】=> 解码 ====> //
参数
config如果 config 不为空,则开启云端混流,如果 config 为空则停止云端混流。详情请参考 TRTCTranscodingConfig
注意
关于云端混流的注意事项:
  • 混流转码为收费功能,调用接口将产生云端混流转码费用,详见 https://cloud.tencent.com/document/product/647/49446
  • 调用该接口的用户,如果没设定 config 参数中的 streamId 字段,TRTC 会将房间中的多路画面混合到当前用户所对应的音视频流上,即 A + B => A。
  • 调用该接口的用户,如果设定了 config 参数中的 streamId 字段,TRTC 会将房间中的多路画面混合到您指定的 streamId 上,即 A + B => streamId。
  • 请注意,若您还在房间中且不再需要混流,请务必再次调用本接口并将 config 设置为空以进行取消,不及时取消混流可能会引起不必要的计费损失。
  • 请放心,当您退房时 TRTC 会自动取消混流状态。

◆ setMotionMute()

abstract void setMotionMute ( boolean  motionMute)
abstract

设置动效静音

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setNetEnv()

static native void setNetEnv ( int  env)
static

设置 TRTC 的后台集群(仅适用于腾讯云研发团队)

◆ setNetworkQosParam()

abstract void setNetworkQosParam ( TRTCCloudDef.TRTCNetworkQosParam  param)
abstract

设置网络质量控制的相关参数

该设置决定在差网络环境下的质量调控策略,如“画质优先”或“流畅优先”等策略。

参数
param用于设置网络质量控制的相关参数,详情请参考 TRTCNetworkQosParam

◆ setNoseSlimLevel()

abstract void setNoseSlimLevel ( int  noseSlimLevel)
abstract

设置瘦鼻级别

弃用:
v6.9 版本开始不推荐使用,建议使用 getBeautyManager 替代之。

◆ setPriorRemoteVideoStreamType()

abstract int setPriorRemoteVideoStreamType ( int  streamType)
abstract

设定优先观看大画面还是小画面

弃用:
v8.0 版本开始不推荐使用,建议使用 startRemoteView:streamType:view: 替代之。

◆ setRemoteAudioParallelParams()

abstract void setRemoteAudioParallelParams ( TRTCCloudDef.TRTCAudioParallelParams  params)
abstract

设置远端音频流智能并发播放策略

设置远端音频流智能并发播放策略,适用于上麦人数比较多的场景。

参数
params音频并发参数,请参考 TRTCAudioParallelParams

◆ setRemoteAudioVolume()

abstract void setRemoteAudioVolume ( String  userId,
int  volume 
)
abstract

设定某一个远端用户的声音播放音量

您可以通过 setRemoteAudioVolume(userId, 0) 将某一个远端用户的声音静音。

参数
userId用于指定远端用户的 ID。
volume音量大小,取值范围为0 - 100,默认值:100。
注意
如果将 volume 设置成 100 之后感觉音量还是太小,可以将 volume 最大设置成 150,但超过 100 的 volume 会有爆音的风险,请谨慎操作。

◆ setRemoteRenderParams()

abstract void setRemoteRenderParams ( String  userId,
int  streamType,
TRTCCloudDef.TRTCRenderParams  params 
)
abstract

设置远端画面的渲染模式

可设置的参数包括有:画面的旋转角度、填充模式以及左右镜像等。

参数
userId指定远端用户的 ID。
streamType可以设置为主路画面(TRTCVideoStreamTypeBig)或辅路画面(TRTCVideoStreamTypeSub)
params画面渲染参数,详情请参考 TRTCRenderParams

◆ setRemoteSubStreamViewFillMode()

abstract void setRemoteSubStreamViewFillMode ( String  userId,
int  mode 
)
abstract

设置辅路画面的填充模式

弃用:
v8.0 版本开始不推荐使用,建议使用 setRemoteRenderParams:streamType:params: 替代之。

◆ setRemoteSubStreamViewRotation()

abstract void setRemoteSubStreamViewRotation ( final String  userId,
final int  rotation 
)
abstract

设置辅路画面的顺时针旋转角度

弃用:
v8.0 版本开始不推荐使用,建议使用 setRemoteRenderParams:streamType:params: 替代之。

◆ setRemoteVideoRenderListener()

abstract int setRemoteVideoRenderListener ( String  userId,
int  pixelFormat,
int  bufferType,
TRTCCloudListener.TRTCVideoRenderListener  listener 
)
abstract

设置远端视频自定义渲染回调

设置该回调之后,SDK 内部会跳过原来的渲染流程,并把采集到的数据回调出来,您需要自己完成画面渲染。

  • pixelFormat 指定回调的数据格式,例如 NV12、i420 以及 32BGRA。
  • bufferType 指定 buffer 的类型,直接使用 PixelBuffer 效率最高;使用 NSData 相当于让 SDK 在内部做了一次内存转换,因此会有额外的性能损耗。

参考文档:自定义采集和渲染

注意
实际使用时,需要先调用 startRemoteView(userid, null) 启动远程视频流的拉取,并将 view 设置为 null,否则不会有数据回调出来。
参数
userId指定远端用户的 ID
pixelFormat指定视频帧的像素格式,目前支持 TRTCCloudDef#TRTC_VIDEO_PIXEL_FORMAT_I420TRTCCloudDef#TRTC_VIDEO_PIXEL_FORMAT_RGBA
bufferType指定视频帧的数据结构,如 TRTCCloudDef#TRTC_VIDEO_BUFFER_TYPE_BYTE_BUFFERTRTCCloudDef#TRTC_VIDEO_BUFFER_TYPE_BYTE_ARRAY
listener自定义视频渲染回调,每一帧视频数据回调一次。
返回
0:成功;<0:错误

◆ setRemoteVideoStreamType()

abstract int setRemoteVideoStreamType ( String  userId,
int  streamType 
)
abstract

切换指定远端用户的大小画面

当房间中某个主播开启了双路编码之后,房间中其他用户通过 startRemoteView 订阅到的画面默认会是【高清大画面】。 您可以通过此接口选定希望订阅的画面是大画面还是小画面,该接口在 startRemoteView 之前和之后调用均可生效。

注意
此功能需要目标用户已经通过 enableEncSmallVideoStream 提前开启了双路编码模式,否则此调用无实际效果。
参数
userId指定远端用户的 ID。
streamType视频流类型,即选择看大画面还是小画面,默认为大画面。

◆ setRemoteViewFillMode()

abstract void setRemoteViewFillMode ( String  userId,
int  mode 
)
abstract

设置远端图像的渲染模式

弃用:
v8.0 版本开始不推荐使用,建议使用 setRemoteRenderParams:streamType:params: 替代之。

◆ setRemoteViewRotation()

abstract void setRemoteViewRotation ( String  userId,
int  rotation 
)
abstract

设置远端图像的顺时针旋转角度

弃用:
v8.0 版本开始不推荐使用,建议使用 setRemoteRenderParams:streamType:params: 替代之。

◆ setReverbType()

abstract void setReverbType ( int  reverbType)
abstract

设置混响效果

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setVoiceReverbType 替代之。

◆ setSubStreamEncoderParam()

abstract void setSubStreamEncoderParam ( TRTCCloudDef.TRTCVideoEncParam  param)
abstract

设置屏幕分享(即辅路)的视频编码参数(桌面系统和移动系统均已支持)

该接口可以设定远端用户所看到的屏幕分享(即辅路)的画面质量,同时也能决定云端录制出的视频文件中屏幕分享的画面质量。 请注意如下两个接口的差异:

参数
param辅流编码参数,详情请参考 TRTCVideoEncParam
注意
即使您使用主路传输屏幕分享(在调用 startScreenCapture 时设置 type=TRTCVideoStreamTypeBig),依然要使用 setSubStreamEncoderParam 设定屏幕分享的编码参数,而不要使用 setVideoEncoderParam

◆ setSystemVolumeType()

abstract void setSystemVolumeType ( int  type)
abstract

设置系统音量类型

弃用:
v8.0 版本开始不推荐使用,建议使用 startLocalAudio:(quality) 替代之,通过 quality 参数来决策音质。

◆ setVideoEncoderMirror()

abstract void setVideoEncoderMirror ( boolean  mirror)
abstract

设置编码器输出的画面镜像模式

该设置不影响本地画面的镜像模式,但会影响房间中其他用户所观看到(以及云端录制文件)的镜像模式。

参数
mirror是否开启远端镜像,true:开启远端画面镜像;false:关闭远端画面镜像,默认值:false。

◆ setVideoEncoderParam()

abstract void setVideoEncoderParam ( TRTCCloudDef.TRTCVideoEncParam  param)
abstract

设置视频编码器的编码参数

该设置能够决定远端用户看到的画面质量,同时也能决定云端录制出的视频文件的画面质量。

参数
param用于设置视频编码器的相关参数,详情请参考 TRTCVideoEncParam

◆ setVideoEncoderRotation()

abstract void setVideoEncoderRotation ( int  rotation)
abstract

设置视频编码器输出的画面方向

该设置不影响本地画面的预览方向,但会影响房间中其他用户所观看到(以及云端录制文件)的画面方向。 当用户将手机或 Pad 上下颠倒时,由于摄像头的采集方向没有变,所以房间中其他用户所看到的画面会变成上下颠倒的, 在这种情况下,您可以通过调用该接口将 SDK 编码出的画面方向旋转180度,如此一来,房间中其他用户所看到的画面可保持正常的方向。 如果您希望实现上述这种友好的交互体验,我们更推荐您直接调用 setGSensorMode 实现更加智能的方向适配,无需您手动调用本接口。

参数
rotation目前支持0和180两个旋转角度,默认值:TRTCVideoRotation_0,即不旋转。

◆ setVideoMuteImage()

abstract void setVideoMuteImage ( Bitmap  image,
int  fps 
)
abstract

设置本地画面被暂停期间的替代图片

当您调用 muteLocalVideo(true) 暂停本地画面时,您可以通过调用本接口设置一张替代图片,设置后,房间中的其他用户会看到这张替代图片,而不是黑屏画面。

参数
image设置替代图片,空值代表在 muteLocalVideo 之后不再发送视频流数据,默认值为空。
fps设置替代图片帧率,最小值为5,最大值为10,默认5。

◆ setVoiceChangerType()

abstract boolean setVoiceChangerType ( int  voiceChangerType)
abstract

设置变声类型

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#setVoiceChangerType 替代之。

◆ setWatermark()

abstract void setWatermark ( Bitmap  image,
int  streamType,
float  x,
float  y,
float  width 
)
abstract

添加水印

水印的位置是通过 rect 参数来指定的,rect 是一个四元组参数,其格式为 (x,y,width,height)

  • x:水印的坐标,取值范围为0 - 1的浮点数。
  • y:水印的坐标,取值范围为0 - 1的浮点数。
  • width:水印的宽度,取值范围为0 - 1的浮点数。
  • height:是不用设置的,SDK 内部会根据水印图片的宽高比自动计算一个合适的高度。

参数设置举例: 如果当前视频的编码分辨率是 540 × 960,且 rect 参数被您设置为(0.1,0.1,0.2,0.0), 那么水印的左上坐标点就是(540 × 0.1,960 × 0.1)即(54,96),水印的宽度是 540 × 0.2 = 108px,水印的高度会根据水印图片的宽高比由 SDK 自动算出。

参数
image水印图片,**必须使用透明底色的 png 格式**
streamType指定给哪一路画面设置水印,详情请参考TRTCVideoStreamType
rect水印相对于编码分辨率的归一化坐标,x,y,width,height 取值范围0 - 1。
注意
如果您要给主画面(一般为摄像头)和辅路画面(一般用作屏幕分享)同时设置水印,需要调用该接口两次,并设定不同的 streamType。

◆ setZoom()

abstract void setZoom ( int  distance)
abstract

设置摄像头缩放倍数(焦距)

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 setCameraZoomRatio 接口替代之。

◆ sharedInstance()

static TRTCCloud sharedInstance ( Context  context)
inlinestatic

创建 TRTCCloud 实例(单例模式)

◆ showDebugView()

abstract void showDebugView ( int  showType)
abstract

显示仪表盘

“仪表盘”是位于视频渲染控件之上的一个半透明的调试信息浮层,用于展示音视频信息和事件信息,便于对接和调试。

参数
showType0:不显示;1:显示精简版(仅显示音视频信息);2:显示完整版(包含音视频信息和事件信息)。

◆ snapshotVideo()

abstract void snapshotVideo ( String  userId,
int  streamType,
TRTCCloudListener.TRTCSnapshotListener  listener 
)
abstract

视频画面截图

您可以通过本接口截取本地的视频画面,远端用户的主路画面以及远端用户的辅路(屏幕分享)画面。

参数
userId用户 ID,如指定空置表示截取本地的视频画面。
streamType视频流类型,可选择截取主路画面(TRTCVideoStreamTypeBig,常用于摄像头)或辅路画面(TRTCVideoStreamTypeSub,常用于屏幕分享)。
sourceType画面来源,可选择截取视频流画面(TRTCSnapshotSourceTypeStream)或视频渲染画面(TRTCSnapshotSourceTypeView),前者一般更清晰。
注意
Windows 平台目前仅支持截取 TRTCSnapshotSourceTypeStream 来源的视频画面。

◆ startAudioRecording()

abstract int startAudioRecording ( TRTCCloudDef.TRTCAudioRecordingParams  param)
abstract

开始录音

当您调用改接口后, SDK 会将本地和远端的所有音频(包括本地音频,远端音频,背景音乐和音效等)混合并录制到一个本地文件中。 该接口在进入房间前后调用均可生效,如果录制任务在退出房间前尚未通过 stopAudioRecording 停止,则退出房间后录制任务会自动被停止。

参数
param录音参数,请参考 TRTCAudioRecordingParams
返回
0:成功;-1:录音已开始;-2:文件或目录创建失败;-3:后缀指定的音频格式不支持。

◆ startLocalAudio() [1/2]

abstract void startLocalAudio ( )
abstract

设置音频质量

弃用:
v8.0 版本开始不推荐使用,建议使用 startLocalAudio:(quality) 替代之。

◆ startLocalAudio() [2/2]

abstract void startLocalAudio ( int  quality)
abstract

开启本地音频的采集和发布

SDK 默认不开启麦克风,当用户需要发布本地音频时,需要调用该接口开启麦克风采集,并将音频编码并发布到当前的房间中。 开启本地音频的采集和发布后,房间中的其他用户会收到 onUserAudioAvailable(userId, true) 的通知。

参数
quality声音音质
  • TRTCAudioQualitySpeech,流畅:采样率:16k;单声道;音频裸码率:16kbps;适合语音通话为主的场景,比如在线会议,语音通话。
  • TRTCAudioQualityDefault,默认:采样率:48k;单声道;音频裸码率:50kbps;SDK 默认的音频质量,如无特殊需求推荐选择之。
  • TRTCAudioQualityMusic,高音质:采样率:48k;双声道 + 全频带;音频裸码率:128kbps;适合需要高保真传输音乐的场景,比如在线K歌、音乐直播等。
注意
该函数会检查麦克风的使用权限,如果当前 App 没有麦克风权限,SDK 会自动向用户申请麦克风使用权限。

◆ startLocalPreview()

abstract void startLocalPreview ( boolean  frontCamera,
TXCloudVideoView  view 
)
abstract

开启本地摄像头的预览画面(移动端)

在 enterRoom 之前调用此函数,SDK 只会开启摄像头,并一直等到您调用 enterRoom 之后才开始推流。 在 enterRoom 之后调用此函数,SDK 会开启摄像头并自动开始视频推流。 当开始渲染首帧摄像头画面时,您会收到 TRTCCloudDelegate 中的 onCameraDidReady 回调通知。

参数
frontCameratrue:前置摄像头;false:后置摄像头。
view承载视频画面的控件
注意
如果希望开播前预览摄像头画面并通过 BeautyManager 调节美颜参数,您可以:
  • 方案一:在调用 enterRoom 之前调用 startLocalPreview
  • 方案二:在调用 enterRoom 之后调用 startLocalPreview + muteLocalVideo(true)

◆ startLocalRecording()

abstract void startLocalRecording ( TRTCCloudDef.TRTCLocalRecordingParams  params)
abstract

开启本地媒体录制

开启后把直播过程中的音视和视频内容录制到本地的一个文件中。

参数
params录制参数,请参考 TRTCLocalRecordingParams

◆ startPublishCDNStream()

abstract void startPublishCDNStream ( TRTCCloudDef.TRTCPublishCDNParam  param)
abstract

开始向非腾讯云 CDN 上发布音视频流

该接口跟 startPublishing 功能类似,不同之处在于,startPublishing 仅支持向腾讯云的 CDN 发布,而本接口支持向非腾讯云的直播 CDN 上转推音视频流。

参数
paramCDN 转推参数,详情请参考 TRTCPublishCDNParam
注意
  • 使用 startPublishing 接口向腾讯云的直播 CDN 上发布音视频流不会收取额外费用
  • 使用 startPublishCDNStream 接口向非腾讯云的直播 CDN 上发布音视频流,需要收取额外的转推带宽费用。

◆ startPublishing()

abstract void startPublishing ( final String  streamId,
final int  streamType 
)
abstract

开始向腾讯云直播 CDN 上发布音视频流

该接口会向 TRTC 服务器发送指令,要求其将当前用户的音视频流旁路到直播 CDN 上。 您可以通过参数 streamId 设定直播流的 StreamId,从而可以指定该用户的音视频流对应在直播 CDN 上的播放地址。 例如:您可以通过该接口将当前用户的直播流 ID 指定为 user_stream_001,那么该用户音视频流对应的 CDN 播放地址为: “http://yourdomain/live/user_stream_001.flv”,其中 yourdomain 为您自己备案的播放域名, 您可以在直播控制台 配置您的播放域名,腾讯云不提供默认的播放域名。 您也可以在设置 enterRoom 的参数 TRTCParams 时指定 streamId, 而且我们更推荐您采用这种方案。

参数
streamId自定义流 ID。
streamType仅支持 TRTCVideoStreamTypeBigTRTCVideoStreamTypeSub
注意
您需要提前在 实时音视频控制台 中的功能配置页面上开启“启用旁路推流”才能生效。
  • 若您选择“指定流旁路”,则您可以通过该接口将对应音视频流推送到腾讯云 CDN 且指定为填写的流 ID。
  • 若您选择“全局自动旁路”,则您可以通过该接口调整默认的流 ID。

◆ startRemoteSubStreamView()

abstract void startRemoteSubStreamView ( String  userId,
TXCloudVideoView  view 
)
abstract

开始显示远端用户的辅路画面

弃用:
v8.0 版本开始不推荐使用,建议使用 startRemoteView:streamType:view 替代之。

◆ startRemoteView() [1/2]

abstract void startRemoteView ( String  userId,
int  streamType,
TXCloudVideoView  view 
)
abstract

订阅远端用户的视频流,并绑定视频渲染控件

调用该接口可以让 SDK 拉取指定 userid 的视频流,并渲染到参数 view 指定的渲染控件上。您可以通过 setRemoteRenderParams 设置画面的显示模式。

  • 如果您已经知道房间中有视频流的用户的 userid,可以直接调用 startRemoteView 订阅该用户的画面。
  • 如果您不知道房间中有哪些用户在发布视频,您可以在 enterRoom 之后等待来自 onUserVideoAvailable 的通知。

调用本接口只是启动视频流的拉取,此时画面还需要加载和缓冲,当缓冲完毕后您会收到来自 onFirstVideoFrame 的通知。

参数
userId指定远端用户的 ID。
streamType指定要观看 userId 的视频流类型:
view用于承载视频画面的渲染控件
注意
注意几点规则需要您关注:
  1. SDK 支持同时观看某 userid 的大画面和辅路画面,或者同时观看某 userid 的小画面和辅路画面,但不支持同时观看大画面和小画面。
  2. 只有当指定的 userid 通过 enableEncSmallVideoStream 开启双路编码后,才能观看该用户的小画面。
  3. 当指定的 userid 的小画面不存在时,SDK 默认切换到该用户的大画面。

◆ startRemoteView() [2/2]

abstract void startRemoteView ( String  userId,
TXCloudVideoView  view 
)
abstract

开始显示远端视频画面

弃用:
v8.0 版本开始不推荐使用,建议使用 startRemoteView:streamType:view 替代之。

◆ startScreenCapture() [1/2]

abstract void startScreenCapture ( int  streamType,
TRTCCloudDef.TRTCVideoEncParam  encParams,
TRTCCloudDef.TRTCScreenShareParams  shareParams 
)
abstract

启动屏幕分享

该接口支持抓取整个 Android 系统的屏幕,可以实现类似腾讯会议的全系统级的屏幕分享。 参考文档:实时屏幕分享(Android) Android 推荐的屏幕分享视频编码参数(TRTCVideoEncParam):

  • 分辨率(videoResolution): 1280 x 720
  • 帧率(videoFps): 10 FPS
  • 码率(videoBitrate): 1200 kbps
  • 分辨率自适应(enableAdjustRes): false
参数
streamType屏幕分享使用的线路,可以设置为主路(TRTCCloudDef#TRTC_VIDEO_STREAM_TYPE_BIG)或者辅路(TRTCCloudDef#TRTC_VIDEO_STREAM_TYPE_SUB)。
encParams编码参数,请参考 TRTCCloudDef#TRTCVideoEncParam。如果您指定 encParams 为 null,SDK 会自动使用之前设定的编码参数。
shareParams请参考 TRTCCloudDef#TRTCScreenShareParams,您可以通过其中的 floatingView 参数弹出悬浮窗(也可以使用 Android 系统的 WindowManager 接口自行弹出)。

◆ startScreenCapture() [2/2]

abstract void startScreenCapture ( TRTCCloudDef.TRTCVideoEncParam  encParams,
TRTCCloudDef.TRTCScreenShareParams  shareParams 
)
abstract

启动屏幕分享(Android)

弃用:
v8.6 版本开始不推荐使用,建议使用 startScreenCapture(streamType, encParams, shareParams) 接口替代之。

◆ startSpeedTest() [1/2]

abstract void startSpeedTest ( int  sdkAppId,
String  userId,
String  userSig 
)
abstract

开始进行网络测速(进入房间前使用)

弃用:
v9.2 版本开始不推荐使用,建议使用 startSpeedTest(params) 接口替代之。

◆ startSpeedTest() [2/2]

abstract int startSpeedTest ( TRTCCloudDef.TRTCSpeedTestParams  params)
abstract

开始进行网速测试(进入房间前使用)

参数
params测速选项
返回
接口调用结果,< 0:失败
注意
  1. 测速过程将产生少量的基础服务费用,详见 计费概述 > 基础服务 文档说明。
  2. 请在进入房间前进行网速测试,在房间中网速测试会影响正常的音视频传输效果,而且由于干扰过多,网速测试结果也不准确。
  3. 同一时间只允许一项网速测试任务运行。

◆ stopAllAudioEffects()

abstract void stopAllAudioEffects ( )
abstract

停止所有音效

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#stopPlayMusic 替代之。

◆ stopAllRemoteView()

abstract void stopAllRemoteView ( )
abstract

停止订阅所有远端用户的视频流,并释放全部渲染资源

调用此接口会让 SDK 停止接收所有来自远端的视频流,并释放全部的解码和渲染资源。

注意
如果当前有正在显示的辅路画面(屏幕分享)也会一并被停止。

◆ stopAudioEffect()

abstract void stopAudioEffect ( int  effectId)
abstract

停止播放音效

弃用:
v7.3 版本开始不推荐使用,建议使用 TXAudioEffectManager#stopPlayMusic 替代之。

◆ stopAudioRecording()

abstract void stopAudioRecording ( )
abstract

停止录音

如果录制任务在退出房间前尚未通过本接口停止,则退出房间后录音任务会自动被停止。

◆ stopBGM()

abstract void stopBGM ( )
abstract

停止播放背景音乐

弃用:
v7.3 版本开始不推荐使用,建议使用 getAudioEffectManager 替代之。

◆ stopLocalAudio()

abstract void stopLocalAudio ( )
abstract

停止本地音频的采集和发布

停止本地音频的采集和发布后,房间中的其他用户会收到 onUserAudioAvailable(userId, false) 的通知。

◆ stopLocalPreview()

abstract void stopLocalPreview ( )
abstract

停止摄像头预览

◆ stopLocalRecording()

abstract void stopLocalRecording ( )
abstract

停止本地媒体录制

如果录制任务在退出房间前尚未通过本接口停止,则退出房间后录音任务会自动被停止。

◆ stopPublishCDNStream()

abstract void stopPublishCDNStream ( )
abstract

停止向非腾讯云 CDN 上发布音视频流

◆ stopPublishing()

abstract void stopPublishing ( )
abstract

停止向腾讯云直播 CDN 上发布音视频流

◆ stopRemoteSubStreamView()

abstract void stopRemoteSubStreamView ( String  userId)
abstract

停止显示远端用户的辅路画面

弃用:
v8.0 版本开始不推荐使用,建议使用 stopRemoteView:streamType: 替代之。

◆ stopRemoteView() [1/2]

abstract void stopRemoteView ( String  userId)
abstract

停止显示远端视频画面,同时不再拉取该远端用户的视频数据流

弃用:
v8.0 版本开始不推荐使用,建议使用 stopRemoteView:streamType: 替代之。

◆ stopRemoteView() [2/2]

abstract void stopRemoteView ( String  userId,
int  streamType 
)
abstract

停止订阅远端用户的视频流,并释放渲染控件

调用此接口会让 SDK 停止接收该用户的视频流,并释放该路视频流的解码和渲染资源。

参数
userId指定远端用户的 ID。
streamType指定要观看 userId 的视频流类型:

◆ stopScreenCapture()

abstract void stopScreenCapture ( )
abstract

停止屏幕分享

◆ stopSpeedTest()

abstract void stopSpeedTest ( )
abstract

停止网络测速

◆ switchCamera()

abstract void switchCamera ( )
abstract

切换摄像头

弃用:
v8.0 版本开始不推荐使用,建议使用 TXDeviceManager 中的 switchCamera 接口替代之。

◆ switchRole()

abstract void switchRole ( int  role)
abstract

切换角色

调用本接口可以实现用户在“主播”和“观众”两种角色之间来回切换。 由于视频直播和语音聊天室需要支持多达10万名观众同时观看,所以设定了“只有主播才能发布自己的音视频”的规则。 因此,当有些观众希望发布自己的音视频流(以便能跟主播互动)时,就需要先把自己的角色切换成“主播”。 您可以在进入房间时通过 TRTCParams 中的 role 字段事先确定用户的角色,也可以在进入房间后通过 switchRole 接口动态切换角色。

参数
role角色,默认为“主播”:
  • TRTCRoleAnchor :主播,可以发布自己的音视频,同一个房间里最多支持50个主播同时发布音视频。
  • TRTCRoleAudience :观众,不能发布自己的音视频流,只能观看房间中其他主播的音视频。如果要发布自己的音视频,需要先通过 switchRole 切换成“主播”,同一个房间内同时最多可以容纳 10 万名观众。
注意
  1. 该接口仅适用于视频直播(TRTCAppSceneLIVE)和语音聊天室(TRTCAppSceneVoiceChatRoom)这两个场景。
  2. 如果您在 enterRoom 时指定的 scene 为 TRTCAppSceneVideoCallTRTCAppSceneAudioCall,请不要调用这个接口。

◆ switchRoom()

abstract void switchRoom ( final TRTCCloudDef.TRTCSwitchRoomConfig  config)
abstract

切换房间

使用该接口可以让用户可以快速从一个房间切换到另一个房间。

  • 如果用户的身份是“观众”,该接口的调用效果等同于 exitRoom(当前房间) + enterRoom(新的房间)。
  • 如果用户的身份是“主播”,该接口在切换房间的同时还会保持自己的音视频发布状态,因此在房间切换过程中,摄像头的预览和声音的采集都不会中断。

该接口适用于在线教育场景中,监课老师在多个房间中进行快速切换的场景。在该场景下使用 switchRoom 可以获得比 exitRoom+enterRoom 更好的流畅性和更少的代码量。 接口调用结果会通过 TRTCCloudDelegate 中的 onSwitchRoom(errCode, errMsg) 回调。

参数
config房间参数,详情请参考 TRTCSwitchRoomConfig
注意
由于对老版本 SDK 兼容的需求,参数 config 中同时包含 roomId 与 strRoomId 两个参数,这两个参数的填写格外讲究,请注意如下事项:
  1. 若您选用 strRoomId,则 roomId 需要填写为0。若两者都填,将优先选用 roomId。
  2. 所有房间需要同时使用 strRoomId 或同时使用 roomId,不可混用,否则将会出现很多预期之外的 bug。

◆ updateLocalView()

abstract void updateLocalView ( TXCloudVideoView  view)
abstract

更新本地摄像头的预览画面

◆ updateRemoteView()

abstract void updateRemoteView ( String  userId,
int  streamType,
TXCloudVideoView  view 
)
abstract

更新远端用户的视频渲染控件

该接口可用于更新远端视频画面的渲染控件,常被用于切换显示区域的交互场景中。

参数
view承载视频画面的控件
streamType要设置预览窗口的流类型(仅支持 TRTCVideoStreamTypeBigTRTCVideoStreamTypeSub
userId指定远端用户的 ID。