BlueFletch Enterprise
  • BlueFletch Enterprise
  • Product Guides
    • BlueFletch Launcher
      • Configurable Layouts
        • Layouts
        • Orientation Options
        • Criteria
        • Widgets
        • Implied Groups
        • Kiosk Mode
        • Persistent Foreground App
        • Password Protected Applications
        • Quick Start Applications Folder
        • Layout Custom Actions
        • Replacement Values
        • Assets Manager
      • Theming
        • Configure Theme
        • Site-Specific Theming
        • Custom Field Display
      • Site Information Service
      • Custom Intents
        • Standard Android Intents
        • Platform Actions
        • Filtering
        • Technical Guide
      • Security and Safety
        • Clear App Data on Logout
        • Application Enabler
        • Disable Packages
        • Key Management
        • NFC Enable/Disable
        • Secure Notifications
        • Wi-Fi UI Settings Enable/Disable
        • Motion Activated Device Lock
        • Unique Login
        • Local Admin Password
        • Device Remote Lock
      • Device Loss Prevention
        • Low Battery Mode
        • Luggage Tag Mode
        • Secure Device Mode
      • Launcher Provider SDK
      • Load Configurations via QR Code Scan
      • Getting Started
      • Technical Guide
      • Release Notes
    • Authentication and SSO
      • Features
        • Secondary Authentication
          • PIN
          • Face Recognition
          • NFC Tag
          • Barcode
          • Alternate Secondary Authentication
      • Technical Guide
        • LDAP
        • AppAuth/OIDC
        • Okta (Session)
        • MSAL
        • ADFS 3.0/2012 Using ADAL
      • Release Notes
    • Support Application
      • Features
        • Events to Splunk
        • Logs to Azure
        • External Configuration Support
        • Application Usage History
        • Generating RxLogger Log Files
      • Technical Guide
        • Event Information
        • Event Examples
      • Support Installer
      • Getting Started
      • Release Notes
    • Device Finder
      • Features
        • Device Details
        • Device Status
        • View Site Devices
      • Technical Guide
      • Getting Started
      • Release Notes
    • Browser
      • Features
        • Custom Scripts
        • FIDO2 / Webauthn Support
        • URL AllowList and BlockList
      • Technical Guide
        • Configuring Browser
        • All Configuration
        • Available Intents
        • APIs and Page Actions
      • Release Notes
    • Chat
      • Features
      • Technical Guide
      • Getting Started
      • Release Notes
    • Playbook Agent
      • Features
      • Getting Started
      • Release Notes
    • Portal
      • Login & Logout
      • Navigation & Account Settings
      • Support Agent
        • Home
        • Device Details
        • Dashboards
        • Cards
        • Event Explorer
        • Reports
      • Enterprise Launcher
        • Creating a Configuration
        • Sending a Notification
        • Managing Sites
      • Playbook MDM
        • Playbooks
        • Plays
        • Devices
        • Deployment Groups
        • Zebra StageNow
      • EMM Console
        • Overview
        • Setup
          • Enroll Org in EMM
          • Policy Management
          • Provisioning
          • Device Management
          • Installing Playbook in EMM
        • Troubleshooting
          • Device Issues
          • Policy Issues
      • Chat Manager
        • Overview
        • Chat Roles
        • Chat Channels
        • Chat Audio Transcription
        • Message Logs
      • Admin
        • Organization
        • Single Sign On
          • Azure Setup
          • Okta Setup
          • Google Workspace Setup
          • Portal Setup
        • Users
        • Roles
          • Overview
          • Predefined Roles
          • Permissions
          • Manage Roles
        • Downloads
        • Agents
        • Key Management
          • Overview
          • API Keys
          • Device Keys
          • Device Restrictions
          • Allowed IP Addresses
        • Enterprise
        • Audit Logs
      • Event Forwarding
      • Remote Control
      • Getting Started
      • Release Notes
    • Other Applications
      • Messaging
        • Features
        • Technical Guide
        • Release Notes
      • Keyboard
        • Features
        • Technical Guide
          • How to: Set Keyboard as default
        • Release Notes
      • Bluetooth
        • Features
        • Release Notes
      • Voice Chat
        • Features
        • Release Notes
      • Device Remote Control
        • Features
        • Technical Guide
        • Release Notes
      • Device ID
        • Features
        • Technical Guide
        • Release Notes
      • Suite Installer
        • Technical Guide
        • Release Notes
      • Accessibility Enabler
        • Release Notes
      • EPM Plugin
        • Features
        • Technical Guide
        • Release Notes
    • Workforce Identity
  • Technical Documentation
    • Updating License Key
    • Commonly Reported Issues
    • Deploying BlueFletch Enterprise
      • Android 10 and 11
      • MDMs
        • Workspace One (VMWare AirWatch)
        • SOTI
        • Microsoft Intune
          • Microsoft Intune + Playbook
      • From Portal to Playbook Agent
