คู่มือ JBand V4 SDK

// หลังจากเชื่อมต่อสำเร็จ
await sendCommand(BleSDK.SetDeviceTime(DateTime.now()));  // 0x01
await sendCommand(BleSDK.GetDeviceBatteryLevel());        // 0x13
await sendCommand(BleSDK.GetDeviceVersion());             // 0x27
await sendCommand(BleSDK.GetDeviceMacAddress());          // 0x22

// เสริม: ตั้งค่าโปรไฟล์ผู้ใช้เพื่อคำนวณแคลอรี่ให้แม่นยำ
await sendCommand(BleSDK.SetPersonalInfo(MyPersonalInfo(
  sex: 1,        // 1=ชาย, 0=หญิง
  age: 30,
  height: 175,   // ซม.
  weight: 70,    // กก.
)));

วิธีการทำงาน: เปิดการสตรีม → อุปกรณ์ส่งข้อมูลต่อเนื่อง → แยกวิเคราะห์และแสดงผล

ตัวเลือกที่ 1: การสตรีมกิจกรรมต่อเนื่อง

คำสั่ง	รหัส	ข้อมูลที่ส่งมา
RealTimeStep(true, true)	0x09	จำนวนก้าว, แคลอรี่, ระยะทาง, อัตราการเต้นของหัวใจ, อุณหภูมิ (ต่อเนื่อง)

// เริ่มการสตรีมแบบเรียลไทม์
await sendCommand(BleSDK.RealTimeStep(true, true));  // enable, tempEnable

// อุปกรณ์ส่งการตอบกลับ 0x09 ต่อเนื่อง:
// โครงสร้างการตอบกลับ (24+ ไบต์):
// [0]     = 0x09 (คำสั่ง)
// [1-4]   = จำนวนก้าว (int32, little-endian)
// [5-8]   = แคลอรี่ (int32, /100 สำหรับ kcal)
// [9-12]  = ระยะทาง (int32, /100 สำหรับเมตร)
// [13-16] = ระยะเวลา (วินาที)
// [17-20] = เวลาที่ใช้งาน
// [21]    = อัตราการเต้นของหัวใจ (BPM) ← สำคัญ!
// [22-23] = อุณหภูมิ (raw/10 = °C)

void onDataReceived(List<int> data) {
  if (data[0] == 0x09) {
    final steps = _parseInt32(data, 1);
    final calories = _parseInt32(data, 5) / 100.0;
    final heartRate = data[21];  // BPM
    final temp = (data[22] + (data[23] << 8)) / 10.0;  // °C

    updateUI(steps: steps, hr: heartRate, temp: temp, cal: calories);
  }
}

// หยุดการสตรีม
await sendCommand(BleSDK.stopGo());

ตัวเลือกที่ 2: การวัดเมื่อต้องการ

การวัด	ประเภท	ระยะเวลา	คำสั่ง
SpO2 (ออกซิเจนในเลือด)	3	~30 วินาที	0x28
อัตราการเต้นของหัวใจ	2	~15 วินาที	0x28
HRV	1	~60 วินาที	0x28
อุณหภูมิ	4	~10 วินาที	0x28

// เริ่มการวัด SpO2
await sendCommand(BleSDK.HealthMeasurementWithDataType(3, true));

// รอการเรียกกลับ (MeasurementOxygenCallback = "65")
// การตอบกลับมีเปอร์เซ็นต์ SpO2

// หยุดการวัด
await sendCommand(BleSDK.HealthMeasurementWithDataType(3, false));

ค่าขั้นตอนการนอน

ค่า	ขั้นตอน	สีที่แนะนำ
0	ตื่น	🟠 ส้ม
1	นอนไม่ลึก	🔵 น้ำเงินอ่อน
2	นอนหลับลึก	🟣 น้ำเงินเข้ม
3	นอน REM	🟣 ม่วง

ดึงข้อมูลการนอน

