【Java】利用Garmin-Fit-SDK 对码表记录文件截取片段

已经很长时间不写随笔了，因为现在也是大AI时代了，很多问题AI来搞定

 

 

一、需求背景

本来是看有没有APP能实现的，Insta360和大疆都只支持剪自己家设备录制的

于是问AI看怎么处理，最开始的方案是装Dart和依赖来完成

 

二、用Dart无法满足需求

但是Dart只能读取Fit一些基本信息

 

感觉就挺无语😅，但是还得继续

 

三、Python也存在缺陷

接下来是用python了

 

 

显然提供的脚本漏洞百出，也没办法实现效果

 

四、Garmin Fit SDK 实现

 

 

 

Garmin 旧版 FIT SDK 的直接下载链接确实会出现 404，但官方现在把 SDK 托管在了 GitHub 组织 garmin​ 下，各语言版本都是独立仓库，可以直接 clone 或下载 ZIP。

官方 GitHub 仓库地址（当前有效）

 

语言	GitHub 仓库
Java（推荐，含 Encode 示例）	https://github.com/garmin/fit-java-sdk
C++	https://github.com/garmin/fit-cpp-sdk
C#	https://github.com/garmin/fit-csharp-sdk
JavaScript	https://github.com/garmin/fit-javascript-sdk
Python（仅解码）	https://github.com/garmin/fit-python-sdk

FIT SDK 配套工具（FitCSVTool、Profile.xlsx、ActivityRepairTool 等）在另一个仓库：

https://github.com/garmin/fit-sdk-tools

以上均为 Garmin 官方维护的仓库。

 

这里我用的是Java, 配套JDK8，Maven版本 3.9.x

 

这里不展示跟AI反复修正的代码逻辑过程，贴上最后可用的源码：

TimeCutter.java

import com.garmin.fit.*;
import java.io.*;
import java.util.*;
import java.util.concurrent.atomic.AtomicInteger;

/**
 * 按时间裁剪 FIT 活动文件
 * 用法: java TimeCutter <输入.fit> <输出.fit> <开始时间(HH:mm)> <结束时间(HH:mm)>
 * 示例: java TimeCutter activity.fit cut.fit 19:50 20:20
 */
public class TimeCutter {

    // 时间戳字段编号（FIT 标准）
    private static final int TIMESTAMP_FIELD_NUM = 253;

    public static void main(String[] args) {
        if (args.length != 4) {
            System.out.println("用法: java TimeCutter <输入.fit> <输出.fit> <开始时间(HH:mm)> <结束时间(HH:mm)>");
            System.out.println("示例: java TimeCutter activity.fit cut.fit 19:50 20:20");
            return;
        }

        String inputFile = args[0];
        String outputFile = args[1];
        String startTimeStr = args[2];
        String endTimeStr = args[3];

        try {
            System.out.println("当前目录: " + new java.io.File(".").getAbsolutePath());
            System.out.println("输入文件: " + inputFile);
            
            java.io.File inputFileObj = new java.io.File(inputFile);
            if (!inputFileObj.exists()) {
                System.out.println("❌ 文件不存在: " + inputFile);
                return;
            }
            System.out.println("文件大小: " + inputFileObj.length() + " 字节");

            DateTime firstTimestamp = getFirstTimestamp(inputFile);
            if (firstTimestamp == null) {
                System.out.println("❌ 错误: 无法读取文件开始时间");
                System.out.println("   请确认文件是有效的 FIT 活动文件");
                return;
            }

            // 解析用户输入的时间
            DateTime startDateTime = parseTimeOfDay(startTimeStr, firstTimestamp);
            DateTime endDateTime = parseTimeOfDay(endTimeStr, firstTimestamp);

            System.out.println("文件开始时间: " + formatDateTime(firstTimestamp));
            System.out.println("目标区间: " + formatDateTime(startDateTime) + " 到 " + formatDateTime(endDateTime));

            cutFitFile(inputFile, outputFile, startDateTime, endDateTime);
            System.out.println("✅ 裁剪完成！输出文件: " + outputFile);

        } catch (Exception e) {
            System.err.println("❌ 错误: " + e.getMessage());
            e.printStackTrace();
        }
    }

