KRD 音声出力（音声合成） - KRD_MZ_VoiceOutput.js

シェア用テキスト：

▼KRD 音声出力（音声合成）（くろうど様作） - KRD_MZ_VoiceOutput.js
https://plugin-mz.fungamemake.com/archives/6278
音声出力（音声合成）

ふりがな：おんせいしゅつりょく（おんせいごうせい）

機能概要： 音声出力（音声合成）

利用規約（ライセンス）： MITライセンス

作者：くろうど

作者サイト：https://x.com/kuroudo119/

解説ページ：https://github.com/kuroudo119/RPGMZ-Plugin

ダウンロードページ：https://raw.githubusercontent.com/kuroudo119/RPGMZ-Plug…

ファイル名：KRD_MZ_VoiceOutput.js

プラグインのヘルプ：

*:
 * @target MZ
 * @plugindesc 音声出力（音声合成）
 * @author くろうど（kuroudo119）
 * @url https://github.com/kuroudo119/RPGMZ-Plugin
 * 
 * @param OPTION_SPEAK_VOLUME
 * @text 音声合成音量オプション
 * @desc 音声合成の音量をオプションに追加します。追加しない場合は文字を消してください。
 * @default 合成音量
 * 
 * @param DEFAULT_SPEAK
 * @text 音声合成音量既定値
 * @desc 音声合成音量のデフォルト値（0 ～ 100）。初期値：100
 * @default 100
 * @type number
 * @max 100
 * 
 * @param AUTO_CANCEL
 * @text メッセージ自動キャンセル
 * @desc 「文章の表示」を閉じる時に音声合成の再生を終了します。
 * @default true
 * @type boolean
 * 
 * @param AUTO_CANCEL_SCROLL
 * @text スクロール自動キャンセル
 * @desc 「文章のスクロール表示」を閉じる時に音声合成の再生を終了します。
 * @default true
 * @type boolean
 * 
 * @param BUTTON_IOS
 * @text iPhone用ボタン表示
 * @desc iPhoneの場合に「iPhone用ボタン」を表示します。ユーザーが押すと音声合成が利用可能になります。
 * @default true
 * @type boolean
 * 
 * @param BUTTON_IOS_TEXT
 * @text iPhone用ボタン文字列
 * @desc 「iPhone用ボタン」を表示する文字列です。
 * @default 音声合成を使う
 * @parent BUTTON_IOS
 * 
 * @param MESSAGE_TOUCH
 * @text メッセージ送り対処
 * @desc メッセージ表示中の入力処理を変更し、プラグインパラメータ「長押し時間」を使います。
 * @default true
 * @type boolean
 * 
 * @param KEY_REPEAT
 * @text 長押し時間
 * @desc 長押し扱いになる時間。システム値:24、プラグイン初期値:48
 * @default 48
 * @type number
 * @parent MESSAGE_TOUCH
 * 
 * @param AUTO
 * @text 自動
 * 
 * @param VAR_AUTO_SPEAK
 * @text 自動音声合成変数
 * @desc プラグインコマンドなしで音声合成するパターンの変数番号です。変数の値が 0 の時は音声合成しません。
 * @default 0
 * @type variable
 * @parent AUTO
 * 
 * @param AUTO_SPEAK_PATTERN
 * @text 自動音声合成パターン
 * @desc プラグインコマンドなしで音声合成するパターンです。自動音声合成変数の値が1以上の時にパターンを使用します。
 * @type struct<pattern>[]
 * @parent AUTO
 * 
 * @command VOICE_OUTPUT
 * @text 音声出力
 * @desc 音声出力（音声合成）するコマンドです。
 * @arg text
 * @text 音声出力文字列
 * @desc テストとして表示する文字列です。
 * @type multiline_string
 * @arg language
 * @text 出力言語
 * @desc 音声出力する言語。日本語は「ja-JP」です。
 * @default ja-JP
 * @type string
 * @arg pitch
 * @text ピッチ
 * @desc 音声合成のピッチ（音の高低）のパーセントです。初期値：100
 * @default 100
 * @type number
 * @arg rate
 * @text レート
 * @desc 音声合成のレート（速度）のパーセントです。初期値：100
 * @default 100
 * @type number
 * 
 * @command VOICE_OUTPUT_VAR
 * @text 音声出力（変数版）
 * @desc 変数内の文字列を音声出力（音声合成）するコマンドです。
 * @arg varText
 * @text 音声出力文字列変数番号
 * @desc テストとして表示する文字列が入っている変数の番号です。
 * @type variable
 * @arg language
 * @text 出力言語
 * @desc 音声出力する言語。日本語は「ja-JP」です。
 * @default ja-JP
 * @type string
 * @arg pitch
 * @text ピッチ
 * @desc 音声合成のピッチ（音の高低）のパーセントです。初期値：100
 * @default 100
 * @type number
 * @arg rate
 * @text レート
 * @desc 音声合成のレート（速度）のパーセントです。初期値：100
 * @default 100
 * @type number
 * 
 * @command VOICE_OUTPUT_VAR2
 * @text 音声出力（変数版）2
 * @desc 変数内の文字列を音声出力（音声合成）するコマンドです。
 * @arg varText
 * @text 音声出力文字列変数番号
 * @desc テストとして表示する文字列が入っている変数の番号です。
 * @type variable
 * @arg language
 * @text 出力言語
 * @desc 音声出力する言語。日本語は「ja-JP」です。
 * @default ja-JP
 * @type string
 * @arg pitch
 * @text ピッチ
 * @desc 音声合成のピッチ（音の高低）のパーセントが入っている変数の番号です。
 * @type variable
 * @arg rate
 * @text レート
 * @desc 音声合成のレート（速度）のパーセントが入っている変数の番号です。
 * @type variable
 * 
 * @command VOICE_CANCEL
 * @text 音声キャンセル
 * @desc 再生中の音声を取り消します。
 * 
 * @help
