PJSIP_SEND_SESSION_REFRESH()¶

Synopsis¶

W/O: Initiate a session refresh via an UPDATE or re-INVITE on an established media session

Description¶

This function will cause the PJSIP stack to immediately refresh the media session for the channel. This will be done using either a re-INVITE (default) or an UPDATE request.

This is most useful when combined with the PJSIP_MEDIA_OFFER dialplan function, as it allows the formats in use on a channel to be re-negotiated after call setup.

Warning

The formats the endpoint supports are not checked or enforced by this function. Using this function to offer formats not supported by the endpoint may result in a loss of media.

Example: Re-negotiate format to g722

; Within some existing extension on an answered channel
same => n,Set(PJSIP_MEDIA_OFFER(audio)=!all,g722)
same => n,Set(PJSIP_SEND_SESSION_REFRESH()=invite)

Syntax¶

PJSIP_SEND_SESSION_REFRESH([update_type])

Arguments¶

update_type - The type of update to send. Default is 'invite'.
- invite - Send the session refresh as a re-INVITE.
- update - Send the session refresh as an UPDATE.

Generated Version¶

This documentation was generated from Asterisk branch 22 using version GIT