vx_evt_subscription
Reference the Vivox Core SDK API.
Read time 2 minutesLast updated 7 months ago
Generated when a buddy wants to request presence visibility. More...
#include <VxcEvents.h>Public Attributes
Name | |
|---|---|
| vx_evt_base_t | base The common properties for all events. |
| VX_HANDLE | account_handle The handle returned from a successful login request. |
| char * | buddy_uri The URI of the buddy whose presence is being sent. |
| char * | subscription_handle The identifier of the subscription event. |
| vx_subscription_type | subscription_type subscription_presence is currently the only supported value. |
| char * | displayname The displayname, if the buddy_uri had a displayname. |
| char * | application The application of the buddy whose subscription is being reported. |
| char * | message NOT CURRENTLY IMPLEMENTED An optional message supplied by the initiating user on vx_req_account_buddy_set_t. |
Detailed Description
struct vx_evt_subscription;
Generated when a buddy wants to request presence visibility.
This event is not presented if an auto-accept or auto-block rule matches the requesting buddy_uri. Typically, the application uses this event to prompt a user to explicitly accept or deny the request for presence. Optionally, the application might create and store an auto-accept or auto-block rule based on the user's selection. The application should generate a vx_req_account_send_subscription_reply_t request based on application logic and/or end-user response. The subscription_handle value must be extracted and returned as a parameter to vx_req_account_send_subscription_reply_t.
Public Attributes Documentation
variable base
vx_evt_base_t base;
The common properties for all events.
variable account_handle
VX_HANDLE account_handle;
The handle returned from a successful login request.
variable buddy_uri
char * buddy_uri;
The URI of the buddy whose presence is being sent.
variable subscription_handle
char * subscription_handle;
The identifier of the subscription event.
Used when forming a reply with vx_req_account_send_subscription_reply_t.
variable subscription_type
vx_subscription_type subscription_type;
subscription_presence is currently the only supported value.
variable displayname
char * displayname;
The displayname, if the buddy_uri had a displayname.
variable application
char * application;
The application of the buddy whose subscription is being reported.
This can be NULL or empty.
variable message
char * message;
NOT CURRENTLY IMPLEMENTED An optional message supplied by the initiating user on vx_req_account_buddy_set_t.