AccountChannelRequest.audio_call

Description:

[ CCode ( has_construct_function = false ) ]
[ Version ( since = "0.19.0" ) ]
public AccountChannelRequest.audio_call (Account account, int64 user_action_time)

Convenience function to create a new AccountChannelRequest object which will yield a Call channel, initially carrying audio only.

After creating the request, you will usually also need to set the "target" of the channel by calling one of the following functions:

- set_target_contact - set_target_id

To call a contact, either use set_target_contact or one of the generic methods that takes a handle type argument. To check whether this is possible, use supports_audio_call with handle_type set to CONTACT.

In some protocols, it is possible to create a Call channel without setting a target at all, which will result in a new, empty conference call. To test whether this is possible, use supports_audio_call with handle_type set to NONE.

Parameters:

account	a Account
user_action_time	the time of the user action that caused this request, or one of the special values USER_ACTION_TIME_NOT_USER_ACTION or `TP_USER_ACTION_TIME_CURRENT_TIME` (see user_action_time)

Returns:

a new AccountChannelRequest object