모바일
Android · iOS
제공 패키지에 따라 Flutter 기반 앱 연동 구성을 확인합니다.
SDK · Development
Newert SDK 개발 안내
지원 환경 선택부터 권한, 장치 연결, 스트림 수신, 이벤트 저장과 실제 측정 검증까지 개발 순서대로 안내합니다.
제품 개요
무엇을 측정하고 무엇을 얻나요?
데스크톱
Windows · Linux
제공 패키지에 따라 Python 환경의 장치·스트림 연동을 구성합니다.
검증 대상
연결 · 샘플 · 시간축
UI보다 먼저 누락 샘플, 이벤트와 PPG·IMU 시간 정렬을 확인합니다.
이런 작업에 적합합니다
Android·iOS 개발자
모바일 권한과 앱 생명주기를 고려해 장치 연결과 측정을 구현합니다.
Windows·Linux 개발자
Python 런타임에서 장치 연결, 데이터 처리와 파일 저장을 구현합니다.
데이터 엔지니어
수신 스트림의 스키마, 시간축, 이벤트와 저장·전송 무결성을 검증합니다.
개발 방법
연결부터 검증까지 여섯 단계로 구현합니다
함수 이름은 버전별 문서를 따르되 상태 전이와 데이터 검증 순서는 동일하게 유지합니다.
시작 전 확인 · 개발 전에 환경과 계약 범위를 확인하세요
SDK 패키지·README
대상 OS와 버전에 맞는 패키지, 샘플 코드와 문서를 준비합니다.
지원 기기·펌웨어
연동할 기기 모델, 펌웨어와 식별 방법을 확인합니다.
개발 환경
모바일 Flutter 또는 데스크톱 Python 등 상품에서 요구하는 환경과 버전을 맞춥니다.
라이선스·PRO 범위
기본 스트림과 PRO 정제·지표 중 사용할 범위를 확인합니다.
- STEP 1
대상 OS 패키지를 설치합니다
Android·iOS·Windows·Linux 중 배포 환경에 맞는 SDK를 설치하고 샘플 프로젝트가 실행되는지 먼저 확인합니다.
- SDK·런타임·아키텍처 버전 기록
- 샘플 프로젝트 빌드
- 라이선스 또는 설정 파일 위치 확인
대상 운영체제와 제공 패키지를 먼저 일치시키세요. - STEP 2
Bluetooth와 운영체제 권한을 설정합니다
앱이 장치를 검색하기 전에 필요한 Bluetooth·주변 기기 권한을 요청하고, 거부·재요청 상태를 UI에서 처리합니다.
- OS 버전별 권한 확인
- 권한 거부 안내
- Bluetooth 꺼짐 상태 처리
- STEP 3
장치를 검색하고 연결 상태를 관리합니다
검색 결과에서 지원 기기만 구분하고 연결 중·연결됨·연결 끊김·재연결 상태를 명확하게 관리합니다.
- 중복 장치 제거
- 사용자가 선택한 식별값 저장
- 앱 종료·백그라운드·재연결 처리
- STEP 4
PPG와 9축 IMU 스트림을 수신합니다
콜백 또는 스트림에서 PPG, ACC, Gyro, Mag를 구분하고 수신 시간과 장치 시간 정보를 보존합니다.
- 신호별 단위와 샘플 주기 확인
- 수신 순서와 버퍼 크기 확인
- UI 갱신과 저장 처리를 분리
- STEP 5
이벤트와 세션 파일을 저장합니다
참여자 코드, 세션 시작·종료와 실험 이벤트를 데이터 시간축에 연결하고 CSV 또는 자체 스키마로 저장합니다.
- 직접 식별정보 제외
- 이벤트 값과 시각 기록
- 정상 종료·중단 시 파일 처리
- STEP 6
실제 측정 조건에서 검증합니다
짧은 테스트와 장시간 측정에서 샘플 누락, 중복, 시간 역전, PPG·IMU 정렬, 연결 끊김과 복구를 검증합니다.
- 예상 샘플 수와 실제 행 수 비교
- 이벤트와 실제 과제 시점 대조
- 연결 끊김 후 파일·상태 무결성 확인
다운로드
샘플 파일을 먼저 확인하세요
실제 측정을 시작하기 전에 파일명, 컬럼과 단위를 확인하면 분석 파이프라인을 미리 준비할 수 있습니다.
수신 데이터 CSV 구조 샘플
PPG와 9축 IMU, 이벤트가 한 시간축에 저장되는 공통 구조를 익명 데이터로 확인합니다.
포함 컬럼
Time · PPG · ACC x/y/z · Gyro x/y/z · Mag x/y/z · event
구조 설명용 샘플이며 정확한 API, 타입, 단위와 샘플링 조건은 설치한 SDK 버전의 README를 우선합니다.
개발용 CSV 구조 다운로드데이터 예시
CSV에는 이런 값이 저장됩니다
아래 값은 구조 설명을 위한 익명 샘플입니다. 가로로 스크롤하면 전체 센서 컬럼을 확인할 수 있습니다.
명확한 연결 상태
검색·연결·측정·끊김·재연결 상태가 UI와 로그에서 일치합니다.
신호별 스트림
PPG, ACC, Gyro, Mag의 단위와 시간 정보가 유지됩니다.
세션·이벤트 기록
참여자 코드와 실험 이벤트가 측정 시간축에 연결됩니다.
분석 가능한 파일
헤더, 단위, 결측과 인코딩이 확인된 CSV 또는 데이터 파일이 생성됩니다.
검증 로그
버전, 기기, 측정 조건과 누락·재연결 결과를 재현할 수 있습니다.
PPG·IMU 수신 데이터 예시
같은 시각 행에서 PPG, ACC, Gyro, Mag와 실험 이벤트를 함께 보존하는 예시입니다.
| Time (seconds) | PPG (dB) | ACC x (m/s²) | ACC y (m/s²) | ACC z (m/s²) | Gyro x (°/s) | Gyro y (°/s) | Gyro z (°/s) | Mag x (µT) | Mag y (µT) | Mag z (µT) | event |
|---|---|---|---|---|---|---|---|---|---|---|---|
| 0.02 | 24119.000 | -0.105 | 0.858 | 9.727 | -0.022 | -0.011 | -0.010 | -50.531 | -7.348 | 8.398 | 0 |
| 0.04 | 24121.918 | -0.106 | 0.907 | 9.721 | -0.030 | -0.024 | -0.010 | -50.363 | -7.078 | 8.298 | 0 |
| 0.06 | 24124.837 | -0.106 | 0.956 | 9.716 | -0.038 | -0.037 | -0.011 | -50.195 | -6.809 | 8.197 | 0 |
기본 구현과 PRO 추가 구현을 분리하세요
기본 연결과 원시 스트림을 먼저 안정화한 뒤 PRO 기능을 별도 단계로 검증합니다.
개발 항목기본PRO 추가
- 연결 상태 머신
- 기본필수
- PRO 추가기본 구현 재사용
- PPG·9축 IMU
- 기본원시 스트림
- PRO 추가원시 스트림 유지
- 정제 파형
- 기본자체 전처리
- PRO 추가제공 범위에 맞는 추가 출력 처리
- 분석 지표
- 기본자체 계산
- PRO 추가상품·버전에 따른 지표 스키마 처리
문의 전 확인
문제가 생기면 이 순서로 확인하세요
샘플 프로젝트가 실행되지 않습니다
- 1.지원 OS·런타임·아키텍처를 확인합니다.
- 2.패키지와 의존성 버전을 확인합니다.
- 3.라이선스·설정 파일 위치를 확인합니다.
- 4.README의 최소 예제를 그대로 실행합니다.
장치는 검색되지만 연결되지 않습니다
- 1.다른 호스트 연결을 해제합니다.
- 2.연결 상태 이벤트와 오류 코드를 기록합니다.
- 3.기기 모델·펌웨어 지원 여부를 확인합니다.
- 4.연결 객체를 중복 생성하지 않았는지 확인합니다.
연결됐지만 데이터가 누락됩니다
- 1.신호 구독 또는 콜백 등록 시점을 확인합니다.
- 2.UI 렌더링과 저장 처리의 병목을 분리합니다.
- 3.버퍼와 파일 쓰기 오류를 기록합니다.
- 4.예상 샘플 수와 실제 수신 수를 비교합니다.
자주 묻는 질문
홈페이지의 코드 구조가 실제 SDK API와 같나요?
아닙니다. 홈페이지는 공통 흐름과 데이터 구조를 설명합니다. 실제 함수명, 타입, 초기화와 오류 코드는 구매한 SDK 버전의 README와 샘플 코드를 기준으로 해야 합니다.
UI 스레드에서 수신 데이터를 바로 저장해도 되나요?
실시간 렌더링과 파일 저장이 서로 지연을 만들지 않도록 분리하는 구성을 권장합니다. 사용 환경의 성능과 샘플 주기로 실제 누락 여부를 검증하세요.
장치 시간과 컴퓨터 시간을 무엇으로 저장하나요?
정확한 타임스탬프 제공 방식은 SDK 문서를 확인해야 합니다. 분석 요구에 따라 수신 시간과 장치 측 시간 정보를 보존하고 이벤트 시간축과 대조하세요.
CSV 샘플의 필드가 항상 동일한가요?
아닙니다. 샘플은 구조 설명용입니다. 실제 필드, 타입과 단위는 기기, 앱·SDK 버전과 설정에 따라 달라질 수 있습니다.