// คำสั่ง: 0x53 | โหมด: 0=ล่าสุด, 2=ต่อ, 99=ลบ
Future<List<SleepRecord>> fetchAllSleepData() async {
  List<Map> allRecords = [];
  bool hasMore = true;
  int mode = 0;  // เริ่มจากล่าสุด

  while (hasMore) {
    await sendCommand(BleSDK.GetDetailSleepDataWithMode(mode));
    final response = await waitForResponse(0x53);

    // โครงสร้างการตอบกลับ:
    // DataType: "26" (GetDetailSleepData)
    // End: true/false
    // Data: { date, arraySleepQuality, sleepUnitLength }

    allRecords.addAll(response['Data']);
    hasMore = response['End'] != true;
    mode = 2;  // โหมดต่อ
  }
  return allRecords.map((r) => SleepRecord.fromMap(r)).toList();
}

แยกวิเคราะห์และวิเคราะห์การนอน

class SleepRecord {
  final String date;           // "2025-12-10 23:30:00"
  final List<int> stages;     // [1, 1, 2, 2, 2, 1, 0, ...]
  final int unitMinutes;       // 5 หรือ 1 (ความยาวช่วงเวลา)

  // คุณสมบัติที่คำนวณ
  int get totalMinutes => stages.length * unitMinutes;
  String get duration => '${totalMinutes ~/ 60}ชม ${totalMinutes % 60}นาที';

  int get deepMinutes => stages.where((s) => s == 2 || s == 3).length * unitMinutes;
  int get lightMinutes => stages.where((s) => s == 1).length * unitMinutes;
  int get awakeMinutes => stages.where((s) => s == 0).length * unitMinutes;

  int get efficiency => totalMinutes > 0
      ? ((totalMinutes - awakeMinutes) / totalMinutes * 100).round()
      : 0;

  String get quality {
    if (efficiency >= 85) return 'ยอดเยี่ยม';
    if (efficiency >= 70) return 'ดี';
    if (efficiency >= 50) return 'ปานกลาง';
    return 'ไม่ดี';
  }
}

// สร้างการแสดงผลไทม์ไลน์การนอน
Widget buildSleepTimeline(List<int> stages) {
  return Row(
    children: stages.map((stage) => Expanded(
      child: Container(
        height: 20,
        color: _getStageColor(stage),
      ),
    )).toList(),
  );
}

Color _getStageColor(int stage) {
  switch (stage) {
    case 0: return Colors.orange;      // ตื่น
    case 1: return Colors.lightBlue;   // ไม่ลึก
    case 2: return Colors.indigo;      // ลึก
    case 3: return Colors.purple;      // REM
    default: return Colors.grey;
  }
}

โครงสร้างข้อมูลการตอบกลับ

รูปแบบ	ไบต์	ช่วงเวลา	ระยะเวลาสูงสุด
34 ไบต์	[3-8]=วันที่, [9]=ความยาว, [10-33]=ขั้นตอน	5 นาที	~2 ชั่วโมง/ระเบียน
130 ไบต์	[3-8]=วันที่, [9]=ความยาว, [10-129]=ขั้นตอน	1 นาที	~2 ชั่วโมง/ระเบียน

ประเภทโหมดกีฬา

โหมด	ชื่อ	โหมด	ชื่อ	โหมด	ชื่อ
0	เดิน	4	ว่ายน้ำ	8	กระโดดเชือก
1	วิ่ง	5	บาสเก็ตบอล	9	โยคะ
2	ปั่นจักรยาน	6	ฟุตบอล	10	เครื่องเยียว
3	เดินป่า	7	แบดมินตัน	11	พายเรือ

เริ่มเซสชันการออกกำลังกาย

// เริ่มโหมดการออกกำลังกาย
await sendCommand(BleSDK.EnterActivityMode(
  1,  // activityMode: 1=วิ่ง
  1   // workMode: 1=เริ่ม
));

// สำคัญ: ส่ง heartbeat ทุก 1 วินาทีเพื่อรักษาเซสชัน!
Timer.periodic(Duration(seconds: 1), (timer) async {
  if (!isExercising) {
    timer.cancel();
    return;
  }
  await sendCommand(BleSDK.sendHeartPackage(
    currentDistance,  // float: ระยะทางรวม
    elapsedSeconds,   // int: ระยะเวลา
    rssi              // int: ความแรงสัญญาณ
  ));
});

