Samsung Health Data SDK/com.samsung.android.sdk.health.data/DeviceManager

DeviceManager

It retrieves information about the devices that provide the health data stored in the Samsung Health app.

For instance, when a user measures their heart rate using the Samsung Health app on their Galaxy Watch paired with an Android phone, the data is automatically transferred from the watch to the phone and stored in the phone's Samsung Health app, with the watch listed as the source device for the data. You can later filter the data by various parameters, such as device ID, device type, and device manufacturer.

For example, to list all watches that provided the data stored in the Samsung Health app, you can use the following code.

val deviceManager = healthDataStore.getDeviceManager()
val devices = deviceManager.getDevices(DeviceGroup.WATCH)
devices.forEach { device ->
    val deviceId = device.id
    val deviceType = device.deviceType
    val deviceManufacturer = device.manufacturer
    val deviceModel = device.model
    val deviceName = device.name
}

Since

1.0.0

Functions

getDevice

abstract suspend fun getDevice(deviceId: String): Device?

Retrieves the Device object corresponding to the specified device ID.

getDeviceAsync

abstract fun getDeviceAsync(deviceId: String): AsyncSingleFuture<Device?>

Retrieves the Device object corresponding to the specified device ID. It works asynchronously using AsyncSingleFuture.

getDeviceBySeed

abstract suspend fun getDeviceBySeed(seed: String): Device?

Retrieves the Device object corresponding to the specified seed.

getDeviceBySeedAsync

abstract fun getDeviceBySeedAsync(seed: String): AsyncSingleFuture<Device?>

Retrieves the Device object corresponding to the specified seed. It works asynchronously using AsyncSingleFuture.

getDevices

abstract suspend fun getDevices(deviceType: DeviceType): List<Device>

Retrieves a list of Devices that have provided the data stored in the Samsung Health app among the devices used, corresponding to specific DeviceType.

getDevicesAsync

abstract fun getDevicesAsync(deviceType: DeviceType): AsyncSingleFuture<List<Device>>

Retrieves a list of Devices that have provided the data stored in the Samsung Health app among the devices used, corresponding to specific DeviceType. It works asynchronously using AsyncSingleFuture.

getDevicesByManufacturer

abstract suspend fun getDevicesByManufacturer(manufacturer: String): List<Device>

Retrieves a list of Devices corresponding to the specific manufacturer that provide the data stored in the Samsung Health app.

getDevicesByManufacturerAsync

abstract fun getDevicesByManufacturerAsync(manufacturer: String): AsyncSingleFuture<List<Device>>

Retrieves a list of Devices corresponding to the specific manufacturer that provide the data stored in the Samsung Health app. It works asynchronously using AsyncSingleFuture.

getDevicesByModel

abstract suspend fun getDevicesByModel(model: String): List<Device>

Retrieves a list of Devices corresponding to the specific device model that provide the data stored in the Samsung Health app.

getDevicesByModelAsync

abstract fun getDevicesByModelAsync(model: String): AsyncSingleFuture<List<Device>>

Retrieves a list of Devices corresponding to the specific device model that provide the data stored in the Samsung Health app. It works asynchronously using AsyncSingleFuture.

getLocalDevice

abstract suspend fun getLocalDevice(): Device

Retrieves the Device object that the Samsung Health app is running on.

getLocalDeviceAsync

abstract fun getLocalDeviceAsync(): AsyncSingleFuture<Device>

Retrieves the Device object that the Samsung Health app is running on. It works asynchronously using AsyncSingleFuture.

getOwnDevices

abstract suspend fun getOwnDevices(): List<Device>

Retrieves a list of Devices registered by the app that calls it.

getOwnDevicesAsync

abstract fun getOwnDevicesAsync(): AsyncSingleFuture<List<Device>>

Retrieves a list of Devices registered by the app that calls it. It works asynchronously using AsyncSingleFuture.

registerDevice

abstract suspend fun registerDevice(request: DeviceRegistrationRequest): String

Registers a device as the source device that provided the health data.

registerDeviceAsync

abstract fun registerDeviceAsync(request: DeviceRegistrationRequest): AsyncSingleFuture<String>

Registers a device as the source device that provided the health data. It works asynchronously using AsyncSingleFuture.

Essential Cookies

These cookies are essential as they enable you to move around the website. This category cannot be disabled.

Analytical/Performance Cookies

These cookies collect information about how you use our website. for example which pages you visit most often. All information these cookies collect is used to improve how the website works.

Functionality Cookies

These cookies allow our website to remember choices you make (such as your user name, language or the region your are in) and tailor the website to provide enhanced features and content for you.

Advertising Cookies

These cookies gather information about your browser habits. They remember that you've visited our website and share this information with other organizations such as advertisers.