Documentation

​
​

Development

User Acquisition

Monetization

Industry

Vivox Core SDK

Vivox Core SDK

Vivox
​
​
Vivox Core SDK
  • Overview
  • Before you begin
  • Get started
  • Release notes
  • Developer Guide
    • Client SDK basics
    • Channels
    • Presence management
    • Messaging
    • Manage audio
    • Couch co-op
    • Android app development
      • Bluetooth profile management
        • Bluetooth profile comparison
        • SCO handshake failures
        • Bluetooth tradeoffs with Vivox
        • Change a Bluetooth profile
        • Troubleshooting Bluetooth SCO underrun issues
      • Android SDK permission requirements
      • Android library requirements
      • Initialize Vivox Android services
      • Android speakerphone audio: Mono or stereo
      • Update the ProGuard rule file
      • Smart Platform Audio Management
      • Acoustic echo cancellation
      • Disable the Vivox SDK internal AEC
      • Hardware echo cancellation
      • Absolute paths for native libraries
      • Reduce Opus CPU load on low-powered Android devices
    • iOS app development
    • macOS app development
    • Windows app development
    • Real-time recording
    • Speech-to-text audio transcription
    • Text-to-speech
    • Troubleshooting
  • Reference
  • Privacy overview
  1. Vivox Core SDK documentation
  3. Android app development

Bluetooth audio profile management

Manage user Bluetooth preferences.
Read time 2 minutes
Last updated 8 months ago
The Vivox SDKs for Android support selecting a preference for a Bluetooth audio profile. By default, Bluetooth Synchronous Connection Oriented Link (Hands-Free Profile) is preferred so that microphone audio is captured from the Bluetooth headset. The only other available preference is for Bluetooth Advanced Audio Distribution Profile (A2DP), which allows for high-quality stereo audio output at the cost of having to get microphone audio from the Android handset microphones.
The Bluetooth profile preference may be set by developers (or users, if exposed in the application's settings) in order to achieve the desired Bluetooth behavior on Android. This documentation goes into the details of what the Bluetooth profiles are and what is to be expected from the default profile preference (SCO) and its alternative (A2DP).

Bluetooth profile

The Bluetooth API includes support for working with Bluetooth profiles. A Bluetooth profile is a wireless interface specification for Bluetooth-based communication between devices, such as the Hands-Free profile. For example, for a mobile device to connect to a wireless headset, both devices must support the Hands-Free profile.
The Bluetooth API provides implementations for the following Bluetooth profiles that are relevant to Vivox:
  • A2DP: The Advanced Audio Distribution Profile.
  • HFP: The Hands-Free Profile (aka SCO).
Bluetooth profile comparisonA comparison between using A2DP or SCO profiles.
SCO handshake failuresWhy does the SCO handshake sometimes fail?
Bluetooth tradeoffs with VivoxBluetooth profile behavior in Vivox.
Changing Vivox's Bluetooth profileHow to change the Bluetooth profile used by a Vivox application.
Troubleshooting SCO underrun issuesA suggested work-around for choppy audio with SCO.
Copyright © 2026 Unity Technologies
LegalPrivacy PolicyCookiesDocumentation Terms of UseDo Not Sell or Share My Personal InformationYour Privacy Choices (Cookie Settings)

"Unity", Unity logos, and other Unity trademarks are trademarks or registered trademarks of Unity Technologies or its affiliates in the U.S and elsewhere (more info here). Other names or brands are trademarks of their respective owners.

Some pages are machine-translated for convenience, and may contain inaccuracies. In the event of conflicting information, the English version is authoritative.

  • On this page

    • Bluetooth profile

Report a problem with this page