FCSDK Release Notes

YRP1-508, 3-4 Hikari-no-Oka Yokosuka-Shi, Kanagawa, 239-0847, Japan

tel.: + 81-(0) 46-821-3362 | cba-japan.com
This document contains confidential information that is proprietary to CBA. No part of its contents
may be used, disclosed or conveyed to any party, in any manner whatsoever, without prior
written permission from CBA.
© Copyright 2023 Communication Business Avenue.

All rights reserved.

Updated: 2023-07-03

Document version: 3.4.11.3

Microsoft and Windows are either registered trademarks or trademarks of Microsoft Corporation
in the United States and/or other countries.

iOS and iPadOS is a trademark or registered trademark of Cisco in the U.S. and other countries
and is used under license by Apple Inc. Apple is a trademark of Apple Inc.

Chrome is a trademark of Google Inc.

All other trademarks mentioned in this document are the property of their respective owners.

Contact Information

For technical support or other queries, contact CBA Support at:

[email protected]

For our worldwide corporate office address, see:

https://www.cba-japan.com (Japanese) https://www.cba-gbl.com (English)

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 2

Documentation Set
FCSDK Overview Guide

FCSDK Architecture Guide

FCSDK Installation Guide

FCSDK Administration Guide

FCSDK Developer Guide

Related Documentation

Fusion Application Server

FAS Architecture Guide

FAS Installation Guide

FAS Administration Guide

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 3

Contents
Fusion Client SDK
New Features
Important Information for this Release
Suggested Configuration
CBA Components
Third Party Platforms
Web Browser
Limitations in Specific Browsers
Desktop
iOS
Android
Windows
BFCP
Java
Resolved Issues
Known Issues

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 4

Fusion Client SDK
The CBA Fusion Client SDK allows users to develop web applications which can:

Make and receive voice and video calls directly from a Web browser to telephones and
other browsers, without employing web plugins.

Share application events and data

New Features

Release ID Features

CBALA-
3.4.11 Increase media idle timeout during upgrade from 10s to 30s
578

CBALA-
Generate jsdoc for the FCSDK web api
568

CBALA-
Restore lockout feature on FAS login
524

CBALA-
Install CLI plugins in product install directory
519

CBALA-
WebRTC version upgrade FCSDK Windows
195

CBALA- When headset or webcam is plugged in or out, the Audio and

3.4.8.2
489 Video now follows this device selection

CBALA-
3.4.7.1 Updated Log4j to version 2.x
497

CBALA-
Added Flexfec-03 as a banned codec
497

3.4.5 No new feature only bug fixes

CBALA-
3.4.4 GLKit Framework Deprecated on iOS
135

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 5

 CBALA-
3.4.1 Call Quality Indicator not representing correct value
275

CBALA-
No Controller.log and event.log for media broker
294

CBALA-
Android SDK / Torch and Auto-Focus Features
252

CBALA- Add Peer Assserted Identity Headsers (PAI) to SIP messages in

3.4.0
266 FCSDK Core

CBALA- Provide a callback to clients when the SIP side indicates a

258 provisional response

CBALA- FCSDK Android Missing Self View When Open Camera to take
3.3.22
214 picture and come back to app

CBALA- When the client mute the audio and then change the camera, the
170 audio becomes unmuted

CBALA-
3.3.21 FCSDK iOS bitcode support
17

CBALA-
FCSDK Android Picture in Picture support
90

3.3.20.1 No new feature only bug fixes

CBALA-
3.3.20 Support H.264 on phones with MediaTek chipset
33

The sample app has a new checkbox on the login page “Supports
renegotiation”. This is an additional setter method on the SDK. The
CBALA-
3.3.18 customer will need to change their Android app to enable the new
117
functionality. They can either do this for all use cases or make it
conditional on the make/model of phone

CBALA- Added optional delegate method to ACBClientCallDelegate to

3.3.17
22 parse out the SSRC from the SDP

CBALA-
Explicitly close websocket connection on FCSDK JS SDK
50

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 6

 3.3.16 New mobile browser camera switch feature

3.3.12 No new feature only bug fixes

Important Information for this Release

Video quality may drop on calls that last over an hour due to an issue with dynamic
bandwidth values dropping to configured floor value

