오늘부터 SDK 문서를 지원합니다!!! 짝짝짝~~

버전 정보

ForMe Algorithm Library 버전 정보 및 변경 사항입니다.

현재 버전

Android (AOS) & iOS

버전: v01.03.03
릴리즈 날짜: 2024

버전 확인 방법

Android (Kotlin)

val version = lib_engine_version()
println("Library Version: $version")
// 출력: Library Version: 01.03.03

iOS (Swift)

let version = lib_engine_version()
print("Library Version: \(version ?? "Unknown")")
// 출력: Library Version: v01.03.03

iOS (Objective-C)

NSString *version = lib_engine_version();
NSLog(@"Library Version: %@", version);
// 출력: Library Version: v01.03.03

변경 이력

v01.03.03 (2024) - 현재 버전

🎉 주요 변경사항

✅ iOS Coherence 지원

iOS에서도 Coherence 계산 기능 추가!

• 이전에는 Android 전용이었던 Coherence 기능이 iOS에서도 사용 가능
• HrvIndices 구조체에 coherence 필드 추가
• calculate_coh 함수 포함
• 5초마다 최근 60초 IBI 데이터로 자동 계산

ℹ️ Android API 간소화

lib_engine_sleep_status 파라미터 간소화

• 제거된 파라미터: sound_state, sleep_control, onsetSound_control
• 더 간단한 API로 동일한 기능 제공

신규 기능 (iOS)

• ✨ Coherence 계산 기능
• FFT 기반 파워 스펙트럼 분석
• 신호/노이즈 비율 계산 (dB)
• 5초마다 자동 업데이트
• 초기 3초는 -100 반환

개선 사항

• 🔧 양 플랫폼 버전 통일 (v01.03.03)
• 🔧 API 일관성 향상
• 🔧 문서 업데이트 및 개선

v01.03.02 (2024) - Android

신규 기능

• ✨ Coherence 계산 기능 추가 (Android 전용)
• calculate_coh 함수 구현
• FFT 기반 파워 스펙트럼 분석

• 신호/노이즈 비율 계산 (dB)

• ✨ IBI 초기 데이터 보정 로직

• IBI_initial_data.h 추가
• 심박수 범위별 초기 IBI 패턴 적용
• 측정 초기 4초에 자동 적용

개선 사항

• 🔧 수면 분석 알고리즘 정확도 향상
• 🔧 RR 간격 검출 안정성 개선
• 🔧 메모리 사용 최적화

v01.02.13 (2024) - iOS

개선 사항

• 🔧 수면 분석 알고리즘 정확도 향상
• 🔧 iOS 플랫폼 안정성 개선
• 🔧 HRV 계산 정확도 개선
• 🔧 메모리 관리 최적화

플랫폼별 기능 비교

호환성

Android

iOS

마이그레이션 가이드

iOS v01.02.13 → v01.03.03

💡 Coherence 사용하기

v01.03.03부터 iOS에서도 Coherence를 사용할 수 있습니다!

변경 사항:
1. HrvIndices 구조체에 coherence 필드 추가
2. 기존 코드 변경 불필요 (하위 호환성 유지)

새 기능 사용:

var hrvIndices = HrvIndices()
// ... lib_engine_heart_rate 호출 ...

// Coherence 사용 (새 기능)
if hrvIndices.coherence > -100 {
    print("Coherence: \(hrvIndices.coherence) dB")
}

Android v01.03.02 → v01.03.03

ℹ️ API 간소화

lib_engine_sleep_status 함수의 파라미터가 간소화되었습니다.

변경 사항:
- 제거된 파라미터: sound_state, sleep_control, onsetSound_control

코드 수정:

// 이전 (v01.03.02)
val result = lib_engine_sleep_status(
    accelData, hrvIndices, devSource, leadOff,
    stimulusControl, sleepCareStart,
    accelMobile, screenStatus, soundState,  // 제거됨
    sleepControl, onsetSoundControl,        // 제거됨
    cntAccel, cntHRV, cntDev, cntLead       // 제거됨
)

// 현재 (v01.03.03)
val result = lib_engine_sleep_status(
    accelData, hrvIndices, devSource, leadOff,
    stimulusControl, sleepCareStart,
    accelMobile, screenStatus
)

알려진 이슈

공통

⚠️ 알려진 제한 사항

1. 메모리 제약: 최대 120초 버퍼 크기 (~2MB)
2. PPG 샘플링: 64Hz 고정 권장 (가변 시 오차 가능)
3. Coherence: 측정 시작 후 5초부터 유효
4. Thread Safety: 단일 스레드 호출 권장

향후 계획

다음 버전 (v01.03.04)

계획 기능

• [ ] 수면 사이클 분석 개선
• [ ] 호흡 패턴 분석 추가
• [ ] 실시간 스트리밍 모드
• [ ] 추가 HRV 지표

성능 개선

• [ ] 메모리 사용량 최적화 (목표: 1.5MB)
• [ ] CPU 사용률 감소 (목표: <3%)
• [ ] 배터리 소모 최소화

지원 종료 일정

다운로드

ℹ️ 라이브러리 다운로드

라이브러리 파일은 내부 팀원만 접근 가능합니다.

• Android: libformelib_module.so
• iOS: libformelib.a

문의: contact@dbbeats.com

문의

• 기능 요청: contact@dbbeats.com