The Jabber Guest SDK for iOS uses H.264 AVC video, which requires activation of a license agreement by each user. When your application calls either startCall: or startSelfView:, or uses CJGuestViewController or CJGuestCallSelfView, the user will be prompted to activate the video license with a UIAlertView. From the UIAlertView, the license can be activated, viewed, or the user can choose to cancel the activation.
No local or remote video will be rendered until the user chooses to activate the video license.
startCall: and startSelfView: both take a completion block which will be executed once the user dismisses the UIAlertView by either choosing to activate the license or choosing to cancel the activation. The isActivated argument will be set to TRUE if the license was activated, and FALSE if the activation was cancelled. For example:
[activeCall startCall: ^(BOOL isActivated) {
if ( isActivated )
; // call started
else
; // user chose not to activate video license, call did not start
} ];
Example using Swift
call.startCall { (isActivated:Bool) -> Void in
if(isActivated) {
} else {
}
}
Once the user activates the video license, they will not be prompted to do so again for subsequent calls. If the app is uninstalled and reinstalled, the video license will need to be reactivated.
If your company has it’s own license agreement for H.264 AVC video from MPEG LA, and you wish to disable the display of the video license UIAlertView, place the following code in your app before calls are made:
[[CJGuestVideoLicense sharedInstance] disableActivation];
See the Jabber Guest SDK for iOS sample apps for examples of where to place this call. If this call is made to disable activation, then you can pass in a nil block to startCall: and startSelfView:, since the user will not be prompted to activate the license. For example:
[activeCall startCall: nil];
If you disable the built-in activation capability of the Jabber SDK for iOS, you do so at your own risk and are responsible for any royalties or other fees associated with your use of the H.264 AVC video codec.