CarbSens アプリ間インテント連携仕様書
（APIドキュメント）

本仕様書は、外部のアプリケーションからAndroidのインテント（Intent）機能／ iPhoneのURL scheme機能を活用し、CarbSensの高度な脈波解析エンジンをダイレクトに呼び出して利用するための開発者向けドキュメントです。

iPhone URLScheme アプリ連携はこちら

【🛍️ パターン1】データ持ち込み型連携 仕様

外部アプリからCarbSensアプリへ、端末内のRAM（メモリ）上で直接CSV形式の脈波データを引き渡します（ファイル保存は不要です）。CarbSensアプリは待機状態から自動復帰し、データをサーバーへアップロードして解析を開始します。

🛍️1. インテント仕様（送信側実装）

• アクション名（Action）: com.carbsens.action.ANALYZE_PPG
• ターゲットパッケージ名: 貴社のCarbSensアプリのパッケージ名
• Intentフラグ（Flags）: Intent.FLAG_ACTIVITY_NEW_TASK
  ※ターゲットがすでにバックグラウンドにいる場合、既存タスクのまま最前面に復帰させます。

添付データ（Intent Extras）

🛍️ 2. 送信側（貴社アプリ）の実装コード例 (Kotlin)。

val finalCsvString = "830400563245156352,-300909,0,0,0\n830400563250838144,-301048,0,0,0\n..."

val intent = Intent("com.carbsens.action.ANALYZE_PPG").apply {
    addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
    //setPackage("com.carbsensのアプリアプリパッケージ名") // ターゲット制限

    // メモリ（String）でCSVデータを直接渡す
    putExtra("EXTRA_CSV_TEXT", finalCsvString) 
    // サンプリング周波数を指定（CarbSens側で自動調整します）
    putExtra("EXTRA_SAMPLING_RATE", 200) 
    // 識別用のファイル名
    //putExtra("EXTRA_FILE_NAME", "PolarPPG_Measurement.csv")
}

try {
    startActivity(intent)
} catch (e: ActivityNotFoundException) {
    // CarbSensアプリがインストールされていない場合の処理
}

🛍️ 3. 受信側（貴社アプリ）の受け取り実装例 (Kotlin)

CarbSensアプリ側では、インテントを検知した際に以下のロジックでメモリ（String）から直接CSVデータを復元し、指定されたサンプリング周波数（Hz）を元に自動調整を行ってから解析へ進みます。
解析結果を戻します。

      // ★★★ 自動受信はここに書く ★★★
        if (intent?.action == "com.sendtocarb.action.RESULT") {
            Log.d("SendToCarb", "Intent CALLED, action=${intent?.action}")
            val result = intent.getStringExtra("result_text") ?: "No result"
            resultTextView.text = result
        }

}

🛍️ 4. 推奨する入力データ構造 (EXTRA_CSV_TEXT)

• フォーマット: カンマ区切り（CSV形式、改行 \n）
• 列構成: [タイムスタンプ],[計算済みの脈波値],0,0,0
• データの軽量化について:
  あらかじめ貴社アプリ側で不要な環境光成分などを差し引いた「計算済みの値」のみを2列目に格納し、3〜5列目を 0 で固定（間引き）していただくことで、転送サイズを大幅に削減（100KB以下推奨）でき、超高速な解析が可能となります。

【🚀 パターン2】直接測定依頼型連携 仕様

外部アプリ内の「測定開始」ボタン等からインテントを発行し、CarbSensアプリを直接呼び出してその場で新規測定を自動で開始させます。貴社側で脈波データを保持・加工する必要がないため、最も手軽に機能を統合できます。

🚀 1. インテント仕様（送信側実装）

• アクション名（Action）: com.carbsens.action.START_MEASUREMENT
• ターゲットパッケージ名: 貴社のCarbSensアプリのパッケージ名
• Intentフラグ（Flags）: Intent.FLAG_ACTIVITY_NEW_TASK

🚀 2. 送信側（貴社アプリ）の実装コード例 (Kotlin)

sendMeasureButton.setOnClickListener {
    val intent = Intent("com.carbsens.action.START_MEASUREMENT").apply {
        addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
        setPackage("貴社のCarbSensアプリのパッケージ名")
    }
    try {
        startActivity(intent)
    } catch (e: ActivityNotFoundException) {
        // CarbSensアプリが未インストールの場合の処理
    }
}

🚀 3. 受信側（CarbSensアプリ）の挙動

CarbSensアプリは launchMode="singleTask"（または singleTop）でバックグラウンドから復帰するため、既存のタスク状態を維持したまま最前面に表示されます。アクション（START_MEASUREMENT）を検知すると、ユーザーの操作を挟むことなく自動的に新規測定と解析リクエストを実行します。

📱 CarbSens URL Scheme 連携 仕様書（最小版）

本本仕様書は、外部アプリケーションから CarbSens iOS アプリを URL Scheme で直接呼び出すための最小限の技術仕様 です。 Intent を持たない iOS において、Android 版の パターン1 / パターン2 に相当する連携を URL Scheme で実現します

🛍️ パターン1：データ持ち込み型 URL Scheme

■ URL Scheme（呼び出し形式）

carbsens://process?
    csv=<URLエンコード済みCSV文字列>&
    samplingHz=<サンプリング周波数Hz>&
    bodyPart=<測定部位名>

■ パラメータ仕様

■ CSV データ構造（Android と同一）

[timestamp],[ppg_processed],0,0,0\n

• 2列目に 環境光除去済みの脈波値
• 3〜5列目は 0 固定（軽量化のため）

■ コード例

//let csv = "timestamp,123,0,0,0\n..."

   // ★ メモリ渡し（UIPasteboard）版 ★
    func sendToCarbSens(csv: String) {

        // ① CSV をメモリ（UIPasteboard）に保存
        UIPasteboard.general.string = csv
        print("CSV を UIPasteboard に保存しました")

        // ② CarbSens を起動し、source=pasteboard を渡す
        let callback = "sendtocarb://result"
            .addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? ""

        // ★ 追加：部位とサンプリング周波数
        let bodyPart = "右手平".addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? ""
        let samplingHz = "180"

        let urlString =
            "carbsens://process?callback=\(callback)&source=pasteboard&bodyPart=\(bodyPart)&samplingHz=\(samplingHz)"


        if let url = URL(string: urlString) {
            UIApplication.shared.open(url)
        } else {
            print("URL 作成失敗:", urlString)
        }
    }

🚀 パターン2：直接測定依頼型 URL Scheme

■ コード例

    // CarbSens を単に起動する
    func openCarbSens() {
        let callback = "sendtocarb://result"
            .addingPercentEncoding(withAllowedCharacters: .urlQueryAllowed) ?? ""

        let urlString = "carbsens://process?callback=\(callback)"

        if let url = URL(string: urlString) {
            UIApplication.shared.open(url)
        } else {
            print("URL 作成失敗:", urlString)
        }
    } 

CarbSens アプリが起動し、即座に新規測定を開始します。
外部アプリ側でデータ保持は不要です。

🧩 Android Intent 仕様との対応表

CarbSens 技術連携について問い合わせる