mcpField
C
corebluetooth

corebluetooth

github.com/nonameplum開発1747 回インストール13 週間前に更新
リポジトリ

corebluetooth について

Apple Core Bluetooth開発向けのリファレンススキルです。セントラルとペリフェラルの役割別手順、API検索、ライフサイクル上の制約を扱い、BLE操作の計画と実装を支援します。

主な機能

  1. 01セントラルのワークフローガイド
  2. 02ペリフェラルのワークフローガイド
  3. 03BLE APIとシンボルの検索
  4. 04バックグラウンド処理と状態復元の解説
  5. 05役割別のベストプラクティス

活用シーン

  1. 01ペリフェラルをスキャンして接続するアプリの構築
  2. 02アプリをペリフェラルとしてアドバタイズする設定
  3. 03Bluetoothのバックグラウンド動作と状態復元への対応

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nonameplum/agent-skills --skill corebluetooth

インストール後、Claude Code で/corebluetoothを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

AboutCoreBluetooth.md
BestPracticesforInteractingwithaRemotePeripheralDevice.md
BestPracticesforSettingUpYourLocalDeviceasaPeripheral.md
BluetoothStateRestorationAppReaunchRules.md
corebluetooth.md
CoreBluetoothBackgroundProcessingforiOSApps.md
CoreBluetoothOverview.md
PerformingCommonCentralRoleTasks.md
PerformingCommonPeripheralRoleTasks.md

詳細

Core Bluetooth

何を開くか

  • 概念と役割の概要については、corebluetooth/AboutCoreBluetooth.md と corebluetooth/CoreBluetoothOverview.md を使用します。
  • セントラルのワークフローを手順に沿って確認するには、corebluetooth/PerformingCommonCentralRoleTasks.md を使用します。
  • ペリフェラルのワークフローを手順に沿って確認するには、corebluetooth/PerformingCommonPeripheralRoleTasks.md を使用します。
  • 注意点とベストプラクティスについては、corebluetooth/BestPracticesforInteractingwithaRemotePeripheralDevice.md と corebluetooth/BestPracticesforSettingUpYourLocalDeviceasaPeripheral.md を使用します。
  • バックグラウンドモードとライフサイクルの制約については、corebluetooth/CoreBluetoothBackgroundProcessingforiOSApps.md を使用します。
  • 状態復元時のアプリ再起動ルールについては、corebluetooth/BluetoothStateRestorationAppRelaunchRules.md を使用します。
  • API の概要とシンボル検索については、corebluetooth/corebluetooth.md を使用します。

ワークフロー

  • アプリがセントラル、ペリフェラル、またはその両方として動作するかを確認します。
  • BLE 操作を実行する前に、マネージャーの状態が poweredOn になるまで待ちます。
  • 役割ごとのチェックリストに従い、デバイスの検出と接続の順序を正しく保ちます。
  • まず役割ごとのタスクガイドとベストプラクティスを開き、正確なシグネチャについては API リファレンスを使用します。

セントラルのチェックリスト

  1. デリゲートとキューを指定して CBCentralManager を作成します。
  2. centralManagerDidUpdateState(_:) を処理し、.poweredOn の場合にのみスキャンを開始します。
  3. scanForPeripherals(withServices:options:) でスキャンし、対象が見つかったら停止します。
  4. 接続し、CBPeripheral デリゲートを設定して、サービスとキャラクタリスティックを検出します。
  5. 必要に応じて、キャラクタリスティックの通知を読み取り、書き込み、または購読します。

ペリフェラルのチェックリスト

  1. デリゲートとキューを指定して CBPeripheralManager を作成します。
  2. 状態が .poweredOn になるまで待ちます。
  3. サービスとキャラクタリスティックを定義し、マネージャーに追加します。
  4. サービス UUID と任意のローカル名を指定して、アドバタイズを開始します。
  5. 読み取りと書き込みのリクエストに応答し、購読中のセントラルに更新を通知します。

注意事項

  • 検出した CBPeripheral インスタンスを保持し、解放されないようにします。
  • ストリーミングデータには通知を使用します。レスポンスなしの書き込みは、canSendWriteWithoutResponse が true の場合にのみ使用します。
  • GATT キャラクタリスティックでは対応できない用途に限り、L2CAP を使用します。

コメント

Markdown 対応