例外

# 例外

例外とは、アプリの実行中に発生する予期しない不正な動作です。Catalyst Androidアプリにおけるすべてのエラーと例外は、Android SDKパッケージで定義されている{{%badge%}}{{%bold%}}ZCatalystException{{%/bold%}}{{%/badge%}}という列挙型によって処理されます。

アプリで例外が発生した場合、その例外の以下のプロパティが返されます：

* {{%bold%}}{{%badge%}}code{{%/badge%}}:{{%/bold%}} エラーの一意識別子
* {{%bold%}}{{%badge%}}errorMsg{{%/badge%}}:{{%/bold%}} エラーに関する一般的な説明
* {{%bold%}}{{%badge%}}errorDetails{{%/badge%}}:{{%/bold%}} エラーに関する追加情報
* {{%bold%}}{{%badge%}}originalException{{%/badge%}}:{{%/bold%}} スローされた実際の例外

Catalyst Android SDKがスローする一般的なエラーコードとその説明を以下に示します：

<table class="content-table">
<thead>
<tr>
<th class="w30p">エラーコード</th>
<th class="w70p">説明</th>
</tr>
</thead>
<tbody>
<tr>
<td>INITIALIZATION_ERROR</td>
<td>SDKの初期化に失敗しました</td>
</tr>
<tr>
<td>LOGIN_ERROR</td>
<td>ユーザーのログイン処理に失敗しました</td>
</tr>
<tr>
<td>LOGOUT_FAILED</td>
<td>ユーザーのログアウト処理に失敗しました</td>
</tr>
<tr>
<td>TOKEN_FETCH_ERROR</td>
<td>アクセストークンの取得に失敗しました</td>
</tr>
<tr>
<td>RESPONSE_PARSE_ERROR</td>
<td>受信したレスポンスを解析できません</td>
</tr>
<tr>
<td>NO_NETWORK_AVAILABLE</td>
<td>API呼び出しを行うためのネットワーク接続が利用できません</td>
</tr>
<tr>
<td>API_FAILED</td>
<td>APIの呼び出しに失敗しました</td>
</tr>
<tr>
<td>INVALID_DATA</td>
<td>送信されたデータが、指定された形式に対して有効な型ではありません</td>
</tr>
<tr>
<td>FILE_SIZE_EXCEEDED</td>
<td>アップロードされたファイルのサイズが100MBの制限を超えています</td>
</tr>
<tr>
<td>FUNCTION_EXECUTION_ERROR</td>
<td>関数の実行に失敗しました</td>
</tr>
<tr>
<td>JSON_EXCEPTION</td>
<td>リクエストに含まれるボディが有効なJSONではありません</td>
</tr>
<tr>
<td>INVALID_REQUEST</td>
<td>作成されたリクエストが有効ではありません</td>
</tr>
<tr>
<td>INVALID_FILE_INPUT</td>
<td>アップロード操作で送信されたファイルが有効ではありません</td>
</tr>
<tr>
<td>INTERNAL_ERROR</td>
<td>SDKで内部エラーが発生しました</td>
</tr>
<tr>
<td>INVALID_CONFIGURATION</td>
<td>ログインに必要な設定でSDKが初期化されていません。適切な設定でSDKを再初期化してください。</td>
</tr>
<tr>
<td>CUSTOM_LOGIN_DISABLED</td>
<td>サードパーティ認証に必要なパラメータが見つかりませんでした。プロジェクトでサードパーティ認証が有効になっていることを確認するか、プロパティファイルを再ダウンロードしてください。</td>
</tr>
</tbody>
</table>

例外とは、アプリの実行中に発生する予期しない不正な動作です。Catalyst Androidアプリにおけるすべてのエラーと例外は、Android SDKパッケージで定義されているZCatalystExceptionという列挙型によって処理されます。

アプリで例外が発生した場合、その例外の以下のプロパティが返されます：

code: エラーの一意識別子
errorMsg: エラーに関する一般的な説明
errorDetails: エラーに関する追加情報
originalException: スローされた実際の例外

Catalyst Android SDKがスローする一般的なエラーコードとその説明を以下に示します：

エラーコード	説明
INITIALIZATION_ERROR	SDKの初期化に失敗しました
LOGIN_ERROR	ユーザーのログイン処理に失敗しました
LOGOUT_FAILED	ユーザーのログアウト処理に失敗しました
TOKEN_FETCH_ERROR	アクセストークンの取得に失敗しました
RESPONSE_PARSE_ERROR	受信したレスポンスを解析できません
NO_NETWORK_AVAILABLE	API呼び出しを行うためのネットワーク接続が利用できません
API_FAILED	APIの呼び出しに失敗しました
INVALID_DATA	送信されたデータが、指定された形式に対して有効な型ではありません
FILE_SIZE_EXCEEDED	アップロードされたファイルのサイズが100MBの制限を超えています
FUNCTION_EXECUTION_ERROR	関数の実行に失敗しました
JSON_EXCEPTION	リクエストに含まれるボディが有効なJSONではありません
INVALID_REQUEST	作成されたリクエストが有効ではありません
INVALID_FILE_INPUT	アップロード操作で送信されたファイルが有効ではありません
INTERNAL_ERROR	SDKで内部エラーが発生しました
INVALID_CONFIGURATION	ログインに必要な設定でSDKが初期化されていません。適切な設定でSDKを再初期化してください。
CUSTOM_LOGIN_DISABLED	サードパーティ認証に必要なパラメータが見つかりませんでした。プロジェクトでサードパーティ認証が有効になっていることを確認するか、プロパティファイルを再ダウンロードしてください。

最終更新日 2026-02-23 18:09:41 +0530 IST

Yes

Thank you for your feedback!

Send your feedback to us

Skip

Submit

Developer Tools