F1® 25 UDP 数据格式开发文档

概述

F1® 25 游戏支持通过 UDP 连接输出游戏数据。这些数据可用于为外部应用程序提供比赛信息，或驱动特定硬件（如运动平台、力反馈方向盘和 LED 设备）。

重要说明

字节序: 所有数据使用小端序（Little Endian）编码
数据打包: 所有数据结构都是紧密打包的，没有填充字节
数据包格式标识: 2025
最大车辆数: 22

数据类型定义

类型	说明	字节数
`uint8`	无符号 8 位整数	1
`int8`	有符号 8 位整数	1
`uint16`	无符号 16 位整数	2
`int16`	有符号 16 位整数	2
`uint32`	无符号 32 位整数	4
`float`	单精度浮点数	4
`double`	双精度浮点数	8
`uint64`	无符号 64 位整数	8
`char`	字符	1

数据包头部

每个数据包都包含以下通用头部结构。

PacketHeader 结构

大小: 29 字节

字段名	类型	偏移	说明
`m_packetFormat`	uint16	0	数据包格式版本号，固定为 2025
`m_gameYear`	uint8	2	游戏年份的后两位，例如 25
`m_gameMajorVersion`	uint8	3	游戏主版本号，例如 "X.00" 中的 X
`m_gameMinorVersion`	uint8	4	游戏次版本号，例如 "1.XX" 中的 XX
`m_packetVersion`	uint8	5	此数据包类型的版本号，从 1 开始
`m_packetId`	uint8	6	数据包类型标识符（见下表）
`m_sessionUID`	uint64	7	会话的唯一标识符
`m_sessionTime`	float	15	会话时间戳（秒）
`m_frameIdentifier`	uint32	19	数据检索时的帧标识符
`m_overallFrameIdentifier`	uint32	23	总体帧标识符（不会因闪回而回退）
`m_playerCarIndex`	uint8	27	玩家车辆在数组中的索引
`m_secondaryPlayerCarIndex`	uint8	28	第二玩家车辆索引（分屏模式），255 表示无第二玩家

数据包类型

数据包 ID 列表

包名称	ID	频率	大小(字节)	说明
Motion	0	按菜单设置的频率	1349	玩家车辆的运动数据
Session	1	每秒 2 次	753	会话信息（赛道、剩余时间）
Lap Data	2	按菜单设置的频率	1285	所有车辆的圈速数据
Event	3	事件发生时	45	会话期间发生的各种事件
Participants	4	每 5 秒	1284	会话中的参与者列表
Car Setups	5	每秒 2 次	1133	比赛中车辆的设置详情
Car Telemetry	6	按菜单设置的频率	1352	所有车辆的遥测数据
Car Status	7	按菜单设置的频率	1239	所有车辆的状态数据
Final Classification	8	比赛结束时一次	1042	比赛结束时的最终排名
Lobby Info	9	大厅中每秒 2 次	954	多人大厅中的玩家信息
Car Damage	10	每秒 10 次	1041	所有车辆的损伤状态
Session History	11	每秒 20 次（循环）	1460	圈速和轮胎使用历史
Tyre Sets	12	每秒 20 次（循环）	231	扩展轮胎组数据
Motion Ex	13	按菜单设置的频率	273	玩家车辆的扩展运动数据
Time Trial	14	每秒 1 次	101	计时赛特定数据
Lap Positions	15	每秒 1 次	1131	每圈的位置信息

1. Motion Packet (ID: 0)

运动数据包提供所有车辆的物理数据。

频率: 按菜单设置的频率
大小: 1349 字节
版本: 1

CarMotionData 结构

大小: 60 字节（每辆车）

字段名	类型	说明
`m_worldPositionX`	float	世界空间 X 坐标（米）
`m_worldPositionY`	float	世界空间 Y 坐标（米）
`m_worldPositionZ`	float	世界空间 Z 坐标（米）
`m_worldVelocityX`	float	世界空间 X 轴速度（米/秒）
`m_worldVelocityY`	float	世界空间 Y 轴速度（米/秒）
`m_worldVelocityZ`	float	世界空间 Z 轴速度（米/秒）
`m_worldForwardDirX`	int16	世界空间前向 X 方向（归一化，需除以 32767.0）
`m_worldForwardDirY`	int16	世界空间前向 Y 方向（归一化）
`m_worldForwardDirZ`	int16	世界空间前向 Z 方向（归一化）
`m_worldRightDirX`	int16	世界空间右向 X 方向（归一化）
`m_worldRightDirY`	int16	世界空间右向 Y 方向（归一化）
`m_worldRightDirZ`	int16	世界空间右向 Z 方向（归一化）
`m_gForceLateral`	float	横向 G 力分量
`m_gForceLongitudinal`	float	纵向 G 力分量
`m_gForceVertical`	float	垂直 G 力分量
`m_yaw`	float	偏航角（弧度）
`m_pitch`	float	俯仰角（弧度）
`m_roll`	float	翻滚角（弧度）

