差分

このページの2つのバージョン間の差分を表示します。

--- seikacenter-201 [2023/04/13 00:45] – 削除 - 外部編集 (Unknown date) 127.0.0.1
+++ seikacenter-201 [2025/03/30 02:01] (現在) – 外部編集 127.0.0.1
@@ 行 1: / 行 1: @@
+====== HTTP機能で提供されるURLの説明 ======
+SeikaCenterのサポートは終了いたしました。\\ この製品に修正や機能拡張は今後行われません。現時点での最新版のダウンロードは可能です。\\
+後継プロダクト AssistantSeika をご利用ください。
+===== 概要 =====
+20200301/uでの説明です。
+SeikaCenterのHTTP機能を有効にすることで提供されるURLの説明です。
+===== エントリーポイントURL =====
+以下のエントリーポイントURLが利用可能です。
+^ メソッド   ^ URI                                   ^ 説明                                                                                  ^
+| GET    | /AVATOR                               | SeikaCenterで利用可能な話者の一覧を返す                                                           |
+| GET    | /AVATOR2                              | SeikaCenterで利用可能な話者の一覧を返す                                                           |
+| GET    | /AVATOR2/{cid}                        | 指定cidの話者のデフォルトパラメタ情報を返す  例: /AVATOR2/2000 → cid=2000の話者のデフォルトパラメタ情報を返す              |
+| GET    | /AVATOR2/{cid}/current                | 指定cidの話者の現在のパラメタ情報を返す  例: /AVATOR2/2001/current → cid=2001の話者の現在のパラメタ情報を返す          |
+| GET    | /app/{path}                           | 指定pathの静的コンテンツを返す。SeikaCenterの設定2タブの設定値"ワークフォルダ"の直下にあるフォルダ名"app"をドキュメントルートとして処理する。  |
+| POST   | /PLAY2/{cid}                          | 指定cidの話者に発声させる                                                                      |
+| POST   | /SAVE2/{cid}                          | 指定cidの話者の音声データ(wav)を返す                                                              |
+| POST   | /SAVE2/{cid}/{sampleRate}             | 指定cidの話者の音声データ(wav)をサンプリングレート sampleRate でリサンプリングして返す                               |
+| GET    | /EFFECT/{cid}/clear                   | 指定cidの話者のエフェクトパラメタ、感情パラメタをクリアする                                                     |
+| GET    | /EFFECT/{cid}/param/{value}           | 指定cidの話者のエフェクトパラメタparamに値valueを設定する                                                 |
+| GET    | /EMOTION/{cid}/param/{value}          | 指定cidの話者の感情パラメタparamに値valueを設定する                                                    |
+| GET    | /PLAY2/{cid}/{talktext}               | 指定cidの話者にテキストtalktextを発声させる                                                         |
+| GET    | /SAVE2/{cid}/{talktext}               | 指定cidの話者にテキストtalktextを発生させた音声データ(wav)を返す                                            |
+| GET    | /SAVE2/{cid}/{sampleRate}/{talktext}  | 指定cidの話者にテキストtalktextを発生させた音声データ(wav)をサンプリングレート sampleRate でリサンプリングして返す             |
+==== REST API風アクセス ====
+/AVATOR2 で利用可能話者の一覧を取得できます。
+/AVATOR2/{cid} で話者cidに割り当てられているパラメタを取得できます。取得したeffectsの内容がエフェクトパラメタ、emotionsの内容が感情パラメタの一覧になります。
+/PLAY2 で音声発声、/SAVE2 で音声データ取得、が実行されます。\\
+リクエストのBODYにJSON形式のパラメタ情報を設定してください。
+<code javascript>
+{
+  "talktext":"おはようございますー！",
+  "effects":{
+    "speed"     :1.0,
+    "volume"    :1.0,
+    "pitch"     :1.0,
+    "intonation":1.0,
+  },
+  "emotions":{
+    "喜び"   :1.00,
+    "悲しみ" :0.20
+  }
+}
+</code>
+SeikaCenterに情報が転送されます。\\
+{{pasted:20230411-195020.png?nolink}}
+また、変更が必要なパラメタのみ渡せるので、以下の形式でも構いません。
+<code javascript>
+{
+  "talktext":"おはようございますー！"
+}
+</code>
+==== GETオンリーアクセス ====
+GETメソッドだけで操作したい場合にこちらを使います。
+最初に /AVATOR2 で利用可能な話者のcidを取得、/AVATOR2/{cid} で適用可能なエフェクト・感情、のパラメタ名と設定値範囲を取得します。\\
+その後、/EFFECT/{cid}/{param}/{value} や /EMOTION/{cid}/{param}/{value} でエフェクト・感情パラメタに値を設定します。\\
+<code>
+ /EFFECT/2000/pitch/2.00
+ /EMOTION/2000/喜び/0.60
+</code>
+上記はエフェクト pitch に 2.00,感情パラメタ 喜び に 0.60 を指定した例です。日本語文字列はUTF8のテキストをURLエンコードしたものになります。
+/PLAY2, /SAVE2 はURI最後にURLエンコードしたUTF8のテキストを付与します。\\
+<code>
+ /PLAY2/2000/こんにちわー
+</code>
+talktextで適用可能な長さ等の制限については検証していません。各環境で利用者自身が判断してください。
+==== 簡易Webサーバ機能 ====
+/app から始まるURIは簡易Webサーバ機能で使用されます。GETメソッドのみサポートされます。\\
+/app/{path}はSeikaCenterの設定2タブで指定したワークフォルダ直下に配置したフォルダ"app"をルートフォルダとしてコンテンツを返します。
+例えばワークフォルダが C:\Work だった場合、/app/index.html のリクエストに対するレスポンスコンテンツは、C:\Work\app\index.html となります。
+===== サンプリングレート変換機能 =====
+製作者環境下で試したものだけ。
+^ #  ^ メソッド  ^ URI                ^ 説明                                                      ^
+| 1  | POST  | /SAVE2/{cid}        | SeikaServer利用時は音声がモノラル化される。たいてい44.1kHzだけど稀に48kHzの時がある。  |
+| 2  | POST  | /SAVE2/{cid}/8000   | SeikaCenterでキャプチャした音声を8kHzモノラルにリサンプリング。                 |
+| 3  | POST  | /SAVE2/{cid}/16000  | SeikaCenterでキャプチャした音声を16kHzモノラルにリサンプリング。                |
+| 4  | POST  | /SAVE2/{cid}/22050  | SeikaCenterでキャプチャした音声を22.05kHzモノラルにリサンプリング。             |
+| 5  | POST  | /SAVE2/{cid}/44100  | SeikaCenterでキャプチャした音声を44.1kHzモノラルにリサンプリング。              |
+| 6  | POST  | /SAVE2/{cid}/48000  | SeikaCenterでキャプチャした音声を48kHzモノラルにリサンプリング。                |
+{{tag> 技術資料 Windows voiceroid Voiceroid2 Codeer.Friendly tool}}