    /**
     * 从 Mesg 中提取时间戳
     * 尝试多种方式获取时间戳值
     */
    private static DateTime extractTimestamp(Mesg mesg) {
        // 方法1: 尝试使用 RecordMesg 专用方法
        if (mesg instanceof RecordMesg) {
            try {
                DateTime ts = ((RecordMesg) mesg).getTimestamp();
                if (ts != null) {
                    return ts;
                }
            } catch (Exception e) {
                // 忽略，尝试其他方法
            }
        }

        // 方法2: 通过字段编号获取原始值
        Field field = mesg.getField(TIMESTAMP_FIELD_NUM);
        if (field != null) {
            Object value = field.getValue();
            if (value instanceof Number) {
                long seconds = ((Number) value).longValue();
                // FIT 时间戳是从 1989-12-31 00:00:00 UTC 开始的秒数
                return new DateTime(seconds);
            } else if (value instanceof DateTime) {
                return (DateTime) value;
            } else if (value instanceof Date) {
                return new DateTime((Date) value);
            } else if (value instanceof String) {
                try {
                    long seconds = Long.parseLong((String) value);
                    return new DateTime(seconds);
                } catch (NumberFormatException e) {
                    // 忽略
                }
            }
        }

        // 方法3: 通过字段名获取
        Field nameField = mesg.getField("timestamp");
        if (nameField != null && nameField != field) {
            Object value = nameField.getValue();
            if (value instanceof Number) {
                long seconds = ((Number) value).longValue();
                return new DateTime(seconds);
            } else if (value instanceof DateTime) {
                return (DateTime) value;
            }
        }

        return null;
    }

    /**
     * 获取 FIT 文件中第一条记录的时间戳
     */
    private static DateTime getFirstTimestamp(String inputFile) throws Exception {
        java.io.File file = new java.io.File(inputFile);
        Decode decode = new Decode();
        MesgBroadcaster broadcaster = new MesgBroadcaster();
        
        List<DateTime> firstTime = new ArrayList<>();
        AtomicInteger recordCount = new AtomicInteger(0);
        
        broadcaster.addListener((MesgListener) mesg -> {
            if (mesg.getNum() == MesgNum.RECORD) {
                int count = recordCount.incrementAndGet();
                if (count <= 3) {
                    System.out.println("  第 " + count + " 条 Record 消息");
                }
                
                if (firstTime.isEmpty()) {
                    DateTime ts = extractTimestamp(mesg);
                    if (ts != null) {
                        firstTime.add(ts);
                        System.out.println("  ✅ 提取到时间戳: " + ts.getDate());
                    } else if (count == 1) {
                        // 如果第一条记录失败，打印调试信息
                        System.out.println("  ⚠️ 第一条记录无法提取时间戳");
                        for (Field f : mesg.getFields()) {
                            System.out.println("    字段: " + f.getName() + 
                                               " (编号: " + f.getNum() + 
                                               ", 值: " + f.getValue() + 
                                               ", 类型: " + f.getType() + ")");
                        }
                    }
                }
            }
        });

        try (FileInputStream in = new FileInputStream(file)) {
            decode.read(in, broadcaster);
        }
        
        System.out.println("总共处理了 " + recordCount.get() + " 条 Record 消息");
        
        if (firstTime.isEmpty()) {
            return null;
        }
        return firstTime.get(0);
    }

