Jabber Guest Android SDK
 All Classes Namespaces Functions Variables Enumerator Pages
com.cisco.jabber.guest.CallBarView Class Reference

A view that represents controls that can alter the functionality of an active call. More...

Inherits LinearLayout, and OnClickListener.

Public Member Functions

void setButtons (int buttons)
 Set the buttons that are shown by this CallBarView. More...
 
boolean isKeypadOpen ()
 Checks the CallBarView to determine if there is an active KeypadView visible in the application during an active call. More...
 

Detailed Description

A view that represents controls that can alter the functionality of an active call.

Available buttons include:

  • Muting / Unmuting (Local) Audio
  • Stopping / Starting (Local) Video
  • Displaying a keypad to enter DTMF digits
  • Ending the current active call

By default, all four of these buttons will be included in this CallBarView, but this can be customized when including this class in an XML layout using the jabberguest:jgsdk_buttons attribute. Acceptable values are:

  • audio
  • video
  • keypad
  • hook
  • all (default)

The jabberguest:jgsdk_buttons attribute can also take multiple values. For example, to provide functionality for an audio-only call where the stopping / starting local video button is not included you could do something similar to the following:

<com.cisco.jabber.guest.CallBarView
android:id="@+id/jgsdk_control_bar_view"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
android:layout_alignParentBottom="true"
android:layout_centerHorizontal="true"
android:layout_marginBottom="10dp"
jabberguest:jgsdk_buttons="audio|keypad|hook" />

This CallBarView also implements default functionality such that if there is no detected touch events on the screen of the Android device, the CallBarView will initiate an alpha animation to disappear (and will re-appear with the next detected touch on the screen during the active call). By default, this animation will wait for up to 3000 milliseconds before starting this alpha animation to cause the CallBarView to disappear from the screen. This animation can either be customized to use a different delay interval, or be disabled entirely. See the method documentation below for more information.

Member Function Documentation

boolean com.cisco.jabber.guest.CallBarView.isKeypadOpen ( )
inline

Checks the CallBarView to determine if there is an active KeypadView visible in the application during an active call.

Returns
True if there is a KeypadView visible, false otherwise
void com.cisco.jabber.guest.CallBarView.setButtons ( int  buttons)
inline

Set the buttons that are shown by this CallBarView.

By default, all buttons are shown.

Buttons:

  • BUTTON_AUDIO: audio mute button
  • BUTTON_VIDEO: video mute button
  • BUTTON_KEYPAD: keypad toggle button
  • BUTTON_HOOK: end call button
  • BUTTON_ALL: include all buttons

Or the desired button values together. For example, to include only the audio mute and end call buttons:

CallBarView controlBar = new CallBarView(context);
controlBar.setButtons(CallBarView.BUTTON_AUDIO | CallBarView.BUTTON_HOOK);
Parameters
buttonsButtons to show in this CallBarView.