# KRD_MZ_VoiceOutput.js

音声出力（音声合成）

## 権利表記

(c) 2021 kuroudo119 (くろうど)

## 利用規約

このプラグインはMITライセンスです。
https://github.com/kuroudo119/RPGMZ-Plugin/blob/master/LICENSE

## 機能

本プラグインは Web Speech API を使用しています。

プラグインコマンドを使用すると、
Web Speech API に対応したブラウザで音声が流れます。

## 自動音声合成

「文章の表示」「文章のスクロール表示」コマンドを使用した際に、
プラグインコマンドなしで音声合成します。

事前に決めた「自動音声合成パターン」を「自動音声合成変数」で指定します。
index = 0 が 1 となります。
0 は自動音声合成しないですので、1 始まりで指定してください。

## iPhone用ボタン

iPhoneではユーザー操作に伴うAPI実行を1回行う必要があります。
そのためのボタンです。

## 制約事項

音声終わりにメッセージ送りをすると
次のメッセージも送られる場合があります。

これは「メッセージ送り対処」を true にし、
「長押し時間」をシステム値より長くすることで回避できます。

この時、「選択肢の表示」コマンドの選択が
クリックからトリガーに変わります。
ちなみに、クリックはボタンを離した時、
トリガーはボタンを押した時です。

## 更新履歴

- ver.0.0.1 (2023/07/08) 作成開始
- ver.0.1.0 (2023/07/08) 非公開版完成
- ver.1.0.0 (2023/07/08) 公開
- ver.1.1.0 (2023/07/09) 音量オプションを追加
- ver.1.2.0 (2023/07/10) デフォルト音量、ピッチ、速度、キャンセルを追加
- ver.1.3.0 (2023/07/11) 自動キャンセルを追加
- ver.1.4.0 (2023/08/03) 音声キャンセル時の不具合修正、パラメータ追加
- ver.1.5.0 (2023/08/05) 選択肢ありでの音声キャンセル時の不具合修正
- ver.1.5.1 (2023/08/05) 選択肢ありでの音声キャンセル時の不具合修正
- ver.1.5.2 (2023/08/17) 修正が適切か不明なのでコメントアウト
- ver.1.6.0 (2023/08/17) speak の引数に null を使用可能にした
- ver.1.7.0 (2023/11/03) VOICE_OUTPUT_VAR2 コマンド追加
- ver.1.8.0 (2023/11/06) iPhone用ボタン追加
- ver.1.9.0 (2023/12/02) コンフィグの音量を優先（関数の直接使用対応）
- ver.1.10.0 (2023/12/21) ゲームパッドでの音声キャンセル時の不具合を修正
- ver.1.11.0 (2024/01/22) iPhone用ボタンの文字列をパラメータ化
- ver.1.12.0 (2024/01/22) 音声終わりメッセージ送りで連打扱いの事象を修正
- ver.1.12.1 (2024/01/25) 上記の追加修正
- ver.1.12.2 (2024/02/11) 選択肢のキャンセルボタンがタッチできないを修正
- ver.1.13.0 (2024/02/12) Web Audio API 動作テスト追加（不要な機能）
- ver.2.0.0 (2024/07/20) 自動音声合成を追加

 * 
 * 
 */