These docs are for v1.0. Click to read the latest docs for v2.0.
added

Asleep Update (23.10.31)

📘

Summary:

신규 수면 정보 추가, 통계 API 추가, unexpected_end_time 필드 추가, Dashboard Sleep Data Table 업데이트, 안드로이드 수면 측정 가이드라인 추가

안녕하세요, 에이슬립입니다.

이번 업데이트에서는 신규 수면 정보 추가, 통계 API 추가, unexpected_end_time 필드 추가, Dashboard Sleep Data Table 업데이트, 안드로이드 수면 측정 가이드라인 추가를 포함하여 다양한 개선과 수정이 이루어졌습니다. 자세한 내용은 아래에서 확인하세요!


✨ New & Updated

🔹API

1. 일어난 횟수, 수면 주기 등 기존에 없던 새로운 수면 정보 추가!

V3 Data API에 8개의 새로운 수면 정보들이 추가 되었습니다!
새로운 수면 정보들을 활용해 더욱 풍부한 수면 분석 결과를 제공해보세요.

해당 데이터들은 2023/10/31에 추가된 기능으로, 업데이트 된 시점 이후로의 V3 Data API 응답과 대시보드에서 확인 가능합니다.

[⭐️참고⭐️]
'WASO'라는 용어는 'Wake after sleep onset'의 줄임말로, 최초 수면 시작 후로 부터의 각성/깨어남을 의미합니다. 에이슬립 데이터로는 sleeptime 시각과 wake_time 시각 사이의 구간에서 sleep_stages 리스트 중 0 값을 가진 구간을 의미합니다.

[추가 데이터]

  1. waso_count:
    수면 구간 중 Wake가 발생한 횟수를 의미하며, 연속한 Wake는 1회로 집계됩니다.
    Wake 발생 횟수가 많을수록 수면의 질이 저하될 수 있습니다.
    1. 예시: 8(회)
  2. longest_waso:
    수면 구간 중 가장 길게 지속된 Wake의 소요 시간을 의미합니다.
    데이터는 초 단위로 제공되며, 분 단위로 계산해 사용하시길 권장합니다.
    1. 예시: 180(seconds)
  3. rem_latency:
    수면의 시작부터 REM 수면 단계가 처음으로 시작될 때까지의 시간을 의미합니다.
    데이터는 초 단위로 제공되며, 분 단위로 계산해 사용하시길 권장합니다.
    1. 예시: 5400(seconds)
  4. deep_latency:
    수면의 시작부터 Deep 수면 단계가 처음으로 시작될 때까지의 시간을 의미합니다.
    데이터는 초 단위로 제공되며, 분 단위로 계산해 사용하시길 권장합니다.
    1. 예시: 1800(seconds)
  5. light_latency:
    수면의 시작부터 Light 수면 단계가 처음으로 시작될 때까지의 시간을 의미합니다. 정상적인 수면 세션에서는 첫 수면 단계 Light 단계로 시작되기 때문에 light_latency 데이터의 값은 일반적으로 0 입니다. 데이터는 초 단위로 제공되며, 분 단위로 계산해 사용하시길 권장합니다.
    1. 예시: 0(seconds)
  6. unstable_breath_count:
    수면 구간 중 불안정한 호흡이 발생한 횟수를 의미합니다. 연속한 Unstable breath는 1회로 집계됩니다.
    Unstable breath 발생 횟수가 많을수록 수면의 질이 저하될 수 있습니다.
    1. 예시: 32(회)
  7. [Beta] sleep_cycle:
    수면 주기 1회당 평균 지속 시간을 의미합니다. 수면 주기란, 하룻밤 동안 수면의 여러 단계를 거치면서 반복되는 패턴을 의미합니다. 평균적으로 하나의 주기는 약 90-120분 동안 지속되며, Non-REM 수면과 REM 수면으로 구성되어 있습니다.
    1. 예시: 6000(seconds)
    2. sleep_cycle은 정식 오픈 전 베타로 오픈하는 데이터이며, 베타 운영 기간 동안 상세 조건의 변화들이 발생할 수 있습니다.
  8. [Beta] sleep_cycle_count:
    하룻밤 동안 수면 주기가 얼마나 많이 반복되었는지를 의미합니다.
    평균적으로 하룻밤에 4~6회의 수면 주기를 경험하게 됩니다.
    1. 예시: 5(times)

