기기 모델 및 인스턴스 스키마

기기 모델

기기 모델은 이 섹션의 필드로 정의됩니다.

기기 모델 필드에는 문자, 숫자 및 마침표 (.), 하이픈 (-), 밑줄 (_), 공백 ( ), 더하기(+) 기호만 포함할 수 있습니다. 필드의 첫 문자는 문자 또는 숫자여야 합니다.

예

{
  "project_id": "my-devices-project",
  "device_model_id": "my-devices-project-prototype-light-v1",
  "manifest": {
    "manufacturer": "Assistant SDK developer",
    "product_name": "Assistant SDK light",
    "device_description": "Assistant SDK light device"
  },
  "device_type": "action.devices.types.LIGHT",
  "traits": ["action.devices.traits.OnOff"]
}

스키마

{
  "project_id": string,
  "device_model_id": string,
  "manifest": {
    "manufacturer": string,
    "product_name": string,
    "device_description": string
  },
  "device_type": string,
  "traits": [ string ]
}

project_id: (문자열) 필수. 이 기기 모델과 연결할 Actions Console 프로젝트의 Google Cloud Platform 프로젝트 ID입니다. 한 프로젝트에 여러 기기 모델이 포함될 수 있습니다.
device_model_id: (문자열) 필수. 이 기기 모델의 전역적으로 고유한 식별자입니다. 모든 프로젝트 범위에서 충돌을 방지하려면 project_id을 프리픽스로 사용하세요. 측정항목에서 및 기기 등록 중에 사용됩니다.
manifest: (object(Manifest)) 필수사항입니다. 기기 모델과 제조업체를 설명하는 메타데이터 이는 향후 SDK 콘솔, 측정항목 대시보드, 기타 관련 시각적 인터페이스에서 표시될 수 있습니다.
- manifest.manufacturer: (문자열) 필수. 기기 제조업체의 이름입니다.
- manifest.product_name: (문자열) 필수. 이 기기 모델의 소비자 대상 제품 이름입니다.
- manifest.device_description: (문자열) 선택사항. 이 기기 모델에 관한 설명입니다.
device_type: (문자열) 필수. 기기 하드웨어 유형입니다. 다음 중 하나를 선택합니다.
- action.devices.types.CAMERA
- action.devices.types.DISHWASHER
- action.devices.types.DRYER
- action.devices.types.LIGHT
- action.devices.types.OUTLET
- action.devices.types.PHONE
- action.devices.types.REFRIGERATOR
- action.devices.types.SCENE
- action.devices.types.SOUNDBAR
- action.devices.types.SPEAKER
- action.devices.types.SWITCH
- action.devices.types.THERMOSTAT
- action.devices.types.TV
- action.devices.types.VACUUM
- action.devices.types.WASHER
traits: (Array<String>) 선택사항. 기기에서 지원하는 trait 목록입니다. 특성에는 기기의 명령어, 속성, 상태가 포함됩니다. 내장 trait.

기기 인스턴스

기기 인스턴스는 이 섹션의 필드로 정의됩니다.

기기 인스턴스 필드는 문자 또는 숫자로 시작해야 합니다. 기기 ID에는 문자, 숫자, 마침표 (.), 하이픈 (-), 밑줄 (_), 더하기 (+) 기호만 포함할 수 있습니다. 기기 닉네임에는 숫자, 문자, 공백 ( ) 기호만 포함할 수 있습니다.

예

  {
    "id": "my_led_1",
    "model_id": "my-devices-project-prototype-light-v1",
    "nickname": "My Assistant Light",
    "client_type": "SDK_LIBRARY"
  }

스키마

  {
    "id": string,
    "model_id": string,
    "nickname": string,
    "client_type": string
  }

id: (문자열) 필수. 테스트 기기의 식별자입니다. 동일한 Google 개발자 프로젝트에 등록된 모든 기기 내에서 고유해야 합니다.
model_id: (문자열) 필수. 기기 모델의 식별자입니다. 이 테스트 기기와 연결된 device_model_id와 동일해야 합니다. 기기 모델이 이전에 등록되어 있어야 합니다.
nickname: (문자열) 선택사항. 기기의 닉네임입니다. 이 이름은 어시스턴트 설정과 같은 시각적 인터페이스에서 기기를 나타내는 데 사용됩니다.
client_type: (문자열) 필수. 클라이언트 기기의 유형입니다. SDK_SERVICE 또는 SDK_LIBRARY 중 하나여야 합니다.