iOS Objective-C中HyperTrack仪表盘始终显示设备断开连接问题

针对你创建用户和visit类型action后，仪表盘显示设备断开且无法获取位置的问题，我来帮你梳理排查方向和修复方案：

核心问题定位 #

这种情况通常是位置追踪未正确启动、权限配置不全，或者SDK初始化环节有遗漏导致的，咱们一步步来检查：

1. 先确认权限配置是否完整 #

你代码里请求了AlwaysAuthorization和MotionAuthorization，但别忘了两个关键步骤：

• Info.plist必须添加权限描述：
  系统要求必须在Info.plist中声明权限用途，否则权限请求会直接失败。需要添加以下key：
  • NSLocationAlwaysAndWhenInUseUsageDescription（iOS11+，解释为什么需要始终获取位置）
  • NSLocationWhenInUseUsageDescription（备用，适配低版本）
  • NSMotionUsageDescription（解释使用运动权限的原因）
• 检查权限请求的回调结果：
  你的代码里有requestAlwaysAuthorizationWithCompletionHandler，但没处理授权失败的情况。如果用户拒绝了权限，追踪根本无法启动，建议在这里添加引导：

  [HyperTrack requestAlwaysAuthorizationWithCompletionHandler:^(BOOL authorized) {
      if (!authorized) {
          UIAlertController *alert = [UIAlertController alertControllerWithTitle:@"权限提示" 
                                                                         message:@"请在设置中开启「始终允许」位置权限，否则无法追踪位置" 
                                                                  preferredStyle:UIAlertControllerStyleAlert];
          [alert addAction:[UIAlertAction actionWithTitle:@"去设置" style:UIAlertActionStyleDefault handler:^(UIAlertAction * _Nonnull action) {
              [[UIApplication sharedApplication] openURL:[NSURL URLWithString:UIApplicationOpenSettingsURLString] options:@{} completionHandler:nil];
          }]];
          [self presentViewController:alert animated:YES completion:nil];
      }
  }];
  

2. 手动启动Action追踪 #

创建visit类型的action后，HyperTrack不会自动启动追踪，你需要显式调用启动方法。在createAndAssignAction的成功回调里添加：

if (action) {
    NSLog(@"Action ID: %@",action.id);
    NSLog(@"Tracking URL: %@",action.trackingUrl);
    // 启动该action的追踪
    [HyperTrack startTrackingAction:action.id completionHandler:^(BOOL success, HyperTrackError * _Nullable error) {
        if (success) {
            NSLog(@"Action追踪已启动");
        } else {
            NSLog(@"启动追踪失败：%@", error.localizedDescription);
        }
    }];
}

同时，也可以确保用户本身处于被追踪状态：

[HyperTrack isTrackingUserWithUserId:userId completionHandler:^(BOOL isTracking, HyperTrackError * _Nullable error) {
    if (!isTracking && !error) {
        [HyperTrack startTrackingUser:userId];
    }
}];

3. 优化SDK初始化时机 #

你现在是在createUser方法里初始化SDK，建议把初始化提前到App启动时，确保SDK完全加载：

- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions {
    // 在这里初始化HyperTrack
    [HyperTrack initialize:@"你的有效API密钥"];
    return YES;
}

另外，务必确认API密钥是正确的，和HyperTrack控制台项目的密钥一致，否则SDK无法和服务端通信。

4. 配置后台追踪（如果需要） #

如果需要App在后台也能上报位置，还要完成两个配置：

• 在Xcode项目的Signing & Capabilities中，添加Background Modes并勾选Location updates；
• 开启HyperTrack的后台追踪：

  [HyperTrack setShouldContinueLocatingInBackground:YES];
  

调试技巧 #

开启HyperTrack的调试日志，能帮你快速定位问题：

[HyperTrack setLogLevel:HyperTrackLogLevelDebug];

然后查看控制台输出，重点关注权限错误、网络请求失败、追踪状态变更等日志。同时也可以去HyperTrack控制台的Events页面，查看是否有设备连接或位置上报的事件，判断是设备没上报还是控制台展示问题。

内容的提问来源于stack exchange，提问作者Shahbaz Akram