Google Home 플레이그라운드

Google Home Playground는 구성 가능한 기기 유형 및 트레잇으로 스마트 홈 프로젝트를 시뮬레이션하는 웹 애플리케이션입니다. 가상 기기를 만들고, 기기 속성과 상태를 수정하고, Google Home Graph에서 이러한 기기를 보고, 기기 구성을 가져오거나 내보낼 수 있습니다.

계정 연결 완료

Google Home Playground를 사용하려면 먼저 도구를 계정에 연결하는 것이 좋습니다. 휴대전화에서 Google Home app (GHA)를 열고 계정 연결 프로세스를 진행합니다.

  1. 왼쪽 상단의 더하기 (+) 아이콘을 클릭합니다.
  2. 기기 설정 > Google 호환 기기를 선택합니다.
  3. Google Home 플레이그라운드라는 작업을 검색합니다.
  4. 작업을 선택하면 GHA가 로그인 페이지로 연결됩니다. Google 계정으로 로그인을 클릭하고 로그인할 계정을 선택합니다.
  5. 승인 버튼을 클릭하여 계정 연결을 승인합니다.
이 그림은 Google Home 플레이그라운드를 연결하기 위한 Google Home 앱 계정 연결 흐름을 보여줍니다.

계정 연결을 완료하면 상호작용할 수 있는 기본 가상 기기 세트가 GHA에 표시됩니다.

이 그림은 사용자가 Google Home 플레이그라운드를 계정에 연결하면 채워지는 기본 기기 목록을 보여줍니다.

로그인

아래 버튼을 클릭하여 Google Home Playground를 실행합니다.

플레이그라운드 실행

Google 계정으로 로그인을 클릭합니다. GHA에서 계정 연결을 완료할 때 사용한 계정으로 로그인해야 합니다.

이 그림은 Google Home 플레이그라운드의 초기 상태를 보여주며 오른쪽 상단의 로그인 버튼을 강조 표시합니다.

로그인하면 Google Home PlaygroundHome Graph에 저장된 가상 기기가 표시됩니다.

이 그림은 Google Home 플레이그라운드의 기본 보기에 표시되는 기기 목록, 기기 정보, 로그 영역을 보여줍니다.

웹 UI는 다음 세 개의 패널로 구성됩니다.

  • 기기 목록에는 모든 가상 기기가 표시됩니다. 이 패널을 통해 특정 가상 기기를 선택하여 정보를 확인하고 가상 기기를 만들 수 있습니다.
  • 기기 정보에는 선택한 가상 기기의 정보가 표시됩니다. 패널을 통해 이 정보를 수정하고 선택한 가상 기기를 삭제할 수도 있습니다.
  • 로그 영역에는 Google Home PlaygroundHome Graph 간의 상호작용 로그가 표시됩니다. 로그를 펼쳐 문제 해결을 위해 요청 및 응답 페이로드를 검사할 수 있습니다.

가상 기기

가상 기기 정보 보기

기기 목록 패널에서 보려는 가상 기기를 선택합니다. 기기 목록 패널에서 보려는 가상 기기를 선택합니다. 기기 정보 패널에는 다음 5가지 탭으로 분류된 정보가 표시됩니다.

  • 기본 정보: 기기 유형, ID, 이름을 비롯한 기기의 최상위 속성입니다.
  • 트레잇: 기기에서 지원되는 트레잇입니다.
  • 속성: 기기의 트레잇별 속성입니다.
  • 상태: 모든 기기 상태입니다.
  • SUV: 기기의 2차 사용자 확인 구성입니다.

가상 기기 정보 수정

가상 기기의 정보를 확인하는 것 외에도 기기 정보 패널을 통해 Home Graph에 저장된 정보를 직접 수정할 수도 있습니다.

지원되는 트레잇 수정

  1. 트레잇 탭을 선택하고 수정 버튼을 클릭합니다.
  2. 팝업 패널에는 기기에서 현재 지원되는 트레잇과 추가할 수 있는 트레잇이 표시됩니다. 화살표 (arrow_forward/arrow_back) 버튼을 사용하여 기기에서 지원되는 트레잇을 추가하거나 삭제합니다.
  3. 지원되는 트레잇 업데이트를 완료하면 저장을 클릭합니다. 그러면 업데이트된 트레잇이 Home Graph에 적용됩니다.
  4. 이러한 트레잇 업데이트는 로그 영역에서 확인할 수 있습니다.
이 그림은 Google Home 플레이그라운드에서 선택한 기기에 지원되는 트레잇을 추가하거나 삭제하기 위한 UX 도구를 보여줍니다.

기기 속성 수정

  1. 속성 탭을 선택하고 기기에서 지원하는 트레잇의 속성을 수정합니다.
  2. 수정을 완료하면 Enter 키를 누르면 속성 변경사항이 Home Graph에 적용됩니다.
  3. 로그 영역에서 업데이트된 속성을 확인할 수 있습니다.

기기 상태 수정

  1. 상태 탭을 선택하고 상태를 직접 수정합니다. 상태 변경사항이 Home Graph에 적용됩니다.
  2. 이러한 상태 수정사항은 로그 영역에서 확인할 수 있습니다.

가상 기기에 2차 사용자 확인 추가

가상 기기에 SUV를 추가하고 각 기기에서 챌린지 유형과 상응하는 동작을 구성할 수 있습니다. 가상 기기에 SUV를 추가하고 각 기기에서 챌린지 유형과 해당 동작을 구성할 수 있습니다.

