音视频通讯SDK API参考手册  Windows 1.6.0
tencent::av 命名空间参考

struct  AudioFrame
 音频数据帧。 更多...
 
struct  AudioFrameDesc
 音频数据帧格式。 更多...
 
class  AVAccompanyDevice
 伴奏设备。 更多...
 
class  AVAudioCtrl
 音频控制器的封装类。 更多...
 
class  AVAudioDevice
 音频设备封装类的基类。 更多...
 
class  AVCameraDevice
 摄像头的封装类。 更多...
 
class  AVContext
 AVContext对象代表着一个SDK运行实例。 更多...
 
class  AVDevice
 音视频设备封装类的基类。 更多...
 
class  AVDeviceMgr
 设备管理器的封装类。 更多...
 
class  AVDeviceTest
 设备测试的封装类。 更多...
 
class  AVEndpoint
 房间成员的封装类。 更多...
 
class  AVExternalCapture
 外部视频捕获设备。 更多...
 
class  AVLocalScreenVideoDevice
 本地屏幕视频设备的封装类。 更多...
 
class  AVMicDevice
 麦克风的封装类。 更多...
 
class  AVPlayerDevice
 音频播放设备的封装类。 更多...
 
class  AVRemoteAudioDevice
 远端音频设备的封装类。 更多...
 
class  AVRemoteScreenVideoDevice
 远端屏幕视频设备的封装类。 更多...
 
class  AVRemoteVideoDevice
 远端视频设备的封装类。 更多...
 
class  AVRoom
 音视频房间封装类的基类。 更多...
 
class  AVRoomMulti
 多人音视频房间的封装类。 更多...
 
class  AVRoomPair
 多人音视频房间的封装类。 更多...
 
class  AVSupportAudioPreview
 音频预览能力的封装类。 更多...
 
class  AVSupportVideoPreTreatment
 视频预处理能力的封装类。 更多...
 
class  AVSupportVideoPreview
 视频预览能力的封装类。 更多...
 
class  AVVideoCtrl
 视频控制器的封装类。 更多...
 
class  AVVideoDevice
 视频设备封装类的基类。 更多...
 
struct  CameraInfo
 摄像头信息。 更多...
 
struct  DetectedDeviceInfo
 硬件检测信息。 更多...
 
struct  VideoFrame
 视频帧。 更多...
 
struct  VideoFrameDesc
 视频帧描述。 更多...
 
struct  View
 视频画面参数。 更多...
 

类型定义

typedef void(* AVClosure) (void *custom_data)
 参数类型为void*的通用回调函数。 更多...
 
typedef struct tencent::av::View View
 视频画面参数。 更多...
 

枚举

enum  AudioCodecType { AUDIO_CODEC_TYPE_SILK = 4102, AUDIO_CODEC_TYPE_CELT = 4103 }
 音频编解码类型。 更多...
 
enum  RelationType {
  RELATION_TYPE_UNKNOWN = 0, RELATION_TYPE_GROUP = 1, RELATION_TYPE_DISCUSS = 2, RELATION_TYPE_BUDDY = 3,
  RELATION_TYPE_TEMP = 4, RELATION_TYPE_OPENSDK = 6
}
 关系类型。 更多...
 
enum  AudioSrcType { AUDIO_SRC_TYPE_NONE = 0 }
 音频源类型。 更多...
 
enum  ColorFormat { COLOR_FORMAT_NONE = -1, COLOR_FORMAT_I420 = 0, COLOR_FORMAT_RGB24 = 8 }
 色彩格式。 更多...
 
enum  VideoSrcType { VIDEO_SRC_TYPE_NONE = 0, VIDEO_SRC_TYPE_CAMERA = 1, VIDEO_SRC_TYPE_SCREEN = 2 }
 视频源类型。 更多...
 
enum  ViewSizeType { VIEW_SIZE_TYPE_SMALL = 0, VIEW_SIZE_TYPE_BIG = 1 }
 画面大小。 更多...
 
enum  NetStateType {
  NETTYPE_E_NONE = 0, NETTYPE_E_LINE = 1, NETTYPE_E_WIFI = 2, NETTYPE_E_3G = 3,
  NETTYPE_E_2G = 4, NETTYPE_E_4G = 5
}
 网络连接类型。 更多...
 
enum  DetectedDeviceType { Detect_Speaker = 0, Detect_Mic }
 硬件检测类型。 更多...
 
