publication.h

[詳解]

//
// © NTT DOCOMO BUSINESS, Inc. All Rights Reserved.
//
 
#pragma once
 
#ifdef __cplusplus
extern "C"
{
#endif
 
#include <stddef.h>
#include <stdint.h>
 
#include "member.h"
 

#define SKW_ROOM_PUBLICATION_ID_SIZE (36+1)

#define SKW_ROOM_PUBLICATION_METADATA_SIZE (1024+1)

typedef enum {
    SKW_ROOM_PUBLICATION_OK                          = 0,   
    SKW_ROOM_PUBLICATION_ERR_NULL_ARGS               = 1,   
    SKW_ROOM_PUBLICATION_ERR_INVALID_ARGS            = 2,   
    SKW_ROOM_PUBLICATION_ERR_CONTEXT_NOT_INITED      = 3,   
    SKW_ROOM_PUBLICATION_ERR_CONTEXT_NOT_SETUP       = 4,   
    SKW_ROOM_PUBLICATION_ERR_REQUEST_FAILED          = 5,   
    SKW_ROOM_PUBLICATION_ERR_MUTEX_UNLOCK_FAILED     = 6,   
    SKW_ROOM_PUBLICATION_ERR_CALLED_IN_HANDLER       = 7,   
    SKW_ROOM_PUBLICATION_ERR_SEND_FAILED             = 8,   
    SKW_ROOM_PUBLICATION_ERR_TIMEOUT                 = 9,   
    SKW_ROOM_PUBLICATION_ERR_CONNECTION_CLOSED       = 10,  
    SKW_ROOM_PUBLICATION_ERR_RESPONSE_TOO_LARGE      = 11,  
    SKW_ROOM_PUBLICATION_ERR_RESPONSE_PARSE_FAILED   = 12,  
    SKW_ROOM_PUBLICATION_ERR_NOT_JOINED              = 13,  
    SKW_ROOM_PUBLICATION_ERR_CONTENT_TYPE_MISMATCH   = 14,  
    SKW_ROOM_PUBLICATION_ERR_NOT_PUBLISHED           = 15,  
    SKW_ROOM_PUBLICATION_ERR_UNKNOWN                 = 99,  
    SKW_ROOM_PUBLICATION_ERR_BAD_REQUEST             = 400, 
    SKW_ROOM_PUBLICATION_ERR_UNAUTHORIZED            = 401, 
    SKW_ROOM_PUBLICATION_ERR_FORBIDDEN               = 403, 
    SKW_ROOM_PUBLICATION_ERR_NOT_FOUND               = 404, 
    SKW_ROOM_PUBLICATION_ERR_ALREADY_EXIST           = 409, 
    SKW_ROOM_PUBLICATION_ERR_TOO_LARGE               = 413, 
    SKW_ROOM_PUBLICATION_ERR_TOO_MANY_REQUESTS       = 429, 
    SKW_ROOM_PUBLICATION_ERR_SERVER_INTERNAL         = 500, 
    SKW_ROOM_PUBLICATION_ERR_SERVER_BUSY             = 503, 
} skw_room_publication_err_t;

typedef enum {
    SKW_ROOM_PUBLICATION_TYPE_P2P = 0, 
    SKW_ROOM_PUBLICATION_TYPE_SFU = 1, 
} skw_room_publication_type_t;

typedef enum {
    SKW_ROOM_PUBLICATION_CONTENT_TYPE_VIDEO = 0, 
    SKW_ROOM_PUBLICATION_CONTENT_TYPE_AUDIO = 1, 
    SKW_ROOM_PUBLICATION_CONTENT_TYPE_DATA  = 2, 
} skw_room_publication_content_type_t;

typedef char skw_room_publication_id_t[SKW_ROOM_PUBLICATION_ID_SIZE];
typedef char skw_room_publication_metadata_t[SKW_ROOM_PUBLICATION_METADATA_SIZE];

typedef struct {
    skw_room_publication_id_t           *id;           
    skw_room_publication_type_t         *type;         
    skw_room_publication_content_type_t *content_type; 
    skw_room_publication_metadata_t     *metadata;     
    skw_room_member_id_t                *publisher_id; 
} skw_room_publication_data_field_t;

typedef struct {
    const char* room_id;        
    const char* publication_id; 
    const char* metadata;       
} skw_room_publication_update_metadata_params_t;

#define SKW_ROOM_PUBLICATION_UPDATE_METADATA_PARAMS_INIT(...) {__VA_ARGS__}

typedef struct {
    const char* publication_id; 
    const uint8_t* data;        
    size_t length;              
} skw_room_publication_send_data_params_t;

#define SKW_ROOM_PUBLICATION_SEND_DATA_PARAMS_INIT(...) {__VA_ARGS__}

typedef struct {
    const char* publication_id; 
    const uint8_t* data;        
    size_t length;              
    uint32_t pts;               
} skw_room_publication_send_frame_params_t;

#define SKW_ROOM_PUBLICATION_SEND_FRAME_PARAMS_INIT(...) {__VA_ARGS__}

typedef void (*skw_room_publication_on_keyframe_request_t)(const char* publication_id);

typedef struct {
    skw_room_publication_on_keyframe_request_t on_keyframe_request; 
} skw_room_publication_handlers_t;

skw_room_publication_err_t skw_room_publication_register_handlers(const skw_room_publication_handlers_t* handlers);

skw_room_publication_err_t skw_room_publication_unregister_handlers(void);

skw_room_publication_err_t skw_room_publication_update_metadata(const skw_room_publication_update_metadata_params_t* params);

skw_room_publication_err_t skw_room_publication_send_data(const skw_room_publication_send_data_params_t* params);

skw_room_publication_err_t skw_room_publication_send_video_frame(const skw_room_publication_send_frame_params_t* params);

skw_room_publication_err_t skw_room_publication_send_audio_frame(const skw_room_publication_send_frame_params_t* params);
 
#ifdef __cplusplus
}
#endif