Home API Android 샘플 앱

샘플 앱은 Google Home API의 기본 기능을 보여줍니다.

기본 요건

앱을 빌드, 설치, 테스트하려면 다음과 같은 몇 가지 기본 요건을 충족해야 합니다.

  • Android Studio, 버전 2024.2.1 ('Ladybug') 이상 이보다 이전 버전은 Home APIs SDK와 제대로 작동하지 않을 수 있습니다.

    Android 스튜디오 다운로드

  • Android 디버거 (adb)

    adb 설치

    SDK 매니저를 사용하면 됩니다.

Home API를 테스트하려면 다음이 필요합니다.

  • 개발에 사용할 Google 계정으로 설정된 Android 10 이상을 실행하는 Android 기기 최신 버전의 Android Studio가 설치되어 있고 이 개발 계정으로 로그인되어 있는지 확인합니다.
  • Wi-Fi 네트워크
  • Home API를 지원하는 Google 허브

  • 집에 지원되는 기기가 하나 이상 있어야 합니다. 이 기기 또는 테스트하려는 다른 기기가 스레드를 사용하는 경우 허브도 스레드 보더 라우터여야 합니다. Android 샘플 앱에서 지원되는 기기 유형 및 트레잇은 다음과 같습니다.

    • 색상 온도 조명 (켜기/끄기, 밝기)
    • 접촉 센서 (불리언 상태)
    • 조광등 (켜기/끄기, 밝기)
    • 확장된 색상 조명 (켜기/끄기, 밝기)
    • 일반 스위치
    • 사람 감지 센서
    • 조명 켜기/끄기 (켜기/끄기, 밝기)
    • 전등 켜기/끄기 스위치
    • 켜기/끄기 플러그인 장치 (켜짐 및 꺼짐)
    • 켜기/끄기 센서

  1. Google Cloud 콘솔에서 프로젝트 선택기 대시보드로 이동하여 OAuth 사용자 인증 정보를 만드는 데 사용할 프로젝트를 선택합니다.
  2. API 및 서비스 페이지로 이동하여 탐색 메뉴에서 사용자 인증 정보를 클릭합니다.

  3. 이 Google Cloud 프로젝트에 동의 화면을 아직 구성하지 않은 경우 동의 화면 구성 버튼이 표시됩니다. 이 경우 다음 절차에 따라 동의 화면을 구성합니다. 그렇지 않으면 다음 섹션으로 이동합니다.

    1. 동의 화면 구성을 클릭합니다. OAuth 동의 화면 페이지가 표시됩니다.
    2. 사용 사례에 따라 내부 또는 외부를 선택한 다음 만들기를 클릭합니다. OAuth 동의 화면 창이 표시됩니다.
    3. 화면에 표시된 안내에 따라 앱 정보 페이지에 정보를 입력한 다음 저장하고 계속하기를 클릭합니다. 범위 창이 표시됩니다.
    4. 범위를 추가할 필요가 없으므로 저장하고 계속하기를 클릭합니다. 테스트 사용자 창이 표시됩니다.
    5. 앱 액세스 권한을 테스트할 사용자를 추가하려면 사용자 추가를 클릭합니다. 사용자 추가 창이 표시됩니다. 테스트 사용자에게는 앱에서 권한을 부여할 권한이 있습니다.
    6. 빈 필드에 하나 이상의 Google 계정 이메일 주소를 추가한 다음 추가를 클릭합니다.
    7. 저장하고 계속하기를 클릭합니다. 요약 창이 표시됩니다.
    8. OAuth 동의 화면 정보를 검토한 다음 대시보드로 돌아가기를 클릭합니다.

자세한 내용은 Google Cloud 콘솔 도움말 사이트의 OAuth 동의 화면 설정을 참고하세요.

소스 코드 다운로드하기

샘플 앱의 소스 코드는 GitHub에서 확인할 수 있습니다.

프로젝트를 저장할 위치로 이동한 다음 프로젝트를 클론합니다.

git clone https://github.com/google-home/google-home-api-sample-app-android.git

SDK 설정

이 공개 베타의 Home API는 아직 Google에서 개발을 위해 제공하는 표준 라이브러리의 일부가 아닙니다. Home API로 애플리케이션을 개발하려면 라이브러리를 로컬에서 다운로드하여 호스팅해야 합니다.

Home APIs Android SDK를 다운로드하려면 먼저 Google Home Developers에 로그인해야 합니다.

지금 로그인하기

빌드와 실행

  1. Android Studio를 연 다음 로컬 머신에 클론된 google-home-api-sample-app-android 프로젝트 폴더를 엽니다.
  2. 첫 번째 설정 중에 Android Studio에서 모든 프로젝트 종속 항목을 다운로드하고 Gradle 빌드를 완료하는 데 최대 10분이 걸릴 수 있습니다.
    • 이 단계에서 Gradle Sync Failed와 같은 오류가 발생하면 다시 시도를 클릭하여 동기화를 다시 시작합니다.
  3. 샘플 앱의 패키지 이름을 이전에 등록되지 않은 새 이름(예: 조직 이름을 기반으로 한 이름)으로 변경합니다.
    1. 프로젝트를 엽니다.
    2. 소스 계층 구조를 펼칩니다.
    3. 변경하려는 패키지 부분(com.example)을 선택합니다.
    4. 패키지를 마우스 오른쪽 버튼으로 클릭하고 Refactor > Rename...(이름 바꾸기)를 선택합니다.
    5. 모든 디렉터리를 클릭합니다.
    6. 새 이름을 입력하고 Refactor(리팩터링)를 클릭합니다.
    7. build.gradle.kts 파일을 수정하여 android namespace 및 applicationId를 새 패키지 이름으로 변경합니다.
    8. AndroidManifest.xml 파일을 수정하고 파일에서 패키지가 발생하는 위치마다 새 패키지 이름으로 변경합니다.

  4. Android Studio에서 앱을 실행하여 OAuth 키를 생성합니다. Android Studio에서 앱을 실행하거나 디버그하면 Android Studio에서 개발 및 디버깅을 위한 OAuth 키를 자동으로 생성합니다. 자세한 내용은 Android 스튜디오: 디버그 빌드 서명을 참고하세요.

    휴대기기를 로컬 머신에 연결합니다. Android Studio에는 연결된 기기가 모델 번호별로 표시됩니다. 목록에서 기기를 선택한 다음 프로젝트 실행을 클릭합니다. 이렇게 하면 휴대기기에 샘플 앱이 빌드되고 설치됩니다.

    자세한 안내는 Android 개발자 사이트의 하드웨어 기기에서 앱 실행을 참고하세요.

    이제 실행 중인 앱을 중지합니다.

  5. Google Cloud 콘솔 도움말 사이트의 OAuth 2.0 / 네이티브 애플리케이션 / Android 설정에 자세히 설명된 안내에 따라 OAuth 인증서의 SHA-1 지문을 가져옵니다.

  6. OAuth 2.0 설정에 제공된 안내에 따라 OAuth 2.0용 샘플 앱을 등록하고 OAuth 사용자 인증 정보를 만듭니다.

    1. 애플리케이션 유형(네이티브/Android 앱)을 표시합니다.
    2. Google Cloud 콘솔 도움말 사이트의 OAuth 2.0 / 네이티브 애플리케이션 / Android 설정 안내에 따라 SHA-1 지문을 OAuth 클라이언트에 추가합니다. 개발 프로세스 전반에서 기본 Android 스튜디오 키에서 SHA-1 키를 생성해야 합니다.
    3. 테스트 사용자를 추가합니다. 테스트 사용자는 샘플 앱에서 권한을 부여할 권한이 있습니다.

  7. 휴대기기를 로컬 머신에 연결한 상태에서 프로젝트 실행을 다시 클릭하여 휴대기기에서 샘플 앱을 실행합니다.

앱이 설치되면 휴대기기에서 Home API 샘플 앱으로 사용할 수 있습니다.