com.xrlab.labframe_brainbit 1.0.1

package/.github/workflows/main.yml

@@ -0,0 +1,27 @@
+name: Push to npm
+ 
+on:
+  push: 
+    branches:
+      - master
+      - main
+ 
+jobs:
+  build:
+   runs-on: ubuntu-latest
+   steps:
+   # Checks-out your repository under $GITHUB_WORKSPACE, so your job can access it
+   - uses: actions/checkout@v2
+   # Install Node.js, with the version 12 and using the registry URL of npm, this could be changed to a custom registry or the GitHub registry.
+   - uses: actions/setup-node@v1
+     with:
+       node-version: 12
+       registry-url: https://registry.npmjs.org/
+ 
+   # Command to install the package dependencies
+   - run: yarn install
+   
+   # Publish to npm
+   - run: npm publish --access public
+     env:
+       NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}

package/.github/workflows/main.yml.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: ed7ffa529d231784c97c9306d57f9c47
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Editor/BrainBitPostProcess.cs

@@ -0,0 +1,31 @@
+using UnityEditor;
+using UnityEditor.Callbacks;
+
+#if UNITY_IOS
+using UnityEditor.iOS.Xcode;
+using System.IO;
+#endif
+
+public sealed class BrainBitPostProcessor
+{
+    [PostProcessBuild(1)]
+    public static void OnPostProcessBuild(BuildTarget target, string path)
+    {
+#if UNITY_IOS
+        if (target == BuildTarget.iOS)
+        {
+            var infoPlistPath = Path.Combine(path, "Info.plist");
+            var infoPlist = new PlistDocument();
+            infoPlist.ReadFromFile(infoPlistPath);
+
+            PlistElementDict dict = infoPlist.root.AsDict();
+            dict.SetString("NSBluetoothAlwaysUsageDescription", 
+                "App requires access to Bluetooth to allow you connect to device");
+            dict.SetString("NSBluetoothPeripheralUsageDescription", 
+                "App uses Bluetooth to connect with your Brainbit device");
+
+            infoPlist.WriteToFile(infoPlistPath);
+        }
+#endif
+    }
+}

package/Editor/BrainBitPostProcess.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 85dc6e8141c759241a61fb2a35a4d67e
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Editor.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 0224d21d402208c499ca9a5d1432514e
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 NCU WMLAB
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/LICENSE.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: a696d53fc286ac54e8d916f64ccf6535
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/README.md

@@ -0,0 +1,95 @@
+# LabFrame 2023 - BrainBit Plugin
+
+此套件為 LabFrame 2023 專用的 BrainBit 設備插件，用於連接與管理 BrainBit 腦波儀。
+
+## 支援功能
+1. **設備連線管理：** 自動搜尋並手動觸發連接藍牙 BrainBit 設備。
+2. **EEG 腦波數據收集：** 自動收集四個通道 (T3, T4, O1, O2) 的腦波數據。
+3. **即時阻抗檢查：** 確認電極與頭皮的接觸阻抗值是否過高 (> 200,000Ω)。
+4. **多階段資料分流儲存：** 收集期間可動態切換儲存 Tag（依照遊戲階段無縫寫入不同檔案）。
+
+---
+
+## 基本使用方式
+
+### 1. 手動觸發設備連線
+預設啟動遊戲時**不會**自動連線，需在適當時間點（例如點擊按鈕或進入準備階段時）透過程式碼手動掃描並連線。
+```csharp
+BrainBitManager.Instance.ManualConnect();
+```
+
+---
+
+### 2. 關於 EEG (持續腦波) 的收集方式
+
+#### 👉 開始 / 停止收集
+開始收集時，可傳入對應的遊戲階段 Tag：
+```csharp
+// "Intro_Phase" 將作為存檔檔名的後綴
+BrainBitManager.Instance.StartEEGStream(true, "Intro_Phase");
+
+// 停止收集
+BrainBitManager.Instance.StopEEGStream();
+```
+
+#### 👉 動態無縫切換儲存階段 (Tag)
+當遊戲進入下一個階段時，你**不需**停止收集，只需修改 Tag：
+```csharp
+if (BrainBitManager.Instance.IsStreamingEEG)
+{
+    // 下一毫秒收集的封包，就會被寫進 "Tutorial_Phase" 的檔案中
+    BrainBitManager.Instance.SetEEGTag("Tutorial_Phase");
+}
+```
+
+#### 👉 取得最新的 EEG 值
+若需要在遊戲邏輯中使用即時腦波：
+```csharp
+var eegData = BrainBitManager.Instance.GetLatestEEGData();
+if (eegData != null)
+{
+    Debug.Log($"T3:{eegData.T3} | T4:{eegData.T4} | O1:{eegData.O1} | O2:{eegData.O2}");
+}
+```
+
+---
+
+### 3. 關於 Impedance (阻抗) 的檢測方式
+
+> 阻抗 (Impedance) 資料流與 EEG (腦波) 資料流是**獨立**的。通常在實驗或遊戲開始前，先開啟阻抗檢測確認配戴良好，然後停止阻抗檢測，再開始 EEG 腦波收集。
+
+#### 👉 開啟 / 停止阻抗檢測與修改 Tag (與 EEG 邏輯完全相同)
+```csharp
+// 啟動阻抗數據流並儲存至 "Preparation_Impedance"
+BrainBitManager.Instance.StartImpedanceStream(true, "Preparation_Impedance");
+
+// 也可呼叫這個無縫切換 Tag 
+BrainBitManager.Instance.SetImpedanceTag("Another_Phase_Impedance");
+
+// 停止阻抗流
+BrainBitManager.Instance.StopImpedanceStream();
+```
+
+#### 👉 判斷各通道阻抗是否過高
+在檢測狀態下，呼叫以下的 API 一次取得四個通道的數值與警示結果：
+```csharp
+var data = BrainBitManager.Instance.GetLatestImpedanceData();
+if (data != null)
+{
+    // 直接一次性取得所有數值與 Boolean (檢查是否大於 200,000)
+    var (t3_val, t3_high, t4_val, t4_high, o1_val, o1_high, o2_val, o2_high) = data.GetImpedanceValues();
+
+    if (t3_high)
+        Debug.LogWarning($"T3 沒接好，當前阻抗值: {t3_val}");
+    if (t4_high)
+        Debug.LogWarning($"T4 沒接好，當前阻抗值: {t4_val}");
+}
+```
+
+---
+
+## 平台需求與建置 (Android / iOS)
+
+本套件已內附相關處理機制：
+- **Android：** 必須包含定位 (`ACCESS_FINE_LOCATION`) 與藍牙及掃描 (`BLUETOOTH_CONNECT`, `BLUETOOTH_SCAN` 等) 權限。相關權限已配置在 `Runtime/Plugins/Android/AndroidManifest.xml` 中，Unity 建置時將自動打包。
+- **iOS：** 打包後製腳本 `BrainBitPostProcess.cs` 會自動為 `Info.plist` 加入必要藍牙權限 (`NSBluetoothAlwaysUsageDescription`)。

