ノードのトラブルシューティング
ステータス上でノードは表示されているが、ノードツールが失敗する場合は、このページを使用してください。コマンドラダー
- ノードが接続され、役割
nodeに対してペアリングされています。 nodes describeに、呼び出している機能が含まれています。- 実行承認に、期待されるモード / 許可リストが表示されています。
フォアグラウンド要件
canvas.*、camera.*、screen.* は、iOS/Android ノードではフォアグラウンド専用です。
簡易チェックと修正:
NODE_BACKGROUND_UNAVAILABLE が表示される場合は、ノードアプリをフォアグラウンドにして再試行してください。
権限マトリクス
| Capability | iOS | Android | macOS ノードアプリ | 典型的な失敗コード |
|---|---|---|---|---|
camera.snap、camera.clip | カメラ（クリップ音声用にマイク） | カメラ（クリップ音声用にマイク） | カメラ（クリップ音声用にマイク） | *_PERMISSION_REQUIRED |
screen.record | 画面収録（マイクは任意） | 画面キャプチャのプロンプト（マイクは任意） | 画面収録 | *_PERMISSION_REQUIRED |
location.get | 使用中または常に許可（モードに依存） | モードに基づくフォアグラウンド/バックグラウンド位置情報 | 位置情報の権限 | LOCATION_PERMISSION_REQUIRED |
system.run | 該当なし（ノードホストのパス） | 該当なし（ノードホストのパス） | 実行承認が必要 | SYSTEM_RUN_DENIED |
ペアリングと承認の違い
これらは異なるゲートです。- デバイスのペアリング: このノードはゲートウェイに接続できますか。
- 実行承認: このノードは特定のシェルコマンドを実行できますか。
system.run が失敗した場合、 exec approvals/allowlist を修正します。
一般的なノードのエラーコード
NODE_BACKGROUND_UNAVAILABLE→ アプリがバックグラウンドです。フォアグラウンドにしてください。CAMERA_DISABLED→ ノード設定でカメラのトグルが無効です。*_PERMISSION_REQUIRED→ OS の権限が不足または拒否されています。LOCATION_DISABLED→ 位置情報モードがオフです。LOCATION_PERMISSION_REQUIRED→ 要求された位置情報モードが付与されていません。LOCATION_BACKGROUND_UNAVAILABLE→ アプリがバックグラウンドですが、「使用中のみ」の権限しかありません。SYSTEM_RUN_DENIED: approval required→ 実行リクエストに明示的な承認が必要です。SYSTEM_RUN_DENIED: allowlist miss→ コマンドが許可リストモードによりブロックされています。
迅速な復旧ループ
- デバイスのペアリングを再承認します。
- ノードアプリを再度開きます（フォアグラウンド）。
- OS の権限を再付与します。
- 実行承認ポリシーを再作成 / 調整します。