PacketMotionData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carMotionData[22]`	CarMotionData	赛道上所有车辆的运动数据

2. Session Packet (ID: 1)

会话数据包包含当前进行中的会话详情。

频率: 每秒 2 次
大小: 753 字节
版本: 1

MarshalZone 结构

大小: 5 字节

字段名	类型	说明
`m_zoneStart`	float	赛道中裁判区开始的位置（0-1 的分数值）
`m_zoneFlag`	int8	旗帜类型：-1=无效/未知，0=无，1=绿旗，2=蓝旗，3=黄旗

WeatherForecastSample 结构

大小: 8 字节

字段名	类型	说明
`m_sessionType`	uint8	会话类型，0=未知，参见附录
`m_timeOffset`	uint8	预报时间偏移（分钟）
`m_weather`	uint8	天气：0=晴朗，1=少云，2=阴天，3=小雨，4=大雨，5=暴风雨
`m_trackTemperature`	int8	赛道温度（摄氏度）
`m_trackTemperatureChange`	int8	赛道温度变化：0=上升，1=下降，2=不变
`m_airTemperature`	int8	空气温度（摄氏度）
`m_airTemperatureChange`	int8	空气温度变化：0=上升，1=下降，2=不变
`m_rainPercentage`	uint8	降雨概率（0-100）

PacketSessionData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_weather`	uint8	天气：0=晴朗，1=少云，2=阴天，3=小雨，4=大雨，5=暴风雨
`m_trackTemperature`	int8	赛道温度（摄氏度）
`m_airTemperature`	int8	空气温度（摄氏度）
`m_totalLaps`	uint8	比赛总圈数
`m_trackLength`	uint16	赛道长度（米）
`m_sessionType`	uint8	会话类型，参见附录
`m_trackId`	int8	赛道 ID，-1 表示未知，参见附录
`m_formula`	uint8	赛事类型：0=F1现代，1=F1经典，2=F2，3=F1通用，4=Beta，6=电竞，8=F1世界，9=F1淘汰赛
`m_sessionTimeLeft`	uint16	会话剩余时间（秒）
`m_sessionDuration`	uint16	会话持续时间（秒）
`m_pitSpeedLimit`	uint8	维修站速度限制（公里/小时）
`m_gamePaused`	uint8	游戏是否暂停（仅网络游戏）：0=否，1=是
`m_isSpectating`	uint8	玩家是否在观战：0=否，1=是
`m_spectatorCarIndex`	uint8	正在观战的车辆索引
`m_sliProNativeSupport`	uint8	SLI Pro 支持：0=未激活，1=激活
`m_numMarshalZones`	uint8	裁判区数量
`m_marshalZones[21]`	MarshalZone	裁判区列表，最多 21 个
`m_safetyCarStatus`	uint8	安全车状态：0=无，1=全场，2=虚拟，3=暖胎圈
`m_networkGame`	uint8	网络游戏：0=离线，1=在线
`m_numWeatherForecastSamples`	uint8	天气预报样本数量
`m_weatherForecastSamples[64]`	WeatherForecastSample	天气预报样本数组
`m_forecastAccuracy`	uint8	预报准确度：0=完美，1=近似
`m_aiDifficulty`	uint8	AI 难度等级（0-110）
`m_seasonLinkIdentifier`	uint32	赛季标识符（跨存档持久）
`m_weekendLinkIdentifier`	uint32	周末标识符（跨存档持久）
`m_sessionLinkIdentifier`	uint32	会话标识符（跨存档持久）
`m_pitStopWindowIdealLap`	uint8	当前策略的理想进站圈数（玩家）
`m_pitStopWindowLatestLap`	uint8	当前策略的最晚进站圈数（玩家）
`m_pitStopRejoinPosition`	uint8	预测的重新加入位置（玩家）
`m_steeringAssist`	uint8	转向辅助：0=关，1=开
`m_brakingAssist`	uint8	刹车辅助：0=关，1=低，2=中，3=高
`m_gearboxAssist`	uint8	变速箱辅助：1=手动，2=手动+建议档位，3=自动
`m_pitAssist`	uint8	进站辅助：0=关，1=开
`m_pitReleaseAssist`	uint8	出站辅助：0=关，1=开
`m_ERSAssist`	uint8	ERS 辅助：0=关，1=开
`m_DRSAssist`	uint8	DRS 辅助：0=关，1=开
`m_dynamicRacingLine`	uint8	动态赛车线：0=关，1=仅弯道，2=完整
`m_dynamicRacingLineType`	uint8	赛车线类型：0=2D，1=3D
`m_gameMode`	uint8	游戏模式 ID，参见附录
`m_ruleSet`	uint8	规则集，参见附录
`m_timeOfDay`	uint32	一天中的时间（自午夜起的分钟数）
`m_sessionLength`	uint8	会话长度：0=无，2=很短，3=短，4=中，5=中长，6=长，7=完整
`m_speedUnitsLeadPlayer`	uint8	主玩家速度单位：0=MPH，1=KPH
`m_temperatureUnitsLeadPlayer`	uint8	主玩家温度单位：0=摄氏度，1=华氏度
`m_speedUnitsSecondaryPlayer`	uint8	第二玩家速度单位：0=MPH，1=KPH
`m_temperatureUnitsSecondaryPlayer`	uint8	第二玩家温度单位：0=摄氏度，1=华氏度
`m_numSafetyCarPeriods`	uint8	会话中出动安全车的次数
`m_numVirtualSafetyCarPeriods`	uint8	会话中虚拟安全车的次数
`m_numRedFlagPeriods`	uint8	会话中红旗的次数
`m_equalCarPerformance`	uint8	车辆性能均衡：0=关，1=开
`m_recoveryMode`	uint8	恢复模式：0=无，1=闪回，2=自动恢复
`m_flashbackLimit`	uint8	闪回限制：0=低，1=中，2=高，3=无限
`m_surfaceType`	uint8	路面类型：0=简化，1=真实
`m_lowFuelMode`	uint8	低燃油模式：0=简单，1=困难
`m_raceStarts`	uint8	比赛起步：0=手动，1=辅助
`m_tyreTemperature`	uint8	轮胎温度：0=仅表面，1=表面+胎体
`m_pitLaneTyreSim`	uint8	维修站轮胎模拟：0=开，1=关
`m_carDamage`	uint8	车辆损伤：0=关，1=减少，2=标准，3=模拟
`m_carDamageRate`	uint8	车辆损伤率：0=减少，1=标准，2=模拟
`m_collisions`	uint8	碰撞：0=关，1=玩家间关闭，2=开
`m_collisionsOffForFirstLapOnly`	uint8	仅第一圈关闭碰撞：0=禁用，1=启用
`m_mpUnsafePitRelease`	uint8	多人不安全出站：0=开，1=关
`m_mpOffForGriefing`	uint8	多人恶意行为关闭：0=禁用，1=启用
`m_cornerCuttingStringency`	uint8	切弯严格度：0=常规，1=严格
`m_parcFermeRules`	uint8	Parc Fermé 规则：0=关，1=开
`m_pitStopExperience`	uint8	进站体验：0=自动，1=广播，2=沉浸
`m_safetyCar`	uint8	安全车：0=关，1=减少，2=标准，3=增加
`m_safetyCarExperience`	uint8	安全车体验：0=广播，1=沉浸
`m_formationLap`	uint8	暖胎圈：0=关，1=开
`m_formationLapExperience`	uint8	暖胎圈体验：0=广播，1=沉浸
`m_redFlags`	uint8	红旗：0=关，1=减少，2=标准，3=增加
`m_affectsLicenceLevelSolo`	uint8	影响单人执照等级：0=关，1=开
`m_affectsLicenceLevelMP`	uint8	影响多人执照等级：0=关，1=开
`m_numSessionsInWeekend`	uint8	周末会话数量
`m_weekendStructure[12]`	uint8	周末结构会话类型列表，参见附录
`m_sector2LapDistanceStart`	float	第 2 扇区开始的赛道距离（米）
`m_sector3LapDistanceStart`	float	第 3 扇区开始的赛道距离（米）

