0% found this document useful (0 votes)

32 views

FCSDK Plugins Release Notes

Uploaded by

ShareFile Pro

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

0% found this document useful (0 votes)

32 views

FCSDK Plugins Release Notes

Uploaded by

ShareFile Pro

We take content rights seriously. If you suspect this is your content, claim it here.

Available Formats

Download as PDF, TXT or read online on Scribd

You are on page 1/ 15

FCSDK Plugins 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 CBA.

All rights reserved.

Updated: 2022-06-29

Document version: 3.4.8

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

IOS 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

Contents
Fusion Client SDK Plugins
New Features
Important Information for this Release
CBA Components
Third-party Platforms
Web Browser
Consumer
Installation
Internet Explorer
Versioning
Log Files
IT Policy
Uninstallation
Installation as an MSI file
Safari
Self-signed Certificates
Browser Plugin Management
Browser Plug-in Version Information
Sample Applications
Resolved Issues
Known Issues

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

Fusion Client SDK Plugins
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

The Fusion Client SDK plug-ins allow FCSDK applications such as the Web sample application
to run on browsers that do not support WebRTC:

Internet Explorer

Safari

Please refer to the Fusion Client SDK Documentation for further information.

New Features

Release Features

3.3.0 (No new features in this release - bug fixes only)

3.2.0 (No new features in this release - bug fixes only)

3.1.0 (No new features in this release - bug fixes only)

3.0.6 (No new features in this release - bug fixes only)

3.0.5 (No new features in this release - bug fixes only)

3.0.4 (No new features in this release - bug fixes only)

3.0.3 (No new features in this release - bug fixes only)

3.0.2 (No new features in this release - bug fixes only)

3.0.1 (No new features in this release - bug fixes only)

3.0.0 Instant Messaging and Presence removed

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

Backwards incompatible change, so major version number increase

2.9.0 Localization of IE Plugin

2.7.0 Support for configuring minimum plugin version

2.6.0 Change to Plug-in installation flow; added new JS API call

Important Information for this Release

Please refer to the Known Issues section on page 11.

When loading the sample IE application, the screen may display initializing… and the IE
plug-in will fail to load. If this occurs, add the web site to the list of Trusted Sites in IE.

The maximum resolution for video when using a plug-in is 1280x720.

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

CBA Components
Fusion Client SDK plug-ins integrate with the following CBA components:

Fusion Client SDK 3.3.9 or later.

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

Third-party Platforms

Web Browser

Fusion Client SDK plug-ins can be used to develop applications that take advantage of the
latest browser technologies. These applications are supported by the following browsers:

Co- Plug-
Browser Version WebRTC Audio Video Platfor
browse in

G.711 VP8 OSX 10