// อุปกรณ์ส่งการตอบกลับ 0x18 พร้อมอัตราการเต้นหัวใจแบบเรียลไทม์ระหว่างการออกกำลังกาย
void onDataReceived(List<int> data) {
  if (data[0] == 0x18) {
    final heartRate = data[1];
    final steps = _parseInt32(data, 2);
    final calories = _parseFloat(data, 6);
    final duration = _parseInt32(data, 10);
    updateWorkoutUI(hr: heartRate, steps: steps, cal: calories);
  }
}

// หยุดการออกกำลังกาย
await sendCommand(BleSDK.EnterActivityMode(1, 0));  // workMode: 0=หยุด

ดึงประวัติการออกกำลังกาย

// คำสั่ง: 0x5C | ระเบียน: 25 ไบต์แต่ละระเบียน
final records = await fetchHistory(BleSDK.GetActivityModeDataWithMode);

// ฟิลด์การตอบกลับต่อระเบียน:
// date, mode, modeName, heartRate, durationMinutes, steps, pace, calories, distance

records.forEach((r) {
  print('${r['date']}: ${r['modeName']} - ${r['durationMinutes']}นาที, '
        '${r['steps']} ก้าว, อัตราการเต้นหัวใจเฉลี่ย ${r['heartRate']}');
});

ประเภทประวัติที่มี

ข้อมูล	รหัส	เมธอด SDK	ระเบียน	การเก็บ
จำนวนก้าวรายวัน	0x51	GetTotalActivityDataWithMode	27 ไบต์	~14 วัน
จำนวนก้าวรายละเอียด	0x52	GetDetailActivityDataWithMode	25 ไบต์	~7 วัน
การนอน	0x53	GetDetailSleepDataWithMode	34/130 ไบต์	~14 คืน
อัตราการเต้นหัวใจ	0x54	GetDynamicHRWithMode	24 ไบต์	~7 วัน
อัตราการเต้นหัวใจเดี่ยว	0x55	GetStaticHRWithMode	10 ไบต์	แตกต่างกัน
การทดสอบ HRV	0x56	GetHRVDataWithMode	15 ไบต์	แตกต่างกัน
การออกกำลังกาย	0x5C	GetActivityModeDataWithMode	25 ไบต์	~20 เซสชัน
ออกซิเจนในเลือด	0x60	GetBloodOxygen	10 ไบต์	แตกต่างกัน
อุณหภูมิ	0x62	GetTemperature_historyDataWithMode	11 ไบต์	แตกต่างกัน

รูปแบบการซิงค์ทั่วไป

// ฟังก์ชันดึงประวัติที่ใช้ซ้ำได้
Future<List<Map>> fetchHistory(Uint8List Function(int) cmdBuilder) async {
  List<Map> allRecords = [];
  bool hasMore = true;
  int mode = 0;  // 0=ล่าสุด, 2=ต่อ, 99=ลบ

  while (hasMore) {
    await sendCommand(cmdBuilder(mode));
    final response = await waitForResponse();

    if (response['Data'] != null) {
      allRecords.addAll(response['Data'] as List);
    }
    hasMore = response['End'] != true;
    mode = 2;  // ดึงข้อมูลต่อ

    await Future.delayed(Duration(milliseconds: 200));  // จำกัดอัตรา
  }
  return allRecords;
}

// ตัวอย่างการใช้งาน:
final sleepData = await fetchHistory(BleSDK.GetDetailSleepDataWithMode);
final hrData = await fetchHistory(BleSDK.GetDynamicHRWithMode);
final stepData = await fetchHistory(BleSDK.GetTotalActivityDataWithMode);
final workouts = await fetchHistory(BleSDK.GetActivityModeDataWithMode);

กลยุทธ์การซิงค์เบื้องหลัง