3. Lap Data Packet (ID: 2)

圈速数据包提供会话中所有车辆的详细信息。

频率: 按菜单设置的频率
大小: 1285 字节
版本: 1

LapData 结构

大小: 58 字节（每辆车）

字段名	类型	说明
`m_lastLapTimeInMS`	uint32	上一圈时间（毫秒）
`m_currentLapTimeInMS`	uint32	当前圈时间（毫秒）
`m_sector1TimeMSPart`	uint16	第 1 扇区时间的毫秒部分
`m_sector1TimeMinutesPart`	uint8	第 1 扇区时间的分钟部分
`m_sector2TimeMSPart`	uint16	第 2 扇区时间的毫秒部分
`m_sector2TimeMinutesPart`	uint8	第 2 扇区时间的分钟部分
`m_deltaToCarInFrontMSPart`	uint16	与前车时间差的毫秒部分
`m_deltaToCarInFrontMinutesPart`	uint8	与前车时间差的分钟部分
`m_deltaToRaceLeaderMSPart`	uint16	与领先者时间差的毫秒部分
`m_deltaToRaceLeaderMinutesPart`	uint8	与领先者时间差的分钟部分
`m_lapDistance`	float	当前圈的距离（米），可能为负
`m_totalDistance`	float	会话中的总距离（米），可能为负
`m_safetyCarDelta`	float	安全车时间差（秒）
`m_carPosition`	uint8	车辆比赛位置
`m_currentLapNum`	uint8	当前圈数
`m_pitStatus`	uint8	进站状态：0=无，1=正在进站，2=在维修区
`m_numPitStops`	uint8	本场比赛的进站次数
`m_sector`	uint8	当前扇区：0=扇区1，1=扇区2，2=扇区3
`m_currentLapInvalid`	uint8	当前圈是否无效：0=有效，1=无效
`m_penalties`	uint8	累计时间处罚（秒）
`m_totalWarnings`	uint8	累计警告数
`m_cornerCuttingWarnings`	uint8	累计切弯警告数
`m_numUnservedDriveThroughPens`	uint8	未执行的通过维修站处罚数
`m_numUnservedStopGoPens`	uint8	未执行的停站处罚数
`m_gridPosition`	uint8	发车位置
`m_driverStatus`	uint8	驾驶员状态：0=车库，1=飞驰圈，2=进站圈，3=出站圈，4=赛道上
`m_resultStatus`	uint8	结果状态：0=无效，1=未激活，2=激活，3=完成，4=未完成，5=被取消资格，6=未分类，7=退赛
`m_pitLaneTimerActive`	uint8	维修站计时器：0=未激活，1=激活
`m_pitLaneTimeInLaneInMS`	uint16	在维修站的时间（毫秒，如果激活）
`m_pitStopTimerInMS`	uint16	实际进站时间（毫秒）
`m_pitStopShouldServePen`	uint8	是否应在此站执行处罚
`m_speedTrapFastestSpeed`	float	此车通过速度陷阱的最快速度（公里/小时）
`m_speedTrapFastestLap`	uint8	达到最快速度的圈数，255=未设置

PacketLapData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_lapData[22]`	LapData	赛道上所有车辆的圈速数据
`m_timeTrialPBCarIdx`	uint8	计时赛个人最佳车辆索引（255=无效）
`m_timeTrialRivalCarIdx`	uint8	计时赛对手车辆索引（255=无效）

4. Event Packet (ID: 3)

此数据包提供会话期间发生的事件详情。

频率: 事件发生时
大小: 45 字节
版本: 1

事件字符串代码

事件代码	说明
"SSTA"	会话开始
"SEND"	会话结束
"FTLP"	最快圈速
"RTMT"	车手退赛
"DRSE"	DRS 启用
"DRSD"	DRS 禁用
"TMPT"	队友进站
"CHQF"	挥动方格旗
"RCWN"	比赛获胜者
"PENA"	发出处罚
"SPTP"	触发速度陷阱
"STLG"	起步灯
"LGOT"	灯灭
"DTSV"	通过维修站处罚已执行
"SGSV"	停站处罚已执行
"FLBK"	闪回激活
"BUTN"	按钮状态
"RDFL"	红旗
"OVTK"	超车
"SCAR"	安全车
"COLL"	碰撞

EventDataDetails 联合体

根据事件类型，包含不同的数据结构：

FastestLap（最快圈速）

字段名	类型	说明
`vehicleIdx`	uint8	创造最快圈速的车辆索引
`lapTime`	float	圈速时间（秒）

Retirement（退赛）

字段名	类型	说明
`vehicleIdx`	uint8	退赛车辆索引
`reason`	uint8	原因：0=无效，1=退赛，2=完成，3=终端损伤，4=未激活，5=圈数不足，6=黑旗，7=红旗，8=机械故障，9=跳过会话，10=模拟会话

DRSDisabled（DRS禁用）

字段名	类型	说明
`reason`	uint8	原因：0=湿赛道，1=安全车部署，2=红旗，3=未达到最小圈数

TeamMateInPits（队友进站）

字段名	类型	说明
`vehicleIdx`	uint8	队友车辆索引

RaceWinner（比赛获胜者）

字段名	类型	说明
`vehicleIdx`	uint8	获胜车辆索引

Penalty（处罚）

字段名	类型	说明
`penaltyType`	uint8	处罚类型，参见附录
`infringementType`	uint8	违规类型，参见附录
`vehicleIdx`	uint8	被处罚车辆索引
`otherVehicleIdx`	uint8	涉及的其他车辆索引
`time`	uint8	获得的时间或执行动作的时间（秒）
`lapNum`	uint8	发生处罚的圈数
`placesGained`	uint8	获得的位置数

SpeedTrap（速度陷阱）

字段名	类型	说明
`vehicleIdx`	uint8	触发速度陷阱的车辆索引
`speed`	float	达到的最高速度（公里/小时）
`isOverallFastestInSession`	uint8	是否是会话中总体最快速度：1=是，0=否
`isDriverFastestInSession`	uint8	是否是该车手会话中最快速度：1=是，0=否
`fastestVehicleIdxInSession`	uint8	会话中最快车辆的索引
`fastestSpeedInSession`	float	会话中最快车辆的速度

StartLights（起步灯）

字段名	类型	说明
`numLights`	uint8	显示的灯数

StopGoPenaltyServed（停站处罚已执行）

字段名	类型	说明
`vehicleIdx`	uint8	执行停站处罚的车辆索引
`stopTime`	float	停站时间（秒）

SafetyCar（安全车）

字段名	类型	说明
`safetyCarType`	uint8	安全车类型：0=无，1=全场，2=虚拟，3=暖胎圈
`eventType`	uint8	事件类型：0=部署，1=返回，2=已返回，3=恢复比赛

Collision（碰撞）

字段名	类型	说明
`vehicle1Idx`	uint8	碰撞中第一辆车的索引
`vehicle2Idx`	uint8	碰撞中第二辆车的索引

PacketEventData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_eventStringCode[4]`	uint8	事件字符串代码
`m_eventDetails`	EventDataDetails	事件详情（根据类型解释）

