Mountain View
Jabber SDK API Documentation

Tutorial: Handle Conversation Capabilities And States

Handle Conversation Capabilities And States

Title In this chapter it will be covered both Telephony Conversation Capabilities and TelephonyConversationStates. They are very important because they can tell, what we can and what can't be done with TelephonyConversation, as well as whats going on with active conversations.

Capabilities

Telephony Conversation Capabilities can tell what we can and can't be done with TelephonyConversation. It is recommended that they are bound to UI elements (Usually buttons}. These elements should be disabled if specific capability is set to false or enabled if capability is set to true. This is crucial because performing action like conversation.end() without capabilities.canEndCall set to true will throw a CapabilityMissing error. In the snippet below it will be shown how to retrieve capabilities.

         var conversation;

         // ...
         // Retrieve conversation object from conversation event.
         // ...

         var conversationState = conversation.states;
    
We'll cover specific capabilities in upcoming tutorials.

States

Telephony Conversation State can tell, if conversation is put on hold or not, or if screen share is being received from remote participant. In the snippet below is shown how to retrieve conversation states.

        var conversation;

        // ...
        // Retrieve conversation object from conversation event.
        // ...

        var conversationState = conversation.states;
    
Specific states will be covered in upcoming tutorials.

Next

Previous