关键类型定义

最近更新时间:2019-08-08 16:20:44

TRTCParams

功能

进房相关参数。

介绍

只有该参数填写正确,才能顺利调用 enterRoom 进入 roomId 所指定的音视频房间。

属性列表

属性 类型 是否必填 字段含义 推荐取值
sdkAppId UInt32 应用标识,腾讯云基于 sdkAppId 完成计费统计。 实时音视频控制台 创建应用后可在帐号信息页面中得到该 ID。
userId NSString * 用户标识。当前用户的 userId,相当于登录用户名。 如果一个用户在您的帐号系统中的 ID 为“abc”,则 userId 即可设置为“abc”。
userSig NSString * 用户签名,当前 userId 对应的验证签名,相当于登录密码。 具体计算方法请参见 如何计算UserSig
roomId UInt32 房间号码,在同一个房间内的用户可以看到彼此并进行视频通话。 您可以自定义设置该参数值,但不可重复。如果您的用户帐号 ID (userId)为数字类型,可直接使用创建者的用户 ID 作为 roomId。
role TRTCRoleType 直播场景下的角色,仅适用于直播场景(TRTCAppSceneLIVE),视频通话场景下指定无效。 默认值:主播(TRTCRoleAnchor)。
privateMapKey NSString * 房间签名,当您希望某个房间只能让特定的 userId 进入时,需要使用 privateMapKey 进行权限保护。 仅建议有高级别安全需求的客户使用,更多详情请参见 进房权限保护
businessInfo NSString * 业务数据,部分高级特性才需要使用该字段。 不建议使用。

TRTCVideoEncParam

功能

视频编码参数。

介绍

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

属性列表