When sharing content with a TPS, resuming from hold on the browser does not recover the
content stream

When building an iOS application, you may need to add the following libraries:

GLKit.framework

libsqlite3.dylib (or similar)

libc++.dylib (or similar)

The Android SDK only comes with native libraries for the ARM architecture. The application
will run slowly on devices running on x86 architectures.

In current versions of Safari, ringtones and dialtones do not play unless the user selects
Allow All Autoplay for the currently open site.

FCSDK bundles the Jackson libraries. These have been updated to version 2.9.4 to avoid
any risk from the Jackson vulnerability (CVE-2017-7525).

FCSDK does not use the Jackson libraries in the way that allows exploitation of this vulnerability,
so earlier versions of FCSDK are safe, and do not need to be upgraded or patched immediately.

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 7

Suggested Configuration
When configuring the product, we recommend the following changes from the default
configuration in the Web Gateway Admin UI:

Set the Max Resolution Height to 480

Set the Max Resolution Width to 640

Add the following to the Banned Codecs:

G722

iLBC

CN

isac

g7221

MP4A-LATM

See the FCSDK Administration Guide for details on how to make these changes.

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 8

CBA Components
Fusion Client SDK integrates with the following CBA components:

Fusion Application Server 2.6.x or later

Please be aware that future release of Fusion Application Server may be made available
which fix issues in this version. The definitive version to use is the one made available on the
download server alongside this release of Fusion Client SDK.

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 9

Third Party Platforms

Web Browser

You can use Fusion Client SDK to develop applications that take advantage of the latest
browser technologies with no additional client or plug-in. These applications are supported by the
following browsers:

Co-
Browser Version WebRTC Plugin Audio Video
browse

Google 2 latest G.711 VP8

Yes Yes No
Chrome releases Opus H.264

Mozilla 2 latest G.711 VP8

Yes Yes No
Firefox releases Opus H.264

2 latest G.711 VP8

Apple Safari Yes Yes No
releases Opus H.264

Microsoft 2 latest G.711 VP8

Yes Yes No
Edge releases Opus H.264

Chrome for 2 latest G.711 VP8

Yes Yes No
Android releases Opus H.264

2 latest G.711 VP8

Safari for iOS Yes Yes No
releases Opus H.264

Limitations in Specific Browsers

Microsoft Edge on Windows - Chromium is supported; Legacy is not supported.

Opera - Not supported.

Microsoft Internet Explorer – known to work but not supported

Google Chrome, Mozilla Firefox, Microsoft Edge (Chromium) – Please check supported
builds of Windows 10. See https://support.microsoft.com/en-us/help/13853/windows-

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 10

 lifecycle-fact-sheet.

Google Chrome for Android - H.264 codec support for mobile devices are available only
for a limited number of devices.

Desktop

Minimum CPU and memory equivalent to an Intel Core 2 Duo with 2 GB of RAM and 2 MP front
facing camera - Intel Core i3/i5/i7 2nd generation or newer (Sandy Bridge) preferred.

iOS

CPU and memory equivalent to the iPhone 8 or better, as in the following devices:

iPad Pro (12-inch/9-inch)

iPad Air 2, iPad Air

iPad 4th/3rd Generation. iPad 2

iPad mini, iPad mini with Retina display;iPad mini 3, iPad mini 4

iPhone 8, 8 Plus, and above

Users of the iOS sample application on iOS 15 will experience some issues with the UI, however
the application remains fully functional.

Applications developed with Fusion Client SDK are compatible with devices running iOS 12 and
later; iOS versions earlier than v13 are not supported.

Due to hardware restrictions Fusion Client SDK only supports iPhone 8 and above, and iPad 2
and above.

Android

Minimum CPU and memory equivalent to a Samsung Galaxy S4 (1.9 GHz Quad-core
Snapdragon GS4, 4G or Wi-Fi a/b/g/n/ac and 2 MP front facing camera), as in the following
devices:

Samsung Galaxy S4, S5, S6, S7 (or newer)

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 11

 Samsung Galaxy Note 3, 4, 5 (or newer)

Google Nexus 5, 6, 7, 9 and 10 (or newer)

Samsung Galaxy Tab S, Tab 4 (or newer)

