버전 0.1.0
EmoConnect 기기에서 PPG와 움직임 데이터를 받는 Flutter SDK입니다. 기기 검색과 연결부터 측정 시작·정지, PPG와 9축 움직임, 배터리 정보 수신까지 Flutter 앱에서 사용할 수 있습니다. 라이선스가 있으면 정제된 PPG 파형과 심박, 착용 상태도 받습니다. 대표 이미지는 SDK 기능을 표현한 개념 일러스트입니다.
제공 기능
• 기기 검색·연결: 주변의 EmoConnect 기기를 검색하고 연결합니다.
• 측정 시작·정지: PPG 밝기를 골라 측정을 시작하고 정지합니다.
• PPG 스트림: 초당 50개(50 Hz)의 PPG 데이터를 제공합니다.
• 움직임: 가속도(m/s²), 회전(rad/s), 지자기(µT)를 각각 50 Hz로 제공합니다.
• 배터리: 잔량(%)을 확인합니다.
• 자동 재연결: 측정 중 연결이 끊기면 기기를 다시 찾아 연결하고 측정을 이어 갑니다.
• Pro 등급(라이선스): 정제된 PPG 파형, 심박(bpm), 착용·움직임 상태를 추가로 제공합니다.
SDK는 데이터 스트림을 제공하며, 데이터 저장은 앱에서 구현합니다.
지원 플랫폼
• Android: Android 7.0(API 24) 이상
• Windows: Windows 10 이상, x64
• Linux·iOS: 다음 버전에서 지원 예정
예제 앱
기기 검색·연결 → 측정 시작·정지 → CSV 저장 흐름을 확인할 수 있습니다. PPG와 정제 PPG, 가속도 그래프, 심박, 배터리 정보도 표시합니다. 전체 예제는 패키지의 example/에 있습니다.
요구 사항
• Android: Android 12 이상은 블루투스 검색·연결 권한, Android 11 이하는 위치 권한이 필요합니다. 기기 검색 전에 실행 중 권한을 요청해야 합니다.
• Windows: 블루투스 LE를 지원하는 어댑터가 필요합니다.
• Flutter 3.38 이상이 필요합니다.
• Pro 등급: Biosignal DataHub 계정의 라이선스와 인터넷 연결이 필요합니다. 한 번 확인되면 최대 30일 동안 오프라인에서도 동작합니다.
다운로드
상단의 다운로드 버튼에서 EmoConnect SDK 저장소를 확인할 수 있습니다. 설치에 사용하는 공개 Git 태그는 v0.1.0입니다. 개발자 매뉴얼(PDF)은 저장소의 doc/ 폴더에 있습니다.
주의 사항
이 SDK는 의료기기가 아니며, 임상적 진단이나 치료 목적으로 사용할 수 없습니다.
문의
SDK 도입, 라이선스, 사용 관련 문의는 홈페이지 상단의 ‘문의하기’를 이용해 주세요.
시작하기
pubspec.yaml에 아래 Git 의존성을 추가한 뒤 flutter pub get을 실행합니다.
dependencies:
emoconnect_sdk:
git:
url: https://github.com/NewertDev/EmoConnect-SDK.git
ref: v0.1.0아래 코드는 README에서 검색·연결, 데이터 수신, 측정 시작·정지에 필요한 부분을 발췌한 호출 순서 예시입니다. 앱에서는 시작·정지를 버튼 등 사용자 동작에 연결하고, 수신 처리와 저장을 구현합니다.
최소 사용 코드
import 'package:emoconnect_sdk/emoconnect_sdk.dart';
final sdk = EmoConnect.instance;
final devices = await sdk.scan(timeout: const Duration(seconds: 5))
.firstWhere((list) => list.isNotEmpty);
final device = await sdk.connect(devices.first);
device.samples.listen((samples) {
for (final s in samples) {
// s.ppg: PPG, s.acceleration / s.rotation / s.magnetic: x, y, z
}
});
await device.start();
final result = await device.stop();
await device.disconnect();