属性 类型 字段含义 推荐取值 特别说明
videoResolution TRTCVideoResolution 视频分辨率。
  • 视频通话建议选择360 × 640及以下分辨率,resMode 选择 Portrait。
  • 手机直播建议选择 540 × 960,resMode 选择 Portrait。
  • Window 和 iMac 建议选择 640 × 360 及以上分辨率,resMode 选择 Landscape。
  • TRTCVideoResolution 默认只有横屏模式的分辨率,例如640 × 360。如需使用竖屏分辨率,请指定 resMode 为 Portrait,例如640 × 360结合 Portrait 则为360 × 640。
    resMode TRTCVideoResolutionMode 分辨率模式(横屏分辨率 - 竖屏分辨率)。 手机直播建议选择 Portrait,Window 和 iMac 建议选择 Landscape。 如果 videoResolution 指定分辨率 640 × 360,resMode 指定模式为 Portrait,则最终编码出的分辨率为360 × 640。
    videoFps uint 视频采集帧率。 15fps或20fps。
  • 5fps以下,卡顿感明显。
  • 10fps以下,会有轻微卡顿感。
  • 20fps以上,则过于浪费(电影的帧率为24fps)。
  • 很多 Android 手机的前置摄像头并不支持15fps以上的采集帧率,部分过于突出美颜功能的 Android 手机前置摄像头的采集帧率可能低于10fps。
    videoBitrate uint 视频上行码率。 推荐设置请参考 TRTCVideoResolution 定义处的注释说明。 码率太低会导致视频中出现大量马赛克。

    TRTCNetworkQosParam

    功能

    网络流控相关参数。

    介绍

    网络流控相关参数,该设置决定 SDK 在各种网络环境下的调控方向(例如弱网下选择“保清晰”或“保流畅”)。

    属性列表

    属性 类型 字段含义 推荐取值 特别说明
    preference TRTCVideoQosPreference 弱网下选择“保清晰”或“保流畅”。 -
  • 弱网下保流畅:在遭遇弱网环境时,画面会变得模糊,且出现较多马赛克,但可以保持流畅不卡顿。
  • 弱网下保清晰:在遭遇弱网环境时,画面会尽可能保持清晰,但可能容易出现卡顿。
  • controlMode TRTCQosControlMode 视频分辨率(云端控制 - 客户端控制)。 云端控制。
  • Server 模式(默认):云端控制模式,若无特殊原因,请直接使用该模式。
  • Client 模式:客户端控制模式,用于 SDK 开发内部调试,客户请勿使用。
  • TRTCQualityInfo

    功能

    视频质量。

    介绍

    表示视频质量的好坏,通过这个数值,您可以在 UI 界面上用图标表征 userId 的通话线路质量。

    属性列表

    属性 类型 字段含义
    userId NSString * 用户 ID。
    quality TRTCQuality 视频质量。

    TRTCVolumeInfo

    功能

    音量大小。

    介绍

    表示语音音量的评估大小,通过这个数值,您可以在 UI 界面上用图标表征 userId 是否有在说话。

    属性列表

    属性 类型 字段含义
    userId NSString * 说话者的 userId, nil 为自己。
    volume NSUInteger 说话者的音量, 取值范围0 - 100。

    TRTCMediaDeviceInfo

    功能

    媒体设备描述。

    介绍

    在 Mac 上,每一种类型的设备都可能有多个,TRTC SDK 的 Mac 版本提供了一系列函数用来操作这些设备。

    属性列表

    属性 类型 字段含义
    type TRTCMediaDeviceType 设备类型。
    deviceId NSString * 设备ID。
    deviceName NSString * 设备名称。

    TRTCScreenCaptureSourceInfo

    功能

    屏幕分享目标信息(仅 Mac)。

    介绍

    如果您要给您的 App 增加屏幕分享功能,一般需要先显示一个窗口选择界面,用户才可以选择希望分享的窗口。 TRTCScreenCaptureSourceInfo 主要用于定义分享窗口的 ID、类型、窗口名称以及缩略图。

    属性列表

    属性 类型 字段含义
    type TRTCScreenCaptureSourceType 分享类型:需要某个窗口或整个屏幕。
    sourceId NSString * 窗口ID。
    sourceName NSString * 窗口名称。
    extInfo NSDictionary * 窗口属性。
    thumbnail NSImage * 窗口缩略图。
    icon NSImage * 窗口小图标。

    TRTCSpeedTestResult

    功能

    网络测速结果。

    介绍

    您可以在用户进入房间前通过 TRTCCloud 的 startSpeedTest 接口进行测速 (注意:请不要在通话中调用), 测速结果会每2 - 3秒钟返回一次,每次返回一个 IP 地址的测试结果。

    属性列表

    属性 类型 字段含义
    ip NSString * 服务器 IP 地址。
    quality TRTCQuality 网络质量,内部通过评估算法测算出的网络质量,loss 越低,rtt 越小,得分便越高。
    upLostRate float 上行丢包率,范围是0 - 1.0,例如,0.3表示每向服务器发送10个数据包可能会在中途丢失3个。
    downLostRate float 下行丢包率,范围是0 - 1.0,例如,0.2表示每从服务器收取10个数据包可能会在中途丢失2个。
    rtt uint32_t 延迟(毫秒),指 SDK 到腾讯云服务器的一次网络往返时间,该值越小越好,正常数值范围是10ms - 100ms。

    TRTCVideoFrame

    功能

    视频帧信息。

    介绍

    TRTCVideoFrame 用来描述一帧视频画面的裸数据,它可以是一帧编码前的画面,也可以是一帧解码后的画面。

    属性列表

    属性 类型 字段含义 推荐取值
    pixelFormat TRTCVideoPixelFormat 视频像素格式。 TRTCVideoPixelFormat_NV12
    bufferType TRTCVideoBufferType 视频数据结构类型。 TRTCVideoBufferType_PixelBuffer
    pixelBuffer CVPixelBufferRef bufferType 为 TRTCVideoBufferType_PixelBuffer 时的视频数据。 -
    data NSData * bufferType 为 TRTCVideoBufferType_NSData 时的视频数据。 -
    timestamp uint64_t 视频帧的时间戳,单位毫秒。 自定义视频采集时可以设置为0。若该参数为0,SDK 会自定填充 timestamp 字段,但请“均匀”地控制 sendCustomVideoData 的调用间隔。
    width uint32_t 视频宽度。 自定义视频采集时不需要填写。
    height uint32_t 视频高度。 自定义视频采集时不需要填写。
    rotation TRTCVideoRotation 视频像素的顺时针旋转角度。 -

    TRTCAudioFrame

    功能

    音频帧数据。

    介绍

    音频帧数据。

    属性列表

    属性 类型 字段含义
    data NSData * 音频数据。
    sampleRate TRTCAudioSampleRate 采样率。
    channels int 声道数。
    timestamp uint64_t 时间戳,单位ms。

    TRTCMixUser

    功能

    云端混流中每一路子画面的位置信息。

    介绍

    TRTCMixUser 用于指定每一路(即每一个 userId)视频画面的具体摆放位置。

    属性列表

    属性 类型 字段含义
    userId NSString * 参与混流的 userId。
    roomID NSString * 混流的房间, 可填 nil 表示是自己所在的房间。
    rect CGRect 图层位置坐标以及大小,左上角为坐标原点(0,0) (绝对像素值)。
    zOrder int 图层层次(1 - 15)不可重复。
    streamType TRTCVideoStreamType 参与混合的是主路画面(TRTCVideoStreamTypeBig)或屏幕分享(TRTCVideoStreamTypeSub)画面。
    pureAudio BOOL 是否是纯音频模式。

    TRTCTranscodingConfig

    功能

    云端混流(转码)配置。

    介绍

    包括最终编码质量和各路画面的摆放位置。

    属性列表

    属性 类型 字段含义 推荐取值
    mode TRTCTranscodingConfigMode 转码config模式。 -
    appId int 腾讯云直播 AppID。 请在 实时音视频控制台 选择已经创建的应用,单击【帐号信息】,在“直播信息”中获取。
    bizId int 腾讯云直播 bizid。 请在 实时音视频控制台 选择已经创建的应用,单击【帐号信息】,在“直播信息”中获取。
    videoWidth int 最终转码后的视频分辨率的宽度(px)。 -
    videoHeight int 最终转码后的视频分辨率的高度(px)。 -
    videoBitrate int 最终转码后的视频分辨率的码率(kbps)。 -
    videoFramerate int 最终转码后的视频分辨率的帧率(FPS)。 15
    videoGOP int 最终转码后的视频分辨率的关键帧间隔(又称为 GOP),单位为秒。 3
    audioSampleRate int 最终转码后的音频采样率。 48000
    audioBitrate int 最终转码后的音频码率,单位为K。 64
    audioChannels int 最终转码后的音频声道数。 2
    mixUsers NSArray< TRTCMixUser * > * 每一路子画面的位置信息。 -

    TRTCPublishCDNParam

    功能

    CDN 旁路推流参数。

    属性列表

    属性 类型 字段含义
    appId int 腾讯云 AppID,请在 实时音视频控制台 选择已经创建的应用,单击【帐号信息】,在“直播信息”中获取。
    bizId int 腾讯云直播 bizid,请在 实时音视频控制台 选择已经创建的应用,单击【帐号信息】,在“直播信息”中获取。
    url NSString * 旁路转推的 URL。

    TRTCAudioRecordingParams

    功能

    录音参数。

    介绍

    请正确填写参数,确保录音文件顺利生成。

    属性列表

    属性 类型 字段含义 特别说明
    filePath NSString * 文件路径(必填),录音文件的保存路径。该路径需要用户自行指定,请确保路径存在且可写。 该路径需精确到文件名及格式后缀,格式后缀决定录制文件的格式,例如:指定路径为path/to/audio.aac,则会生成一个 AAC 格式的文件。目前支持的格式有 PCM、WAV 和 AAC。

    TRTCLocalStatistics

    功能

    自己本地的音视频统计信息。

    属性列表

    属性 类型 字段含义
    width uint32_t 视频宽度。
    height uint32_t 视频高度。
    frameRate uint32_t 帧率(fps)。
    videoBitrate uint32_t 视频发送码率(Kbps)。
    audioSampleRate uint32_t 音频采样率(Hz)。
    audioBitrate uint32_t 音频发送码率(Kbps)。
    streamType TRTCVideoStreamType 流类型(主画面 &#124、小画面 &#124或辅路画面)。

    TRTCRemoteStatistics

    功能

    远端成员的音视频统计信息。

    属性列表

    属性 类型 字段含义
    userId NSString * 用户 ID,指定是哪个用户的视频流。
    finalLoss uint32_t 该线路的总丢包率(%)。
    该值越小越好,例如,丢包率为0表示网络很好。丢包率是该线路的 userId 从上行到服务器再到下行的总丢包率。如果 downLoss 为 0%,但是 finalLoss 不为0,说明该 userId 上行时出现了无法恢复的丢包。
    width uint32_t 视频宽度。
    height uint32_t 视频高度。
    frameRate uint32_t 接收帧率(fps)。
    videoBitrate uint32_t 视频码率(Kbps)。
    audioSampleRate uint32_t 音频采样率(Hz)。
    audioBitrate uint32_t 音频码率(Kbps)。
    streamType TRTCVideoStreamType 流类型(主画面 &#124、小画面 &#124或辅路画面)。

    TRTCStatistics

    功能

    统计数据。

    属性列表

    属性 类型 字段含义
    upLoss uint32_t C -> S 上行丢包率(%),该值越小越好,例如,丢包率为0表示网络很好, 丢包率为30%则意味着 SDK 向服务器发送的数据包中会有30%丢失在上行传输中。
    downLoss uint32_t S -> C 下行丢包率(%),该值越小越好,例如,丢包率为0表示网络很好,丢包率为30%则意味着 SDK 向服务器发送的数据包中会有30%丢失在下行传输中。
    appCpu uint32_t 当前 App 的 CPU 使用率(%)。
    systemCpu uint32_t 当前系统的 CPU 使用率(%)。
    rtt uint32_t 延迟(毫秒),指 SDK 到腾讯云服务器的一次网络往返时间,该小越好。一般低于50ms的 rtt 相对理想,而高于100ms的 rtt 会引入较大的通话延时。由于数据上下行共享一条网络连接,所以 local 和 remote 的 rtt 相同。
    receivedBytes uint64_t 总接收字节数(包含信令及音视频)。
    sentBytes uint64_t 总发送字节数(包含信令及音视频)。
    localStatistics NSArray< TRTCLocalStatistics * > * 自己本地的音视频统计信息,可能有大画面、小画面以及辅路画面等多路的情况,因此是一个数组。
    remoteStatistics NSArray< TRTCRemoteStatistics * > * 远端成员的音视频统计信息,可能有大画面、小画面以及辅路画面等多路的情况,因此是一个数组。

    TRTCVideoResolution

    功能

    视频分辨率。

    介绍

    此处仅定义横屏分辨率,如需使用竖屏分辨率(例如360 × 640),需要同时指定 TRTCVideoResolutionMode 为 Portrait。

    枚举 含义
    TRTCVideoResolution_120_120 [C] 建议码率80kbps。
    TRTCVideoResolution_160_160 [C] 建议码率100kbps。
    TRTCVideoResolution_270_270 [C] 建议码率200kbps。
    TRTCVideoResolution_480_480 [C] 建议码率350kbps。
    TRTCVideoResolution_160_120 [C] 建议码率100kbps。
    TRTCVideoResolution_240_180 [C] 建议码率150kbps。
    TRTCVideoResolution_280_210 [C] 建议码率200kbps。
    TRTCVideoResolution_320_240 [C] 建议码率250kbps。
    TRTCVideoResolution_400_300 [C] 建议码率300kbps。
    TRTCVideoResolution_480_360 [C] 建议码率400kbps。
    TRTCVideoResolution_640_480 [C] 建议码率600kbps。
    TRTCVideoResolution_960_720 [C] 建议码率1000kbps。
    TRTCVideoResolution_160_90 [C] 建议码率100kbps。
    TRTCVideoResolution_256_144 [C] 建议码率150kbps。
    TRTCVideoResolution_320_180 [C] 建议码率250kbps。
    TRTCVideoResolution_480_270 [C] 建议码率350kbps。
    TRTCVideoResolution_640_360 [C] 建议码率550kbps。
    TRTCVideoResolution_960_540 [C] 建议码率850kbps。
    TRTCVideoResolution_1280_720 [C] 摄像头采集 - 建议码率1200kbps [S] 屏幕分享 - 建议码率:低清:400kbps 高清:600kbps。
    TRTCVideoResolution_1920_1080 [S] 屏幕分享 - 建议码率800kbps。

    TRTCVideoResolutionMode

    功能

    视频宽高比模式。

    介绍

    • 横屏分辨率:TRTCVideoResolution_640_360 + TRTCVideoResolutionModeLandscape = 640 × 360
    • 竖屏分辨率:TRTCVideoResolution_640_360 + TRTCVideoResolutionModePortrait = 360 × 640。
    枚举 含义
    TRTCVideoResolutionModeLandscape 横屏分辨率。
    TRTCVideoResolutionModePortrait 竖屏分辨率。

    TRTCVideoStreamType

    功能

    视频流类型。

    介绍

    TRTC 内部有三种不同的音视频流,分别是:

    • 主画面:最常用的一条线路,一般用来传输摄像头的视频数据。
    • 小画面:跟主画面的内容相同,但是分辨率和码率更低。
    • 辅流画面:一般用于屏幕分享,以及远程播片(例如老师放一段视频给学生)。

    说明:

    • 如果主播的上行网络和性能比较好,则可以同时送出大小两路画面。
    • SDK 不支持单独开启小画面,小画面必须依附于主画面而存在。
    枚举 含义
    TRTCVideoStreamTypeBig 主画面视频流。
    TRTCVideoStreamTypeSmall 小画面视频流。
    TRTCVideoStreamTypeSub 辅流(屏幕分享)。

    TRTCQuality

    功能

    画质级别。

    介绍

    TRTC SDK 对画质定义了六种不同的级别,Excellent 表示最好,Down 表示不可用。

    枚举 含义
    TRTCQuality_Unknown 未定义。
    TRTCQuality_Excellent 最好。
    TRTCQuality_Good 好。
    TRTCQuality_Poor 一般。
    TRTCQuality_Bad 差。
    TRTCQuality_Vbad 很差。
    TRTCQuality_Down 不可用。

    TRTCVideoFillMode

    功能

    视频画面填充模式。

    介绍

    如果画面的显示分辨率不等于画面的原始分辨率,就需要您设置画面的填充模式:

    • TRTCVideoFillMode_Fill,图像铺满屏幕,超出显示视窗的视频部分将被裁剪,画面显示可能不完整。
    • TRTCVideoFillMode_Fit,图像长边填满屏幕,短边区域会被填充黑色,画面的内容完整。
    枚举 含义
    TRTCVideoFillMode_Fill 图像铺满屏幕,超出显示视窗的视频部分将被裁剪。
    TRTCVideoFillMode_Fit 图像长边填满屏幕,短边区域会被填充黑色。

    TRTCVideoRotation

    功能

    视频画面旋转方向。

    介绍

    TRTC SDK 提供了对本地和远程画面的旋转角度设置 API,下列旋转角度都是指顺时针方向的。

    枚举 含义
    TRTCVideoRotation_0 不旋转。
    TRTCVideoRotation_90 顺时针旋转90度。
    TRTCVideoRotation_180 顺时针旋转180度。
    TRTCVideoRotation_270 顺时针旋转270度。

    TRTCBeautyStyle

    功能

    美颜(磨皮)算法。

    介绍

    TRTC SDK 内置多种不同的磨皮算法,您可以选择最适合您产品定位的方案。

    枚举 含义
    TRTCBeautyStyleSmooth 光滑,适用于美女秀场,效果比较明显。
    TRTCBeautyStyleNature 自然,磨皮算法更多地保留了面部细节,主观感受上会更加自然。

    TRTCVideoPixelFormat

    功能

    视频像素格式。

    介绍

    TRTC SDK 提供针对视频的自定义采集和自定义渲染功能,在自定义采集功能中,您可以用下列枚举值描述您采集的视频像素格式。 在自定义渲染功能中,您可以指定您期望 SDK 回调的视频像素格式。

    枚举 含义
    TRTCVideoPixelFormat_Unknown 未知。
    TRTCVideoPixelFormat_I420 YUV420P I420
    TRTCVideoPixelFormat_NV12 YUV420SP NV12
    TRTCVideoPixelFormat_32BGRA BGRA8888

    TRTCVideoBufferType

    功能

    视频数据包装格式。

    介绍

    在自定义采集和自定义渲染功能,您需要用到下列枚举值来指定您希望以什么类型的容器来包装视频数据。

    • PixelBuffer:直接使用效率最高,iOS 系统提供众多 API 获取或处理 PixelBuffer。
    • NSData:仅用于自定义渲染,SDK 帮您做了一次 PixelBuffer 到 NSData 的内存拷贝工作,会有一定的性能损耗。
    枚举 含义
    TRTCVideoBufferType_Unknown 未知。
    TRTCVideoBufferType_PixelBuffer 直接使用效率最高,iOS 系统提供众多 API 获取或处理 PixelBuffer。
    TRTCVideoBufferType_NSData 仅用于自定义渲染,SDK 帮您做了一次 PixelBuffer 到 NSData 的内存拷贝工作,会有一定的性能损耗。

    TRTCLocalVideoMirrorType

    功能

    本地视频预览镜像类型。

    介绍

    iOS 的本地画面提供下列设置模式。

    枚举 含义
    TRTCLocalVideoMirrorType_Auto 前置摄像头镜像,后置摄像头不镜像。
    TRTCLocalVideoMirrorType_Enable 前后置摄像头画面均镜像。
    TRTCLocalVideoMirrorType_Disable 前后置摄像头画面均不镜像。

    TRTCAppScene

    功能

    应用场景。

    介绍

    TRTC 可用于视频会议和在线直播等多种应用场景,针对不同的应用场景,TRTC SDK 的内部会进行不同的优化配置:

    • VideoCall:视频通话场景,即绝大多数时间都是两人或两人以上视频通话的场景,例如1v1在线课程辅导,1vN (N < 8) 视频会议或者小班课堂等。
    • LIVE:在线直播场景,即绝大多数时间都是一人直播,偶尔有多人视频互动的场景,例如美女秀场连麦等场景。
    枚举 含义
    TRTCAppSceneVideoCall 视频通话场景,内部编码器和网络协议优化侧重流畅性,降低通话延迟和卡顿率。
    TRTCAppSceneLIVE 在线直播场景,内部编码器和网络协议优化侧重性能和兼容性,性能和清晰度表现更佳。

    TRTCRoleType

    功能

    角色,仅适用于直播场景(TRTCAppSceneLIVE)。

    介绍

    在直播场景中,多数用户仅为观众,个别用户为主播,这种角色区分有利于 TRTC 进行更好的定向优化。

    • Anchor:主播,可以上行视频和音频,一个房间里的主播人数不能超过 50 人。
    • Audience:观众,只能观看,不能上行视频和音频,一个房间里的观众人数没有上限。
    枚举 含义
    TRTCRoleAnchor 主播。
    TRTCRoleAudience 观众。

    TRTCQosControlMode

    功能

    流控模式。

    介绍

    TRTC SDK 内部需要时刻根据网络情况调整内部的编解码器和网络模块,以便能够对网络的变化做出反应。 为了支持快速算法升级,SDK 内部设置了两种不同的流控模式:

    • ModeServer:云端控制,默认模式,推荐选择。
    • ModeClient:本地控制,用于 SDK 开发内部调试,客户请勿使用。

    说明:

    推荐您使用云端控制,当升级 Qos 算法时,您无需升级 SDK 即可体验更好的效果。

    枚举 含义
    TRTCQosControlModeClient 客户端控制(用于 SDK 开发内部调试,客户请勿使用)。
    TRTCQosControlModeServer 云端控制 (默认)。

    TRTCVideoQosPreference

    功能

    画质偏好。

    介绍

    指当 TRTC SDK 在遇到弱网络环境时,您期望“保清晰”或“保流畅”:

    • Smooth:弱网下保流畅。即在遭遇弱网环境时首先确保声音的流畅和优先发送,画面会变得模糊且会有较多马赛克,但可以保持流畅不卡顿。
    • Clear:弱网下保清晰。即在遭遇弱网环境时,画面会尽可能保持清晰,但可能会更容易出现卡顿。
    枚举 含义
    TRTCVideoQosPreferenceSmooth 弱网下保流畅。
    TRTCVideoQosPreferenceClear 弱网下保清晰。

    TRTCAudioSampleRate

    功能

    音频采样率。

    介绍

    音频采样率用来衡量声音的保真程度,采样率越高保真程度越好,如果您的应用场景有音乐的存在,推荐使用 TRTCAudioSampleRate48000。

    枚举 含义
    TRTCAudioSampleRate16000 16k采样率。
    TRTCAudioSampleRate32000 32采样率。
    TRTCAudioSampleRate44100 44.1k采样率。
    TRTCAudioSampleRate48000 48k采样率。

    TRTCAudioRoute

    功能

    声音播放模式(音频路由)。

    介绍
    微信和手机 QQ 视频通话功能的免提模式就是基于音频路由实现的。 一般手机都有两个扬声器,一个是位于顶部的听筒扬声器,声音偏小;一个是位于底部的立体声扬声器,声音偏大。设置音频路由的作用就是决定声音使用哪个扬声器播放。

    • Speakerphone:扬声器,位于手机底部,声音偏大,适合外放音乐。
    • Earpiece:听筒,位于手机顶部,声音偏小,适合通话。
    枚举 含义
    TRTCAudioModeSpeakerphone 扬声器。
    TRTCAudioModeEarpiece 听筒。

    TRTCReverbType

    功能

    声音混响模式。

    介绍

    该枚举值应用于直播场景中的混响模式,主要用于秀场直播中。

    枚举 含义
    TRTCReverbType_0 关闭混响。
    TRTCReverbType_1 KTV
    TRTCReverbType_2 小房间。
    TRTCReverbType_3 大会堂。
    TRTCReverbType_4 低沉。
    TRTCReverbType_5 洪亮。
    TRTCReverbType_6 金属声。
    TRTCReverbType_7 磁性。

    TRTCVoiceChangerType

    功能

    变声模式。

    介绍

    该枚举值应用于直播场景中的变声模式,主要用于秀场直播中。

    枚举 含义
    TRTCVoiceChangerType_0 关闭变声。
    TRTCVoiceChangerType_1 熊孩子。
    TRTCVoiceChangerType_2 萝莉。
    TRTCVoiceChangerType_3 大叔。
    TRTCVoiceChangerType_4 重金属。
    TRTCVoiceChangerType_5 感冒。
    TRTCVoiceChangerType_6 外国人。
    TRTCVoiceChangerType_7 困兽。
    TRTCVoiceChangerType_8 死肥仔。
    TRTCVoiceChangerType_9 强电流。
    TRTCVoiceChangerType_10 重机械。
    TRTCVoiceChangerType_11 空灵。

    TRTCLogLevel

    功能

    Log 级别。

    介绍

    不同的日志等级定义了不同的详实程度和日志数量,推荐一般情况下将日志等级设置为:TRTCLogLevelInfo。

    枚举 含义
    TRTCLogLevelNone 不输出任何 SDK Log。
    TRTCLogLevelVerbose 输出所有级别的 Log。
    TRTCLogLevelDebug 输出 DEBUG,INFO,WARNING,ERROR 和 FATAL 级别的 Log。
    TRTCLogLevelInfo 输出 INFO,WARNNING,ERROR 和 FATAL 级别的 Log。
    TRTCLogLevelWarn 只输出WARNNING,ERROR 和 FATAL 级别的 Log。
    TRTCLogLevelError 只输出ERROR 和 FATAL 级别的 Log。
    TRTCLogLevelFatal 只输出 FATAL 级别的 Log。

    TRTCGSensorMode

    功能

    重力感应开关。

    介绍

    此配置仅适用于 iOS 和 iPad 等移动设备,并且需要配合您当前 UI 的布局模式一起使用:

    • Disable:表示视频画面不会跟随重力感应方向而调整。
    • UIAutoLayout:表示SDK 不会自动调整 LocalVideoView 的旋转方向,而是交给系统进行处理。适用于您的 App 界面已适配重力感应的场景。
    • UIFixLayout:表示SDK 自动调整 LocalVideoView 的旋转方向。适用于您的 App 界面暂未适配重力感应的场景。
    枚举 含义
    TRTCGSensorMode_Disable 关闭重力感应。
    TRTCGSensorMode_UIAutoLayout 开启重力感应,需要您的 App 界面已适配重力感应。
    TRTCGSensorMode_UIFixLayout 开启重力感应,适用于您的 App 界面暂未适配重力感应的场景。

    TRTCMediaDeviceType

    功能

    设备类型(仅 Mac)。

    介绍

    在 Mac 上,每一种类型的设备都可能有多个,TRTC SDK 的 Mac 版本提供了一系列函数用来操作这些设备。

    枚举 含义
    TRTCMediaDeviceTypeUnknown 未定义。
    TRTCMediaDeviceTypeAudioInput 麦克风。
    TRTCMediaDeviceTypeAudioOutput 扬声器或听筒。
    TRTCMediaDeviceTypeVideoCamera 摄像头。
    TRTCMediaDeviceTypeVideoWindow 某个窗口(用于屏幕分享)。
    TRTCMediaDeviceTypeVideoScreen 整个屏幕(用于屏幕分享)。

    TRTCScreenCaptureSourceType

    功能

    屏幕分享目标类型(仅 Mac)。

    介绍

    该枚举值主要用于 SDK 区分屏幕分享的目标(某一个窗口或整个屏幕)。

    枚举 含义
    TRTCScreenCaptureSourceTypeUnknown 未定义。
    TRTCScreenCaptureSourceTypeWindow 该分享目标是某一个Mac窗口。
    TRTCScreenCaptureSourceTypeScreen 该分享目标是整个Mac桌面。

    TRTCTranscodingConfigMode

    功能

    混流参数配置模式。

    介绍

    目前暂仅支持手动配置这一种模式,即需要指定 TRTCTranscodingConfig 的全部参数。

    枚举 含义
    TRTCTranscodingConfigMode_Unknown 未定义。
    TRTCTranscodingConfigMode_Manual 手动配置混流参数。