어시스턴트의 상황별 콘텐츠 최적화

Android 6.0 Marshmallow에서는 사용자가 Google 어시스턴트와 같은 어시스턴트 앱을 통해 앱에 참여할 수 있는 새로운 방법을 제공합니다. 어시스턴트는 사용자가 현재 활동에 상황에 맞는 관련 작업을 보기 위해 볼 수 있는 최상위 창입니다. 이러한 작업에는 기기의 다른 앱으로 연결되는 딥 링크가 포함될 수 있습니다.

사용자는 홈 버튼을 길게 누르거나 핵심 구문을 말하여 어시스턴트를 활성화합니다. 이에 응답하여 시스템은 상황에 맞는 관련 작업을 표시하는 최상위 창을 엽니다.

Google 어시스턴트와 같은 어시스턴트 앱은 Android 플랫폼 수준 기능과 함께 작동하는 Now on Tap 기능을 통해 어시스턴트 오버레이 창을 구현합니다. 사용자는 시스템을 통해 Android의 Assist API를 사용하여 앱에서 컨텍스트 정보를 가져오는 어시스턴트 앱을 선택할 수 있습니다.

이 가이드에서는 Android 앱에서 Android의 Assist API를 사용하여 어시스턴트 사용자 환경을 개선하는 방법을 설명합니다. 어시스턴트가 실행하고 제어할 수 있는 미디어 앱을 만드는 방법을 알아보려면 Google 어시스턴트 및 미디어 앱을 참고하세요.

어시스턴트 사용

그림 1은 어시스턴트와의 일반적인 사용자 상호작용을 보여줍니다. 사용자가 홈 버튼을 길게 누르면 소스 앱에서 Assist API 콜백이 호출됩니다 (1단계). 어시스턴트가 오버레이 창을 렌더링하면 (2단계 및 3단계) 사용자가 실행할 작업을 선택합니다. 어시스턴트는 (대상) 식당 앱으로 연결되는 딥 링크를 사용하여 인텐트를 실행하는 것과 같이 선택된 작업을 실행합니다 (4단계).

그림 1. Google 앱의 Now on Tap 기능을 통한 어시스턴트 상호작용 예

사용자는 설정 > 앱 > 기본 앱 > 지원 및 음성 입력을 선택하여 어시스턴트를 구성할 수 있습니다. 사용자는 그림 2와 같이 화면 콘텐츠에 텍스트로 액세스하고 스크린샷에 액세스하는 등의 시스템 옵션을 변경할 수 있습니다.

그림 2. 지원 및 음성 입력 설정

소스 앱

앱이 사용자에 대한 정보의 소스로 어시스턴트와 작동하도록 하려면 접근성 권장사항을 따라야 합니다. 이 섹션에서는 맞춤 뷰와 같이 특별한 처리가 필요한 시나리오뿐만 아니라 어시스턴트 사용자 환경을 개선하는 데 도움이 되는 추가 정보를 제공하는 방법을 설명합니다.

어시스턴트와 추가 정보 공유

텍스트와 스크린샷 외에도 앱은 어시스턴트와 다른 정보를 공유할 수 있습니다. 예를 들어 음악 앱은 어시스턴트가 현재 활동에 맞는 더 스마트한 작업을 제안할 수 있도록 현재 앨범 정보를 전달하도록 선택할 수 있습니다. Assist API는 미디어 컨트롤을 제공하지 않습니다. 미디어 컨트롤을 추가하려면 Google 어시스턴트 및 미디어 앱을 참고하세요.

어시스턴트에 추가 정보를 제공하기 위해 앱은 앱 리스너를 등록하여 전역 애플리케이션 컨텍스트를 제공하고 그림 3과 같이 활동 콜백을 통해 활동별 정보를 제공합니다.

그림 3. Assist API 수명 주기 시퀀스 다이어그램

전역 애플리케이션 컨텍스트를 제공하기 위해 앱은 Application.OnProvideAssistDataListener의 구현을 만들고 registerOnProvideAssistDataListener()를 사용하여 등록합니다. 활동별 컨텍스트 정보를 제공하기 위해 활동은 onProvideAssistData()onProvideAssistContent()를 재정의합니다. 이 두 가지 활동 메서드는 선택적 전역 콜백이 호출된 후에 호출됩니다. 콜백은 기본 스레드에서 실행되므로 즉시 완료해야 합니다. 콜백은 활동이 실행 중인 경우에만 호출됩니다.

맥락 제공

사용자가 어시스턴트를 활성화하면 onProvideAssistData()가 호출되어 현재 애플리케이션의 모든 컨텍스트가 AssistStructure의 인스턴스로 표시되는 전체 ACTION_ASSIST 인텐트를 빌드합니다. 이 메서드를 재정의하여 원하는 것을 번들에 배치하여 지원 인텐트의 EXTRA_ASSIST_CONTEXT 부분에 표시할 수 있습니다.

콘텐츠 설명

앱은 onProvideAssistContent()를 구현하여 현재 활동과 관련된 콘텐츠 관련 참조를 제공함으로써 어시스턴트 사용자 환경을 개선할 수 있습니다. JSON-LD 객체를 통해 Schema.org에서 정의한 공통 용어를 사용하여 앱 콘텐츠를 설명할 수 있습니다. 아래 예에서 음악 앱은 구조화된 데이터를 제공하여 사용자가 현재 보고 있는 음악 앨범을 설명합니다.

