Vitalera SDK v2
A Vitalera SDK v2 egy Kotlin Multiplatform (KMP) könyvtár, amely egységes API-t biztosít orvosi eszközök integrálásához Androidon és iOS-en. A v1 monolitikus SDK-t egy moduláris, provider-alapú architektúrával váltja fel.
Fő funkciók
- Moduláris Provider rendszer: Csak azokat az eszközintegrációkat tartalmazza, amelyekre az alkalmazásának szüksége van. Minden eszközgyártó (Omron, Polar, Lifevit, Beurer stb.) külön provider modul.
- Kotlin Multiplatform: Megosztott kódbázis Android és iOS között, platform-specifikus BLE és kriptográfiai implementációkkal.
- Típusos megfigyelések: 30+ típusos megfigyelési osztály (pl.
BloodPressureObservation,HeartRateObservation) váltja fel a v1 generikusObservationmodelljét. - Flow-alapú felfedezés: Az eszközkeresés Kotlin
Flow(Android) ésAsyncSequence(iOS) technológiát használ beépített időtúllépéssel és szűréssel. - DPoP hitelesítés: Szervezeti licenckulcsok DPoP-kötött OAuth2 tokenekkel. 7 napos offline türelmi időszak gyorsítótárazott jogosultságokkal.
- Csatlakoztatott mód: Opcionálisan betegek feloldása és megfigyelések közvetlen küldése a Vitalera háttérrendszerbe.
- Standard BLE tartalék: A szabványos Bluetooth SIG egészségügyi profilokat (vérnyomás, pulzus stb.) használó eszközök automatikusan működnek gyártó-specifikus provider nélkül.
Architektúra
Platform támogatás
| Platform | Min. verzió | Terjesztés |
|---|---|---|
| Android | API 24 (Android 7.0) | Maven (GitHub Packages) |
| iOS | 14.0 | Swift Package Manager |
Modulok
| Modul | Android artifact | iOS SPM termék | Leírás |
|---|---|---|---|
| Core | com.vitalera:sdk-core | VitaleraSdkCore | Builder, hitelesítés, registry, megfigyelési típusok |
| BLE | com.vitalera:sdk-ble | VitaleraSdkBle | BLE absztrakció, szabványos profilok |
| Omron | com.vitalera:provider-omron | VitaleraSdkProviderOmron | Vérnyomásmérő, hőmérő |
| Polar | com.vitalera:provider-polar | VitaleraSdkProviderPolar | Pulzusmérő (H10, Verity Sense) |
| Lifevit | com.vitalera:provider-lifevit | VitaleraSdkProviderLifevit | BPM, oximéter, mérleg |
| Beurer | com.vitalera:provider-beurer | VitaleraSdkProviderBeurer | BPM, oximéter |
| Smart Peak Flow | com.vitalera:provider-smart-peak-flow | VitaleraSdkProviderSmartPeakFlow | Hang-alapú csúcsáramlás |
| HealthKit | N/A | VitaleraSdkProviderHealthKit | Apple HealthKit (csak iOS) |
| Health Connect | com.vitalera:provider-health-connect | N/A | Android Health Connect |
| Umbrella | com.vitalera:sdk-android | VitaleraSdk | Minden provider tartalmazza |
Gyors indulás
// 1. SDK inicializálása DPoP hitelesítéssel
val sdk = VitaleraSdk.builder()
.clientId("your-org-license-key")
.addProvider("omron")
.addProvider("polar")
.connectedMode(true)
.build()
// 2. Eszközök felfedezése
val filter = DiscoveryFilter(
capabilities = setOf(DeviceCapability.BLOOD_PRESSURE)
)
sdk.devices.discover(filter, timeoutMs = 15_000L).collect { descriptor ->
println("Found: ${descriptor.name} (${descriptor.provider})")
}
// 3. Csatlakozás és típusos megfigyelések gyűjtése
val device = sdk.devices.createDevice(descriptor)
device.connect()
device.collect().collect { observation ->
when (observation) {
is BloodPressureObservation ->
println("BP: ${observation.systolic}/${observation.diastolic}")
is HeartRateObservation ->
println("HR: ${observation.heartRate} bpm")
}
}
device.disconnect()
// 4. Erőforrások felszabadítása
sdk.close()
Első lépések
- Android: Lásd az Android áttekintést, a Telepítési útmutatót és a Használati útmutatót.
- iOS: Lásd az iOS áttekintést, a Telepítési útmutatót és a Használati útmutatót.
- Migráció a v1-ről: Lásd a migrációs útmutatót az SDK referencia dokumentációban.
- Eszköztámogatás: Lásd az Eszközintegrációs útmutatókat az eszközönkénti beállítási utasításokért.
Támogatás
Licenckulcsokért vagy technikai támogatásért forduljon a sdk@vitalera.com címhez.