Apple (Maveric
8+ Yes No Yes
Safari Opus H.264 Yosemite
El Capita

G.711 VP8 Window

Microsoft
7, 8.1, 1
Internet 11 Yes No Yes
Opus H264 (32 and
Explorer
bit)

Consumer

Web browsers are not supported on iOS or Android

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

Installation

Internet Explorer

To install the Internet Explorer plug-in:

1. FCSDK must be installed

2. Obtain the Internet Explorer plug-in artifact (IEPluginMSI.war) from CBA.

3. Deploy the ActiveX IE plug-in application to FAS - see the Browser Plugin Management
section on page 9, and the Deploying Applications section in the FAS Administration
Guide.

4. The Internet Explorer version of the sample application requires compatibility mode to be
switched off.

In Internet Explorer 11, go to Settings -> Compatibility View Settings and uncheck Display
intranet sites in Compatibility View.

Restart Internet Explorer.

5. Log in to the FCSDK web sample application in Internet Explorer, and you will be prompted
to install the plug-in. The plugin will download an MSI file (WebRTC-Plugin.msi), which you
should run to install the plug-in. When you refresh the page, IE will start using the plug-in.

If Internet Explorer blocks the installation of the ActiveX control for security reasons, see IT
Policy below.

If you have a previous version of the plug-in installed, and you are prompted to upgrade to the
latest version, you must restart Internet Explorer for the changes to take effect.

6. You should now be able to use the sample web application to make voice and video calls
from within Internet Explorer.

Versioning
It is important that the installed version of the Internet Explorer plug-in matches the version of the
Fusion Client SDK. Mismatches can cause problems for Internet Explorer when downloading

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

and installing the plug-in.

Log Files
The IE plug-in logs to the file system at:

<user-home>\AppData\LocalLow\FusionVideo\ieplugin.log.

When raising issues please include this log file.

IT Policy

For Windows users without administrative privileges, the IT policy for client machines must allow
users to install ActiveX controls. Either the IT administrator for the domain or a local user with
administrative provileges should make the following changes to the configuration. The following
summary describes the configuration process for a local administrative user. See
http://technet.microsoft.com/en-gb/library/dd631688(v=ws.10).aspx for full details:

1. In the Start menu search box, type gpedit.msc and press Enter.

2. In the policy editor, go to Local Computer Policy -> Computer Configuration ->
Administrative Templates -> Windows Components -> ActiveX Installer Service

3. Double click Approved Installation Sites For ActiveX Controls

4. Check the Enabled radio button

5. In the Options pane, click the Show button

6. In the Host URLs table, add http://<server> as the Value name, and 2, 2, 1, 0 as the Value,
and click OK

<server> should be the machine which serves the ActiveX control. The 2,2,1,0 string is an
example that specifies the policy for downloading ActiveX controls from that server; see the MS
Technet page above for details.

7. Click OK

If non-administrative users still experience problems installing the ActiveX control, then you may
need to add the FAS server to the IE trusted sites zone, and ensure that the security settings for
that zone allow for the downloading of ActiveX controls.

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

Uninstallation

To uninstall the plug-in, go to Windows Control Panel -> Programs and Features, select the
plug‑in from the list of programs, then on the context menu click Uninstall.

Installation as an MSI file

The IE plugin can also be installed from an MSI file:

1. Obtain the file WebRTC-Plugin-Admin-installer-for-all-users.msi from CBA.

2. Log on to the PC as an Administrator

3. Run the WebRTC-Plugin-Admin-installer-for-all-users.msi file.

4. Log out.

The plugin is now available to any user who logs on to the PC.

You may wish to use this method if:

Security policy in your organization prevents the user who will use the plugin from installing
it

Working methods in your organization require many users to use the same machine, with
the same software available to each user.

You do not want the plugin installed on the FAS.

Safari

To install the Safari plug-in:

1. FCSDK must be installed.

2. Obtain the Safari plugin artefact from CBA.

3. Deploy the Safari plug-in application to FAS - see the Browser Plugin Management section
on page 9, and the Deploying Applications section in the FAS Administration Guide.

4. Log in to the FCSDK web sample application in Safari. You should be prompted to download
the Safari plug-in.

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

5. Once downloaded you will need to manually run the downloaded Safari plug-in DMG file to
install the plug-in.

6. Restart Safari.

You must restart Safari for the changes to take effect.

7. Now log in to the FCSDK web sample application in Safari

8. You should be able to use the web application to make voice and video calls from within
Safari.

If the sample web application still has problems detecting the Safari plug-in, please check Safari
Preferences to ensure that your application trusts and allows the plug-in to run.

The Safari plug-in logs to the OS X Console and the Safari console on the Develop menu. When
raising issues, please include this log file.

If you need to re-install the Safari plug-in, please start from step 1 again.

Self-signed Certificates

If you are connecting to a server that uses a self-signed certificate, you will need to add that
certificate and the associated CA root certificate to the keychain on your client.

You can obtain the server certificate and CA root certificate from the FAS Administration screens.
The FAS Administration Guide explains how to view and export certificates. You will need to
extract the HTTPS Identity Certificate (server certificate) and the Trust Certificate (CA root
certificate) that has signed your server certificate.

Once you have exported and downloaded the two certificates, they need to be copied to your
client. Please follow the user documentation for your device to install the certificates.

You should then view the installed server certificate through the appropriate tool (e.g. OSX
Keychain) and confirm that the server certificate is trusted. If it is, then your application should be
able to connect to the server.

Browser Plugin Management

You can install the browser plugin files on the Gateway, or in another location that your users can
access - their browser retrieves this information from the Gateway. See the FCSDK

Administration Guide for details on how to configure the plugins in the Web Administration
console.

Browser Plug-in Version Information

Browser Latest Released Version Minimum Acceptable Version

Internet Explorer 3.3.9 3.3.9

Safari 3.3.9 3.3.9

Sample Applications

The sample applications provide comprehensive examples of how to use the Internet Explorer
and Safari plug-ins, including retrieving the following information:

Possible
Setting
values

required

pluginInfo.status optional

notNeeded

none when
plug-in is
missing or
not
pluginInfo.installedVersion required

version
number in
x.y.z form

pluginInfo.minimumRequired
none when
a plug-in is

not
required

version
number in
x.y.z form

none when
a plug-in is
not
required
pluginInfo.latestAvailable
version
number in
x.y.z form

The URL
of the
installer

An empty
pluginInfo.pluginURL
string
when a
plugin is
not
required