目次
概要
Event Reporting は、アプリケーションの設定ファイルに記述をすることで、アプリ全体のコンテンツを自動でWOVNへ吸い上げと翻訳ができる機能です。
設定方法
application に lifecycleCallback を追加する
WovnActivityLifecycleCallbacks クラスのインスタンスを生成し、ActivityLifecycleCallbacks として追加してください。
```java
// アプリで実装済みのカスタム application クラス
@Override
public void onCreate() {
super.onCreate();
// lifecycleCallback を追加
this.registerActivityLifecycleCallbacks(new WovnActivityLifecycleCallbacks(BuildConfig.DEBUG));
}
```
インフォメーション
ViewGroup.OnHierarchyChangeListener を実装している場合は、「OnHierarchyChangeListenerの上書きを防いで実装する方法」を参照してください。
OnHierarchyChangeListenerの上書きを防いで実装する方法
アプリで ViewGroup.OnHierarchyChangeListener
を実装している場合、config で autoAddChild
を false
に指定してください。(本機能により実装したListenerが上書きされる可能性があります。)
```java
// アプリで実装済みのカスタム application クラス
@Override
public void onCreate() {
super.onCreate();
// lifecycleCallback を追加
WovnTranslationConfig config = new WovnTranslationConfig();
config.setAutoAddChild(false);
WovnActivityLifecycleCallbacks lifecycleCallbacks = new WovnActivityLifecycleCallbacks(config);
this.registerActivityLifecycleCallbacks(lifecycleCallbacks);
}
```
WOVN管理画面にコンテンツが取り込まれることを確認する
Event Reporting を設定完了後にアプリを起動し、元言語で画面ごとに10秒以上待機すると、表示している画面のコンテンツが WOVN へ送信されます。
WOVN管理画面 で 「アプリ」→「Android app」を選択し、一覧に新しいディスプレイが作成されていることを確認してください。
インフォメーション
管理画面に一覧表示されるディスプレイ名は、表示した画面に紐づくソースコードのクラス名です。
各ディスプレイを選択すると、翻訳管理画面を開くことができます。WOVNプロジェクトの初期設定では「自動機械翻訳&公開」がONになっているため、数分経過すると自動で機械翻訳と公開処理が行われます。
アプリ上で翻訳されることを確認する
翻訳が公開されている場合は、アプリを起動して言語を切り替えることで翻訳されることを確認できます。
インフォメーション
ディスプレイ一覧で「公開済み」ステータスになっていれば、そのディスプレイは1言語以上で翻訳が適用されています。
ディスプレイ内のバリューごとに翻訳公開状況を確認するには、翻訳編集ページでバリュー右下にある「●」の状況によって確認ができます。
言語を切り替える方法
WOVN は、初期設定で端末の言語設定を読み取って自動で言語を切り替えます。
言語切替ウィジェットを作成して、好きな言語を切り替えるには、ユーザーのタップイベントなどで下記コードを実行するようにアプリを実装します。
詳細は WovnクラスのchangeLang() メソッド を参照してください
```java
Wovn.changeLang('en');
```
明示的に端末の言語設定に切り替える場合は、 Wovnクラスの changeToSystemLang() メソッドを参照してください
次に行う作業について
個人情報を取り扱うアプリでは、 かならず wovnIgnore を適切に設定してからアプリストアへ申請してください。
Event Reporting に対応していないコンポーネントを翻訳するには、 translateView() を使った方法で翻訳することができます。
Event Reporting に対応していないコンポーネントを翻訳する
Toast や Alert をもつコンポーネントを翻訳するには、下記ページを参考にしてください。
その他の機能要件に応じた実装をするには、下記目次も参照してください。