Motorola Moto G (or newer)

The minimum version of the Android API that Fusion Client SDK supports is Lollipop v9.0 (API
v28).

H264 codec support is available to following chipset only and Huawei Kirin is not supported.

Qualcom

EXYNOS

MediaTek

SAMSUNG-SGH-I337(Galaxy S4), Google Nexus 7 and Google Nexus 4 don’t support H264
because of its poor H264 support. please use vp8 or vp9 instead.

Windows

The Windows SDK and the .NET SDK target the x86 architecture only; they are compatible with
Windows 10 (32 and 64 bit).

BFCP

Fusion Client SDK supports the following:

Cisco Telepresence Server (TPS) version 4.0.28

Cisco Telepresence Conductor version XC3.0.3

Cisco Virtual Service Control Engine (VSCE) version X8.5.2

Java

Java Packages:

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 12

 Java Package Support Versions

Java SE Development Kit (JDK) Java 8 (1.8.0_60 and later)

Java Runtime Environment (JRE)

OpenJDK

Each hardware platform hosting the Fusion Application Server requires the Oracle Java SE
Development Kit (JDK)or Java Runtime Environment (JRE) or OpenJDK. Ensure that you install
the version of Java with the applicable word size for your operating system.

Unless they are required for a particular reason, it is recommended that you remove any older
versions of Java, and obtain the new installation packages from your chosen deployment-
platform manufacturer.

If you install Java from the platform manufacturer, ensure that the distribution is the standard
JDK/JRE, and is one of the supported versions listed above.

If you must add a later version of the JDK or JRE alongside an existing Java installation, ensure
that all paths to the new Java installation are correctly altered in the startup files; in addition,
ensure that you use an appropriate RPM file.

It is recommended that you do not change the existing paths to the older Java package because
this may adversely affect other platform-resident applications that depend on the earlier version
of Java.

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 13

Resolved Issues
Fixed in version Bug ID Description

CBALA-
4.2.3 iOS: Back camera preview video mirrored
734

CBALA- iOS: Incorrect PreviewView video orientation when device

727 lies flat

CBALA- iOS: Crash in FCSDKiOS v4.2.0 When Making Call to SIP

711 Address

CBALA- iOS: Changing timeout value is always showing 7.00000

4.2.0
643 in the logs

CBALA- Android: CWE-331 Vulnerability patched for third-party

3.5.5
720 library (HybiParser.java)

CBALA-
3.4.11.2 Media Broker installation failure bug fix
624

CBALA- Android only; Live assist android app selecting back

3.4.11.1
517 camera by default LA 1.64.13

CBALA- During QUICK install default idle timeout on MB is not set

3.4.11.1
610 to 30secs

CBALA- Android only; Allow Android app to run a call without

3.4.11.1
592 bluetooth permission

CBALA- Android only; Crash at end of session in Android SDK if

3.4.11
585 no bluetooth

CBALA- Android only; FCSDK Android SDK media persistence

576 through network disconnect/reconnect

CBALA-
Android only; FCSDK Android SDK reconnect issue
551

CBALA- Android only; Javadocs are not being produced for the
567 Android SDK

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 14

 CBALA-
3.4.11 When line or call 2 is ended, line 1 video disappeared
566

CBALA- Web FCSDK Network Loss for Safari. Recover media

561 after network interruption

CBALA- The Audio/Video options now match the experience; after

3.4.8.2
536 muting, putting on hold and releasing hold

Android only FCSDK 3.4.8: Resolved an issue where

CBALA-
3.4.8 there was no ringing sound on the Android app when
482
dialing

CBALA- Resolved an issue where iOS or MacOS Safari as the

3.4.7.1
490 callee were not receiving audio

CBALA-
3.4.7.1 Set preffered audio input re-added to Safari
521

Android only FCSDK 3.4.6: Bluetooth Connect

CBALA-
3.4.6 permissions updated on API 31 (Android 12) (Android/iOS
481
Update only)

3.4.5 CBALA-423: Mixed ObjC / Swift test samples so that we

can potentially migrate to Swift if needed (iOS update
only)

CBALA-455: We’re not using STUN and TURN servers

when creating PeerConnections (iOS update only)

CBALA-418: Add nullability, collection generics and

