# Android

### 이 글에서는

GrowSpace Android SDK는 BLE 및 UWB 기반 실내 위치 기술을 Android 앱에 간편하게 통합할 수 있도록 설계된 개발 키트입니다. 거리 측정(Ranging)부터 RTLS 위치 추정까지 모두 하나의 클래스(`SpaceUwb`)로 제어할 수 있습니다.

***

### 주요 기능

* BLE + UWB 거리 측정 (Ranging)
* RTLS 기반 위치 추정 (x, y, z 계산)
* 실시간 장치 연결 / 해제 이벤트 제공

***

### 설치하기

#### Gradle 설정

```kotlin
dependencies {
    implementation("io.github.freegrowenterprise:SpaceSDK-Android:0.0.9")
}
```

#### Android 권한 설정 (AndroidManifest.xml)

```xml
<uses-permission android:name="android.permission.BLUETOOTH" />
<uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
<uses-permission android:name="android.permission.BLUETOOTH_SCAN" />
<uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
<uses-permission android:name="android.permission.UWB_RANGING" />
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.ACCESS_NETWORK_STATE" />
```

### 요구 사항

| 항목         | 조건                        |
| ---------- | ------------------------- |
| Android OS | Android 14 (API 34) 이상    |
| 언어         | Kotlin 1.9.22 (권장)        |
| 디바이스       | UWB 지원 Android 스마트폰       |
| 하드웨어       | GrowSpace UWB 제품군 (태그/앵커) |

***

### 초기화

```kotlin
val spaceUwb = SpaceUwb(context = applicationContext, activity = this)
```

***

### 거리 측정 시작

```kotlin
spaceUwb.startUwbRanging(
    maximumConnectionCount = 4,
    replacementDistanceThreshold = 8f,
    isConnectStrongestSignalFirst = true,
    onUpdate = { result ->
        Log.d("UWB", "device=${result.deviceName}, distance=${result.distance}m")
    },
    onDisconnect = { device ->
        Log.w("UWB", "Disconnected from ${device.deviceName}")
    }
)
```

### 거리 측정 중지

```kotlin
spaceUwb.stopUwbRanging { result ->
    if (result.isSuccess) {
        Log.i("UWB", "Ranging stopped")
    } else {
        Log.e("UWB", "Stop failed: ${result.exceptionOrNull()?.message}")
    }
}
```

***

### RTLS 위치 추정 시작

```kotlin
val anchorMap = mapOf(
    "FGU-0001" to Triple(0.0, 0.0, 0.0),
    "FGU-0002" to Triple(5.0, 0.0, 0.0),
    "FGU-0003" to Triple(0.0, 5.0, 0.0)
)

spaceUwb.startUwbRtls(
    anchorPositionMap = anchorMap,
    zCorrection = 1.0f,
    maximumConnectionCount = 4,
    replacementDistanceThreshold = 8f,
    isConnectStrongestSignalFirst = true,
    filterType = RtlsFilterType.AVERAGE,
    onResult = { location ->
        Log.d("RTLS", "x=${location.x}, y=${location.y}, z=${location.z}")
    },
    onFail = { error ->
        Log.e("RTLS", "Positioning failed: $error")
    },
    onDeviceRanging = { map ->
        map.forEach { (id, dist) ->
            Log.d("RTLS", "$id = $dist m")
        }
    }
)
```

***

### 테스트 앱

공식 테스트 앱을 통해 SDK 기능을 손쉽게 검증할 수 있습니다.

* [GitHub](https://github.com/freegrowenterprise/SpaceSDK-Android-TestApp)
* [Google Play](https://play.google.com/store/apps/details?id=com.growspace.testapp\&pcampaignid=web_share)