enum  Error {
  AV_OK = 0, AV_ERR_FAILED = 1, AV_ERR_REPEATED_OPERATION = 1001, AV_ERR_EXCLUSIVE_OPERATION = 1002,
  AV_ERR_HAS_IN_THE_STATE = 1003, AV_ERR_INVALID_ARGUMENT = 1004, AV_ERR_TIMEOUT = 1005, AV_ERR_NOT_IMPLEMENTED = 1006,
  AV_ERR_NOT_IN_MAIN_THREAD = 1007, AV_ERR_RESOURCE_IS_OCCUPIED = 1008, AV_ERR_CONTEXT_NOT_EXIST = 1101, AV_ERR_CONTEXT_NOT_STOPPED = 1102,
  AV_ERR_ROOM_NOT_EXIST = 1201, AV_ERR_ROOM_NOT_EXITED = 1202, AV_ERR_DEVICE_NOT_EXIST = 1301, AV_ERR_ENDPOINT_NOT_EXIST = 1401,
  AV_ERR_ENDPOINT_HAS_NOT_VIDEO = 1402, AV_ERR_TINYID_TO_OPENID_FAILED = 1501, AV_ERR_OPENID_TO_TINYID_FAILED = 1502, AV_ERR_DEVICE_TEST_NOT_EXIST = 1601,
  AV_ERR_DEVICE_TEST_NOT_STOPPED = 1602, AV_ERR_INVITE_FAILED = 1801, AV_ERR_ACCEPT_FAILED = 1802, AV_ERR_REFUSE_FAILED = 1803,
  AV_ERR_SERVER_FAILED = 10001, AV_ERR_SERVER_INVALID_ARGUMENT = 10002, AV_ERR_SERVER_NO_PERMISSION = 10003, AV_ERR_SERVER_TIMEOUT = 10004,
  AV_ERR_SERVER_ALLOC_RESOURCE_FAILED = 10005, AV_ERR_SERVER_ID_NOT_IN_ROOM = 10006, AV_ERR_SERVER_NOT_IMPLEMENT = 10007, AV_ERR_SERVER_REPEATED_OPERATION = 10008,
  AV_ERR_SERVER_ROOM_NOT_EXIST = 10009, AV_ERR_SERVER_ENDPOINT_NOT_EXIST = 10010, AV_ERR_SERVER_INVALID_ABILITY = 10011
}
 常见错误码集合。 更多...
 
enum  VideoCodecType { VIDEO_CODEC_TYPE_H264 = 5 }
 视频编码器类型。 更多...
 

类说明

struct tencent::av::CameraInfo

摄像头信息。

类成员
string device_id 摄像头设备id
uint32 fps 采集帧率
uint32 height 采集画面高度
uint32 width 采集画面宽度
struct tencent::av::DetectedDeviceInfo

硬件检测信息。

类成员
DetectedDeviceType flow 硬件检测类型
bool isNewDevice true: 新启用设备,false: 拔出或禁用设备。
bool isUsedDevice 仅对拔出设备时有效,代表拔出的是使用中的设备。
string strGuid 设备GUID。
string strName 设备名称。

类型定义说明

typedef void(* tencent::av::AVClosure) (void *custom_data)

此函数是和异步操作一起使用的回调函数,用来异步返回执行结果。

参数
custom_data值等于调用异步操作时的入参custom_data。

视频画面参数。

枚举类型说明

音频编解码类型。

枚举值
AUDIO_CODEC_TYPE_SILK 

SILK。

AUDIO_CODEC_TYPE_CELT 

CELT。

音频源类型,预留。

枚举值
AUDIO_SRC_TYPE_NONE 

默认值,无意义。

色彩格式。

枚举值
COLOR_FORMAT_NONE 

无意义

COLOR_FORMAT_I420 

i420格式

COLOR_FORMAT_RGB24 

rgb24格式

硬件检测类型。

枚举值
Detect_Speaker 

检测到扬声器

Detect_Mic 

检测到麦克风

常见错误码集合。

枚举值
AV_OK 

成功

AV_ERR_FAILED 

一般错误。

AV_ERR_REPEATED_OPERATION 

重复操作。已经在进行某种操作,再次去做同样的操作,则返回这个错误。

AV_ERR_EXCLUSIVE_OPERATION 

互斥操作。已经在进行某种操作,再次去做同类型的其他操作,则返回这个错误。

