Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/voxeet/voxeet-sdk-android-audio
Manage and improve Android Audio lifecycle (Routes, headsets, ...)
https://github.com/voxeet/voxeet-sdk-android-audio
Last synced: 21 days ago
JSON representation
Manage and improve Android Audio lifecycle (Routes, headsets, ...)
- Host: GitHub
- URL: https://github.com/voxeet/voxeet-sdk-android-audio
- Owner: voxeet
- License: apache-2.0
- Created: 2019-04-10T00:03:42.000Z (over 5 years ago)
- Default Branch: main
- Last Pushed: 2023-07-05T12:06:15.000Z (over 1 year ago)
- Last Synced: 2024-04-20T16:55:50.264Z (9 months ago)
- Language: C++
- Size: 895 KB
- Stars: 2
- Watchers: 4
- Forks: 1
- Open Issues: 4
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://app.voxeet.com)
This Android library helps managing the various event and feature around external peripherals, sound outputs
# install
```gradle
dependencies {
//add this one if you want to use the logic-only SDK
compile ('io.dolby:audio:2.5.2') {
transitive = true
}
}
```
# Usage
Breaking change : a new version exists which now by default sets the Wired Headset mode as stream music
instead of call mode. This is forced by design until a new version of the library lets full control
over which device and what mode to use. In the meantime, if the previous mode is required, you can
use `WiredMode.SetAsMusic = false`.
## Instance
```
AudioDeviceManager manager = new AudioDeviceManager(Context, ListenerForUpdates);
```
## Enumerate devices
```
Promise> devices = manager.enumerateDevices();
```
## Enumerate devices for a specific type
```
Promise> devices = manager.enumerateDevices(DeviceType);
```
## Filter devices
```
List filtered = manager.filter(List, DeviceType);
```
## Connect to a device
```
Promise connection = manager.connect(MediaDevice);
```
## Disconnect from a device
```
Promise connection = manager.disconnect(MediaDevice);
```
# Models
## DeviceType
```
DeviceType {
INTERNAL_SPEAKER,
EXTERNAL_SPEAKER,
BLUETOOTH,
NORMAL_MEDIA,
WIRED_HEADSET,
USB
}
```
## MediaDevice
### id()
System's id for the wrapped device
### deviceType()
Type of the current device
### connectionState()
Current connection state from the SDK point of view
### platformConnectionState()
Current connection state from a platform point of view (a device can be connected to the platform but not used)
## ConnectionState
```
ConnectionState {
DISCONNECTED,
CONNECTING,
CONNECTED,
DISCONNECTING;
}
```
# Testing
## Running
Ensure a device is plugged in the current desktop (multiple devices for more integration testing purposes)
And run the following command :
```
./gradlew :audio:connectedCheck test
```
## Check the results
The various test implementation results can be found in the following folders. Use the direct links to access your own results :
- [Unit Tests](./audio/build/reports/tests/testDebugUnitTest/index.html)
- [Integration Tests](./audio/build/reports/androidTests/connected/index.html)
- [Code Coverage](./audio/build/reports/coverage/debug/index.html)
# Changelogs
v2.3.0 :
- following Android 12 new behavior related to the permissions, to have properly the various bluetooth devices listed, you will need to ask explicitly the BLUETOOTH_CONNECT permission. Please refer to the [permissions for Android 12 or higher article](https://developer.android.com/guide/topics/connectivity/bluetooth/permissions#declare-android12-or-higher)
- added catch block to prevent crash on permission-less app used on Android 12
v2.2.2 :
- merge wired_headset and internal_speaker into one default_speaker device
- fix behavior where plugging / unplugging wired headset wouldn't generate expected device update event
v2.x :
- asynchronous and safe use of various device manipulation
v1.0.5 :
- address issue on some HTC devices where the `getDefaultAdapter()` for Bluetooth would trigger a VerifyError
v1.0.4 :
- Improve Bluetooth management with a fix in the constructor to use the warmup method