動的設定と送信先アドレスの動的更新¶
リモート設定¶
SDK 0.5.7 以降でサポートされます。
リモート設定を通じてプラットフォームから配信される環境変数を取得し、サンプリング、ログフィルタリング、データ送信などの設定を調整します。
前提条件¶
FTMobileFlutter.sdkConfig() で enableRemoteConfiguration: true を設定し、有効な送信先アドレスを構成したうえで、FTRUMManager().setConfig() で現在のプラットフォームの RUM App ID を設定します。完全な導入手順は SDK の初期化 と RUM 設定 を参照してください。ログ、トレーシング、Session Replay はそれぞれ個別に初期化を完了する必要があります。
適用範囲¶
フィールド名はネイティブ SDK に準拠します。サポートされるフィールド、単位、反映方法は Flutter リモート設定フィールド を参照してください。サンプリング、ログフィルタリング、送信などの共通設定は Flutter データに影響します。ネイティブの View、Action、Resource、スタッタリングなどのスイッチはネイティブの収集のみを制御し、Flutter の自動ルーティング、Dart のネットワーク収集、Dart LongTask の設定は変更しません。
更新方法¶
| 更新方法 | 最小更新間隔 | 取得結果 |
|---|---|---|
| SDK による自動更新トリガー | remoteConfigMiniUpdateInterval、単位は秒、デフォルトは 12 時間 |
FTMobileFlutter.addRemoteConfigListener() |
FTMobileFlutter.updateRemoteConfig() |
初期化時に設定した間隔を使用 | 戻り値の Future<FTRemoteConfigResult> |
FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(interval) |
今回渡された interval を使用、単位は秒、値は非負整数、0 の場合は間隔チェックをスキップ |
戻り値の Future<FTRemoteConfigResult> |
最小更新間隔はリクエスト頻度を制限するためのものであり、SDK が 12 時間ごとに定期的に更新することを意味するものではありません。能動的な更新は非同期操作であり、0 を渡した場合でも上記の初期化条件を満たす必要があります。
// 初期化時に設定した最小更新間隔を使用
final result = await FTMobileFlutter.updateRemoteConfig();
debugPrint('リモート設定の更新結果:${result.success}');
// 業務上すぐに更新する必要がある場合は、最小間隔チェックをスキップ
final immediateResult =
await FTMobileFlutter.updateRemoteConfigWithMiniUpdateInterval(0);
debugPrint('能動的更新の結果:${immediateResult.success}');
更新結果のリッスン¶
FTMobileFlutter.addRemoteConfigListener() で自動更新の結果をリッスンします。能動的に呼び出した結果は戻り値の Future から取得し、このリスナーでは通知されません。
// 業務側のカスタムコールバック(関数名は任意)
void onRemoteConfigUpdated(FTRemoteConfigResult result) {
debugPrint('自動更新の結果:${result.success}');
}
FTMobileFlutter.addRemoteConfigListener(onRemoteConfigUpdated);
リッスンを終了する場合は、FTMobileFlutter.removeRemoteConfigListener(onRemoteConfigUpdated) を呼び出します。
送信先アドレスの動的更新¶
FTMobileFlutter を使用して SDK の実行中にデータ送信先アドレスを切り替えます。設定に成功すると、以降のデータは新しいアドレスに送信されます。
setDatakitURL と setDatawayURL はいずれか一方を選択します。setDatawayURL を使用する場合は、同時に cliToken を渡す必要があります。
await FTMobileFlutter.setDatakitURL(datakitUrl);
// 公網 DataWay を使用する場合は上記の方法とのいずれか一方を選択
// await FTMobileFlutter.setDatawayURL(datawayUrl, cliToken);
送信先アドレスの遅延設定¶
SDK 0.5.8 以降でサポートされます。
初期化時に、FTMobileFlutter.sdkConfig() では datakitUrl、datawayUrl、cliToken を渡さなくても構いません。SDK はまずデータを収集してキャッシュし、すぐには送信しません。アドレスを取得したら、上記のメソッドを呼び出して設定するだけで、同期された設定に従って送信されます。
データは引き続きローカルキャッシュ設定の制限を受け、上限に達すると破棄される可能性があります。autoSync: false を設定した場合は、FTMobileFlutter.flushSyncData() を呼び出して能動的に送信する必要があります。