オープン機能とは?
オープン機能は、プラットフォームが コードブロック に注入するホスト関数のセットです。コードブロックはこれらの関数を通じて、明示的に許可された操作をチャットページに依頼します——チャットページへ直接アクセスするわけではありません。
オープン機能の関数はすべてコードブロックの中でしか呼び出せません。現在公開中の機能は以下の通りで、それぞれ個別のチュートリアルがあります:
| 関数 | 役割 | チュートリアル | Tavern Helper 互換 |
|---|---|---|---|
setChatInput(text, option?) | ロールプレイ / 指示入力欄にテキストを書き込む | setChatInput:チャット入力欄への書き込み | /setinput(triggerSlash) |
setChatMessages(updates, option?) | グリーティングのバージョンを切り替える | setChatMessages:グリーティングの切り替え | 同名関数 |
オープン機能は今後も拡充され、新しい関数が順次公開されます。
呼び出し方とエラー処理
オープン機能の関数はすべて Promise を返します:成功時は resolve、パラメータ検証エラー・操作失敗・タイムアウト(10 秒)時は reject します。postMessage を自分で組み立てる必要はなく、関数をそのまま呼び出すだけです。
機能ごとに存在チェックを行い、Promise の reject を必ず処理してください:
js
if (typeof window.setChatInput === 'function') {
try {
await window.setChatInput('入力する内容');
} catch (error) {
console.error(error.message);
}
}ヒント
- 呼び出す前に機能チェックを行い、Promise の reject を必ず処理する
- コードブロックの書き方・表示・実行環境の制限は コードブロックとは? を参照