5. Participants Packet (ID: 4)

参与者列表数据包。对于 AI 控制的车辆，名称为车手名称。对于多人游戏，名称将是 Steam ID（PC）或 LAN 名称。

频率: 每 5 秒
大小: 1284 字节
版本: 1

LiveryColour 结构

大小: 3 字节

字段名	类型	说明
`red`	uint8	红色值（0-255）
`green`	uint8	绿色值（0-255）
`blue`	uint8	蓝色值（0-255）

ParticipantData 结构

大小: 58 字节（每个参与者）

字段名	类型	说明
`m_aiControlled`	uint8	是否为 AI 控制：1=AI，0=人类
`m_driverId`	uint8	车手 ID，参见附录，255=网络人类玩家
`m_networkId`	uint8	网络 ID（网络玩家的唯一标识符）
`m_teamId`	uint8	车队 ID，参见附录
`m_myTeam`	uint8	我的车队标志：1=我的车队，0=其他
`m_raceNumber`	uint8	赛车号码
`m_nationality`	uint8	车手国籍，参见附录
`m_name[32]`	char	参与者名称（UTF-8 格式，null 结尾）
`m_yourTelemetry`	uint8	玩家的 UDP 设置：0=受限，1=公开
`m_showOnlineNames`	uint8	显示在线名称设置：0=关，1=开
`m_techLevel`	uint16	F1 世界科技等级
`m_platform`	uint8	平台：1=Steam，3=PlayStation，4=Xbox，6=Origin，255=未知
`m_numColours`	uint8	有效颜色数量
`m_liveryColours[4]`	LiveryColour	车辆颜色

PacketParticipantsData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_numActiveCars`	uint8	活跃车辆数量（应与 HUD 上的车辆数匹配）
`m_participants[22]`	ParticipantData	参与者数据

6. Car Setups Packet (ID: 5)

此数据包详细说明会话中每辆车的设置。注意，在多人游戏中，其他玩家的车辆将显示为空白，您只能看到自己的车辆设置。

频率: 每秒 2 次
大小: 1133 字节
版本: 1

CarSetupData 结构

大小: 51 字节（每辆车）

字段名	类型	说明
`m_frontWing`	uint8	前翼下压力
`m_rearWing`	uint8	后翼下压力
`m_onThrottle`	uint8	油门时的差速器调整（百分比）
`m_offThrottle`	uint8	松油门时的差速器调整（百分比）
`m_frontCamber`	float	前轮外倾角（悬挂几何）
`m_rearCamber`	float	后轮外倾角（悬挂几何）
`m_frontToe`	float	前轮前束角（悬挂几何）
`m_rearToe`	float	后轮前束角（悬挂几何）
`m_frontSuspension`	uint8	前悬挂
`m_rearSuspension`	uint8	后悬挂
`m_frontAntiRollBar`	uint8	前防倾杆
`m_rearAntiRollBar`	uint8	后防倾杆
`m_frontSuspensionHeight`	uint8	前车身高度
`m_rearSuspensionHeight`	uint8	后车身高度
`m_brakePressure`	uint8	刹车压力（百分比）
`m_brakeBias`	uint8	刹车平衡（百分比）
`m_engineBraking`	uint8	引擎制动（百分比）
`m_rearLeftTyrePressure`	float	左后轮胎压（PSI）
`m_rearRightTyrePressure`	float	右后轮胎压（PSI）
`m_frontLeftTyrePressure`	float	左前轮胎压（PSI）
`m_frontRightTyrePressure`	float	右前轮胎压（PSI）
`m_ballast`	uint8	配重
`m_fuelLoad`	float	燃油负载

PacketCarSetupData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carSetups[22]`	CarSetupData	车辆设置
`m_nextFrontWingValue`	float	下次进站后的前翼值（仅玩家）

7. Car Telemetry Packet (ID: 6)

此数据包详细说明比赛中所有车辆的遥测数据。

频率: 按菜单设置的频率
大小: 1352 字节
版本: 1

CarTelemetryData 结构

大小: 61 字节（每辆车）

