알림 새로운 개발자 프리뷰 프로그램이 곧 출시됩니다. 여기에서 신청하여 새로운 도구를 사용해 보고 의견을 제공해 보세요.

개발자 프로젝트 만들기

Matter 통합을 포함하는 개발자 프로젝트는 새 Google Home Developer Console에서 관리됩니다. 이 페이지에서는 Developer Console에서 새 개발자 프로젝트를 설정하는 방법을 설명합니다.

제한사항

Developer Console는 개발자 프리뷰에 있습니다. 개발자 체크리스트에 설명된 대로 모든 주요 Matter 기능을 사용할 수 있습니다.

Cloud-to-cloud 또는 Local Home SDK 기능은 Developer Console의 프로젝트에 추가할 수 없습니다. 기존 Cloud-to-cloud 또는 Local Home 통합에 Matter 기능을 추가하려면 먼저 기존 Actions on Google 프로젝트를 가져와야 합니다.

프로젝트 이름 지정

프로젝트 이름을 지정할 때는 다음과 같은 이름을 지정하는 것이 좋습니다.

  • 프로젝트에 관한 기본 정보를 포함합니다.
  • 다른 프로젝트의 프로젝트와 쉽게 혼동되지 않습니다.
  • 프로젝트 내의 모든 통합을 나타낼 수 있습니다.

project-gamma-798과 같은 일반적인 이름은 쉽게 떠올릴 수 있지만 이러한 이름은 사실상 '위장'되며 일반적으로 이름이 지정된 다른 프로젝트 목록에서 눈에 띄지 않습니다.

프로젝트 이름을 의미 있고 구별할 수 있도록 프로젝트 이름을 지정할 때 다음 안내를 고려하세요.

  • 회사 이름 사용
  • 이름에 프로젝트 또는 작업 유형 사용
  • 프로젝트 이름에 'test'를 사용하지 않습니다.

예를 들어 acme-smarthome 또는 acme-lighting는 명확하고 고유한 프로젝트 이름입니다.

프로젝트 만들기

개발자 프로젝트는 하나 이상의 통합을 나타냅니다. 소유자는 개발팀의 구성원과 프로젝트를 공유하면 다른 사용자가 프로젝트의 모든 통합을 관리하도록 허용할 수 있습니다.

Google 스마트 홈 생태계 통합은 새로운 Developer Console를 사용하여 관리됩니다. Developer Console에서 프로젝트를 설정하는 방법에는 두 가지가 있습니다.

  1. 새 프로젝트를 만듭니다.
  2. Actions on Google 콘솔에서 기존 프로젝트를 가져옵니다.

특히 테스트 공급업체 ID와 Matter의 제품 ID로 테스트할 때 문제가 발생하지 않도록 테스트와 프로덕션 모두에 대해 하나의 통합만 만드는 것이 좋습니다.

방법 1: 새 프로젝트 만들기

Developer Console로 이동합니다.

개발자 콘솔로 이동

  1. 프로젝트 관리 페이지에서 프로젝트 만들기를 클릭합니다.
  2. 시작하기 페이지에서 프로젝트 만들기를 클릭합니다.
  3. 프로젝트 이름 지정 가이드라인을 준수해야 하는 프로젝트 이름을 입력합니다.
  4. 새 프로젝트 만들기를 클릭합니다.

새 프로젝트의 페이지로 다시 리디렉션됩니다.

방법 2: Actions on Google 콘솔에서 기존 프로젝트 가져오기

기존 Cloud-to-cloud 또는 Local Home 통합에 Matter 지원을 추가하려면 기존 Actions on Google 프로젝트를 새 Developer Console로 가져오면 됩니다.

이 메서드에는 다음 제한사항이 적용됩니다.

  • 가져오기는 단방향입니다. 이 작업은 되돌릴 수 없습니다.
  • 프로젝트 소유자만 기존 Actions on Google 프로젝트를 가져올 수 있습니다. 소유자는 프로젝트를 만든 사람이며 구성원 링크를 사용하여 볼 수 있습니다.
  • 가져온 프로젝트의 회사 프로필은 Actions on Google 콘솔에서만 수정할 수 있습니다. 변경사항은 Google Home 개발자 콘솔에 반영됩니다.

가져오기 후에는 기존 Actions on Google 프로젝트 (예: Cloud-to-cloud, Local Home, App Discovery)를 계속 사용하여 기존 통합을 관리할 수 있습니다.

Actions on Google Console에서 기존 프로젝트를 가져오려면 Developer Console로 이동합니다.

개발자 콘솔로 이동

  1. 프로젝트 만들기를 클릭합니다.
  2. 기존 작업 프로젝트 이름을 입력하거나 드롭다운 목록에서 프로젝트를 선택합니다. 예를 들어 아래 스크린샷에서 프로젝트 이름은 'My Matter 프로젝트'입니다.
  3. 프로젝트 가져오기를 클릭합니다.

Developer Console의 기존 프로젝트 세부정보로 다시 리디렉션됩니다.

Google Home 개발자 센터
시작하기

로그 수준 설정

기본적으로 프로젝트의 각 통합에 대한 오류 로그만 Google Cloud에 저장됩니다.

각 통합의 모든 로그를 Google Cloud에 저장하려면 로그 수준 제어: 오류 로그 섹션에서 모든 로그를 선택합니다.

Google Home 개발자 센터 프로젝트 로그 수준

이 설정은 프로젝트의 모든 통합에 적용됩니다. 통합별로 설정할 수 없습니다. 모든 로그를 Google Cloud에 저장하면 로그 스토리지 공간이 초과될 경우 추가 비용이 발생할 수 있습니다.

로그에 대한 자세한 내용은 Matter용 Cloud Logging을 참조하세요.

개발자 프로젝트 공유

사전 정의된 역할을 사용하여 팀의 사용자 중 프로젝트에 대한 액세스 권한을 추가하거나 삭제할 수 있습니다.

  1. Developer Console 페이지에서 구성원을 클릭하여 Google Cloud ConsoleIAM 및 관리자 > IAM 페이지로 이동합니다.

    또는 프로젝트 세부정보를 클릭한 후 하단의 구성원 섹션에서 GCP의 구성원 관리를 클릭합니다.

  2. 필요에 따라 Google Cloud Console 대시보드를 사용하여 변경합니다.

프로젝트 액세스 권한을 수정하는 방법은 액세스 제어 Google Cloud 문서를 참조하세요.

사용자 목록에 추가된 사용자는 Developer Console에서 프로젝트와 모든 통합을 볼 수 있습니다.