Tuning Fork 附加效用函数

将使用 Tuning Fork 的附加效用函数。

摘要

函数
TuningFork_findFidelityParamsInApk(JNIEnv *env, jobject context, const char *filename, CProtobufSerialization *fidelity_params)
从 assets/tuningfork/ 加载保真度参数，将 fp 的所有权传递给调用方，由调用方调用 CProtobufSerialization_Free 以取消分配存储在结构体中的数据。
TuningFork_saveOrDeleteFidelityParamsFile(JNIEnv *env, jobject context, const CProtobufSerialization *fidelity_params)
TuningFork_init 函数会将保真度参数保存到文件中，以供在下载连接不可用时使用。
TuningFork_startFidelityParamDownloadThread(const CProtobufSerialization *default_params, ProtoCallback fidelity_params_callback)
在单独的线程上下载保真度参数。

函数

TuningFork_findFidelityParamsInApk

TFErrorCode TuningFork_findFidelityParamsInApk(
  JNIEnv *env,
  jobject context,
  const char *filename,
  CProtobufSerialization *fidelity_params
)

从 assets/tuningfork/ 加载保真度参数，将 fp 的所有权传递给调用方，由调用方调用 CProtobufSerialization_Free 以取消分配存储在结构体中的数据。

详细信息
参数
env
JNIEnv
context
应用上下文
filename
需加载的文件名
fidelity_params
对发现的保真度参数进行协议缓冲区序列化。
返回值
如果无错误，则为 TFERROR_OK

TuningFork_saveOrDeleteFidelityParamsFile

TFErrorCode TuningFork_saveOrDeleteFidelityParamsFile(
  JNIEnv *env,
  jobject context,
  const CProtobufSerialization *fidelity_params
)

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

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

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

TuningFork_startFidelityParamDownloadThread

TFErrorCode TuningFork_startFidelityParamDownloadThread(
  const CProtobufSerialization *default_params,
  ProtoCallback fidelity_params_callback
)

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

系统会激活下载线程以检索保真度参数，并会持续重试，直到下载成功或发生超时。下载的参数存储在本地，当以后启动应用时，这些参数将取代默认参数。请求将基于初始化 Tuning Fork 时使用的 TFSettings 结构体中的 initial_request_timeout_ms 和 ultimate_request_timeout_ms 字段发生超时。

详细信息
参数
default_params
该 protobuf 序列化包含保真度参数，如果没有下载连接且没有已保存的参数，则将使用这些参数。
fidelity_params_callback
使用已下载的参数或默认/已保存的参数调用。
返回值
如果无错误，则为 TFERROR_OK