字段名	类型	说明
`m_speed`	uint16	车速（公里/小时）
`m_throttle`	float	油门开度（0.0 到 1.0）
`m_steer`	float	转向角度（-1.0 完全左转，1.0 完全右转）
`m_brake`	float	刹车力度（0.0 到 1.0）
`m_clutch`	uint8	离合器踩下量（0 到 100）
`m_gear`	int8	档位（1-8，N=0，R=-1）
`m_engineRPM`	uint16	引擎转速
`m_drs`	uint8	DRS 状态：0=关，1=开
`m_revLightsPercent`	uint8	转速灯指示（百分比）
`m_revLightsBitValue`	uint16	转速灯（位 0=最左 LED，位 14=最右 LED）
`m_brakesTemperature[4]`	uint16	刹车温度（摄氏度）
`m_tyresSurfaceTemperature[4]`	uint8	轮胎表面温度（摄氏度）
`m_tyresInnerTemperature[4]`	uint8	轮胎内部温度（摄氏度）
`m_engineTemperature`	uint16	引擎温度（摄氏度）
`m_tyresPressure[4]`	float	轮胎压力（PSI）
`m_surfaceType[4]`	uint8	驾驶表面类型，参见附录

注意: 所有轮胎数组顺序为：[0]=左后，[1]=右后，[2]=左前，[3]=右前

PacketCarTelemetryData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carTelemetryData[22]`	CarTelemetryData	车辆遥测数据
`m_mfdPanelIndex`	uint8	打开的 MFD 面板索引，255=MFD 关闭
`m_mfdPanelIndexSecondaryPlayer`	uint8	第二玩家的 MFD 面板索引
`m_suggestedGear`	int8	建议档位（1-8），0=无建议

8. Car Status Packet (ID: 7)

此数据包详细说明比赛中所有车辆的状态。

频率: 按菜单设置的频率
大小: 1239 字节
版本: 1

CarStatusData 结构

大小: 56 字节（每辆车）

字段名	类型	说明
`m_tractionControl`	uint8	牵引力控制：0=关，1=中，2=完全
`m_antiLockBrakes`	uint8	防抱死刹车：0=关，1=开
`m_fuelMix`	uint8	燃油混合：0=精益，1=标准，2=富油，3=最大
`m_frontBrakeBias`	uint8	前刹车平衡（百分比）
`m_pitLimiterStatus`	uint8	维修站限速器状态：0=关，1=开
`m_fuelInTank`	float	当前油箱燃油量
`m_fuelCapacity`	float	油箱容量
`m_fuelRemainingLaps`	float	剩余燃油圈数（MFD 上的值）
`m_maxRPM`	uint16	车辆最大转速（转速限制器点）
`m_idleRPM`	uint16	车辆怠速转速
`m_maxGears`	uint8	最大档位数
`m_drsAllowed`	uint8	DRS 是否允许：0=不允许，1=允许
`m_drsActivationDistance`	uint16	DRS 激活距离，0=不可用，非零=可在 X 米内使用
`m_actualTyreCompound`	uint8	实际轮胎配方，参见附录
`m_visualTyreCompound`	uint8	视觉轮胎配方，参见附录
`m_tyresAgeLaps`	uint8	当前轮胎组的使用圈数
`m_vehicleFiaFlags`	int8	FIA 旗帜：-1=无效/未知，0=无，1=绿旗，2=蓝旗，3=黄旗
`m_enginePowerICE`	float	内燃机功率输出（瓦）
`m_enginePowerMGUK`	float	MGU-K 功率输出（瓦）
`m_ersStoreEnergy`	float	ERS 能量储存（焦耳）
`m_ersDeployMode`	uint8	ERS 部署模式：0=无，1=中等，2=热圈，3=超车
`m_ersHarvestedThisLapMGUK`	float	本圈 MGU-K 回收的 ERS 能量
`m_ersHarvestedThisLapMGUH`	float	本圈 MGU-H 回收的 ERS 能量
`m_ersDeployedThisLap`	float	本圈部署的 ERS 能量
`m_networkPaused`	uint8	车辆在网络游戏中是否暂停

PacketCarStatusData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carStatusData[22]`	CarStatusData	车辆状态数据

9. Final Classification Packet (ID: 8)

此数据包详细说明比赛结束时的最终排名。

频率: 比赛结束时一次
大小: 1042 字节
版本: 1

FinalClassificationData 结构

大小: 47 字节（每辆车）

字段名	类型	说明
`m_position`	uint8	完赛位置
`m_numLaps`	uint8	完成的圈数
`m_gridPosition`	uint8	发车位置
`m_points`	uint8	获得的积分
`m_numPitStops`	uint8	进站次数
`m_resultStatus`	uint8	结果状态：0=无效，1=未激活，2=激活，3=完成，4=未完成，5=被取消资格，6=未分类，7=退赛
`m_resultReason`	uint8	结果原因：0=无效，1=退赛，2=完成，3=终端损伤，4=未激活，5=圈数不足，6=黑旗，7=红旗，8=机械故障，9=跳过会话，10=模拟会话
`m_bestLapTimeInMS`	uint32	会话中的最佳圈速（毫秒）
`m_totalRaceTime`	double	总比赛时间（秒，不含处罚）
`m_penaltiesTime`	uint8	累计处罚时间（秒）
`m_numPenalties`	uint8	处罚次数
`m_numTyreStints`	uint8	轮胎使用段数
`m_tyreStintsActual[8]`	uint8	车手使用的实际轮胎
`m_tyreStintsVisual[8]`	uint8	车手使用的视觉轮胎
`m_tyreStintsEndLaps[8]`	uint8	轮胎段结束的圈数

PacketFinalClassificationData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_numCars`	uint8	最终排名中的车辆数
`m_classificationData[22]`	FinalClassificationData	排名数据

10. Lobby Info Packet (ID: 9)

此数据包详细说明当前在多人大厅中的玩家。

频率: 大厅中每秒 2 次
大小: 954 字节
版本: 1

LobbyInfoData 结构

大小: 43 字节（每个玩家）

字段名	类型	说明
`m_aiControlled`	uint8	是否为 AI 控制：1=AI，0=人类
`m_teamId`	uint8	车队 ID，参见附录，255=未选择车队
`m_nationality`	uint8	车手国籍
`m_platform`	uint8	平台：1=Steam，3=PlayStation，4=Xbox，6=Origin，255=未知
`m_name[32]`	char	参与者名称（UTF-8 格式）
`m_carNumber`	uint8	玩家的赛车号码
`m_yourTelemetry`	uint8	玩家的 UDP 设置：0=受限，1=公开
`m_showOnlineNames`	uint8	显示在线名称设置：0=关，1=开
`m_techLevel`	uint16	F1 世界科技等级
`m_readyStatus`	uint8	准备状态：0=未准备，1=准备，2=观战

PacketLobbyInfoData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_numPlayers`	uint8	大厅中的玩家数
`m_lobbyPlayers[22]`	LobbyInfoData	大厅玩家数据

