# 类型

当您已经知道所需操作并希望获取 Luxonis Hub GraphQL 控制 API 返回的确切公共数据类型时，请使用此页面。它涵盖了您最可能在查询和变更结果中直接选择的公共对象和连接类型。

> **参考范围**
> 此页面重点介绍公共对象和连接类型。如需了解枚举、输入对象、联合类型和辅助边缘包装器等完整的 SDL 详细信息，请参阅
> [Schema](https://docs.luxonis.com/cloud/api/reference/control-api/schema.md)
> .

## 关于类型

这些类型是您在处理 publicApp、publicApps 和 team { ... } 时最常遇到的公共输出形状。

使用此页面可以：

 * 确认公共对象上可用的确切字段名称
 * 检查连接和详细信息包装器类型的顶层结构
 * 从查询、变更或指南直接链接到某个类型
 * 已弃用的字段被有意省略。

## App

表示在公共或团队范围内的目录中可见的应用。

### App 的字段

 * id (ID!)
 * identifier (String!)
 * isPublic (Boolean!)
 * scope (AppScope!)
 * coverImageUrl (String)
 * tags ([String!])
 * stats (AppStats)
 * store (AppStore)
 * createdAt (DateTime!)
 * updatedAt (DateTime!)

## AppConnection

基于游标的分页应用列表。

### AppConnection 的字段

 * nodes ([App!]!)
 * edges ([AppEdge!]!)
 * pageInfo (PageInfo!)

## AppDetail

详细的应用视图，将基础应用对象与相关的前端、发布、截图和特定于查看者的数据相结合。

### AppDetail 的字段

 * app (App!)
 * frontend (AppFrontend)
 * releases (AppReleaseConnection!)
 * screenshots ([AppScreenshot!])
 * user (AppUser!)

## AppFrontend

应用的前端元数据。

### AppFrontend 的字段

 * frontendUrl (String!)
 * isFallback (Boolean!)

## AppRelease

一个应用发布的基本元数据。

### AppRelease 的字段

 * id (ID!)
 * appId (ID!)
 * version (String!)
 * isPublic (Boolean!)
 * createdAt (DateTime!)
 * updatedAt (DateTime!)

## AppReleaseConnection

基于游标的分页应用发布列表。

### AppReleaseConnection 的字段

 * nodes ([AppRelease!]!)
 * edges ([AppReleaseEdge!]!)
 * pageInfo (PageInfo!)

## AppReleaseModel

附加到应用发布的模型元数据。

### AppReleaseModel 的字段

 * modelId (ID!)
 * modelIdentifier (String!)
 * modelInstanceId (ID!)
 * modelVersionId (ID!)

## AppReleaseStore

附加到应用发布的存储元数据。

### AppReleaseStore 的字段

 * changelog (String!)
 * createdAt (DateTime!)
 * updatedAt (DateTime!)

## AppReleaseWithDetail

包含模型和存储元数据的详细应用发布视图。

### AppReleaseWithDetail 的字段

 * id (ID!)
 * appId (ID!)
 * version (String!)
 * isPublic (Boolean!)
 * models ([AppReleaseModel!])
 * store (AppReleaseStore)
 * createdAt (DateTime!)
 * updatedAt (DateTime!)

## AppScreenshot

应用列表的截图元数据。

### AppScreenshot 的字段

 * appStoreMediaId (ID!)
 * order (Int!)
 * url (String!)

## AppStats

应用的聚合使用指标。

### AppStats 的字段

 * downloadCount (Int!)
 * starCount (Int!)

## AppStore

应用面向商店的元数据。

### AppStore 的字段

 * name (String)
 * descriptionShort (String)
 * descriptionLong (String)
 * sourceUrl (String)

## AppUser

特定于查看者的应用元数据。

### AppUser 的字段

 * isStarred (Boolean!)

## Device

托管设备的基础元数据。

### Device 的字段

 * id (ID!)
 * name (String!)
 * kind (DeviceKind!)
 * status (DeviceStatus!)
 * architecture (DeviceArch!)
 * capabilities ([DeviceCapability!]!)
 * flags ([DeviceFlag!]!)
 * model (String)
 * normalizedModel (String)
 * platform (String)
 * serialNumber (String)
 * linuxId (String)
 * osRelease (DeviceOsRelease)
 * version (String)
 * lastContactAt (DateTime)
 * lastStatusChangeAt (DateTime)

## DeviceApp

安装在设备上的应用的基础元数据。

### DeviceApp 的字段

 * id (ID!)
 * identifier (String!)
 * localAppId (String!)
 * appVersion (String!)
 * enabled (Boolean)
 * frontendPort (Int)
 * isDev (Boolean!)
 * state (DeviceAppState!)

## DeviceAppConnection

针对一个设备的基于游标的分页设备应用列表。

### DeviceAppConnection 的字段

 * nodes ([DeviceApp!]!)
 * edges ([DeviceAppEdge!]!)
 * pageInfo (PageInfo!)

## DeviceAppDetail

已安装的设备应用及其相关应用元数据的详细视图。

### DeviceAppDetail 的字段

 * deviceApp (DeviceApp!)
 * app (AppDetail)
 * appRelease (AppRelease)
 * frontend (DeviceAppFrontend)

## DeviceAppFailure

设备应用状态的失败详情。

### DeviceAppFailure 的字段

 * code (Int)
 * message (String!)

## DeviceAppFrontend

设备应用的前端端点元数据。

### DeviceAppFrontend 的字段

 * kind (DeviceAppFrontendKind!)
 * url (String!)

## DeviceAppInstallation

设备应用的安装进度详情。

### DeviceAppInstallation 的字段

 * processing (Boolean!)
 * progress (Int)

## DeviceAppState

设备应用的当前运行时和更新状态。

### DeviceAppState 的字段

 * status (DeviceAppStatus!)
 * failure (DeviceAppFailure)
 * installation (DeviceAppInstallation)
 * update (DeviceAppUpdate)

## DeviceAppUpdate

设备应用的更新进度详情。

### DeviceAppUpdate 的字段

 * appVersion (String!)
 * message (String)
 * progress (Int)
 * status (DeviceAppUpdateStatus!)

## DeviceConnection

基于游标分页的设备列表。

### DeviceConnection 的字段

 * nodes ([Device!]!)
 * edges ([DeviceEdge!]!)
 * pageInfo (PageInfo!)

## DeviceGroup

一个设备组的元数据。

### DeviceGroup 的字段

 * id (ID!)
 * name (String!)
 * createdAt (DateTime!)
 * updatedAt (DateTime!)

## DeviceGroupConnection

基于游标分页的设备组列表。

### DeviceGroupConnection 的字段

 * nodes ([DeviceGroup!]!)
 * edges ([DeviceGroupEdge!]!)
 * pageInfo (PageInfo!)

## DeviceNetworkInterface

设备的网络接口详情。

### DeviceNetworkInterface 的字段

 * interfaceName (String!)
 * ipv4Address (IpAddress)
 * ipv6Address (IpAddress)
 * macAddress (MacAddress)
 * otherIps ([IpAddress!])

## DeviceOsRelease

设备的操作系统发行版元数据。

### DeviceOsRelease 的字段

 * id (Int!)
 * imageRev (String!)
 * versionId (String!)
 * buildId (String)
 * flavor (String)
 * name (String)
 * prettyName (String)
 * version (String)

## DeviceUpgrade

设备的 OTA 或升级记录。

### DeviceUpgrade 的字段

 * status (DeviceUpgradeStatus!)
 * percentage (Int)
 * error (String)
 * stdout (String)
 * stderr (String)
 * startedByTeamMemberId (ID)
 * versionFrom (UUID)
 * versionTo (UUID)
 * startAt (DateTime)
 * endAt (DateTime)
 * createdAt (DateTime!)
 * updatedAt (DateTime!)

## DeviceUpgradeConnection

基于游标分页的设备升级记录列表。

### DeviceUpgradeConnection 的字段

 * nodes ([DeviceUpgrade!]!)
 * edges ([DeviceUpgradeEdge!]!)
 * pageInfo (PageInfo!)

## DeviceWithDetail

包含网络和升级元数据的详细设备视图。

### DeviceWithDetail 的字段

 * id (ID!)
 * name (String!)
 * kind (DeviceKind!)
 * status (DeviceStatus!)
 * architecture (DeviceArch!)
 * capabilities ([DeviceCapability!]!)
 * flags ([DeviceFlag!]!)
 * availableUpgrade (Firmware)
 * networkInterfaces ([DeviceNetworkInterface!]!)
 * model (String)
 * normalizedModel (String)
 * platform (String)
 * serialNumber (String)
 * linuxId (String)
 * osRelease (DeviceOsRelease)
 * version (String)
 * lastContactAt (DateTime)
 * lastStatusChangeAt (DateTime)

## EventFile

附加到事件快照的存储文件。

### EventFile 的字段

 * id (ID!)
 * name (String!)
 * classification (EventFileClassification!)
 * mimeType (String!)
 * hash (String!)
 * size (Int!)
 * presignedUrl (String!)

## EventSnap

存储的快照及其关联元数据。

### EventSnap 的字段

 * id (ID!)
 * name (String!)
 * createdAt (DateTime!)
 * tags ([String!]!)
 * extras (JSONObject!)
 * files ([EventFile!])
 * sourceAppIdentifier (String)
 * sourceDeviceId (ID)
 * sourceSerialNumber (String)

## EventSnapConnection

基于游标分页的事件快照列表。

### EventSnapConnection 的字段

 * nodes ([EventSnap!]!)
 * edges ([EventSnapEdge!]!)
 * pageInfo (PageInfo!)

## PageInfo

连接类型共享的分页元数据。

### PageInfo 的字段

 * hasNextPage (Boolean!)
 * hasPreviousPage (Boolean!)
 * startCursor (String)
 * endCursor (String)

## TeamAdoptKey

一个采纳密钥的元数据。

### TeamAdoptKey 的字段

 * id (ID!)
 * name (String!)
 * usesRemaining (Int!)
 * deleteWhenUnusable (Boolean!)
 * expiresAt (DateTime)
 * revokedAt (DateTime)

## TeamAdoptKeyConnection

基于游标分页的采纳密钥列表。

### TeamAdoptKeyConnection 的字段

 * nodes ([TeamAdoptKey!]!)
 * edges ([TeamAdoptKeyEdge!]!)
 * pageInfo (PageInfo!)

## Related docs

### 架构

检查实时架构端点、SDL 工作流程和内省选项。

[架构](https://docs.luxonis.com/cloud/api/reference/control-api/schema.md)

### 查询

切换到确切的公共查询字段参考。

[查询](https://docs.luxonis.com/cloud/api/reference/control-api/queries.md)

### 变更

切换到确切的公共变更字段参考。

[变更](https://docs.luxonis.com/cloud/api/reference/control-api/mutations.md)

### 关于 GraphQL

返回请求结构、认证和公共 API 边界。

[关于 GraphQL](https://docs.luxonis.com/cloud/api/graphql.md)