Kotlin

override fun onProvideAssistContent(assistContent: AssistContent) {
    super.onProvideAssistContent(assistContent)

    val structuredJson: String = JSONObject()
            .put("@type", "MusicRecording")
            .put("@id", "https://example.com/music/recording")
            .put("name", "Album Title")
            .toString()

    assistContent.structuredData = structuredJson
}

Java

@Override
public void onProvideAssistContent(AssistContent assistContent) {
  super.onProvideAssistContent(assistContent);

  String structuredJson = new JSONObject()
       .put("@type", "MusicRecording")
       .put("@id", "https://example.com/music/recording")
       .put("name", "Album Title")
       .toString();

  assistContent.setStructuredData(structuredJson);
}

onProvideAssistContent()의 맞춤 구현으로 사용자 환경을 개선할 수도 있습니다. 이 경우 다음과 같은 이점이 있습니다.

참고: 맞춤 텍스트 선택 구현을 사용하는 앱은 onProvideAssistContent()를 구현하고 setClipData()를 호출해야 할 수 있습니다.

기본 구현

onProvideAssistData()onProvideAssistContent() 콜백이 모두 구현되지 않은 경우에도 시스템은 계속 진행하여 현재 창이 보안으로 플래그가 지정되지 않는 한 자동으로 수집된 정보를 어시스턴트에 전달합니다. 그림 3과 같이 시스템은 onProvideStructure()onProvideVirtualStructure()의 기본 구현을 사용하여 텍스트와 뷰 계층 구조 정보를 수집합니다. 뷰에서 맞춤 텍스트 그리기를 구현하는 경우 onProvideStructure()를 재정의하여 setText(CharSequence)를 호출하여 사용자에게 표시되는 텍스트를 어시스턴트에 제공합니다.

대부분의 경우 접근성 지원을 구현하면 어시스턴트가 필요한 정보를 얻을 수 있습니다. 접근성 지원을 구현하려면 다음을 포함하여 애플리케이션을 액세스 가능하게 만들기에 설명된 권장사항을 확인하세요.

어시스턴트에서 뷰 제외

민감한 정보를 처리하기 위해 앱은 WindowManagerFLAG_SECURE 레이아웃 매개변수를 설정하여 어시스턴트에서 현재 뷰를 제외할 수 있습니다. 대화상자를 포함하여 활동에서 만든 모든 창에 FLAG_SECURE를 명시적으로 설정해야 합니다. 앱에서 setSecure()를 사용하여 노출 영역을 어시스턴트에서 제외할 수도 있습니다. 어시스턴트에서 모든 뷰를 제외하는 전역 (앱 수준) 메커니즘은 없습니다. FLAG_SECURE로 인해 Assist API 콜백이 실행을 중지하지 않습니다. FLAG_SECURE를 사용하는 활동은 이 가이드의 앞부분에서 설명한 콜백을 사용하여 어시스턴트 앱에 명시적으로 정보를 제공할 수 있습니다.

참고: 기업 계정 (Android for Work)의 경우 관리자는 DevicePolicyManager API의 setScreenCaptureDisabled() 메서드를 사용하여 직장 프로필의 어시스턴트 데이터 수집을 중지할 수 있습니다.

음성 상호작용

지원 API 콜백은 주요 구문 감지 시에도 호출됩니다. 자세한 내용은 음성 액션 문서를 참고하세요.

Z-order 고려사항

어시스턴트는 현재 활동 위에 표시되는 가벼운 오버레이 창을 사용합니다. 사용자는 언제든지 어시스턴트를 활성화할 수 있으므로 그림 4와 같이 오버레이 창을 방해하는 영구적인 시스템 알림 창을 만들지 마세요.

그림 4. 지원 레이어 Z-order

앱에서 시스템 알림 창을 사용하는 경우 이 창을 화면에 열어 두면 사용자 환경이 저하되므로 즉시 삭제하세요.

대상 앱

어시스턴트 앱은 일반적으로 딥 링크를 활용하여 대상 앱을 찾습니다. 앱을 잠재적인 대상 앱으로 만들려면 딥 링크 지원을 고려해 보세요. 현재 사용자 컨텍스트와 딥 링크 또는 오버레이 창 (그림 1의 3단계 참고)에 표시된 다른 잠재적 작업 간의 일치는 Google 어시스턴트 구현에 따라 다릅니다. 예를 들어 Google 어시스턴트 앱은 대상 앱으로 트래픽을 유도하기 위해 딥 링크와 앱 링크를 사용합니다.

자신의 어시스턴트 구현

자신의 어시스턴트를 구현하고자 할 수 있습니다. 그림 2와 같이 사용자는 활성 어시스턴트 앱을 선택할 수 있습니다. 어시스턴트 앱은 VoiceInteraction와 같이 VoiceInteractionSessionServiceVoiceInteractionSession 구현을 제공해야 합니다. 또한 BIND_VOICE_INTERACTION 권한도 필요합니다. 그러면 어시스턴트는 onHandleAssist()에서 AssistStructure의 인스턴스로 표시되는 텍스트 및 뷰 계층 구조를 수신할 수 있습니다. onHandleScreenshot()을 통해 스크린샷을 수신합니다.