Create manager

Asleep.createSleepTrackingManager()

var config: Asleep.Config?
let delegate: AsleepSleepTrackingManagerDelegate = self
var manager: Asleep.SleepTrackingManager?

if let config {
    manager = Asleep.createSleepTrackingManager(config: config,
                                                delegate: delegate)
}

AsleepSleepTrackingManagerDelegate

protocol AsleepSleepTrackingManagerDelegate {
    func didCreate()
    func didUpload(sequence: Int)
    func didClose(sessionId: String)
    func didFail(error: Asleep.AsleepError)
    func didInterrupt()
    func didResume()
    func micPermissionWasDenied()
    func analysing(session: Asleep.Model.Session)
}

1. didCreate()
   tracking이 생성됩니다.

2. didUpload()
   오디오 데이터가 업로드됩니다.

   Property Name	Type	Description
   sequence	Int	epoch의 순서

3. didClose()
   tracking이 종료됩니다.

   Property Name	Type	Description
   sessionId	String	Report 결과 조회를 위한 id 값

4. didFail()
   에러로 인해 tracking이 종료됩니다

   Property Name	Type	Description
   error	Asleep.AsleepError	Error Codes

5. didInterrupt()
   통화 등 interrupt가 발생하여 tracking이 중단됩니다.

6. didResume()
   interrupt 요인이 사라져 tracking이 재개됩니다.

7. micPermissionWasDenied()
   마이크 권한 없이는 tracking을 시작할 수 없습니다.

8. analysing()
   현재까지 측정된 결과를 받아옵니다.

   Property Name	Type	Description
   session	Asleep.Model.Session	측정 중 트래킹 세션 정보

Concurrent Audio Capture (optional)

Asleep.SleepTrackingManager.setDeliveryDelegate()

var trackingManager = Asleep.createSleepTrackingManager(config: config, delegate: delegate)
trackingManager?.setDeliveryDelegate(self)

Asleep.AsleepAudioDeliveryManagerDelegate

protocol AsleepAudioDeliveryManagerDelegate: AnyObject {
    func deliveryAudio(didReceiveRawBuffer buffer: AVAudioPCMBuffer, 
										   at time: AVAudioTime)
}

🚧

SDK-클라이언트 동시 녹음이 필요한 경우에만 사용

이 함수는 iOS에서 하나의 Audio Session만 사용하는 애플 권장 사항을 따르면서,
SDK와 클라이언트가 동시에 오디오를 다뤄야 하는 상황에서도 안정적으로 녹음 데이터를 제공하기 위해 사용됩니다. 특히 InputNode 레벨에서 PCM 데이터를 클라이언트 측으로 실시간 전달할 수 있도록 설계되었습니다.

Start sleep tracking

Asleep.SleepTrackingManager.startTracking()

var manager: Asleep.SleepTrackingManager?
manager?.startTracking()

🚧

수면 측정 테스트 시 안내 사항을 따라주시기 바랍니다.

Asleep의 수면 측정/분석 기능을 정확하게 테스트하려면, 
테스트 환경 가이드를 반드시 따라주시기 바랍니다. 이 가이드를 준수하지 않은 환경에서 얻은 수면 분석 결과는 
실제 수면 패턴과 정확하게 일치하지 않을 수 있음을 유의해주세요.

🔗 Test Environment Guideline 확인하기

Request the latest analyzed sleep data

Asleep.SleepTrackingManager.requestAnalysis()

var manager: Asleep.SleepTrackingManager?
manager?.requestAnalysis()

Stop sleep tracking

Asleep.SleepTrackingManager.stopTracking()

var manager: Asleep.SleepTrackingManager?
manager?.stopTracking()

Get sleep tracking status

Asleep.SleepTrackingManager.getTrackingStatus()

var manager: Asleep.SleepTrackingManager?
let trackingStatus = manager?.getTrackingStatus()

Resume tracking

Asleep.SleepTrackingManager.resumeTracking()

• 수면측정 중 cannotActivateInBackground 오류가 발생하였을 경우 사용자에게 notification 등으로 알리고 앱을 foreground 상태에서 Asleep.SleepTrackingManager.resumeTracking()을 실행하여야 함.

var manager: Asleep.SleepTrackingManager?
manager?.resumeTracking()

Data Type

Asleep.SleepTrackingManager.TrackingStatus

struct TrackingStatus {
    var sessionId: String?
}

Asleep.Model.Session

struct Session {
    let id: String
    let state: State
    let startTime: Date
    let endTime: Date?
    let unexpectedEndTime: Date?
    let createdTimezone: String
    let sleepStages: [Int]?
    let snoringStages: [Int]?
}

enum State {
    case open
    case closed
    case complete
}