コンテンツにスキップ

動的設定と送信先アドレスの動的更新

リモート設定

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() を呼び出して能動的に送信する必要があります。

フィードバック

このページは役に立ちましたか?