BlackBerry Dynamics for Xamarin Forms  7.0.0.22
Runtime library for Xamarin Forms applications
BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid Interface Reference

Interface containing additional methods and properties for Android for IBBDXamarin. More...

Public Member Functions

ISharedPreferencesWrapper GetBBDSharedPreferences (string name, int mode)
 Access a preferences file in the BlackBerry Dynamics secure store. More...
 
bool SupportsFingerprintAuthentication ()
 
string GetApplicationId ()
 
string GetAppVersion ()
 
Task ConfigureUIWithLogoAsync (ImageSource smallApplicationLogo, ImageSource bigApplicationLogo, Color?color=null)
 

Properties

string BBDAppConfigKeyPreventScreenCapture [get]
 Constant key value for allowing or disallowing screen capture. More...
 
string BBDAppConfigKeyAndroidKeyboardRestrictedMode [get]
 Constant key value for whether keyboard restricted mode is enabled. More...
 

Detailed Description

Interface containing additional methods and properties for Android for IBBDXamarin.

Member Function Documentation

Task BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.ConfigureUIWithLogoAsync ( ImageSource  smallApplicationLogo,
ImageSource  bigApplicationLogo,
Color?  color = null 
)

Call this function to configure the visual appearance of screens in the BlackBerry Dynamics user interface (BBD UI).

The following aspects of the BBD UI's appearance can be configured:

  • Logo image.
  • Brand color, used for the key line and interactive elements.

This function can be called prior to authorize, in order to configure the BBD UI as displayed during authorization processing.

Returns
Task.
Parameters
smallApplicationLogoImageSource for the image to show as the logo on the unlock screen and other places where a smaller logo is used. The image will be scaled to fit the screen, with aspect ratio preserved.
bigApplicationLogoImageSource for the image to show as the logo on the welcome screen and other places where a larger logo is used. The image will be scaled to fit the screen, with aspect ratio preserved.
colorColor for the brand color, or null to select the default.
string BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.GetApplicationId ( )

This method returns the BBD App ID value that was effective at authorization time.

On Android this method can only be called after BBD authorization processing has been initiated, otherwise it will throw GDInitializationError.

Returns
String containing the BBD App ID.
string BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.GetAppVersion ( )

This method returns the BBD application version value that was effective at authorization time.

On Android this method can only be called after BBD authorization processing has been initiated

Returns
String containing the BBD application version.
ISharedPreferencesWrapper BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.GetBBDSharedPreferences ( string  name,
int  mode 
)

Access a preferences file in the BlackBerry Dynamics secure store.

Returns
ISharedPreferencesWrapper object that can be used to take actions on the preferences file, such as reading and editing preference settings.
Parameters
nameString containing the name of the preferences file.
modeint specifying the operating mode of the preferences file, which must be MODE_PRIVATE.
bool BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.SupportsFingerprintAuthentication ( )

Call this method to check whether BlackBerry Dynamics fingerprint authentication is currently available.

Fingerprint authentication will be available if:

  • Fingerprint authentication is currently allowed by the enterprise that the end user represents.
  • The mobile device on which the application is installed has a fingerprint sensor that is supported by BlackBerry Dynamics.

This method can be used to determine whether the BBD fingerprint settings should be offered within the application's UI, see OpenFingerprintSettingsUI, above.

The enterprise that the end user represents can allow and disallow fingerprint authentication by changing a policy setting in their BlackBerry Control server. This means that the return value of this method could be different at different times, if the enterprise has changed their policies.

Returns
true, if fingerprint authentication is available, false otherwise.

Property Documentation

string BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.BBDAppConfigKeyAndroidKeyboardRestrictedMode
get

Constant key value for whether keyboard restricted mode is enabled.

string BBDXamarinForms.Droid.Interfaces.RuntimeObject.IBBDXamarinDroid.BBDAppConfigKeyPreventScreenCapture
get

Constant key value for allowing or disallowing screen capture.

true means that enterprise security policies require that the end user must be prevented from creating screen capture images. true means that the above policy isn't in effect, so the user is permitted to create screen capture images.