Setup

앱 실행 후 수면 측정을 시작하기 전에 호출하고, onComplete()를 받은 뒤 Asleep.initAsleepConfig()를 호출하세요.

Asleep.setup(context, apiKey, asleepSetupListener, productInfo)   ← 인증 정보 · 기기 정보 전달
   └ onComplete()
        └ Asleep.initAsleepConfig(context, apiKey, userId, asleepConfigListener)
             └ onSuccess(userId, asleepConfig)
                  └ createSleepTrackingManager → startSleepTracking
                     또는 beginSleepTracking

productInfo를 넘기지 않으면 기존(3.2.0)과 완전히 같이 동작합니다. Product 등록을 사용하려면 setup에 productInfo를 넘겨야 합니다.

Asleep.setup()

val productInfo = ProductInfo(
    model = "MODEL_NAME",
    identifierType = Asleep.ProductIdentifierType.SERIAL,
    identifierValue = "SERIAL_NUMBER"
)

Asleep.setup(
    context = applicationContext,
    apiKey = "YOUR_API_KEY",
    baseUrl = null,
    callbackUrl = null,
    service = null,
    asleepSetupListener = object : Asleep.AsleepSetupListener {
        override fun onComplete() { }
        override fun onProgress(progress: Int) { }
        override fun onFail(errorCode: Int, detail: String) { }
    },
    productInfo = productInfo
)

Token 방식

API Key 대신 앱 인증 정보(appId · appSecret) 로 인증할 수 있습니다. setup 이후의 모든 API는 인증 방식과 관계없이 똑같이 사용합니다.

Asleep.setup(
    context = applicationContext,
    appId = "YOUR_APP_ID",
    appSecret = "YOUR_APP_SECRET",
    asleepSetupListener = asleepSetupListener,
    productInfo = productInfo
)

API Key 방식과의 차이

• appId 또는 appSecret가 빈 문자열이면 즉시 onFail(11000) 입니다.
• 두 방식은 같은 재호출 가드를 공유합니다. API Key setup이 진행 중이면 Token setup도 무시됩니다.
• 토큰 관련 실패는 12000~12003 으로 전달됩니다. 아래 에러 코드 표를 참고하세요.

AsleepSetupListener

interface AsleepSetupListener {
    fun onComplete()
    fun onProgress(progress: Int)
    fun onFail(errorCode: Int, detail: String)
}

• onComplete() — setup이 끝났을 때 호출됩니다. productInfo를 넘겼다면 기기 등록까지 끝난 뒤에만 호출됩니다.
• onFail(errorCode, detail) — setup이 실패했을 때 호출됩니다. 이 경우 onComplete()는 호출되지 않습니다.
  • detail은 원인 확인(로그)용 문자열입니다. 앱 로직은 반드시 errorCode로 분기하세요.
• onProgress(progress) — Product 등록 과정에서는 호출되지 않습니다. 빈 구현으로 두어도 됩니다.

호출 규칙

Product 등록

Product 등록은 SDK가 탑재된 기기를 Asleep 서버에 등록하는 기능입니다. 등록해두면 서버가 어떤 세션이 어떤 기기에서 측정되었는지 기록합니다.

• 별도 API 없이 setup에 productInfo를 넘기면 등록됩니다.
• 등록에 성공하면 SDK가 등록 정보를 기기에 저장하고, 이후 세션 생성 · 데이터 업로드 등의 요청에 자동으로 포함합니다. 앱이 따로 다룰 값은 없습니다.
• productInfo 없이 setup을 호출하면 등록 요청을 보내지 않습니다.

ProductInfo

data class ProductInfo(
    val model: String,
    val identifierType: Asleep.ProductIdentifierType,
    val identifierValue: String
)

enum class ProductIdentifierType { SERIAL, MAC_ADDRESS }

동작 방식

productInfo를 넘기면 기기 등록이 setup의 한 단계가 되고, 등록이 끝나야 나머지 단계가 진행됩니다.