instancetype markers to the FCSDK ObjC API so that it’s
more more Swift-friendly.(iOS update only)

CBALA-459: Only support Trickle ICE as a discovery

mechanism (Android/iOS Update only)

CBALA-329: FCSDK: Audio Issue on Safari to Chrome

and Edge

CBALA-439: Ensure Javascript SDK passes

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 15

 recommended lint checks

CBALA-396: Video element resizing not working for Safari

CBALA-447: Unable to send topic data from browser after

websocket reconnection
(Android/iOS Update only)

Android CBALA-386: Android sample crash when logging

in

Android CBALA-330 : Inconsistencies between iOS and

Android Call audio/video API and implementation

Android CBALA-389 : Android sample to use

targetSdkVersion 30 or higher

3.4.4 iOS CBALA-399 : Phone, AED and Session text at the

bottom very faint in iOS FCSDK 3.4.3 sample app

CBALA-222 : Behaviour change required when changing

camera when video is muted

CBALA-403 : FCSDK SDK does not have full support for

IE11 browser

CBALA-406 : WebSocket reconnection is failing

CBALA-332 : iOS: Calling [ACBUC stopSession] in the

“call ended” callback fails to send message to backend
s.t.
3.4.3
CBALA-372 : Includes log4j 2.17.1

CBALA-336 : Submitting AED data crashes server

CBALA- CVE-2021-44228,CVE-2021-45046 patch for

3.4.2
356 MediaBroker

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 16

 CBALA-213 : Remove media broker native tarballs for
EL6 and MAC
3.4.0

CBALA-249 : No video from Safari to Jabber using H264

CBALA- iPhone 11 Pro - FCSDK 3.3.21 iOS, one way video issue
3.3.23.1
221 (No video from jabber to iOS)

CBALA-
3.3.23 Security scan vulnerabilities FCSDK(Android)
242

CBALA-
3.3.23 FCSDK Android Custom Audio Device Manager Crash
225

CBALA- FCSDK Call Audio isn’t going back to speaker phone if

3.3.22
125 there’s another call from other Apps (eg: whatsapp)

CBALA-
3.3.22 VP8 and VP9 not included in SDP from iOS client
253

CBALA-
3.3.21 Getting issue if don’t use the UC.setHostNameVerifier
193

CBALA-
3.3.21 Partiallyvideo of the previewView becomes double
192

CBALA-
3.3.21 Android, all calls are failing from web to Android SDK
190

CBALA-
3.3.21 cli.sh is not working on FCSDK-3.3.12
71

CBALA- Partially Black Screen using FCSDK with h.264 codec on

3.3.21
97 Android

CBALA-
3.3.20.1 Android, all calls are failing from web to Android SDK
190

CBALA- NPE thrown by FAS webserver from Tomcat

3.3.20.1
130 MimeHeaders class

CBALA-
3.3.20.1 Xiaomi Mi A1 one way video
188

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 17

 CBALA- iOS crash when call answered in other app when in an
3.3.20
136 FCSDK call

CBALA-
3.3.20 Crash on Nokia 4.2
94

CBALA-
3.3.20 NPE thrown from Tomcat MimeHeaders class
130

CBALA-
3.3.19 Andoid SDK does not support HTTP websocket
134

CBALA-
3.3.19 Android 11 problem switching the camera in call
118

CBALA-
3.3.19 Remove Plan-B support from MB
65

CBALA- On switch camera, mute audio/video function doesn’t

3.3.19
127 work

CBALA- FCSDK 3.3.17 app crashes on Xiaomi Mi A1 when

3.3.18
107 making calls

CBALA- Using Xiaomi Mi A1, call doesn’t connect when it goes

3.3.18
117 through the queue

CBALA-
3.3.17 iOS 13.3+ crashes mainly apps using SWIFT
59

CBALA- The image on the video from agent doesn’t fit the size of
3.3.17
70 the container

CBALA-
3.3.16 FCSDK for Android SDK error handling
14

CBALA-
3.3.16 Call issue on iOS Safari browser
3

CBALA- Self view on mobile/web browsers, self preview is flipped

3.3.16
43 horizontally (not mirroring)

3.3.13 Fix video freezing issue

