RaiseHandAction
@ExperimentalAppActions
public interface RaiseHandAction
The action used to determine if the raise hand action is supported by the calling application and notify the calling application when the user requests to raise or lower their hand.
Summary
Public methods |
|
|---|---|
abstract boolean |
Whether or not raising/lowering hands is supported by the calling application. |
abstract @NonNull CallControlResult |
requestRaisedHandStateChange(boolean isRaised)Request the calling application to raise or lower this user's hand. |
abstract void |
setSupported(boolean isSupported)Whether or not raising/lowering hands is supported by the calling application. |
Public methods
isSupported
abstract boolean isSupported()
Whether or not raising/lowering hands is supported by the calling application.
if true, then updates about raised hands from the calling application will be notified. If false, then the calling application doesn't support this action and state changes will not be notified to the caller and requestRaisedHandStateChange requests will fail.
Must not be queried until CallExtensionScope.onConnected is called or an error will be thrown.
requestRaisedHandStateChange
abstract @NonNull CallControlResult requestRaisedHandStateChange(boolean isRaised)
Request the calling application to raise or lower this user's hand.
Whether or not this user's hand is currently raised is determined by inspecting whether or not this Participant is currently included in the ParticipantExtensionRemote.addRaiseHandAction onRaisedHandsChanged callback List.
Note: A CallControlResult.Success result does not mean that the raised hand state of the user has changed. It only means that the request was received by the remote application and processed. This can be used to gray out UI until the request has processed.
| Parameters | |
|---|---|
boolean isRaised |
|
| Returns | |
|---|---|
@NonNull CallControlResult |
Whether or not the remote application received this event. This does not mean that the operation succeeded, but rather the remote received and processed the event successfully. |
setSupported
abstract void setSupported(boolean isSupported)
Whether or not raising/lowering hands is supported by the calling application.
if true, then updates about raised hands from the calling application will be notified. If false, then the calling application doesn't support this action and state changes will not be notified to the caller and requestRaisedHandStateChange requests will fail.
Must not be queried until CallExtensionScope.onConnected is called or an error will be thrown.