这是一个使用 Swift 编写的非官方 Porsche Connect API 库。该库的主要目的是作为构建移动、桌面和服务器端应用程序的基础模块，这些应用程序都围绕 Porsche Connect 服务构建。

绝对不是。这些端点是通过逆向工程保时捷的 Web 和移动应用程序获得的。

该库拥有一套全面的单元测试，可在 GitHub Actions 上运行。目前，测试套件在基于 Intel 的 macOS v13.x 上运行，并使用 XCode 14.3。

Porsche Connect 需要 Swift 5.7 或更高版本。它使用 Swift 5.5 中引入的新的 async/await 并发语言特性。

自 2023 年第 12 周开始，保时捷已将其生产环境中的身份提供商 (iDP) 迁移到 Auth0。此库的 v0.1.37 及更高版本以透明的方式对外部客户端使用此新的 Auth0 服务。旧 iDP 的使用已停用。

 let porscheConnect = PorscheConnect(username: "homer.simpson@icloud.example", 
                                     password: "Duh!")

要使用此库，需要有效的 MyPorsche 用户名（电子邮件）和密码。

获取与您的 My Porsche 帐户关联的车辆列表。此调用将返回一个 Vehicle 结构体数组，其中包含嵌套的 VehicleAttribute 和 VehiclePicture（如果适用），以用于车辆配置。

do {
  let result = try await porscheConnect.vehicles()
  if let vehicles = result.vehicles {
    // Do something with vehicles
  }
} catch {
  // Handle the error
}

例如，要获取帐户中第一辆车的外部 Color（一个 SwiftUI 结构体）

do {
  let result = try await porscheConnect.vehicles()
  if let vehicles = result.vehicles {
    let firstVehicle = vehicles.first!
    let color: Color = firstVehicle.color
  }
} catch {
  // Handle the error
}

do {
  let result = try await porscheConnect.summary(vin: vehicle.vin)
  if let summary = result.summary {
    // Do something with the summary
  }
} catch {
  // Handle the error
}

获取车辆上次报告的位置。此调用将返回一个 Position 结构体。

do {
  let result = try await porscheConnect.position(vin: vehicle.vin)
  if let position = result.position {
    // Do something with the position
  }
} catch {
  // Handle the error
}

获取车辆的功能。此调用将返回一个 Capabilities 结构体。此结构体包含嵌套的 OnlineRemoteUpdateStatus 和 HeatingCapabilities 结构体（如果适用于车辆）。

do {
  let result = try await porscheConnect.capabilities(vin: vehicle.vin)
  if let capabilities = result.capabilities {
    // Do something with the capabilities
  }
} catch {
  // Handle the error
}

如果车辆是插电式混合动力汽车 (PHEV) 或电池电动汽车 (BEV)，这将返回车辆电动性能的状态和配置。此调用需要车辆及其匹配的功能。此调用将返回一个 Emobility 结构体。传入车辆的 Capabilites 是可选的 - 如果未传入，则该库将假定该车辆基于 J1 (Taycan) 平台。

do {
  let result = try await porscheConnect.emobility(vin: vehicle.vin, capabilities: capabilities)
  if let emobility = result.emobility {
    // Do something with the emobility
  }
} catch {
  // Handle the error
}

获取车辆的状态。此调用将返回一个 Status 结构体。此结构体包含嵌套的 ServiceIntervals 和 RemainingRanges 结构体（如果适用于车辆）。

do {
  let result = try await porscheConnect.status(vin: vehicle.vin)
  if let status = result.status {
    // Do something with the status
  }
} catch {
  // Handle the error
}

获取车辆的行程。此调用将返回一个 Trip 结构体数组。您可以指定返回 shortTerm 或 longTerm 行程。如果未指定类型，则默认为 shortTerm。

do {
  let result = try await porscheConnect.trips(vin: vehicle.vin, type: .longTerm)
  if let trips = result.trips {
    // Do something with the trips
  }
} catch {
  // Handle the error
}

获取车辆的维护状态。此调用将返回一个 Maintenance 结构体，其中包含许多维护 items。

do {
  let result = try await porscheConnect.maintenance(vin: vehicle.vin)
  if let maintenance = result.maintenance {
    // Do something with maintenance
  }
} catch {
  // Handle the error
}

要求车辆闪烁指示灯并选择性地鸣喇叭。当请求被接受时，此调用将返回一个 RemoteCommandAccepted 结构体。 andHorn 参数是可选的，默认为 false。

do {
  let result = try await porscheConnect.flash(vin: vehicle.vin, andHorn: true)
  if let remoteCommandAccepted = result.remoteCommandAccepted {
    // Do something with the remote command
  }
} catch {
  // Handle the error
}

由于鸣笛和闪灯是一个远程命令，可能需要一段时间才能到达汽车并被执行，您可以检查命令的状态。您需要传入车辆和上面 flash() 调用的响应。