package/README.md.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 188932e280f293942935c05a53ba02ce
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Plugins/Android/AndroidManifest.xml

@@ -0,0 +1,15 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          xmlns:tools="http://schemas.android.com/tools">
+
+    <uses-permission android:name="android.permission.ACCESS_BACKGROUND_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
+    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
+    <uses-permission android:name="android.permission.BLUETOOTH" android:maxSdkVersion="30" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADMIN" />
+    <uses-permission android:name="android.permission.BLUETOOTH_ADVERTISE" />
+    <uses-permission android:name="android.permission.BLUETOOTH_CONNECT" />
+    <uses-permission android:name="android.permission.BLUETOOTH_SCAN"
+        tools:targetApi="31"
+        android:usesPermissionFlags="neverForLocation" />
+
+</manifest>

package/Runtime/Plugins/Android/AndroidManifest.xml.meta

@@ -0,0 +1,7 @@
+fileFormatVersion: 2
+guid: 2d795f31e57226543990547310ab486c
+TextScriptImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Plugins/Android.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 331151d800deb7545bc70319e8a4356c
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime/Plugins.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 3dfb332a598e99f4caa78a38877c63f3
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Runtime.meta

@@ -0,0 +1,8 @@
+fileFormatVersion: 2
+guid: 6db1f38d3f0bbe24dace8a0e72a63a61
+folderAsset: yes
+DefaultImporter:
+  externalObjects: {}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: 

package/Scripts/BrainBitData.cs