2. 신규 통계 API: 유저별 평균 데이터 및 여러날의 세션 정보 조회를 더욱 쉽게!

사용자에게 일주일/한달의 평균 수면 정보를 제공하거나, 여러날의 리포트를 동시에 제공하시나요?
새로 공개된 통계 API를 통해 평균 데이터와 여러날의 리포트를 활용하는게 더욱 편리해졌습니다!

신규 API의 다양한 기능들과 예시 응답을 확인해보세요!

[API 기능]

  1. 평균 데이터 조회: 조회하는 기간을 설정하면, 해당 기간 내 측정 세션 중 Slept Sessions(수면을 취한 세션)의 데이터 평균을 제공합니다. 최대 100일을 조회할 수 있습니다.
  2. Never Slept Session 조회: 조회 기간 내 한숨도 안잔 세션들의 목록을 쉽게 확인할 수 있습니다.
  3. Slept Session 조회: Slept Session의 Session Object들을 쉽게 확인할 수 있습니다.

3. 'unexpected_end_time' 필드 신규 추가

Data API V3에서는 unexpected_end_time 필드가 새로 도입되었습니다. 이 필드는 세션이 예기치 않게 종료된 시각을 나타냅니다. 만약 이 값이 null이라면 세션이 정상적으로 종료된 것으로 판단할 수 있습니다. 반대로, 값이 존재한다면 세션이 예기치 않게 종료된 것입니다. 예기치 않게 종료된 세션은 peculiarities에 따라 유효 세션 혹은 무효 세션으로 분류될 수 있습니다.

세션 종료의 비정상적인 원인으로는 인터넷의 연결 문제, 앱의 크래시 등 다양한 요인이 고려될 수 있습니다.

이 기능은 2023년 10월 25일에 업데이트 되었습니다.

🔹Dashboard

1. Session 페이지 Sleep Data Table 업데이트

Session 페이지의 Sleep Data Table에서 새롭게 추가된 수면 정보들을 확인 할 수 있고, 기존 API 응답으로 제공되었으나 대시보드에서 확인할 수 없었던 모든 데이터가 표시되게 업데이트 되었습니다.

해당 데이터들은 대시보드의 Users 탭과 Analysis 탭에도 순차적으로 업데이트 될 예정입니다.

  1. 기존 API로만 제공되던 데이터:
    time_in_sleep_period, sleep_ratio, breathing_index
  2. 새롭게 추가된 수면 정보:
    waso_count, longest_waso, rem_latency, light_latency, deep_latency, unstable_breath_count
  3. 베타 오픈 정보:
    sleep_cycle, sleep_cycle_count

🔹SDK

1. 안드로이드 수면 측정 가이드라인 추가

Android SDK를 이용한 수면 모니터링 앱을 사용할 때 다른 녹음/녹화 앱과 같이 실행 중이면 수면 측정이 정상적으로 작동하지 않습니다. 해당 조건에 대한 안내 사항이 추가되었으니, 자세한 내용은 아래 페이지에서 확인하세요.

🔹User Guide & Guideline

1. Introduction about Sleep - Sleep Cycle 설명 업데이트

베타 오픈된 Sleep Cycle에 대한 개념 소개가 추가되었습니다. Sleep Cycle이 어떤 의미를 갖는지 확인해보세요!

2. Sleep Environment Guideline 항목 추가

Android SDK를 이용한 수면 모니터링 앱을 사용할 때 다른 녹음/녹화 앱과 같이 실행 중이면 수면 측정이 정상적으로 작동하지 않습니다. 해당 조건에 대한 안내 사항이 추가되었으니, 자세한 내용은 아래 페이지에서 확인하세요.


문서에서 설명이 더 필요한 부분이나 에이슬립에 대한 궁금한 점이 있으시다면, 아래 방법으로 문의해주세요. 앞으로도 사용자의 편의를 위해 계속해서 노력하는 에이슬립이 되겠습니다.

감사합니다.