Asleep.setup(context, apiKey, asleepSetupListener, productInfo)
  │
  ├ ① 저장된 등록 정보 확인
  │     같은 API Key · 같은 productInfo로 이미 등록됨 → 등록 요청 없이 바로 통과
  │
  ├ ② 입력값 확인
  │     model / identifierValue 조건 위반 → onFail(13400)
  │
  ├ ③ 서버에 등록 요청
  │     네트워크 오류 · 서버 오류 → 2초 · 4초 · 8초 뒤 최대 3번 재시도
  │
  └ ④ 성공 → (나머지 setup 단계) → onComplete()
       실패 → onFail(13000 또는 13400)

앱을 실행할 때마다 같은 productInfo로 setup을 호출하세요. 두 번째 실행부터는 등록 요청 없이 바로 통과합니다.

소요 시간

등록은 setup을 멈췄다 진행하는 단계라, 네트워크가 나쁜 상태에서는 종결 콜백이 늦어집니다.

• 이미 등록된 기기: 등록 요청 없이 바로 통과합니다.
• 처음 등록: 보통 요청 한 번으로 끝납니다.
• 서버가 응답하지 않아 재시도를 모두 쓰는 경우: API Key 방식은 최대 약 90초, Token 방식은 시도마다 요청이 2건이라 최대 약 3분 뒤에 onFail(13000)이 호출됩니다. (HTTP 타임아웃 10초 · 최대 4회 시도 · 백오프 합 14초).
• 4xx 거부는 재시도하지 않아 1회 왕복 안에 끝납니다.

setup 호출 직후부터 로딩 화면을 보여주는 것을 권장합니다.

측정 시작 시점

세션이 어떤 기기에서 측정되었는지는 세션이 생성될 때 결정됩니다.

• 반드시 onComplete()를 받은 뒤 측정을 시작하세요.
• onFail(13xxx)을 받았다면 setup은 미완료 상태입니다. 측정을 시작하지 말고 원인을 해결한 뒤 setup을 다시 호출하세요.
• 수면 측정 중에는 setup이 무시됩니다. 연결된 기기가 바뀌었다면 측정을 종료한 뒤 새 productInfo로 setup을 호출하세요.

저장 정보

• 등록 정보는 SDK 전용 EncryptedSharedPreferences에 저장됩니다.
• 등록 정보(credential)는 앱에 노출되지 않으며, SDK가 요청에 자동으로 붙입니다.

에러 코드

등록 실패는 AsleepSetupListener.onFail()로 전달되며, 앱이 다르게 대응해야 하는 두 가지 코드로 구분됩니다.

사용 예시

class SleepSdkController(private val context: Context) {

    private val productInfo = ProductInfo(
        model = "MODEL_NAME",
        identifierType = Asleep.ProductIdentifierType.SERIAL,
        identifierValue = deviceSerial
    )

    private val setupListener = object : Asleep.AsleepSetupListener {
        override fun onComplete() {
            // 기기 등록이 끝난 뒤에만 호출됩니다.
            Asleep.initAsleepConfig(
                context = context,
                apiKey = "YOUR_API_KEY",
                userId = userId,
                asleepConfigListener = configListener
            )
        }

        override fun onProgress(progress: Int) { }

        override fun onFail(errorCode: Int, detail: String) {
            when (errorCode) {
                13000 -> {
                    // 일시적인 실패 — 네트워크 확인 후 잠시 뒤 setup 재호출
                }
                13400 -> {
                    // 거부 — productInfo / API Key 확인 (다시 시도해도 결과 동일)
                }
            }
        }
    }

    private val configListener = object : Asleep.AsleepConfigListener {
        override fun onSuccess(userId: String?, asleepConfig: AsleepConfig?) {
            // 이제 측정을 시작할 수 있습니다.
        }

        override fun onFail(errorCode: Int, detail: String) { }
    }

    fun start() {
        Asleep.setup(
            context = context.applicationContext,
            apiKey = "YOUR_API_KEY",
            asleepSetupListener = setupListener,
            productInfo = productInfo
        )
    }
}