    /**
     * 解析 "HH:mm" 格式的时间
     */
    private static DateTime parseTimeOfDay(String timeStr, DateTime baseDateTime) {
        String[] parts = timeStr.split(":");
        if (parts.length != 2) {
            throw new IllegalArgumentException("时间格式错误，请使用 HH:mm");
        }
        int hours = Integer.parseInt(parts[0]);
        int minutes = Integer.parseInt(parts[1]);
        
        Date baseDate = baseDateTime.getDate();
        @SuppressWarnings("deprecation")
        int year = baseDate.getYear() + 1900;
        @SuppressWarnings("deprecation")
        int month = baseDate.getMonth();
        @SuppressWarnings("deprecation")
        int day = baseDate.getDate();
        
        System.out.println("基准日期: " + year + "-" + (month+1) + "-" + day);
        System.out.println("目标时间: " + hours + ":" + minutes);
        
        @SuppressWarnings("deprecation")
        Date targetDate = new Date(year - 1900, month, day, hours, minutes, 0);
        return new DateTime(targetDate);
    }

    /**
     * 核心裁剪逻辑
     */
    private static void cutFitFile(String inputFile, String outputFile, 
                                   DateTime startTime, DateTime endTime) throws Exception {
        java.io.File file = new java.io.File(inputFile);
        Decode decode = new Decode();
        MesgBroadcaster broadcaster = new MesgBroadcaster();
        
        List<Mesg> filteredRecords = new ArrayList<>();
        List<Mesg> otherMessages = new ArrayList<>();
        
        broadcaster.addListener((MesgListener) mesg -> {
            if (mesg.getNum() == MesgNum.RECORD) {
                DateTime ts = extractTimestamp(mesg);
                if (ts != null && ts.compareTo(startTime) >= 0 && ts.compareTo(endTime) <= 0) {
                    filteredRecords.add(mesg);
                }
            } else {
                otherMessages.add(mesg);
            }
        });

        try (FileInputStream in = new FileInputStream(file)) {
            decode.read(in, broadcaster);
        }
        
        System.out.println("解码完成: 共 " + filteredRecords.size() + " 条记录在时间区间内");

        if (filteredRecords.isEmpty()) {
            throw new Exception("在指定的时间区间内没有找到任何记录");
        }

        java.io.File outputFileObj = new java.io.File(outputFile);
        FileEncoder encoder = new FileEncoder(outputFileObj, Fit.ProtocolVersion.V2_0);
        
        // 写入 FileId
        boolean hasFileId = false;
        for (Mesg msg : otherMessages) {
            if (msg.getNum() == MesgNum.FILE_ID) {
                encoder.write(msg);
                hasFileId = true;
                break;
            }
        }
        if (!hasFileId) {
            FileIdMesg fileId = new FileIdMesg();
            fileId.setType(com.garmin.fit.File.ACTIVITY);
            fileId.setManufacturer(1);
            encoder.write(fileId);
        }

        // 写入设备信息
        for (Mesg msg : otherMessages) {
            int num = msg.getNum();
            if (num == MesgNum.DEVICE_INFO || num == MesgNum.SOFTWARE) {
                encoder.write(msg);
                break;
            }
        }

        // 写入筛选后的记录
        for (Mesg record : filteredRecords) {
            encoder.write(record);
        }

        // 写入 Session 和 Lap
        for (Mesg msg : otherMessages) {
            int num = msg.getNum();
            if (num == MesgNum.SESSION || num == MesgNum.LAP || num == MesgNum.EVENT) {
                encoder.write(msg);
            }
        }

        encoder.close();
        
        System.out.println("编码完成，输出文件大小: " + outputFileObj.length() + " 字节");
    }

    private static String formatDateTime(DateTime dt) {
        if (dt == null) return "null";
        return dt.getDate().toString();
    }
}

 

我是直接拉取SDK源码仓库然后打包项目，再把脚本文件丢在源码里面编译执行的

打包SDK命令：

D:\apache-maven-3.9.16\bin\mvn package -Pfitsdk

编译源码文件

javac -cp "target\fit-21.214.0.jar" TimeCutter.java

执行脚本

java -cp "target\fit-21.214.0.jar;." TimeCutter MAGENE_C506SE_2026-08-25_181425_1272912.fit NEW_CUT.fit 20:00 20:21

　　

 

 

 

用Garmin VIRB Edit 打开剪切的Fit可以校验结果：