Skip to content

オープン機能とは?

オープン機能は、プラットフォームが コードブロック に注入するホスト関数のセットです。コードブロックはこれらの関数を通じて、明示的に許可された操作をチャットページに依頼します——チャットページへ直接アクセスするわけではありません。

オープン機能の関数はすべてコードブロックの中でしか呼び出せません。現在公開中の機能は以下の通りで、それぞれ個別のチュートリアルがあります:

関数役割チュートリアル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 を必ず処理する
  • コードブロックの書き方・表示・実行環境の制限は コードブロックとは? を参照