SDK 개요

최신 기술과 기능, 사용자에게 더 나은 경험을 제공하기 위해 2.0 버전 SDK 권장

Docs 2.0 버전 기준으로 적용된 SDK는 최신 수면 분석 데이터를 활용하여 사용자에게 더 정확하고 효과적인 수면 분석을 제공합니다. 또한, 최신 대시보드와 완벽하게 통합되어 사용자에게 최상의 경험을 제공합니다. 앞으로 사용자 개발 경험을 향상시키기 위해 추가 기능도 Docs 2.0 버전 기준의 SDK를 지속적으로 제공할 예정입니다.

Docs 1.0 버전 기준의 SDK와 Docs 2.0 버전 기준의 SDK는 서로 호환되지 않으며, 제공되는 Callback 및 Response 타입이 다릅니다.

SDK Version 정책

Docs Version에 따른 SDK iOS / Android 사용 가능 버전

Docs VersioniOS SDK 버전Android SDK 버전
1.0SDK 1.x.x (1.0.0 ~ 1.1.6)SDK 1.x.x (1.0.0 ~ 1.0.9)
2.0SDK 2.x.xSDK 2.x.x

Platform

OSSDKSample App
iOSSwiftiOS Sample App
AndroidKotlin안드로이드 Sample App

SDK Release

Asleep SDK iOS

Asleep SDK Android

SDK Call Flow

1. INIT

2. TRACKING

  • Mel Upload는 30초 주기로 업데이트
    • Android SDK는 수면 오디오 레코딩링 중 전화 등의 Audio 인터럽트 발생시 "zero" 값만 업데이트 (20분 Audio Data 중에 5분이상이 Zero 값일 경우 인퍼런스 분석 안됨.)
    • iOS SDK는 수면 오디오 레코딩 중 전화 등의 Audio 인터럽트 발생시 Upload 동작 처리를 안함 (OS 자체적으로 제한)
  • TRACKING시 Foreground service를 구현해야 앱이 백그라운드로 가더라도 계속 tracking을 할 수 있다.

3. REPORT

  • StopTracking 후 전체 수면 분석이 완료되기 전 시점에 Report 요청을 할 경우 실시간 모니터링 된 수면 데이터가 전달 되고 전체 분석이 완료된 이후 시점에 Report 요청시 최종 수면 모니터링 결과를 받을 수 있음.
  • 수면 분석 완료 시점은 Server로 부터 Callback으로 complete 받은 시점. SDK Report를 통해 수신을 원할 경우 StopTracking 호출 후 1초 이내 Delay 후에 요청 필요.