11. Car Damage Packet (ID: 10)

此数据包详细说明比赛中所有车辆的损伤参数。

频率: 每秒 10 次
大小: 1041 字节
版本: 1

CarDamageData 结构

大小: 47 字节（每辆车）

字段名	类型	说明
`m_tyresWear[4]`	float	轮胎磨损（百分比）
`m_tyresDamage[4]`	uint8	轮胎损伤（百分比）
`m_brakesDamage[4]`	uint8	刹车损伤（百分比）
`m_tyreBlisters[4]`	uint8	轮胎起泡值（百分比）
`m_frontLeftWingDamage`	uint8	左前翼损伤（百分比）
`m_frontRightWingDamage`	uint8	右前翼损伤（百分比）
`m_rearWingDamage`	uint8	后翼损伤（百分比）
`m_floorDamage`	uint8	底板损伤（百分比）
`m_diffuserDamage`	uint8	扩散器损伤（百分比）
`m_sidepodDamage`	uint8	侧箱损伤（百分比）
`m_drsFault`	uint8	DRS 故障：0=正常，1=故障
`m_ersFault`	uint8	ERS 故障：0=正常，1=故障
`m_gearBoxDamage`	uint8	变速箱损伤（百分比）
`m_engineDamage`	uint8	引擎损伤（百分比）
`m_engineMGUHWear`	uint8	引擎 MGU-H 磨损（百分比）
`m_engineESWear`	uint8	引擎 ES 磨损（百分比）
`m_engineCEWear`	uint8	引擎 CE 磨损（百分比）
`m_engineICEWear`	uint8	引擎 ICE 磨损（百分比）
`m_engineMGUKWear`	uint8	引擎 MGU-K 磨损（百分比）
`m_engineTCWear`	uint8	引擎 TC 磨损（百分比）
`m_engineBlown`	uint8	引擎爆缸：0=正常，1=故障
`m_engineSeized`	uint8	引擎卡死：0=正常，1=故障

PacketCarDamageData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carDamageData[22]`	CarDamageData	车辆损伤数据

12. Session History Packet (ID: 11)

此数据包包含会话的圈速和轮胎使用情况。每个数据包关联一辆特定车辆，每 1/20 秒发送一次，循环发送车辆。

频率: 每秒 20 次（循环车辆）
大小: 1460 字节
版本: 1

LapHistoryData 结构

大小: 14 字节（每圈）

字段名	类型	说明
`m_lapTimeInMS`	uint32	圈速时间（毫秒）
`m_sector1TimeMSPart`	uint16	第 1 扇区毫秒部分
`m_sector1TimeMinutesPart`	uint8	第 1 扇区分钟部分
`m_sector2TimeMSPart`	uint16	第 2 扇区毫秒部分
`m_sector2TimeMinutesPart`	uint8	第 2 扇区分钟部分
`m_sector3TimeMSPart`	uint16	第 3 扇区毫秒部分
`m_sector3TimeMinutesPart`	uint8	第 3 扇区分钟部分
`m_lapValidBitFlags`	uint8	有效性标志：0x01=圈有效，0x02=扇区1有效，0x04=扇区2有效，0x08=扇区3有效

TyreStintHistoryData 结构

大小: 3 字节（每个轮胎段）

字段名	类型	说明
`m_endLap`	uint8	轮胎使用结束圈数（255=当前轮胎）
`m_tyreActualCompound`	uint8	车手使用的实际轮胎配方
`m_tyreVisualCompound`	uint8	车手使用的视觉轮胎配方

PacketSessionHistoryData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carIdx`	uint8	此圈速数据关联的车辆索引
`m_numLaps`	uint8	数据中的圈数（包括当前部分圈）
`m_numTyreStints`	uint8	数据中的轮胎段数
`m_bestLapTimeLapNum`	uint8	达到最佳圈速的圈数
`m_bestSector1LapNum`	uint8	达到最佳第 1 扇区的圈数
`m_bestSector2LapNum`	uint8	达到最佳第 2 扇区的圈数
`m_bestSector3LapNum`	uint8	达到最佳第 3 扇区的圈数
`m_lapHistoryData[100]`	LapHistoryData	最多 100 圈的历史数据
`m_tyreStintsHistoryData[8]`	TyreStintHistoryData	轮胎段历史数据

13. Tyre Sets Packet (ID: 12)

此数据包提供车辆在会话期间分配的轮胎组的详细信息。

频率: 每秒 20 次（循环车辆）
大小: 231 字节
版本: 1

TyreSetData 结构

大小: 11 字节（每组轮胎）

字段名	类型	说明
`m_actualTyreCompound`	uint8	实际使用的轮胎配方
`m_visualTyreCompound`	uint8	视觉使用的轮胎配方
`m_wear`	uint8	轮胎磨损（百分比）
`m_available`	uint8	此组是否当前可用
`m_recommendedSession`	uint8	此轮胎组的推荐会话，参见附录
`m_lifeSpan`	uint8	此轮胎组剩余圈数
`m_usableLife`	uint8	此配方推荐的最大圈数
`m_lapDeltaTime`	int16	与安装的轮胎组相比的圈速差（毫秒）
`m_fitted`	uint8	是否安装：0=否，1=是

