★ | 意味 |
ITMGContext | コアインターフェース |
ITMGPTT | 音声メッセージ・テキスト変換の関連インターフェース |
インターフェース | インターフェース意味 |
Init | GME初期化 |
Poll | イベントのコールバックをトリガー |
Pause | システムの一時停止 |
Resume | システムリカバリ |
Uninit | GMEの未初期化 |
using GME;
//class ITMGContextpublic abstract int Init(string sdkAppID, string openID);
パラメータ | タイプ | 意味 |
sdkAppId | string | |
openID | string | openIDはInt64型(stringに変換して渡す)のみに対応しており、ルールはApp開発者が独自に定め、App内で重複しないようにしてください。文字列をOpenidとして渡す必要がある場合は、チケットを提出をして開発者に連絡してください。| |
戻り値 | 処理 |
QAVError.OK= 0 | SDK初期化成功 |
AV_ERR_SDK_NOT_FULL_UPDATE=7015 | SDKファイルが完全であるかどうかをチェックし、削除後にSDKを再インポートすることをお勧めします |
int ret = ITMGContext.GetInstance().Init(sdkAppId, openID);//戻り値で初期化が成功したかどうかを判断するif (ret != QAVError.OK){Debug.Log("SDK初期化失敗:"+ret);return;}
ITMGContext public abstract int Poll();
public void Update(){ITMGContext.GetInstance().Poll();}
ITMGContext public abstract int Pause()
ITMGContext public abstract int Resume()
ITMGContext public abstract int Uninit()
インターフェース | インターフェース意味 |
GenAuthBuffer | ローカル認証の生成 |
ApplyPTTAuthbuffer | 認証の初期化 |
SetMaxMessageLength | 最大音声メッセージの長さの制限 |
QAVAuthBuffer GenAuthBuffer(int appId, string roomId, string openId, string key)
パラメータ | タイプ | 意味 |
appId | int | Tencent CloudコンソールからのAppID番号です。 |
roomId | string | nullまたは空の文字列を入力します。 |
openId | string | ユーザーIDです。Initの場合のopenIDと同じです。 |
key | string |
ITMGPTT int ApplyPTTAuthbuffer (byte[] authBuffer)
パラメータ | タイプ | 意味 |
authBuffer | byte[] | 認証 |
UserConfig.SetAppID(transform.Find ("appId").GetComponent<InputField> ().text);UserConfig.SetUserID(transform.Find ("userId").GetComponent<InputField> ().text);UserConfig.SetAuthKey(transform.Find("authKey").GetComponent<InputField>().text);byte[] authBuffer = UserConfig.GetAuthBuffer(UserConfig.GetAppID(), UserConfig.GetUserID(), null,UserConfig.GetAuthKey());ITMGContext.GetInstance().GetPttCtrl().ApplyPTTAuthbuffer(authBuffer);
ITMGPTT int SetMaxMessageLength(int msTime)
パラメータ | タイプ | 意味 |
msTime | int | 音声の長さです。単位はmsで、区間は1000 < msTime < = 58000です |
ITMGContext.GetInstance().GetPttCtrl().SetMaxMessageLength(58000);
インターフェース | インターフェース意味 |
StartRecordingWithStreamingRecognition | ストリーミング録音の開始 |
StopRecording | 録音の停止。 |
ITMGPTT int StartRecordingWithStreamingRecognition(string filePath)ITMGPTT int StartRecordingWithStreamingRecognition(string filePath, string speechLanguage,string translateLanguage)
パラメータ | タイプ | 意味 |
filePath | String | 音声の保存パス |
speechLanguage | String | |
translateLanguage | String | speechLanguageと同じの値を入力します |
string recordPath = Application.persistentDataPath + string.Format("/{0}.silk", sUid++);int ret = ITMGContext.GetInstance().GetPttCtrl().StartRecordingWithStreamingRecognition(recordPath, "cmn-Hans-CN","cmn-Hans-CN");
OnStreamingSpeechComplete
はレコーディングを停止して認識が完了した後にテキストを返します。これは、発話が完了した後に認識されたテキストを返すことに相当します。OnStreamingSpeechisRunning
は録音中に認識されたテキストをリアルタイムで返します。これは、発話しながら認識された文字を返すことに相当します。メッセージ名称 | 意味 |
result | ストリーミング音声識別に成功したかを判断するためのリターンコード |
text | ボイスツーテキスト変換用のテキスト |
file_path | 録音が保存されたローカルアドレス |
file_id | バックグラウンドでの録音のURLアドレスです。録音はサーバーで90日間保存されます |
ITMG_MAIN_EVNET_TYPE_PTT_STREAMINGRECOGNITION_IS_RUNNING
メッセージをリッスンする場合、file_idは空です。エラーコード | 意味 | 処理方法 |
32775 | ストリーミングボイスツーテキスト変換に失敗しましたが、録音は成功しました | UploadRecordedFileインターフェースを呼び出して録音をアップロードしてから、SpeechToTextインターフェースを呼び出してボイスツーテキスト変換を行います |
32777 | ストリーミングボイスツーテキスト変換に失敗しましたが、録音は成功し、アップロードは成功しました。 | 返されたメッセージには正常にアップロードしたバックグラウンドurlがあり、SpeechToTextインターフェースを呼び出してボイスツーテキスト変換操作を行います |
32786 | ストリーミングボイスツーテキスト変換に失敗 | ストリーミングレコーディング状態では、ストリーミングレコーディングインターフェースの実行結果が返されるのを待ってください |
32787 | テキスト変換に成功し、テキスト翻訳サービスは非アクティブ状態です | コンソールでテキスト翻訳サービスをアクティブにする必要があります |
32788 | テキスト変換に成功し、テキスト翻訳パラメータはサポートされていません | 渡されるパラメータを再確認します |
//イベントを監視します:ITMGContext.GetInstance().GetPttCtrl().OnStreamingSpeechComplete +=new QAVStreamingRecognitionCallback (OnStreamingSpeechComplete);ITMGContext.GetInstance().GetPttCtrl().OnStreamingSpeechisRunning += new QAVStreamingRecognitionCallback (OnStreamingRecisRunning);//監視処理:void OnStreamingSpeechComplete(int code, string fileid, string filepath, string result){// ストリーミングAutomatic Speech Recognitionのコールバックの起動}void OnStreamingRecisRunning(int code, string fileid, string filePath, string result){if (code == 0){setBtnText(mStreamBtn, "ストリーミング");InputField field = transform.Find("recordFilePath").GetComponent<InputField>();field.text = filePath;field = transform.Find("downloadUrl").GetComponent<InputField>();field.text = "Stream is Running";field = transform.Find("convertTextResult").GetComponent<InputField>();field.text = result;showWarningText("レコーディング中");}}
インターフェース | インターフェース意味 |
StartRecording | 録音の開始 |
PauseRecording | 録音の一時停止 |
ResumeRecording | 録音の再開 |
StopRecording | 録音の停止。 |
CancelRecording | 録音のキャンセル |
ITMGPTT int StartRecording(string fileDir)
パラメータ | タイプ | 意味 |
fileDir | string | 音声の保存パス |
string recordPath = Application.persistentDataPath + string.Format ("/{0}.silk", sUid++);int ret = ITMGContext.GetInstance().GetPttCtrl().StartRecording(recordPath);
ITMGPTT int StopRecording()
ITMGContext.GetInstance().GetPttCtrl().StopRecording();
public delegate void QAVRecordFileCompleteCallback(int code, string filepath);public abstract event QAVRecordFileCompleteCallback OnRecordFileComplete;
パラメータ | タイプ | 意味 |
code | string | codeが0である場合は、レコーディングが完了します |
filepath | string | レコーディングが保存されたアドレスです。アクセス可能なパスである必要があります。fileidをパスとして使用することはできません |
エラーコードの値 | 原因 | お勧めの提案 |
4097 | パラメータは空です | コード内のインターフェースパラメータが正しいかどうかを確認します |
4098 | 初期化エラー | デバイスが占用されているか、権限が正常であるか、正常に初期化されているかを確認します |
4099 | レコーディング中 | 適切なタイミングでSDKレコーディング機能を使用することを確認してください |
4100 | 音声データが収集されていません | マイクデバイスが正常であるかを確認します |
4101 | レコーディング中のレコーディングファイルアクセスエラー | ファイルが存在し、ファイルパスが有効であることを確認してください |
4102 | マイク権限を取得していないエラー | SDKを使うには、マイク権限を取得する必要があります。権限追加については、対応するエンジンまたはプラットフォームのSDKプロジェクト構成ドキュメントをご参照ください |
4103 | 録音時間が短すぎるエラー | まず、録音長さの単位をミリ秒とするようにし、パラメータが正確であるかどうかを確認します。次に、正常にレコーディングするには、録音長さは1000ミリ秒以上である必要があります |
4104 | 録音が開始されていません | 録音開始インターフェイスが呼び出されたかどうかを確認します |
//イベントをリッスンITMGContext.GetInstance().GetPttCtrl().OnRecordFileComplete += new QAVRecordFileCompleteCallback (OnRecordFileComplete);//監視処理void OnRecordFileComplete(int code, string filepath){### 録音開始のコールバック}
ITMGPTT int PauseRecording()
ITMGContext.GetInstance().GetPttCtrl().PauseRecording();
ITMGPTT int ResumeRecording()
ITMGContext.GetInstance().GetPttCtrl().ResumeRecording();
ITMGPTT int CancelRecording()
ITMGContext.GetInstance().GetPttCtrl().CancelRecording();
インターフェース | インターフェース意味 |
UploadRecordedFile | 音声ファイルのアップロード |
DownloadRecordedFile | 音声ファイルのダウンロード |
PlayRecordedFile | 音声の再生 |
StopPlayFile | 音声再生の停止 |
GetFileSize | 音声ファイルのサイズ |
GetVoiceFileDuration | 音声ファイルの長さ |
ITMGPTT int UploadRecordedFile (string filePath)
パラメータ | タイプ | 意味 |
filePath | String | アップロードされる音声パスです。このパスはローカルパスです。 |
ITMGContext.GetInstance().GetPttCtrl().UploadRecordedFile(filePath);
public delegate void QAVUploadFileCompleteCallback(int code, string filepath, string fileid);public abstract event QAVUploadFileCompleteCallback OnUploadFileComplete;
パラメータ | タイプ | 意味 |
code | int | codeが0である場合は、レコーディングが完了します |
filepath | string | レコーディングが保存されるアドレスです |
fileid | string | ファイルのurlパス |
エラーコードの値 | 原因 | お勧めの提案 |
8193 | ファイルをアップロードする時、ファイルアクセスエラーが発生します | ファイルが存在し、ファイルパスが有効であることを確認してください |
8194 | 署名検証失敗エラー | 認証キーが正しいかを確認し、オフライン音声が初期化されているかを確認します |
8195 | ネットワークエラー | デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
8196 | アップロードされるパラメータの取得中にネットワークに障害が発生しました | 認証が正しいかを確認し、デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
8197 | アップロードされるパラメータの取得中に返信パケットのデータが空となります | 認証が正しいかを確認し、デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
8198 | アップロードされるパラメータの取得中に返信パケットの解凍に失敗しました | 認証が正しいかを確認し、デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
8200 | appinfoが設定されていません | applyインターフェースが呼び出されているか、渡されるパラメータが空であるかを確認します |
//イベントをリッスンITMGContext.GetInstance().GetPttCtrl().OnUploadFileComplete +=new QAVUploadFileCompleteCallback (OnUploadFileComplete);//監視処理void OnUploadFileComplete(int code, string filepath, string fileid){// 音声アップロード完了のコールバック}
ITMGPTT DownloadRecordedFile (string fileID, string downloadFilePath)
パラメータ | タイプ | 意味 |
fileID | String | ファイルのurlパス |
downloadFilePath | String | ファイルがローカルで保存されたアドレスです。アクセス可能なパスである必要があります。fileidをパスとして使用することはできません |
ITMGContext.GetInstance().GetPttCtrl().DownloadRecordedFile(fileId, filePath);
public delegate void QAVDownloadFileCompleteCallback(int code, string filepath, string fileid);public abstract event QAVDownloadFileCompleteCallback OnDownloadFileComplete;
パラメータ | タイプ | 意味 |
code | int | codeが0である場合は、レコーディングが完了します |
filepath | string | レコーディングが保存されるアドレスです |
fileid | string | ファイルのurlパスです。録音はサーバーで90日間保存されます |
エラーコードの値 | 原因 | お勧めの提案 |
12289 | ファイルをダウンロードする時、ファイルアクセスエラーが発生します | ファイルパスが有効であるかを確認します |
12290 | 署名検証に失敗しました | 認証キーが正しいかを確認し、オフライン音声が初期化されているかを確認します |
12291 | ネットワークストレージシステムの異常 | サーバーによる音声ファイルの取得に失敗しました。インターフェースパラメータfileidが正しいかどうか、ネットワークが正常であるかどうか、cosファイルが存在しているかどうかを確認します |
12292 | サーバーファイルシステムエラー | デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認し、サーバーにこのファイルがあるかを確認します |
12293 | ダウンロードされるパラメータの取得中にHTTPネットワークに失敗しました | デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
12294 | ダウンロードされるパラメータの取得中に返信パケットのデータが空となります | デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
12295 | ダウンロードされるパラメータの取得中に返信パケットの解凍に失敗しました | デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
12297 | appinfoが設定されていません | 認証キーが正しいかを確認し、オフライン音声が初期化されているかを確認します |
//イベントをリッスンITMGContext.GetInstance().GetPttCtrl().OnDownloadFileComplete +=new QAVDownloadFileCompleteCallback(OnDownloadFileComplete);//監視処理void OnDownloadFileComplete(int code, string filepath, string fileid){// 音声ファイルをダウンロードした後のコールバック}
ITMGPTT PlayRecordedFile(string filePath)ITMGPTT PlayRecordedFile(string filePath,int voiceType);
パラメータ | タイプ | 意味 |
filePath | string | ローカル音声ファイルのパス |
voicetype | int |
エラーコードの値 | 原因 | お勧めの提案 |
20485 | 再生が開始されていません | ファイルが存在し、ファイルパスが有効であることを確認してください |
ITMGContext.GetInstance().GetPttCtrl().PlayRecordedFile(filePath);
public delegate void QAVPlayFileCompleteCallback(int code, string filepath);public abstract event QAVPlayFileCompleteCallback OnPlayFileComplete;
パラメータ | タイプ | 意味 |
code | int | codeが0である場合は、再生が完了します |
filepath | string | レコーディングが保存されるアドレスです |
エラーコードの値 | 原因 | お勧めの提案 |
20481 | 初期化エラー | デバイスが占用されているか、権限が正常であるか、正常に初期化されているかを確認します |
20482 | 再生中、中断して次の再生に失敗しました(正常に中断可能) | ロジックコードが正しいかを確認します |
20483 | パラメータは空です | コード内のインターフェースパラメータが正しいかどうかを確認します |
20484 | 内部エラー | プレーヤー初期化エラー、デコードエラーなどの問題によりこのエラーコードが表示されます。ログセットを参照して問題を特定する必要があります |
//イベントを監視します:ITMGContext.GetInstance().GetPttCtrl().OnPlayFileComplete +=new QAVPlayFileCompleteCallback(OnPlayFileComplete);//監視処理:void OnPlayFileComplete(int code, string filepath){//音声再生のコールバック}
ITMGPTT int StopPlayFile()
ITMGContext.GetInstance().GetPttCtrl().StopPlayFile();
ITMGPTT GetFileSize(string filePath)
パラメータ | タイプ | 意味 |
filePath | String | 音声ファイルのパスです。このパスはローカルパスです。 |
int fileSize = ITMGContext.GetInstance().GetPttCtrl().GetFileSize(filepath);
ITMGPTT int GetVoiceFileDuration(string filePath)
パラメータ | タイプ | 意味 |
filePath | String | 音声ファイルのパスです。このパスはローカルパスです。 |
int fileDuration = ITMGContext.GetInstance().GetPttCtrl().GetVoiceFileDuration(filepath);
インターフェース | インターフェース意味 |
SpeechToText | 音声を文字に識別する |
ITMGPTT int SpeechToText(String fileID)
パラメータ | タイプ | 意味 |
fileID | String | 音声ファイルurl |
ITMGContext.GetInstance().GetPttCtrl().SpeechToText(fileID);
ITMGPTT int SpeechToText(String fileID,String speechLanguage)ITMGPTT int SpeechToText(String fileID,String speechLanguage,String translatelanguage)
パラメータ | タイプ | 意味 |
fileID | String | 音声ファイルのurlです。録音はサーバーで90日間保存されます |
speechLanguage | String | |
translatelanguage | String |
ITMGContext.GetInstance().GetPttCtrl().SpeechToText(fileID,"cmn-Hans-CN","cmn-Hans-CN");
public delegate void QAVSpeechToTextCallback(int code, string fileid, string result);public abstract event QAVSpeechToTextCallback OnSpeechToTextComplete;
パラメータ | タイプ | 意味 |
code | int | codeが0である場合は、レコーディングが完了します |
fileid | string | 音声ファイルのurlです。録音はサーバーで90日間保存されます |
result | string | 変換されたテキスト結果 |
エラーコードの値 | 原因 | お勧めの提案 |
32769 | 内部エラー | ログを分析し、バックグラウンドからクライアントに返された本当のエラーコードを取得し、解決してもらうようにバックグラウンドのスタッフに連絡します |
32770 | ネットワークに失敗 | デバイスネットワークがパブリックネットワーク環境に正常にアクセスできるかを確認します |
32772 | 返信パッケージの解凍に失敗 | ログを分析し、バックグラウンドからクライアントに返された本当のエラーコードを取得し、解決してもらうようにバックグラウンドのスタッフに連絡します |
32774 | appinfoが設定されていません | 認証キーが正しいかを確認し、オフライン音声が初期化されているかを確認します |
32776 | authbuffer検証に失敗 | authbufferが正しいかを確認します |
32784 | ボイスツーテキスト変換パラメータエラー | コード内のインターフェースパラメータfileidが正しいかどうかを確認します |
32785 | ボイスツーテキスト変換の翻訳でエラーが返されます | オフライン音声バックグラウンドのエラーです。ログを分析し、バックグラウンドからクライアントに返された本当のエラーコードを取得し、解決してもらうようにバックグラウンドのスタッフに連絡します |
32787 | テキスト変換に成功し、テキスト翻訳サービスは非アクティブ状態です | コンソールでテキスト翻訳サービスをアクティブにする必要があります |
32788 | テキスト変換に成功し、テキスト翻訳パラメータはサポートされていません | 渡されるパラメータを再確認します |
//イベントをリッスンITMGContext.GetInstance().GetPttCtrl().OnSpeechToTextComplete += new QAVSpeechToTextCallback(OnSpeechToTextComplete);//監視処理void OnSpeechToTextComplete(int code, string fileid, string result){// 識別のコールバック}
インターフェース | インターフェース意味 |
GetMicLevel | マイクのリアルタイムボリュームの取得 |
SetMicVolume | レコーディングボリュームの設定 |
GetMicVolume | レコーディングボリュームの取得 |
GetSpeakerLevel | スピーカーのリアルタイムボリュームの取得 |
SetSpeakerVolume | 再生ボリュームの設定 |
GetSpeakerVolume | 再生ボリュームの取得 |
ITMGPTT int GetMicLevel()
ITMGContext.GetInstance().GetPttCtrl().GetMicLevel();
ITMGPTT int SetMicVolume(int vol)
ITMGContext.GetInstance().GetPttCtrl().SetMicVolume(100);
ITMGPTT int GetMicVolume()
ITMGContext.GetInstance().GetPttCtrl().GetMicVolume();
ITMGPTT int GetSpeakerLevel()
ITMGContext.GetInstance().GetPttCtrl().GetSpeakerLevel();
ITMGPTT int SetSpeakerVolume(int vol)
ITMGContext.GetInstance().GetPttCtrl().SetSpeakerVolume(100);
ITMGPTT int GetSpeakerVolume()
ITMGContext.GetInstance().GetPttCtrl().GetSpeakerVolume();
ITMGContext abstract string GetSDKVersion()
ITMGContext.GetInstance().GetSDKVersion();
ITMGContext SetLogLevel(ITMG_LOG_LEVEL levelWrite, ITMG_LOG_LEVEL levelPrint)
パラメータ | タイプ | 意味 |
levelWrite | ITMG_LOG_LEVEL | ログの書き込むレベルを設定します。TMG_LOG_LEVEL_NONEは書き込まないことを示し、デフォルトはTMG_LOG_LEVEL_INFOです。 |
levelPrint | ITMG_LOG_LEVEL | ログのプリントレベルを設定します。TMG_LOG_LEVEL_NONEはプリントしないことを示し、デフォルトはTMG_LOG_LEVEL_ERRORです。 |
ITMG_LOG_LEVEL | 意味 |
TMG_LOG_LEVEL_NONE | ログをプリントしない |
TMG_LOG_LEVEL_ERROR | エラーログをプリントします(デフォルト) |
TMG_LOG_LEVEL_INFO | お知らせ通知ログをプリントします |
TMG_LOG_LEVEL_DEBUG | 開発デバッグログをプリントします |
TMG_LOG_LEVEL_VERBOSE | 高頻度ログをプリントする |
ITMGContext.GetInstance().SetLogLevel(TMG_LOG_LEVEL_INFO,TMG_LOG_LEVEL_INFO);
プラットフォーム | パス |
Windows | %appdata%\\Tencent\\GME\\ProcessName |
iOS | Application/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/Documents |
Android | /sdcard/Android/data/xxx.xxx.xxx/files |
Mac | /Users/username/Library/Containers/xxx.xxx.xxx/Data/Documents |
ITMGContext SetLogPath(string logDir)
パラメータ | タイプ | 意味 |
logDir | String | パス |
ITMGContext.GetInstance().SetLogPath(path);
この記事はお役に立ちましたか?