tencent cloud

/*
*   Callback Registration Function
*   context Context pointer, this pointer will be returned during the callback
*   callback Registered TRRO_OnOperationPermissionState Callback Function
*/

extern "C" TRRO_EXPORT void TRRO_registerOnOperationPermissionState(void* context, TRRO_OnOperationPermissionState* callback);


/*
* #name :   TRRO_OnOperationPermissionState
* @brief :  Callback for permissions state notification
* @input :  context             Callback context pointer, returned when the registration callback function is invoked
*           field_devid         the field device ID
*           self_permission     The current permissions type of this remote device, refer to TrroPermission, 0 is guest, only view permission, 1 is master, has full operation permission
*           master_devid        Remote device ID with master permissions
* @return : void
*/
typedef void STD_CALL TRRO_OnOperationPermissionState(void* context, const char* field_devid, int self_permission, const char* master_devid);

/*
* @name : TRRO_requestPermission
* @brief : Send permission request to the field device, the field device will respond with TRRO_OnOperationPermissionState to update permissions
* @input : gwid          Target field device ID
*          permisson     Refer to the structure TrroPermission
* @return : successful 1; failed <= 0
*/
extern "C" TRRO_EXPORT int TRRO_requestPermission(const char* gwid, int permisson);

/**
* @name  TRRO_registerOperationPermissionRequest
* @brief Register callback for remote device control permission request notification
* @param[in]   context              //Application context
* @param[in]   callback             Callback function
* @return 1 for success, other failed
*/
extern "C" TRRO_EXPORT int TRRO_registerOperationPermissionRequest(void *context, TRRO_onOperationPermissionRequest *callback);


/**
* @name TRRO_onOperationPermissionRequest
* @brief Notification of remote device control permission request
* @param[in]     remote_devid         Remote device ID requesting permission
* @param[in]     permission           Requested permission, refer to TrroPermission, 0: guest (view only), 1: master (full control)
* @return void 
*/
typedef void TRRO_onOperationPermissionRequest(void* context, const char* remote_devid, int permission);


/**
 * @name  TRRO_setOperationPermission
 * @brief Sets the control permission for remote devices. Currently, only one remote device can have master permission at a time. If a remote device already has master permission, calling this interface to set master permission will automatically revoke the master permission from the previous device and set it for the new device;
 * @param[in]  remote_devid         Remote device ID to set permissions
 * @param[in]  permission           Refer to TrroPermission, 0: guest (view only), 1: master (full control)
 * @return 1 for success, other failed
 */
extern "C" TRRO_EXPORT int TRRO_setOperationPermission(const char* remote_devid, int permission);