播放相关 API

PlayVehicleRecord

函数作用:播放载具轨迹文件
基本构造:PlayVehicleRecord( vehicle, name, id, speed, pedAi, async )
示例代码:

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
local name  = "testdrive" -- 轨迹文件名
local id    = 1           -- 轨迹文件 ID
local speed = 1.0         -- 播放速度
exports.zerodream_records:PlayVehicleRecord(vehicle, name, id, speed, false)

StopPlayingRecord

函数作用:停止播放载具轨迹文件
基本构造:StopPlayingRecord( vehicle )
示例代码:

local vehicle = GetVehiclePedIsIn(PlayerPedId(), false)
exports.zerodream_records:StopPlayingRecord(vehicle)

PreloadRecord

函数作用:预加载载具轨迹文件
基本构造:PreloadRecord( name, id, timeout )
示例代码:

local name    = "testdrive" -- 轨迹文件名
local id      = 1           -- 轨迹文件 ID
local timeout = 10000       -- 超时时间
exports.zerodream_records:PreloadRecord(name, id, timeout)

LoadVehicleRecord

函数作用:加载载具轨迹文件
基本构造:LoadVehicleRecord( name, id, cache )
示例代码:

local name  = "testdrive" -- 轨迹文件名
local id    = 1           -- 轨迹文件 ID
local cache = false       -- 是否从本地缓存加载
exports.zerodream_records:LoadVehicleRecord(name, id, cache)

LoadVehicleRecordFromUrl

函数作用:从网络加载载具轨迹文件
基本构造:LoadVehicleRecordFromUrl( url, name, id )
示例代码:

local url  = "http://example.com/testdrive.yvr" -- 轨迹文件 URL
local name = "testdrive"                        -- 轨迹文件名
local id   = 1                                  -- 轨迹文件 ID
exports.zerodream_records:LoadVehicleRecordFromUrl(url, name, id)

UnloadVehicleRecord

函数作用:卸载载具轨迹文件
基本构造:UnloadVehicleRecord( name, id )
示例代码:

local name = "testdrive" -- 轨迹文件名
local id   = 1           -- 轨迹文件 ID
exports.zerodream_records:UnloadVehicleRecord(name, id)

关于预加载

由于 LoadVehicleRecord 函数会在调用的时候请求服务器读取载具轨迹文件,读取并传输文件需要较长时间,可能会影响游戏体验,因此我们加入了预加载功能,您可以通过 PreloadRecord 函数提前将轨迹文件加载到内存,然后在调用 LoadVehicleRecord 时将 cache 参数设置为 true 即可瞬间完成加载,无需等待。