jrtc.h

浏览该文件的文档.

#ifndef __JRTC_H__
#define __JRTC_H__
#ifdef __cplusplus
extern "C" {
#endif
#define JRTC_VERSION   "4.0.0"
 
enum jrtc_error
{
    JRTC_ENIL   = 0,  
    JRTC_EPERM  = 1,  
    JRTC_ENONET = 64, 
    JRTC_EPROTO = 71, 
    JRTC_EMSGSIZE = 90,   
    JRTC_ECONNRESET=104,  
    JRTC_ETIMEDOUT =101,  
    JRTC_ECONNREFUSED=111,
    JRTC_EOFFLINE = 128, 
    JRTC_EDECLINE = 129, 
    JRTC_EINVOKETIMEOUT = 130,   
    JRTC_ECALLSERVERERROR = 131, 
    JRTC_EROOMNOTFND = 132,  
    JRTC_ECALLTIMEOUT = 133, 
    JRTC_ENOTREG = 134, 
    JRTC_ELOGIN = 135,  
    JRTC_ETOKEN_NOTFOUND = 136, 
    JRTC_ETOKEN_INV = 137,    
    JRTC_ETOKEN_EXPIRE = 138, 
    JRTC_ECODECINVALID = 139, 
    JRTC_EAUDIOCALL = 252, 
    JRTC_EAUDIO=253,  
    JRTC_EVIDEO=254,  
    JRTC_EBYE = 255,  
};
 
enum jrtc_dtype
{
    JRTC_I420 = 0, 
    JRTC_NV12 = 1, 
    JRTC_UYVY = 2, 
    JRTC_JPEG = 3, 
    JRTC_NV16 = 4, 
    JRTC_RGB565 = 64,
 
    JRTC_H264 = 96,
    JRTC_H263 = 97,
};
 
struct jrtc_photo_t
{
    void* data;     
    unsigned bytes; 
    unsigned short width;  
    unsigned short height; 
    char format; 
    char reserve[3]; 
};
struct jrtc_image_t
{/* 可强转为 jrtc_photo_t 使用 */
    void* data;      
    unsigned bytes;  
    unsigned short width;  
    unsigned short height; 
    char format;
    char fps;   
    char reserve[2]; 
    unsigned short kbps;   
    volatile char put; 
    volatile char get; 
};
struct jrtc_t;
 
struct jrtc_slice_t
{
    unsigned    offset:16; 
    unsigned    length:16; 
    unsigned    reserve:16;
};
 
#define JRTC_ROLE_SENDER    0x2
#define JRTC_ROLE_PLAYER    0x4
#define JRTC_ROLE_OWNER     0x8
/* 保留低8位, 高位允许按位扩展自定义角色 */
 
#define JRTC_STATUS_FORWARD_VIDEO    0x1
#define JRTC_STATUS_FORWARD_AUDIO    0x2
#define JRTC_STATUS_VIDEO   0x4
#define JRTC_STATUS_AUDIO   0x8
#define JRTC_STATUS_MEDIA   (JRTC_STATUS_AUDIO|JRTC_STATUS_VIDEO)
#define JRTC_SENDING_AUDIO  (JRTC_STATUS_AUDIO|JRTC_STATUS_FORWARD_AUDIO)
#define JRTC_SENDING_VIDEO  (JRTC_STATUS_VIDEO|JRTC_STATUS_FORWARD_VIDEO)
/* 保留低8位,高位允许按位扩展自定义状态 */
 
struct jrtc_handler_t
{
    int (*on_user_joined) (struct jrtc_t* jc, char uid[64], unsigned role, unsigned status);
 
    int (*on_user_changed) (struct jrtc_t* jc, char uid[64], int index, unsigned role, unsigned status);
 
    void (*on_user_offline) (struct jrtc_t* jc, char uid[64], int index, enum jrtc_error reason);
 
    void (*on_user_message) (struct jrtc_t* jc, char uid[64], int index, struct jrtc_slice_t msg[], unsigned num);
 
    void (*on_video_changed) (struct jrtc_t* jc, char vid[64], int index);
 
    void (*on_share_changed) (struct jrtc_t* jc, char uid[64], int index);
 
    void (*on_audio_volume) (struct jrtc_t* jc, unsigned num, unsigned char index_volume[][2]);
 
    void (*on_user_netstate) (struct jrtc_t* jc, unsigned num, unsigned char index_netstate[][2]);
};
void jrtc_config (const char appKey[24], const char license[64],
    const char aesKey[16], const char tokens[128],  const struct jrtc_handler_t *handler);
 
struct jrtc_options_t
{
    unsigned role;
    unsigned status;
    const char* vid;
};
 
struct jrtc_t* jrtc_open (const char channelId[64], const char uid[64],
    struct jrtc_image_t* video, struct jrtc_image_t* camera, struct jrtc_options_t* options);
 
void jrtc_close (struct jrtc_t* jc, enum jrtc_error err);
 
enum jrtc_error jrtc_error  (const struct jrtc_t *jc);
 
enum jrtc_state
{
    JRTC_CLOSED=0,
    JRTC_LEAVING, 
    JRTC_OPENED,  
    JRTC_JOINING, 
    JRTC_JOINED,  
    JRTC_TALKING, 
};
 
enum jrtc_state jrtc_state (const struct jrtc_t *jc);
 
enum jrtc_state jrtc_leave(struct jrtc_t* jc, enum jrtc_error err);
 
void jrtc_set_video(struct jrtc_t* jc, const char vid[64], int index);
 
void jrtc_set_status (struct jrtc_t* jc, const char uid[64], unsigned mask, unsigned status);
 
void jrtc_set_role (struct jrtc_t* jc, const char uid[64], unsigned mask, unsigned role);
 
void jrtc_set_index(struct jrtc_t*jc, const char uid[64], int index);
 
enum jrtc_batch
{
    JRTC_AUDIO_VOLUME  = 1, 
    JRTC_USER_NETSTATE = 2, 
};
void jrtc_request_batch(struct jrtc_t* jc, int types);
#define jrtc_request_volume(jc)   jrtc_request_batch(jc, JRTC_AUDIO_VOLUME)
#define jrtc_request_netstate(jc) jrtc_request_batch(jc, JRTC_USER_NETSTATE)
 
void* jrtc_set_ptr (struct jrtc_t* jc, void* ptr);
void* jrtc_get_ptr (struct jrtc_t* jc);
 
void jrtc_set_camera (struct jrtc_t* jc, int camera,
    void (*effect) (struct jrtc_photo_t* frame));
 
extern unsigned _jrtc_net_id;
extern unsigned _jrtc_cam_angle;
extern void* _jrtc_net_info;
 
enum jrtc_device
{
    JRTC_SPEAKER    = 1,
    JRTC_MICROPHONE = 2,
    JRTC_CAMERA     = 4,
    JRTC_AUDIO      = 3,
};
void jrtc_activate (struct jrtc_t* jc, int devices);
 
void jrtc_deactivate (struct jrtc_t* jc, int devices);
 
#ifdef __cplusplus
}
#endif
#endif