(Android Update only)

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 18

 Android: Fixed switch camera (Phone.setCamera)
Android SDK: Update targetSdkVersion to 28

Android: Applied patches for WebRTC

Android: Fixed Samsung Note10+ camera issue
3.3.12
Android: Fixed Samsung S20+ crash issue
Android: Fixed Huawei Mate 30 Pro issue

CBALA-
3.3.12 Camera is not released even after call is terminated
2

CBALA-
3.3.12 Safari on iOS freeze
3

CBALA-
3.3.12 Android – SDK Error handling adjustment
14

CBALA-
3.3.12 Chrome 86 unable to make call/ hold/unhold issue
36

CBALA-
3.3.12 NQI not working in FireFox
21

Known Issues
The following known issues are present in this release:

Bug ID Description

When iOS or MacOS Safari is receiving a call whilst they have their video
CBALA-
disabled, there is no audio on the Safari Callee side.
490
(3.4.5
Workaround: Please use 3.4.4 or wait for fixes version if you are using Audio
only)
only call.

iPhone - FCSDK 3.3.21 iOS, one way video (No video from Cisco jabber to
CBALA- iOS)
221
(3.3.21) Workaround: Please upgrade iOS 14.7 or higher. Most of iPhones is OK but
iPhone11 Pro is not working.

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 19

 Set video direction to “Only receive video” for caller, call may fail.
CBALA-
116
Workaround: Please add flexfec-03 codec in banned list (Gateway Media
(3.3.18)
Configuration) to solve this issue.

Unable to reconnect Bluetooth device after leaving and coming back in

9497
Bluetooth connectivity range.

Edge 14 Support Agent/Consumer: call is not getting established.We only

9311
support Edge 15+ — see the Web Browser section

Calling from Chrome with Local Video set to On, media error if camera is not
9209
attached

Calling from Firefox on Mac, to Chrome 57 on Windows - first call succeeds,

9126
subsequent calls may fail

iOS and Android: Console error on call hold. Call from device to browser—
8695
when call is held at browser, cannot resume, and browser crashes.

Invoking hold then resume immediately results in both endpoints being placed
on hold. When two FCSDK clients are in a call, invoking hold() on the UC call
object and then immediately invoking resume() before the hold operation has
completed results in both endpoints being placed on hold, without any way of
resuming the held calls.
8439

Workaround: Do not allow the user to trigger resume() from the UI for a few
seconds (for example, 5 seconds) after they trigger hold(); similarly do not
allow the user to trigger hold() from the UI for a few seconds after they trigger
resume().

Firefox on Mac OSX - Consumer Cannot Make Two Consecutive Calls.

On multiple versions of Firefox, for example, 39, 40, and 43, consumers
cannot make two consecutive calls.
8149

Workaround: Wait for about five minutes before making the second call; or
click the camera button before making the second call.

8069 Safari ‘Plugin Failure’ when number not found, or number busy (call rejected)

7194 iOS Sample Application no longer builds against the iOS 6 SDK

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 20

 Workaround: Conditionally define your own AVAudioSessionModeVideoChat
variable to satisfy the linker.
#if __IPHONE_OS_VERSION_MIN_REQUIRED < __IPHONE_7_0
NSString *const AVAudioSessionModeVideoChat =
@”AVAudioSessionModeVideoChat”;
#endif

Certain video endpoints cannot render 720x1280 video (that is, 720p in portrait
mode, for example from a mobile device).

6700 Workaround: Either ensure the video stream from the mobile device cannot
be rotated into portrait mode or update the Video Resolution Configuration
section of the Media Configuration through the Admin UI or CLI to restrict the
possible dimensions of the image.

If Video Scaling Mode is set to NONE for the first participant dialing into a
TPS, that participant will not see any video.
5961
Workaround: Ensure Scaling Mode is set to STRETCH (the default) when
using FCSDK to dial into a conference

Audio codec offer from iOS causes SDP failure in media broker.
5242
Workaround: Add G722 to the set of banned codecs.

Resume fails if both parties are held in a two party call.

5210
Workaround: Add CN to the set of banned codecs.

5157 Application Event Distribution topic names cannot contain a space.

© 2023 CBA | All Rights Reserved | Unauthorized use prohibited. Page 21