@@ -0,0 +1,187 @@
+using UnityEngine;
+using System.Collections;
+using System.Collections.Generic;
+using LabFrame2023;
+using System;
+
+/// <summary>
+/// BrainBit EEG 數據
+/// </summary>
+[Serializable]
+public class BrainBit_EEGData : LabDataBase
+{
+    /// <summary>
+    /// T3 通道 EEG 值
+    /// </summary>
+    public double T3;
+
+    /// <summary>
+    /// T4 通道 EEG 值
+    /// </summary>
+    public double T4;
+
+    /// <summary>
+    /// O1 通道 EEG 值
+    /// </summary>
+    public double O1;
+
+    /// <summary>
+    /// O2 通道 EEG 值
+    /// </summary>
+    public double O2;
+
+    /// <summary>
+    /// 所有 EEG 值的列表 (T3, T4, O1, O2)
+    /// </summary>
+    public List<double> EEGValues => new List<double>() { T3, T4, O1, O2 };
+
+    public BrainBit_EEGData() : base() { }
+
+    public BrainBit_EEGData(double t3, double t4, double o1, double o2) : base()
+    {
+        T3 = t3;
+        T4 = t4;
+        O1 = o1;
+        O2 = o2;
+    }
+
+    public override string ToString()
+    {
+        return $"T3: {T3:N4} | T4: {T4:N4} | O1: {O1:N4} | O2: {O2:N4}";
+    }
+}
+
+/// <summary>
+/// BrainBit 阻抗數據
+/// </summary>
+[Serializable]
+public class BrainBit_ImpedanceData : LabDataBase
+{
+    /// <summary>
+    /// T3 通道阻抗值
+    /// </summary>
+    public double T3;
+
+    /// <summary>
+    /// T4 通道阻抗值
+    /// </summary>
+    public double T4;
+
+    /// <summary>
+    /// O1 通道阻抗值
+    /// </summary>
+    public double O1;
+
+    /// <summary>
+    /// O2 通道阻抗值
+    /// </summary>
+    public double O2;
+
+    /// <summary>
+    /// 所有阻抗值的列表 (T3, T4, O1, O2)
+    /// </summary>
+    public List<double> ImpedanceValues => new List<double>() { T3, T4, O1, O2 };
+
+    public BrainBit_ImpedanceData() : base() { }
+
+    public BrainBit_ImpedanceData(double t3, double t4, double o1, double o2) : base()
+    {
+        T3 = t3;
+        T4 = t4;
+        O1 = o1;
+        O2 = o2;
+    }
+
+    /// <summary>
+    /// 檢查所有通道阻抗是否皆正常(小於閾值)
+    /// </summary>
+    public bool IsImpedanceGood
+    {
+        get
+        {
+            double threshold = 200000.0;
+            return T3 < threshold && T4 < threshold && O1 < threshold && O2 < threshold;
+        }
+    }
+
+    /// <summary>
+    /// 一次取得各通道數值以及各通道是否阻抗過高(大於200,000)
+    /// </summary>
+    /// <returns>(T3數值, T3太高?, T4數值, T4太高?, O1數值, O1太高?, O2數值, O2太高?)</returns>
+    public (double t3_val, bool t3_high, double t4_val, bool t4_high, double o1_val, bool o1_high, double o2_val, bool o2_high) GetImpedanceValues()
+    {
+        double threshold = 200000.0;
+        return (
+            T3, T3 > threshold,
+            T4, T4 > threshold,
+            O1, O1 > threshold,
+            O2, O2 > threshold
+        );
+    }
+
+    /// <summary>
+    /// 獲取阻抗狀態描述
+    /// </summary>
+    /// <param name="threshold">阻抗警告閾值</param>
+    /// <returns>阻抗狀態字符串</returns>
+    public string GetImpedanceStatus(double threshold = 200000.0)
+    {
+        var status = new List<string>();
+        if (T3 > threshold) status.Add("T3");
+        if (T4 > threshold) status.Add("T4");
+        if (O1 > threshold) status.Add("O1");
+        if (O2 > threshold) status.Add("O2");
+
+        if (status.Count == 0)
+            return "All channels good";
+        else
+            return $"High impedance: {string.Join(", ", status)}";
+    }
+
+    public override string ToString()
+    {
+        return $"T3: {T3:N0}Ω | T4: {T4:N0}Ω | O1: {O1:N0}Ω | O2: {O2:N0}Ω";
+    }
+}
+
+/// <summary>
+/// BrainBit 連接狀態數據
+/// </summary>
+[Serializable]
+public class BrainBit_ConnectionData : LabDataBase
+{
+    /// <summary>
+    /// 連接狀態
+    /// </summary>
+    public bool IsConnected;
+
+    /// <summary>
+    /// 設備名稱
+    /// </summary>
+    public string DeviceName;
+
+    /// <summary>
+    /// 設備地址
+    /// </summary>
+    public string DeviceAddress;
+
+    /// <summary>
+    /// 連接/斷開時間戳
+    /// </summary>
+    public string EventType; // "Connected" or "Disconnected"
+
+    public BrainBit_ConnectionData() : base() { }
+
+    public BrainBit_ConnectionData(bool isConnected, string deviceName, string deviceAddress, string eventType) : base()
+    {
+        IsConnected = isConnected;
+        DeviceName = deviceName;
+        DeviceAddress = deviceAddress;
+        EventType = eventType;
+    }
+
+    public override string ToString()
+    {
+        return $"{EventType}: {DeviceName} ({DeviceAddress}) - Connected: {IsConnected}";
+    }
+}

package/Scripts/BrainBitData.cs.meta

@@ -0,0 +1,11 @@
+fileFormatVersion: 2
+guid: 9ee0213436b29314eb44951c6825aa25
+MonoImporter:
+  externalObjects: {}
+  serializedVersion: 2
+  defaultReferences: []
+  executionOrder: 0
+  icon: {instanceID: 0}
+  userData: 
+  assetBundleName: 
+  assetBundleVariant: