법적 사안을 위한 Google Home 샘플 앱

Matter용 Google Home 샘플 앱

Google Home Sample App for Matter는 Google Home Mobile SDK 다음과 유사한 Android 앱을 만듭니다. Google Home app (GHA)입니다. 이 샘플 앱은 다음과 같은 기능을 제공합니다.

  • 실제 및 가상 Matter 기기를 로컬 Android 패브릭
  • 개발 패브릭에 실제 및 가상 기기 커미셔닝
  • 개발 패브릭에서 기기를 제어합니다(예: 약함
  • 다중 관리자 기능을 통해 개발 패브릭에서 기기를 공유할 수 있음 반대로 다른 앱과의 상호작용으로 다른 앱에서 공유된 패브릭 기기
  • 개발자 유틸리티

이 가이드에서는 Sample App for Matter APK를 설치하고 Matter개의 기기를 커미셔닝, 제어, 공유합니다.

소스 코드를 다운로드하고, Mobile SDK를 통합하고, Android 스튜디오에서 화면을 맞춤설정하는 방법을 알아보려면 Sample App for Matter Codelab을 사용해 보세요.

Sample App for Matter Codelab으로 이동

기본 요건

커미셔닝에는 허브(예: Google Nest Hub (2nd gen))가 필요하지 않습니다. Sample App for Matter로 기기를 제어할 수 있습니다.

설치

  1. 출시 섹션으로 이동합니다. - Sample App for Matter GitHub 저장소 최신 버전은 저작물 섹션에서 찾습니다. 이름이 지정된 APK는 GHSAFM-version-default-debug.apk targetcommissioner를 선택하지 마세요.

  2. Android 디버그 브리지 (adb)를 설치합니다.

    adb 설치

  3. USB로 Android 기기를 연결하고 파일 전송을 사용 설정한 다음 APK를 설치합니다.

    $ adb unroot && adb install GHSAFM-version-default-debug.apk

수수료 기기

샘플 앱을 처음 실행하면 Sample App for Matter Codelab 링크가 포함된 대화상자가 표시됩니다. 이 메시지를 다시 표시하지 않음을 선택한 경우 언제든지 앱의 관리 섹션에서 환경설정을 업데이트하여 대화상자를 다시 표시할 수 있습니다.

다음 단계에서는 샘플 앱에만 로컬인 개발 Fabric과 함께 Matter 기기를 로컬 Android Fabric에 추가합니다.

Matter 패브릭이란 무엇인가요?

Matter용 Google Home 샘플 앱

Matter 패브릭은 기기 간에 공유된 신뢰할 수 있는 도메인입니다. 서로 통신할 수 있게 해주는 홈 네트워크의 장치입니다.

기기에는 플랫폼, 앱 또는 앱에 대응하는 패브릭이 하나 이상 있을 수 함께 상호작용하는 기기 그룹입니다. 패브릭은 패브릭과 기기가 동일한 사용자 인증 정보 및 인증 기관을 공유 (CA) 이 사용자 인증 정보는 Matter 중에 할당됩니다. 커미셔닝하고 있습니다.

Matter 기기를 커미셔닝하려면 다음 단계를 완료하세요.

  1. 추가를 탭합니다. 커미셔닝 프로세스를 시작하는 기기 버튼

    기기 추가

  2. 다음으로 컨트롤이 실행되는 Google Play services로 전송됩니다. Mobile SDK 호출에서 반환됩니다. 소유 증빙 자료로 QR 코드 스캔을 선택하거나 페어링 코드 사용을 탭합니다.

    QR 코드 스캔

  3. 커미셔닝이 완료되면 기기 이름을 입력한 다음 완료를 탭합니다.

이제 기기가 로컬 Android Fabric과 개발 Fabric에 모두 연결되었습니다.

모든 커미셔닝 작업과 관련 화면은 기기 커미셔닝 시 Play services 이 일관된 사용자 환경을 제공하므로 민감한 정보를 다루거나 권한을 부여할 수 있습니다

기기 제어

개발 패브릭은 사용자 인증 정보를 생성하여 Matter 기기를 샘플 앱에서 바로 사용할 수 있습니다.

홈 화면에서 기기를 사용 또는 사용 중지로 전환할 수 있습니다. 그런 다음 기기 세부정보에 액세스합니다.

기기 추가됨

기기 공유

기기 공유는 Matter 사양에서 멀티 관리자 흐름이라고 합니다. 기기가 샘플 앱에 커미셔닝되면 손쉽게 공유할 수 있습니다. 다른 생태계와도 상호작용할 수 있습니다

Matter 기기를 다른 생태계와 공유하려면 Android 기기에 다른 플랫폼이 설치되어 있어야 합니다. 이 외부 플랫폼이 대상 위원이 됩니다. 새로운 대상 커미셔닝 실행자로 사용할 수 있는 샘플 앱의 인스턴스입니다.

  1. Sample App for Matter GitHub 저장소의 출시 섹션으로 이동합니다. 최신 버전은 저작물 섹션에서 찾습니다. 이름이 지정된 APK는 GHSAFM-version-targetcommissioner-debug.apk 선택한 default

  2. 타겟 커미셔닝을 설치합니다.

    $ adb unroot && adb install GHSAFM-version-targetcommissioner-debug.apk

  3. 홈 화면에서 기기를 탭하여 기기 정보를 표시합니다. 공유를 탭합니다.

    기기 공유

샘플 앱은 Mobile SDK Share API를 호출하고 다시 한번 컨트롤이 Play services에게 이전됩니다.

공유 시트가 표시되어 내가 공유할 앱 또는 플랫폼을 선택할 수 있습니다. 지정할 수 있습니다. 이 화면에서는 기기:

  1. 대상 커미셔닝 앱과 공유할 설정 코드를 통해 수동으로 설정
  2. Android 개발자로 등록된 로컬 Android 앱 사용 Matter 위원

대상 커미셔닝 앱에는 GHSAFM-TC 라벨이 지정됩니다. 이 인스턴스를 샘플 앱을 다운로드하여 기기를 공유할 수 있습니다.

다음으로 외부 앱 (타겟 커미셔닝 담당자)이 자체 패브릭에 넣습니다.

설정

홈 화면에서 설정 아이콘 여기에서는 다음과 같은 옵션을 사용할 수 있습니다. 사용자 환경설정을 업데이트하고, 도움말을 확인하고, 앱에 대해 자세히 알아볼 수 있습니다.

설정

하프 시트 알림

설정 화면에서 사전 수수료 가능 기능을 사용 중지할 수 있습니다. 기기 Matter대의 검색 알림

애플리케이션이 자체 Matter 검색을 제공하는 경우 또는 커미셔닝 흐름에 따라 다릅니다. 합니다. 커미셔닝 가능한 탐색 중지를 참고하세요. 알림 를 참조하세요.

개발자 유틸리티

설정 화면에서 개발자 유틸리티에 액세스할 수도 있습니다.

기기 및 사용자 환경설정 DataStore 저장소의 콘텐츠 검토 Logcat에서 다음 단계를 완료합니다.

  1. 저장소 콘텐츠 로그를 클릭합니다.

  2. 대화상자에서 OK를 클릭한 후 Logcat을 선택합니다.

의견 및 도움말

서비스 개선을 위한 의견이나 아이디어 제출 Sample App for Matter 사용 경험이 있으신 경우 의견 양식을 작성해 주세요.

의견 보내기

Sample App for Matter에 문제가 있는 경우 다음 단계를 따르세요. 환경을 확인하는 단계를 수행합니다.

샘플 앱을 사용하거나 코드 버그를 발견하는 데 대해 궁금한 점이 있으면 GitHub 저장소의 Issue Tracker에 문제를 제출할 수 있습니다.

기술적 질문에 관한 Google의 공식 안내를 받으려면 스마트 홈 개발자 포럼을 사용하세요.

커뮤니티의 기술 지원을 받으려면 Stack Overflow에서 google-smart-home 태그를 사용하세요.