设置截图缓存时间 - SetSnapCacheTime

函数简介

设置截图缓存时间，在指定时间内复用同一帧截图数据以提高性能。

接口名称

SetSnapCacheTime

DLL调用

int32_t SetSnapCacheTime(int64_t instance, int32_t cacheTime);

参数说明

参数名	类型	说明
instance	长整数型	OLAPlug对象的指针，由 CreateCOLAPlugInterFace 接口生成。
cacheTime	整数型	截图缓存时间（毫秒）。0 不缓存实时截图，>0 在指定毫秒数内缓存截图

示例

int32_t ret = SetSnapCacheTime(ola, 100);
if (ret == 1) {
    printf("已设置截图缓存时间为 100 ms\n");
}
// 关闭截图缓存
SetSnapCacheTime(ola, 0);

返回值

整数型：1 成功，0 失败。

注意事项

• 超过缓存时间后会自动重新截图并更新缓存帧。
• 此接口只影响截图相关接口（如 GetScreenDataPtr 等）。
• 对于频繁调用截图且画面变化不大的场景，建议启用适当的缓存时间以提高性能。