SDK エラー一覧
このページでは、Vonage Client SDK の使用時に返される可能性のあるすべてのエラーの種類とコードについて、包括的なリファレンスを提供しています。これらのエラーを理解することで、アプリケーションに適切なエラー処理を実装するのに役立ちます。
エラー構造
Client SDK におけるすべてのエラーは、 VonageError 以下の特性を持つ：
| プロパティ |
タイプ |
説明 |
type |
string |
エラーのカテゴリ（以下の「エラーの種類」を参照） |
code |
string |
具体的なエラーを特定するエラーコード |
message |
string |
エラーに関する人間が理解できる説明 |
エラーの種類
このSDKでは、以下のエラータイプのカテゴリが使用されています：
| エラーの種類 |
説明 |
CS_ERROR |
バックエンドサービスのエラー（VonageのバックエンドサービスによるAPIエラー） |
SESSION_ERROR |
認証およびセッションに関連するエラー |
NETWORK_ERROR |
ネットワーク接続の問題、タイムアウト、およびHTTP 5xxサーバーエラー |
INTERNAL_ERROR |
メディアエラー、検証エラー、解析エラーなど、SDKによって発生したエラー |
UNKNOWN_ERROR |
サポートに報告すべき予期せぬエラー |
エラーコード完全リファレンス
CS_ERROR コード
Vonage API から返されたバックエンドサービスのエラー：
| エラーコード |
HTTPコード |
説明 |
http:error:db-unavailable |
500 |
データベースは一時的に利用できません |
http:error:service-not-available |
503 |
現在、本サービスは一時的にご利用いただけません |
http:error:not-found |
404 |
そのエンドポイントは存在しません、またはアクセス権限がありません |
SESSION_ERROR コード
認証および認可に関するエラー：
| エラーコード |
説明 |
internal:auth:authorization_error |
認証トークンが無効か、または存在しません |
system:error:expired-token |
指定されたトークンの有効期限が切れています |
system:error:invalid-token |
指定されたトークンは無効です |
system:error:missing-token |
トークンが指定されていません |
NETWORK_ERROR コード
ネットワークおよび接続に関するエラー：
| エラーコード |
HTTPコード |
説明 |
internal:error:serviceNotAvailable |
503 |
現在、サービスは一時的にご利用いただけません。しばらくしてから再度お試しください。 |
http:error:internal |
500 |
サーバー内部エラーが発生しました。しばらくしてからもう一度お試しください。 |
INTERNAL_ERROR コード
メディア、検証、および解析に関する問題など、SDKによって発生したエラー：
メディアエラー
| エラーコード |
説明 |
voice:error:media_timeout |
タイムアウト期間内にメディア接続を確立できませんでした |
voice:error:no_call_found |
指定された通話IDに該当する緊急通報は見つかりませんでした |
voice:error:no_call_media_found |
指定された通話に対応するメディアが見つかりませんでした |
voice:error:no_offer_found |
このコールに対してSDPオファーは生成されませんでした |
voice:error:no_answer_found |
この通話に対して、SDP応答は受信されませんでした |
media:error:media_not_found |
指定されたコールIDに対応するメディア接続が見つかりません |
media:error:peer_connection_not_found |
指定されたコール ID に対応する WebRTC ピア接続が見つかりませんでした |
media:error:track_not_found |
指定されたコールIDに対応するオーディオトラックが見つかりません |
media:error:create_answer_error |
SDPアンサーの作成に失敗しました |
media:error:create_offer_error |
SDPオファーの作成に失敗しました |
media:error:create_media_error |
ローカルメディアの作成に失敗しました |
media:error:process_answer_error |
SDP応答の処理に失敗しました |
media:error:process_offer_error |
SDPオファーの処理に失敗しました |
media:error:audio_transformer_error |
音声処理／変換のエラー |
media:error:noise_suppression_already_enabled |
ノイズ抑制機能はすでに有効になっています |
media:error:noise_suppression_already_disabled |
ノイズ抑制機能はすでに無効になっています |
media:error:noise_suppression_models_not_found |
ノイズ抑制モデルが見つかりません |
検証エラーおよび構文解析エラー
| エラーコード |
説明 |
internal:error:parsing_exception |
サーバーからの応答を解析できませんでした |
internal:error:unsanitized_input_error |
リクエストにサニタイズされていない入力が含まれていたため、拒否されました |
internal:error:illegal_argument_exception |
メソッドに不適切な引数が渡されました |
internal:error:unexpected_null_value |
予期しないnull値が検出されました |
緊急事態特有のエラー
| エラーコード |
説明 |
emergency:error:invalid_reconnect_token_origin |
リコネクトトークンが見つからないか、オリジンが無効です |
emergency:error:call_timeout |
緊急通報の処理がタイムアウトしました |
UNKNOWN_ERROR
| エラーコード |
説明 |
| 該当なし |
他のカテゴリに該当しない予期せぬエラー - サポートへ報告してください |