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
  • Overview
  • User Guide
  • Feature Configuration
  • Run XML
  • Adjust Audio
  • Open WIFI Settings
  • Open Bluetooth Settings
  • Set Language
  • Other Actions
  1. Product Guides
  2. BlueFletch Launcher
  3. Configurable Layouts

Layout Custom Actions

Layout Custom Actions are platform actions that can be surfaced as icons on the Launcher home screen.

Overview

BlueFletch supports Layout Custom Actions that can be used to launch system actions on the Launcher home screen.

User Guide

To create a Layout Custom Action, you will need to specify the action name that will be displayed on the Launcher home screen and the action type that will be executed.

After creating a Layout Custom Action, it can be assigned to a layout. For example, if you assign a custom action to the "Login" layout, it will be executed when the user logs in to the device.

Feature Configuration

The Launcher configuration allows you to define the Layout Custom Actions that can be performed or executed. Use the examples below as a guide:

Run XML

The custom action com.bluefletch.ems.RUN_XML allows for running an XML file, such a Stage Now profile, as a layot action shortcut. The layout item also requires an intent extra that defines the file location:

{
    "label": "Stage Now - Turn On Autorotate",
    "action": "com.bluefletch.ems.RUN_XML",
    "intentExtras": { 
        "file": "/sdcard/Download/ems/autorotateOn.xml"
    }
}
{
    "label": "Stage Now - Turn On Autorotate",
    "action": "com.bluefletch.ems.RUN_XML",
    "intentExtras": { 
        "file": "assets:autorotateOn"
    }
}

Adjust Audio

The custom action com.bluefletch.ems.AUDIO can be used to adjust the volume of notification sounds, system sounds, or alarms. In the example below, the volume for notifications will be audible at full volume which is 100%, while the volume for other sounds can be adjusted to 50% only.

{
  "action" : "com.bluefletch.ems.AUDIO", 
  "label": "Audio - Half Volume (Except Notifications)", 
  "intentExtras": {
    "setting": "ADJUST_AUDIO",    
    "notification": 100,    
    "others": 50
  }
}

The custom action com.bluefletch.ems.AUDIO supports the intentExtras key-value pairs. The "setting" key-value pair specifies the type of audio setting that should be adjusted while the other key-value pairs specify the volume level for the corresponding sound. The volume level is specified as a whole number, where 0 is the lowest volume level and 100 is the highest volume level.

  • "setting": Set value to "ADJUST_AUDIO".

  • "notification": Value defines notification volume level by the whole number.

  • "music": Value defines music volume level by the whole number.

  • "ring": Value defines ringtone volume level by the whole number.

  • "system": Value defines system volume level by the whole number.

  • "dtmf": Value defines dual-tone multi-frequency volume level by the whole number.

  • "call": Value defines call volume level by the whole number.

  • "alarm": Value defines alarm volume level by the whole number.

  • "others": Value defines all volume levels not defined elsewhere by whole numbers.

Open WIFI Settings

BlueFletch also currently supports the custom action android.settings.WIFI_SETTINGS. When it is invoked, this will allow users to access the Wi-Fi settings from their devices. If wifiSettingsEnabled is set to true, end users can edit within the Wi-Fi Settings UI. False indicates no permission to change the Wi-Fi settings. In the example below, all users belonging to the Admin layout can access and/or edit the Wi-Fi settings.

"layouts" : {
    ...

    "ADMIN":[
      {
        "label" : "Wifi Settings",
        "action": "android.settings.WIFI_SETTINGS",
        "icon" : "com.android.settings",
        "wifiSettingsEnabled": true
      }

In the example below, users are allowed to view but not change the Wi-Fi settings.

  "layouts" : {
    ...

    "*": [
        {
            "label" : "Wifi Settings-ReadOnly",
            "action": "android.settings.WIFI_SETTINGS",
            "icon" : "com.android.settings",
            "wifiSettingsEnabled": false,
            "password": "ef92b778bafe771e89245b89ecbc08a44a4e166c06659911881f383d4473e94f"
       }
    ]
  },

Open Bluetooth Settings

BlueFletch also currently supports android.settings.BLUETOOTH_SETTINGS. When this custom action is enabled, it would open the Bluetooth settings screen on the current device.

Caution: Handling of Android Settings API shortcuts such as android.settings.WIFI_SETTINGS or android.settings.BLUETOOTH_SETTINGS differs across Android OS versions, OEMs, and even patch versions within the same OEM; sometimes full access to the Android Settings app and even to the Quick Settings tiles is allowed.

BlueFletch does NOT recommend placing these shortcuts in the Open Zone without protections in place due to the risk of users reaching full Android Settings.

Set Language

The custom action com.bluefletch.ems.LANGUAGE will set the device language at the OS level and apply translations to BlueFletch apps. Use Zebra-supported language/locale codes (e.g. "en_US", "fr_CA", "es_US")

{
    "action" : "com.bluefletch.ems.LANGUAGE",
    "label": "French (Canada)",
    "intentExtras": {
     "lang": "fr_CA"
   }
}

Available in Launcher 3.25.15. Only available on Zebra devices.

Other Actions

PreviousQuick Start Applications FolderNextReplacement Values

Last updated 3 months ago

Alternatively, the same XML file can be referenced using :

BlueFletch recommends that Android Settings API shortcuts be placed in for manager roles or have a set, which only managers know, if the shortcuts are in the Open Zone.

Android Developer documentation provides a list of other , although some actions may not currently be fully supported by BlueFletch.

Assets Manager
layouts
password
Android Settings actions