기기에서 SUV 구성

  1. 기기 목록 패널에서 구성할 가상 기기를 선택합니다.
  2. 기기 정보 패널에서 SUV 탭을 선택하고 다음을 구성합니다.
    • 사용 설정됨: 기기에서 SUV가 사용 설정 또는 사용 중지되었는지 여부 (챌린지 없음)입니다.
    • 챌린지 유형: SUV에 명시적 확인(ackNeeded) 또는 개인 식별 번호 (pinNeeded)가 필요한지 여부입니다.
    • PIN: 유효한 PIN입니다.
    • 잘못된 PIN 처리: PIN이 잘못된 경우 사용자에게 다시 묻을지 여부와 그렇지 않은 경우 응답할 오류입니다.
이 그림은 Google Home 플레이그라운드에서 선택한 기기에서 보조 사용자 인증 트레잇을 사용 설정하기 위한 UX 도구를 보여줍니다.

SUV를 사용 설정하는 기기 식별

기기 목록 패널에서 각 SUV 지원 기기 옆에 키 아이콘 가 표시됩니다.

이 그림은 2차 사용자 인증을 사용 설정하는 것이 권장되는 기기를 보여줍니다.

다음과 같은 트레잇 목록에는 SUV가 필요합니다.

새 가상 기기 만들기

  1. 기기 목록 패널에서 기기 추가를 클릭합니다.
  2. 팝업 패널에서 기기 유형을 선택하고 새 기기의 기기 이름을 입력합니다. 또는 사전 정의된 기기 세트를 선택하여 추가할 수도 있습니다.
  3. 모든 단계를 완료하면 새 기기가 Home Graph에 추가됩니다.
이 그림은 Google Home 플레이그라운드에서 새 기기 유형을 추가하기 위한 UX 도구를 보여줍니다.

가상 기기 삭제

  1. 기기 목록 패널에서 삭제하려는 기기를 선택합니다. 그런 다음 기기 정보 패널에서 기본 정보 탭을 선택하고 그런 다음 기기 정보 패널에서 기본 정보 탭을 선택하고 하단의 휴지통 아이콘기기 삭제를 클릭합니다.
  2. 팝업 알림에서 기기 삭제를 확인합니다.
  3. 기기 삭제를 확인하면 기기가 Home Graph에서 삭제됩니다.
이 그림은 Google Home 플레이그라운드에서 가상 기기 유형을 삭제하기 위한 UX 도구를 보여줍니다.

동기화 응답 편집기

Google Home Playground에서 동기화 응답을 검증하거나 업데이트할 수 있습니다. 동기화 응답 편집기를 클릭하여 삽입된 IDE를 엽니다.

이 그림은 동기화 응답 편집기를 여는 버튼을 보여줍니다.

동기화 응답을 수정하거나 복사하여 붙여넣고 저장을 클릭하여 변경사항을 적용하고 Google Home 생태계에서 작동하는 방식을 확인합니다.

이 그림은 동기화 응답을 수정하는 창을 보여줍니다.

가상 기기 가져오기 및 내보내기

문제 해결 또는 재현을 위해 가상 기기를 상태와 함께 파일로 내보내고 이 파일을 다른 사용자와 공유하여 가상 기기를 가져오고 복제할 수 있습니다.

이 그림은 Google Home 플레이그라운드에서 가상 기기를 가져오고 내보내는 UX 도구를 보여줍니다.

가상 기기를 파일로 내보내기

  1. 아이콘을 클릭하여 가상 기기를 파일로 내보냅니다.
  2. 내보낼 파일 이름을 입력하고 확인을 클릭합니다.
  3. 파일 이름을 입력하면 브라우저에서 내보낸 가상 기기의 파일을 다운로드합니다.

파일에서 가상 기기 가져오기

  1. 아이콘을 클릭하여 파일에서 가상 기기를 가져옵니다.
  2. 가져올 파일을 선택하고 확인을 클릭합니다.
  3. 가져올 파일을 확인하면 Google Home Playground가 파일에서 상태가 있는 가상 기기를 가져오고 Home Graph에서 가져온 기기의 정보와 상태를 업데이트합니다.

상호작용 로그 검사

가상 기기와 상호작용할 때 Google Home Playground은 변경사항을 Home Graph에 자동으로 적용합니다. Home Graph와의 상호작용은 로그 영역 패널에 기록되며 여기에서 각 항목을 펼쳐 Home Graph API 요청 및 응답 페이로드를 검사할 수 있습니다.

각 로그 항목은 다음 구조의 요소가 포함된 JSON 배열입니다.

{
  "uri": string,
  "request": object,
  "response": object
}
필드 유형 설명
uri string Home Graph API 호출의 URL입니다.
request object Home Graph API 호출의 요청 본문입니다. 각 메서드의 형식은 참조 문서 참조 문서를 참고하세요.
response object Home Graph API 호출의 응답 본문입니다. 각 메서드의 형식은 참조 문서 참조 문서를 참고하세요.

지원되는 기기 유형 및 트레잇 보기

오른쪽 상단의 물음표 도움말 아이콘에는 Google Home Playground에서 지원하는 현재 기기 유형 및 트레잇 목록이 표시됩니다.

이 그림은 Google Home 플레이그라운드에서 새 기기 유형을 추가하기 위한 UX 도구를 보여줍니다.

문제 신고

여러분의 의견을 기다립니다. 오른쪽 상단의 경고 표시 아이콘 의견을 사용하여 발생한 문제를 신고합니다.

이 그림은 Google Home 플레이그라운드에서 의견을 제공하고 문제를 신고하기 위한 아이콘을 보여줍니다.