Android의 Automation API 개요

자동화는 홈에서 작업과 기기 설정을 자동화하는 방법입니다. 자동화는 Google Home 생태계에서 Google Home app (GHA)의 루틴으로, Google Home for webautomation script editor을 통해 사용할 수 있었습니다.

이제 Android용 Home API를 통해 Google Home 생태계의 자동화를 사용할 수 있습니다. GHA 루틴 및 script editor에 사용되는 기본 개념과 동일하지만 다음과 같은 Home API를 통해서만 가능한 향상된 기능과 기능을 사용합니다.

  • Home API에 표시된 대로 기기의 모든 Matter 표준 및 smart home 특성에 대한 액세스 권한
  • 순차, 병렬, 선택 실행 흐름 지원

자동화는 Kotlin에서 자동화를 빌드하도록 설계된 도메인별 언어인 자동화 DSL을 사용하여 작성됩니다.

기기 및 구조 또는 자동화 API와 함께 앱에서 사용하려는 특성과 유형은 초기화 시 등록해야 합니다. Android에서 홈 초기화를 참고하세요.

개발자 여정

Automation API는 더 큰 개발 여정의 일부입니다. 사용자가 자동화를 사용하고 싶을 때 사용할 수 있도록 구조 및 기기 API를 통합한 후에 제공됩니다.

  1. 개발자가 자동화를 계획하고 자동화 DSL을 사용하여 정의합니다.
  2. 개발자가 Kotlin Android 앱에 자동화 정의를 삽입합니다.
  3. 앱은 Discovery API 또는 Device API를 사용하여 수집된 특성, 속성, 명령어, 이벤트 등 기기에 관한 정보를 기반으로 사용자에게 자동화를 표시합니다.
    1. Discovery API를 사용하면 앱이 사용자의 입력이 있든 없든 사용자의 구조에 있는 기기 유형과 특성에 맞게 맞춤설정된 자동화 초안을 생성할 수 있습니다.
    2. 기기 API는 검색 API와 거의 동일한 정보를 제공할 수 있지만 자동화 사용 사례에 최적화되어 있지는 않습니다. 자세한 내용은 기기 API와 검색 API 비교를 참고하세요.
  4. 앱은 선택한 구조에 키가 지정된 실제 자동화를 만듭니다.
  5. 이제 자동화가 사용자의 구조에서 제공되며 구조 API 메서드를 사용하여 실행하거나 삭제할 수 있습니다.

사용자는 언제든지 자동화의 새 인스턴스를 만들어 다른 구조를 선택하거나 앱 로직에 따라 다른 기기 집합을 선택할 수 있습니다. 이렇게 할 때마다 앱은 자동화의 새 인스턴스를 생성합니다.

가장 기본적인 시나리오에서는 비교적 기본적인 작업을 실행하는 사전 정의된 자동화를 사용자에게 제안할 수 있습니다. 또는 사용자가 자신의 필요에 맞게 맞춤설정할 수 있는 자동화의 스켈레톤을 표시할 수도 있습니다. 또는 사용자가 Automation API에서 제공되는 모든 빌딩 블록을 사용하여 복잡한 자동화를 구성할 수 있는 개방형 자동화 편집기를 작성할 수도 있습니다.

리소스 한도

Home API의 자동화에는 다음 한도가 적용됩니다.

표: 자동화 API 리소스 한도
측정항목 한도
구조당 최대 자동화 수 64
자동화당 최대 노드 수 128
자동화당 최대 표현식 노드 수 64
구조당 최대 자동화 인스턴스 수 1024
구조당 개발자별 최대 자동화 인스턴스 수 64
구조당 일일 최대 실행 수 1024
개발자당, 구조당, 일일 최대 실행 수 128