spectrum

Spectrum

Spectrum は、Photon の統合メッセージング SDK です。app.messages ストリームに対してハンドラーロジックを記述し、iMessage、WhatsApp Business、Terminal、またはカスタムプロバイダーを通じて配信できます。このスキルの対象は spectrum-ts 12.2.0 です。コードサンプルには TypeScript を使用しています。

契約の確認

プロバイダー固有のコードを書く前に、プロバイダーを特定し、そのトピックファイルを読み込んでください。サンプルが完全とみなされるのは、すべてのインポート、メソッド、コンテンツの形式、プラットフォーム ID、フォールバック、スローされるエラーが spectrum-ts 12.2.0 と選択したプロバイダーの契約に準拠している場合に限ります。共通メソッドが存在していても、すべてのプロバイダーがそれを実装しているとは限りません。サポート状況が正確性に関わる場合は、capability-semantics.md を読んでください。

このスキルの構成

各トピックは、このディレクトリ内の個別ファイルに記載されています。ユーザーの質問に関連するファイルを読んでください。

ファイル	参照するタイミング
getting-started.md	インストール、Spectrum() アプリインスタンス、マルチプラットフォームのセットアップ、4 つのコアプリミティブ。
messages.md	メッセージの受信、Message の形式、content.type による絞り込み、自分自身のメッセージのフィルタリング。
content.md	送信メッセージ用のコンテンツビルダー：text、markdown、attachment、voice、contact、richlink、app、poll、group、custom。
spaces-and-users.md	Space インターフェース、入力中インジケーター、responding、DM とグループの作成。
reactions-and-replies.md	message.react(...)、スレッド形式の message.reply(...)、それぞれの使い分け。
capability-semantics.md	ネイティブサポートとフォールバック、警告してスキップ、受け付けるだけの何もしない処理、スローされるエラー。
platform-narrowing.md	汎用 Spectrum プリミティブからプラットフォーム固有の型を復元する方法。
providers/imessage.md	iMessage — クラウド／ローカルの個別プロバイダー、共有／専用クラウド回線モデル、電話番号ごとのルーティング、メッセージエフェクト、Tapback。
providers/terminal.md	Terminal TUI プロバイダー — チャットサイドバー、リアクション、返信、添付ファイル、スラッシュコマンド。
providers/whatsapp-business.md	WhatsApp Business Cloud API。1 対 1 のみ。
custom-events-and-lifecycle.md	プロバイダーごとのイベントストリーム（app.typing など）、app.stop()、シグナル処理。
custom-platforms.md	definePlatform を使った独自プロバイダーの作成 — フィールドの完全なリファレンス。
best-practices.md	Photon が内部で使用している本番環境向けアーキテクチャパターン — デバウンスパイプライン、処理中のキャンセル、引き継ぎ、冪等な再試行、リソースごとのメモリ、ジョブ失敗監査ログ。

関連項目

• Spectrum のドキュメント
• GitHub の spectrum-ts