AV_ERR_HAS_IN_THE_STATE 

已经处于所要状态,无需再操作。如设备已经打开,再次去打开,就返回这个错误码。

AV_ERR_INVALID_ARGUMENT 

错误参数。

AV_ERR_TIMEOUT 

操作超时。

AV_ERR_NOT_IMPLEMENTED 

功能未实现。

AV_ERR_NOT_IN_MAIN_THREAD 

不在主线程中执行操作。

AV_ERR_RESOURCE_IS_OCCUPIED 

资源被占用。

AV_ERR_CONTEXT_NOT_EXIST 

AVContext不存在。

AV_ERR_CONTEXT_NOT_STOPPED 

AVContext未结束。

AV_ERR_ROOM_NOT_EXIST 

房间不存在。

AV_ERR_ROOM_NOT_EXITED 

房间未退出。

AV_ERR_DEVICE_NOT_EXIST 

设备不存在。

AV_ERR_ENDPOINT_NOT_EXIST 

房间成员不存在。

AV_ERR_ENDPOINT_HAS_NOT_VIDEO 

该成员没有上视频。

AV_ERR_TINYID_TO_OPENID_FAILED 

tiny id转换至identifier失败。

AV_ERR_OPENID_TO_TINYID_FAILED 

identifier转换至tiny id失败。

AV_ERR_DEVICE_TEST_NOT_EXIST 

AVDeviceTest不存在。

AV_ERR_DEVICE_TEST_NOT_STOPPED 

AVDeviceTest未结束。

AV_ERR_INVITE_FAILED 

发送邀请失败。

AV_ERR_ACCEPT_FAILED 

接受邀请失败。

AV_ERR_REFUSE_FAILED 

拒绝邀请失败。

AV_ERR_SERVER_FAILED 

服务器内部错误

AV_ERR_SERVER_INVALID_ARGUMENT 

服务器内部错误

AV_ERR_SERVER_NO_PERMISSION 

服务器内部错误

AV_ERR_SERVER_TIMEOUT 

服务器内部错误

AV_ERR_SERVER_ALLOC_RESOURCE_FAILED 

服务器内部错误

AV_ERR_SERVER_ID_NOT_IN_ROOM 

服务器内部错误

AV_ERR_SERVER_NOT_IMPLEMENT 

服务器内部错误

AV_ERR_SERVER_REPEATED_OPERATION 

服务器内部错误

AV_ERR_SERVER_ROOM_NOT_EXIST 

服务器内部错误

AV_ERR_SERVER_ENDPOINT_NOT_EXIST 

服务器内部错误

AV_ERR_SERVER_INVALID_ABILITY 

服务器内部错误

网络连接类型。

枚举值
NETTYPE_E_NONE 

无连接.

NETTYPE_E_LINE 

LINE.

NETTYPE_E_WIFI 

WIFI.

NETTYPE_E_3G 

3G

NETTYPE_E_2G 

2G

NETTYPE_E_4G 

4G

关系类型。腾讯开放给第三方开发者使用的这套音视频通信SDK,与腾讯QQ使用的是同一套的协议和架构。 以此枚举类型的定义为例,1~4的枚举值是腾讯QQ专用的,6的枚举值是第三方App专用的。

枚举值
RELATION_TYPE_UNKNOWN 

默认值,无意义。

RELATION_TYPE_GROUP 

QQ群。

RELATION_TYPE_DISCUSS 

QQ讨论组。

RELATION_TYPE_BUDDY 

QQ好友。

RELATION_TYPE_TEMP 

QQ临时会话。

RELATION_TYPE_OPENSDK 

音视频开放SDK,第三方App专用。

视频编码器类型。

枚举值
VIDEO_CODEC_TYPE_H264 

视频源类型。

枚举值
VIDEO_SRC_TYPE_NONE 

默认值,无意义。

VIDEO_SRC_TYPE_CAMERA 

摄像头。

VIDEO_SRC_TYPE_SCREEN 

屏幕。

画面大小, 这里仅代表从服务器接收的画面最大分辨率,实际运行过程中受视频上行方约束。

枚举值
VIEW_SIZE_TYPE_SMALL 

小画面,分辨率包含192x144、160x120。

VIEW_SIZE_TYPE_BIG 

大画面,分辨率包含320x240、480x360、640x480、800x600、720P、1080P。