Overview

The BlueParrott SDK provides developer access to the programmable BlueParrott Button™ and other functions of compatible headsets.

Typical uses of the BlueParrott SDK are:

  • Push to Talk and Voice Messaging Applications, where recording is triggered by pressing the BlueParrott Button
  • Voice Recognition and custom Voice Assistant applications, where the Voice Assistant is triggered by tapping the BlueParrott button
  • Other Enterprise Applications, where custom features can be triggered based on one or more button event

Functionality

The SDK provides following functionality:

  • BlueParrott Button configuration
  • Automatic configuration of the BlueParrott Button for use with an application
  • Support for foreground and/or background control within an application
  • Access to sensor data
  • Headset firmware version
  • Headset Configuration

This functionality requires compatible BlueParrott devices.

BlueParrott Button

The BlueParrott Button can be configured for up to five Events:

  • Press (for example to start a Push to Talk Call)
  • Release (for example to end a Push to Talk Call)
  • Single Tap (to invoke a voice recognition or other enterprise application)
  • Double Tap
  • Long Press

Each of these states is addressable for individual functions within a mobile application. To increase the overall utility of integration, functionality can be either limited to when the application is in the foreground or extended to offer background access as well.

SDK Content

There are two different versions of BlueParrott SDK:

  • BlueParrott SDK for Android
  • BlueParrott SDK for iOS

The SDK contains (for both Android and iOS):

  • SDK Library
  • Example test application to show connectivity and connected device BlueParrott Button state
  • Notes and documentation.

Only the SDK for Android contains:

  • Example test application to additionally show foreground and background processing and utilise audio.

Note: Audio recording and playback are generally not part of the BlueParrott SDK. However, some considerations for audio applications are discussed with reference to the sample application under Advanced Android Integration.

Compatibility

This table shows headset compatibility for the latest version of BlueParrott SDK.

Headset Standard Headset Configuration Proximity (Sensor 1) Firmware Version
M300-XT Yes Yes No Yes
B350-XT Yes No No No
B350-XT II Yes Yes No No
B450-XT Yes No No No
B450-XT II Yes Yes No Yes
B550-XT Yes From v1.33 From v1.34 From v1.34
C300-XT Yes From v1.19 From v1.21 From v1.21
C400-XT Yes From v2.01 No No
S450-XT Yes No No No
Reveal Pro Yes No No No

Supported Operating Systems

BlueParrott SDK for Android SDK supports:

  • Android (version 4.4 or higher)

Capabilities of the SDK vary depending on the Android version:

  • Android 4.4 – SDK supports integration with the BlueParrott B550-XT only
  • Android 5 and greater – SDK supports integration with all compatible headsets

Downloads

Name Version Last Updated Link
BlueParrott SDK for Android 4.1.01 Mar 2022 Download SDK
BlueParrott SDK for Android 4.1.01 Mar 2022 Download SDK
BlueParrott SDK for Android 4.0.02 Dec 2020 Download SDK
BlueParrott SDK for Android 3.4.0.0 Dec 2019 Download SDK
BlueParrott SDK for Android 3.1.06 Aug 2018 Download SDK