PacketTyreSetsData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_carIdx`	uint8	此数据关联的车辆索引
`m_tyreSetData[20]`	TyreSetData	轮胎组数据（13 干胎 + 7 雨胎）
`m_fittedIdx`	uint8	安装的轮胎在数组中的索引

14. Motion Ex Packet (ID: 13)

运动扩展数据包为正在驾驶的车辆提供扩展数据，目标是能够驱动运动平台设置。

频率: 按菜单设置的频率
大小: 273 字节
版本: 1

PacketMotionExData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_suspensionPosition[4]`	float	悬挂位置
`m_suspensionVelocity[4]`	float	悬挂速度
`m_suspensionAcceleration[4]`	float	悬挂加速度
`m_wheelSpeed[4]`	float	每个车轮的速度
`m_wheelSlipRatio[4]`	float	每个车轮的滑移率
`m_wheelSlipAngle[4]`	float	每个车轮的滑移角
`m_wheelLatForce[4]`	float	每个车轮的横向力
`m_wheelLongForce[4]`	float	每个车轮的纵向力
`m_heightOfCOGAboveGround`	float	重心离地高度
`m_localVelocityX`	float	本地空间 X 轴速度（米/秒）
`m_localVelocityY`	float	本地空间 Y 轴速度
`m_localVelocityZ`	float	本地空间 Z 轴速度
`m_angularVelocityX`	float	角速度 X 分量（弧度/秒）
`m_angularVelocityY`	float	角速度 Y 分量
`m_angularVelocityZ`	float	角速度 Z 分量
`m_angularAccelerationX`	float	角加速度 X 分量（弧度/秒²）
`m_angularAccelerationY`	float	角加速度 Y 分量
`m_angularAccelerationZ`	float	角加速度 Z 分量
`m_frontWheelsAngle`	float	当前前轮角度（弧度）
`m_wheelVertForce[4]`	float	每个车轮的垂直力
`m_frontAeroHeight`	float	前扰流板边缘离地高度
`m_rearAeroHeight`	float	后扰流板边缘离地高度
`m_frontRollAngle`	float	前悬挂侧倾角
`m_rearRollAngle`	float	后悬挂侧倾角
`m_chassisYaw`	float	底盘相对运动方向的偏航角（弧度）
`m_chassisPitch`	float	底盘相对运动方向的俯仰角（弧度）
`m_wheelCamber[4]`	float	每个车轮的外倾角（弧度）
`m_wheelCamberGain[4]`	float	每个车轮的外倾增益（弧度，主动外倾与动态外倾的差）

注意: 所有车轮数组顺序为：[0]=左后，[1]=右后，[2]=左前，[3]=右前

15. Time Trial Packet (ID: 14)

计时赛数据包提供仅与计时赛游戏模式相关的额外信息。

频率: 每秒 1 次
大小: 101 字节
版本: 1

TimeTrialDataSet 结构

大小: 32 字节

字段名	类型	说明
`m_carIdx`	uint8	此数据关联的车辆索引
`m_teamId`	uint8	车队 ID，参见附录
`m_lapTimeInMS`	uint32	圈速时间（毫秒）
`m_sector1TimeInMS`	uint32	第 1 扇区时间（毫秒）
`m_sector2TimeInMS`	uint32	第 2 扇区时间（毫秒）
`m_sector3TimeInMS`	uint32	第 3 扇区时间（毫秒）
`m_tractionControl`	uint8	牵引力控制：0=辅助关，1=辅助开
`m_gearboxAssist`	uint8	变速箱辅助：0=辅助关，1=辅助开
`m_antiLockBrakes`	uint8	防抱死刹车：0=辅助关，1=辅助开
`m_equalCarPerformance`	uint8	车辆性能：0=真实，1=均衡
`m_customSetup`	uint8	自定义设置：0=否，1=是
`m_valid`	uint8	有效性：0=无效，1=有效