Powered by GitBook
On this page
  • Device Events
  • Key-Value Pairs
  • Examples
  • All Device Event Arrays
  1. Product Guides
  2. BlueFletch Launcher
  3. Custom Intents

Technical Guide

Configuration key-value pairs applicable to custom intents.

PreviousFilteringNextSecurity and Safety

Last updated 3 months ago

Device Events

The following device states/events are available as triggers in the launcher.json's "intents". Multiple intent objects can be listed sequentially in each device event's array.

Field
Description

preLogin

array A collection of Custom Intents to invoke before the authentication process begins.

login

array A collection of Custom Intents to invoke after user logs into the device.

logout

array A collection of Custom Intents to invoke after user logs out of the device, prior to launcher completing full logout.

postLogout

array A collection of Custom Intents to invoke after user logs out of the device. This occurs after all Logout actions are completed.

boot

array A collection of Custom Intents to invoke after device boot.

uncradle

array A collection of Custom Intents to invoke after the device is removed from the cradle.

cradle

array A collection of Custom Intents to invoke after the device is placed on the cradle.

screenOn

array A collection of Custom Intents to invoke after the screen turns on.

motionLockEnter

array A collection of custom intents to invoke when lockInMotion engages on the device.

motionLockExit

array A collection of custom intents to invoke when the device exits from lockInMotion state.

siteChange

array A collection of custom intents to invoke when a site change is detected.

Key-Value Pairs

The following key-value pairs are used to build each custom intent object:

Key
Value Description

package

string The package to invoke.

action

string Android action, or special Platform Action.

category

string Android Category.

class

string The Class name within the package.

flags

integer Flags to use during firing the intent. Currently supports the value of 1, which indicates new task.

typeIntent

string The type of intent, values b, i, a, d or p. b = Broadcast (default), i = implicit intent, a = start Activity, d = delay, p = platform.

extras

Hash Map Key/value pairs of additional data to send. Example:

data

string Data to send with the intent.

filter

object Object for defining which key-value pair of the session object will trigger the intent. Example:

Examples

All Device Event Arrays

Below is an example where each device event array is present. The following example performs the following:

  1. After login, the Launcher home screen will rotate to Landscape orientation

  2. During logout:

    1. Launcher clears the cache of Android Chrome

    2. The Launcher home screen will rotate back to Portrait orientation

  3. In addition, whenever the device is removed from the cradle:

    1. The device volume will be adjusted to 100%

"intents": {
    "preLogin": [],
    "login": [
        {
            "action": "com.bluefletch.launcher.ACTION_ROTATE_LANDSCAPE",
            "typeIntent": "p"
        }
    ],
    "logout":[
        {
            "action": "CLEARCACHE",
            "package": "com.android.chrome",
            "typeIntent": "p"
        },
        {
            "action": "com.bluefletch.launcher.ACTION_ROTATE_PORTRAIT",
            "typeIntent": "p"
        }
    ],
    "postLogout": [],
    "boot": [],
    "uncradle": [
        {
            "action": "ADJUST_AUDIO",
            "typeIntent": "p",
            "extras": {
                "others": 100
            }
        }
    ],
    "cradle": [],
    "screenOn": [],
    "motionLockEnter": [],
    "motionLockExit": [],
    "siteChange": [
        {
            "action": "SET_LANGUAGE",
            "typeIntent": "p",
            "extras": {
              "lang": "${config.ex.lang}"
            }
        },
        {
            "action": "SET_TIMEZONE",
            "typeIntent": "p",
            "extras": {
              "timezone": "${config.ex.timezone}",
              "ntpServer": "north-america.pool.ntp.org"
            }
         }
    ]
  }

Unused arrays may or may not be included in the "intents" object for the existing intents to work; empty arrays do not cause issues but they are also not required to be included.

"extras": {
   "market": "retail", 
   "region": "northeast"
}
"filter": { 
   "session.groups": "Associates"
}
base-level object