Tuning Fork 额外实用程序

用于使用 Tuning Fork 的额外实用函数。

摘要

函数
TuningFork_findFidelityParamsInApk(JNIEnv *env, jobject context, const char *filename, TuningFork_CProtobufSerialization *fidelity_params)
从 assets/tuningfork/ 加载保真参数fp 的所有权已传递给调用方：调用 TuningFork_CProtobufSerialization_free 以释放结构体中存储的数据。
TuningFork_saveOrDeleteFidelityParamsFile(JNIEnv *env, jobject context, const TuningFork_CProtobufSerialization *fidelity_params)
TuningFork_init 函数会将保真参数保存到文件中，以便在下载连接不可用时使用。
TuningFork_startFidelityParamDownloadThread(const TuningFork_CProtobufSerialization *default_params, TuningFork_FidelityParamsCallback fidelity_params_callback)
在单独的线程中下载保真参数。

函数

TuningFork_findFidelityParamsInApk

TuningFork_ErrorCode TuningFork_findFidelityParamsInApk(
  JNIEnv *env,
  jobject context,
  const char *filename,
  TuningFork_CProtobufSerialization *fidelity_params
)

从 assets/tuningfork/ 加载保真参数fp 的所有权已传递给调用方：调用 TuningFork_CProtobufSerialization_free 以释放结构体中存储的数据。

详细信息
参数
env
JNIEnv
context
应用上下文
filename
要加载的文件名
fidelity_params
找到的保真参数的协议缓冲区序列化。
返回值
如果无错误，则返回 TUNINGFORK_ERROR_OK

TuningFork_saveOrDeleteFidelityParamsFile

TuningFork_ErrorCode TuningFork_saveOrDeleteFidelityParamsFile(
  JNIEnv *env,
  jobject context,
  const TuningFork_CProtobufSerialization *fidelity_params
)

TuningFork_init 函数会将保真参数保存到文件中，以便在下载连接不可用时使用。

使用此函数，您可以替换或删除已保存的文件。

详细信息
参数
env
JNIEnv
context
应用上下文。
fidelity_params
要保存的参数。如果 fidelity_params 为 NULL，则会删除保存的文件。
返回值
如果无错误，则返回 TUNINGFORK_ERROR_OK

TuningFork_startFidelityParamDownloadThread

TuningFork_ErrorCode TuningFork_startFidelityParamDownloadThread(
  const TuningFork_CProtobufSerialization *default_params,
  TuningFork_FidelityParamsCallback fidelity_params_callback
)

在单独的线程中下载保真参数。

下载线程已激活，用于检索保真参数，并将执行重试，直到下载成功或发生超时。下载的参数会存储在本地，并在应用下次启动时优先于默认参数使用。请求将根据初始化 Tuning Fork 所用的 TuningFork_Settings 结构体中的 initial_request_timeout_ms 和 ultimate_request_timeout_ms 字段超时。

详细信息
参数
default_params
如果无下载连接且无已保存参数，将使用包含保真参数的 protobuf 序列化。
fidelity_params_callback
将使用任何下载的参数或默认/已保存的参数进行调用。
返回值
如果无错误，则返回 TUNINGFORK_ERROR_OK