WOVNサービス障害時の影響 (Native iOS、Xamarine、Native Android、SwiftUI、React Native、Flutter)(自動翻訳)
このドキュメントでは、WOVNのサービスがダウンした際にクライアントに及ぼす影響について説明します。まず、WOVN SDKがWOVNサーバーとどのように通信するかを確認し、その後、さまざまなシナリオにおけるクライアントへの影響を分析します。
簡単に言うと、WOVN SDKが機能しなくなり(アプリが元の言語で表示される)、以下の3つの条件がすべ て満たされた場合のみ発生します:
- WOVNサービスが1日以上ダウンしている。
- アプリが以前に開かれたことがない。
- アプリにキックスタートデータがない。
WOVN SDKとWOVNサーバーの通信方法
アプリが起動すると、WOVN SDKは以下の順序で初期化されます:
-
ローカルデータによる初期化
- アプリが以前に開かれたことがある場合:
- SDKはWOVNサーバーから取得した最新のローカルキャッシュデータを使用して初期化します。
- アプリが以前に開かれたことがない場合:
- SDKはキックスタートデータを検索します。
- キックスタートデータが見つかれば、そのデータで初期化します。
- キックスタートデータが利用できない場合、SDKは「ローカルデータなし」と判断します。
- アプリが以前に開かれたことがある場合:
-
CDNからの初回データロード
- SDKはWOVNのCDNに最新データをリクエストします(CDNは変更が発生すると自動的に更新され、データを1日以内にキャッシュします)。
- リクエスト成功: ローカルキャッシュと現在のデータを更新します。
- リクエスト失敗(ネットワーク問題): 何も行われません。
-
定期的な更新チェック
- 初回APIコール後、SDKはCDN経由で定期的に更新をチェックします。
- リクエスト成功(新しいデータあり): ローカルキャッシュと現在のデータを更新します。
- リクエスト失敗(ネットワーク問題/更新なし): 何も行われません。
WOVNサービスダウンの影響(1日以内)
- クライアント:
- ダウン中は設定や翻訳データを変更できません。
- エンドユーザー:
- SDKはCDNサーバーから翻訳データをリクエストでき、最後に成功したAPIコールのキャッシュデータを使用します(1日間有効)。
- 翻訳機能に目立った違いはありません。
WOVNサービスダウンの影響(1日以上)
- クライアント:
- ダウン中は設定や翻訳データを変更できません。
- CDNへの影響:
- CDNは初日以降、新しい翻訳データを提供できません。
- エンドユーザーへの影響:
- アプリが以前に開かれたことがある場合:
- SDKは最後に成功したAPIコールのロー カルキャッシュデータを使用します(アプリがアンインストールされるまで保持されます)。
- 翻訳機能に目立った違いはありません。
- アプリが以前に開かれたことがないが、キックスタートデータが利用可能な場合:
- SDKはキックスタートデータで初期化します。
- 翻訳機能に目立った違いはありません。
- アプリが以前に開かれたことがなく、キックスタートデータも利用できない場合:
- SDKは初期化できません(API、ローカルキャッシュ、キックスタートデータのいずれも利用不可)。
- エンドユーザーはアプリを元の言語で表示します。
- アプリが以前に開かれたことがある場合:
エンドユーザーへの影響のまとめ
短時間の停止(1日以内)
- ユーザーへの影響なし: 最近のキャッシュデータを使用して翻訳は通常通り機能します。
長時間の停止(1日以上)
- ほとんどのユーザーでは翻訳は引き続き機能します:
- アプリにWOVNキックスタート(セットアップ時にプリロードされる)が含まれている場合、ユーザーが初めてアプリを開いても翻訳が表示されます。
- ユーザーが以前にアプリを開いたことがある場合、ローカルにキャッシュされたAPIデータを使用して翻訳が機能し続けます。
- リスクのあるシナリオは1つのみ:
- アプリにキックスタートデータがなく、ユーザーが初めて開く場合、3つのデータソース(API、ローカルキャッシュ、キックスタート)がすべて利用できないため、アプリは元の言語で表示されます。