// กำหนดการซิงค์เป็นระยะด้วย WorkManager
await Workmanager().registerPeriodicTask(
  'health-sync',
  'syncHealthData',
  frequency: Duration(hours: 1),
  constraints: Constraints(
    networkType: NetworkType.connected,
    requiresBatteryNotLow: true,
  ),
);

// หรือซิงค์เวลานอน (03:00 น. รายวัน)
await Workmanager().registerOneOffTask(
  'sleep-sync',
  'syncSleepData',
  initialDelay: _getDelayUntil3AM(),
);

ประเภทการแจ้งเตือน

ประเภท	ค่า	ประเภท	ค่า
สายโทรศัพท์	0	Twitter	7
WeChat	1	VK	8
SMS	2	WhatsApp	9
Facebook	3	หยุดสายโทร	0xFF
Telegram	4

// ส่งการแจ้งเตือนไปยังอุปกรณ์ (สูงสุด 60 ไบต์ข้อความ)
await sendCommand(BleSDK.setNotifyData(Notifier(
  type: Notifier.Data_WhatApp,  // 9
  info: 'ข้อความใหม่จาก John'
)));

// การแจ้งเตือนสายโทรเข้า
await sendCommand(BleSDK.setNotifyData(Notifier(
  type: Notifier.Data_Tel,  // 0
  info: 'แม่'
)));

// หยุดสายโทรเข้า (ผู้ใช้ปฏิเสธ/รับ)
await sendCommand(BleSDK.setNotifyData(Notifier(
  type: Notifier.Data_Stop_Tel,  // 0xFF
  info: ''
)));

// กระตุ้นการสั่น (เช่น สำหรับการเตือนแบบกำหนดเอง)
await sendCommand(BleSDK.MotorVibrationWithTimes(3));  // สั่น 3 ครั้ง

ตั้งค่าการปลุก

// ตั้งค่าการปลุกได้สูงสุด 5 รายการ
final alarms = [
  Clock(
    number: 0,
    type: 1,           // 1=ปกติ, 2=ยา, 3=น้ำ
    hour: 7, minute: 30,
    weeks: ['0','1','1','1','1','1','0'],  // จันทร์-ศุกร์
    content: 'ตื่นนอน',
    enable: true,
  ),
];
await sendCommand(BleSDK.setClockData(alarms));

// อ่านการปลุก
await sendCommand(BleSDK.GetAlarmClock(0));  // 0=อ่าน, 99=ลบทั้งหมด

// ลบการปลุกทั้งหมด
await sendCommand(BleSDK.deleteAllClock());

ตั้งค่าเป้าหมายจำนวนก้าว

await sendCommand(BleSDK.SetStepGoal(10000));  // 10,000 ก้าว
final goal = await sendCommand(BleSDK.GetStepGoal());

การตรวจสอบอัตราการเต้นหัวใจอัตโนมัติ

// กำหนดการวัดอัตราการเต้นหัวใจอัตโนมัติ
await sendCommand(BleSDK.SetAutomaticHRMonitoring(MyAutomaticHRMonitoring(
  open: 2,           // 0=ปิด, 1=ต่อเนื่อง, 2=ช่วงเวลา
  startHour: 8, startMinute: 0,
  endHour: 22, endMinute: 0,
  week: 127,         // ทุกวัน (pow(2,0)+pow(2,1)+...+pow(2,6))
  time: 30,          // ทุก 30 นาที
  type: 1,           // 1=HR, 2=SpO2, 3=Temp, 4=HRV
)));

// อ่านการตั้งค่าปัจจุบัน
await sendCommand(BleSDK.GetAutomaticHRMonitoring(1));  // type=1 สำหรับ HR

การเตือนการนั่งเป็นเวลานาน

await sendCommand(BleSDK.SetSedentaryReminder(MySedentaryReminder(
  startHour: 9, startMinute: 0,
  endHour: 18, endMinute: 0,
  week: 62,          // จันทร์-ศุกร์ (pow(2,1)+...+pow(2,5))
  intervalTime: 60,  // เตือนทุก 60 นาที
  leastStep: 100,    // ข้ามถ้าผู้ใช้เดิน 100+ ก้าว
  enable: true,
)));