PacketTimeTrialData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_playerSessionBestDataSet`	TimeTrialDataSet	玩家会话最佳数据组
`m_personalBestDataSet`	TimeTrialDataSet	个人最佳数据组
`m_rivalDataSet`	TimeTrialDataSet	对手数据组

16. Lap Positions Packet (ID: 15)

圈位置数据包指示每辆车在每圈开始时的位置。最多传输 50 圈的数据。

频率: 每秒 1 次
大小: 1131 字节
版本: 1

PacketLapPositionsData 结构

字段名	类型	说明
`m_header`	PacketHeader	数据包头部
`m_numLaps`	uint8	数据中的圈数
`m_lapStart`	uint8	数据开始的圈索引（从 0 开始）
`m_positionForVehicleIdx[50][22]`	uint8	数组保存车辆在给定圈的位置，0=无记录

附录

车队 ID

ID	车队名称
0	梅赛德斯 (Mercedes)
1	法拉利 (Ferrari)
2	红牛赛车 (Red Bull Racing)
3	威廉姆斯 (Williams)
4	阿斯顿马丁 (Aston Martin)
5	阿尔卑斯 (Alpine)
6	RB
7	哈斯 (Haas)
8	迈凯伦 (McLaren)
9	索伯 (Sauber)
41	F1 通用
104	F1 自定义车队

赛道 ID

ID	赛道名称
0	墨尔本 (Melbourne)
2	上海 (Shanghai)
3	萨基尔/巴林 (Sakhir/Bahrain)
4	加泰罗尼亚 (Catalunya)
5	摩纳哥 (Monaco)
6	蒙特利尔 (Montreal)
7	银石 (Silverstone)
9	匈牙利环 (Hungaroring)
10	斯帕 (Spa)
11	蒙扎 (Monza)
12	新加坡 (Singapore)
13	铃鹿 (Suzuka)
14	阿布扎比 (Abu Dhabi)
15	德克萨斯/美洲赛道 (Texas/COTA)
16	巴西 (Brazil)
17	奥地利 (Austria)
19	墨西哥 (Mexico)
20	巴库/阿塞拜疆 (Baku/Azerbaijan)
26	赞德沃特 (Zandvoort)
27	伊莫拉 (Imola)
29	吉达 (Jeddah)
30	迈阿密 (Miami)
31	拉斯维加斯 (Las Vegas)
32	洛赛尔 (Losail)

会话类型

ID	会话类型
0	未知 (Unknown)
1	练习赛 1 (Practice 1)
2	练习赛 2 (Practice 2)
3	练习赛 3 (Practice 3)
4	短练习赛 (Short Practice)
5	排位赛 1 (Qualifying 1)
6	排位赛 2 (Qualifying 2)
7	排位赛 3 (Qualifying 3)
8	短排位赛 (Short Qualifying)
9	单圈排位赛 (One-Shot Qualifying)
10	冲刺赛排位 1 (Sprint Shootout 1)
11	冲刺赛排位 2 (Sprint Shootout 2)
12	冲刺赛排位 3 (Sprint Shootout 3)
13	短冲刺赛排位 (Short Sprint Shootout)
14	单圈冲刺赛排位 (One-Shot Sprint Shootout)
15	正赛 (Race)
16	正赛 2 (Race 2)
17	正赛 3 (Race 3)
18	计时赛 (Time Trial)

路面类型

ID	路面类型
0	柏油路 (Tarmac)
1	减速带 (Rumble strip)
2	混凝土 (Concrete)
3	岩石 (Rock)
4	砂砾 (Gravel)
5	泥地 (Mud)
6	沙地 (Sand)
7	草地 (Grass)
8	水面 (Water)
9	鹅卵石 (Cobblestone)
10	金属 (Metal)
11	波纹路面 (Ridged)

轮胎配方

F1 现代

ID	配方
16	C5
17	C4
18	C3
19	C2
20	C1
21	C0
22	C6
7	中性胎 (Inter)
8	雨胎 (Wet)

F1 视觉

ID	配方
16	软胎 (Soft)
17	中性胎 (Medium)
18	硬胎 (Hard)
7	中性胎 (Inter)
8	雨胎 (Wet)

处罚类型

ID	处罚类型
0	通过维修站 (Drive through)
1	停站处罚 (Stop Go)
2	发车位罚退 (Grid penalty)
3	处罚提醒 (Penalty reminder)
4	时间处罚 (Time penalty)
5	警告 (Warning)
6	取消资格 (Disqualified)
7	从暖胎圈移除 (Removed from formation lap)
8	停车时间过长计时器 (Parked too long timer)
9	轮胎规则违规 (Tyre regulations)
10	本圈无效 (This lap invalidated)
11	本圈和下一圈无效 (This and next lap invalidated)
16	退赛 (Retired)
17	黑旗计时器 (Black flag timer)

游戏模式 ID

ID	模式
4	大奖赛 '23 (Grand Prix '23)
5	计时赛 (Time Trial)
6	分屏 (Splitscreen)
7	在线自定义 (Online Custom)
15	在线每周赛事 (Online Weekly Event)
17	剧情模式/刹车点 (Story Mode - Braking Point)
27	我的车队生涯 '25 (My Team Career '25)
28	车手生涯 '25 (Driver Career '25)
29	在线生涯 '25 (Career '25 Online)
30	挑战生涯 '25 (Challenge Career '25)
75	剧情模式/APXGP (Story Mode - APXGP)
127	基准测试 (Benchmark)

UDP 配置

如何启用 UDP 遥测输出

在 F1 25 中，通过游戏内菜单控制 UDP 遥测输出：

进入主菜单的选项菜单（三角形 / Y）
进入设置菜单
UDP 选项在列表底部
可以启用/禁用 UDP 输出、配置 IP 地址和端口、切换广播模式并设置发送频率

高级 PC 用户 XML 配置

文件位置：...\Documents\My Games\<game_folder>\hardwaresettings\hardware_settings_config.xml


<motion>
  <udp enabled="false" broadcast="false" ip="127.0.0.1" port="20777" sendRate="20"
       format="2025" yourTelemetry="restricted" onlineNames="off" />
</motion>

参数说明

enabled: true/false - 是否启用 UDP 输出
broadcast: true/false - 广播模式，向网络子网中的多个设备传输数据
ip: 接收应用程序的 IP 地址
port: 端口号（默认 20777）
sendRate: 发送频率（Hz）
format: 数据格式（2025、2024 或 2023）
yourTelemetry: restricted/public - 遥测隐私设置
onlineNames: on/off - 是否显示在线名称

数据包发送频率

首帧数据包（会话时间戳 0.000）

Session
Participants
Car Setups
Lap Data
Motion Data
Car Telemetry
Car Status
Car Damage
Motion Ex Data

按菜单设置频率发送

Motion (0)
Lap Data (2)
Car Telemetry (6)
Car Status (7)
Motion Ex (13)

每秒 2 次

Session (1)
Car Setups (5)

每 5 秒

Participants (4)

每秒 10 次

Car Damage (10)

每秒 20 次（循环车辆）

Session History (11)
Tyre Sets (12)

事件触发

Event (3)
Final Classification (8) - 比赛结束时
Lobby Info (9) - 仅在大厅中

受限数据（遥测隐私设置）

当玩家将"Your Telemetry"设置为"Restricted"时，以下数据项对其他玩家将设置为零：

Car Status Packet

油箱燃油量及相关数据
ERS 系统数据
刹车平衡

Car Damage Packet

所有损伤数据

Tyre Sets Packet

所有轮胎组数据

F1 25 UDP 格式变更

相比去年（F1 24），F1 25 的变更包括：

事件数据包中增加了停站处罚时间
车辆损伤数据包中增加了轮胎起泡百分比
Motion Ex 数据包中增加了底盘俯仰角
参与者数据包中增加了车辆颜色（名称大小减少到 32 字符）
Motion Ex 数据包中增加了车轮外倾角和外倾增益
增加了 DRS 禁用的详细原因
退赛事件中增加了退赛原因
新增圈位置数据包 (ID: 15)
最终排名数据包中增加了结果原因
文档中增加了 C6 配方轮胎

开发注意事项

字节对齐: 所有结构都是紧密打包的，不要假设有任何填充字节
车辆索引: 在会话期间，每辆车分配一个车辆索引，不会改变
活跃车辆: 始终检查 m_numActiveCars 和每辆车的 resultStatus
归一化值: 方向向量（int16）需除以 32767.0 转换为浮点数
数组顺序: 所有车轮数组顺序为 [左后, 右后, 左前, 右前]
兼容性: F1 25 支持 2025、2024 和 2023 三种 UDP 格式

法律声明

F1® 25 Game - FIA Formula One World Championship™ 的官方产品

文档版本: 1.0
适用游戏: F1® 25
最后更新: 2025