Wear OS에서 구성 액티비티 제공

일부 시계 화면에서는 사용자가 시계 화면의 모양과 동작 방식을 맞춤설정할 수 있는 구성 매개변수를 지원합니다. 예를 들어 일부 시계 화면에서는 사용자가 맞춤 배경 색상을 선택할 수 있습니다. 다른 두 시간대의 시간을 알려주는 기타 시계 화면에서는 사용자가 관심 있는 시간대를 선택할 수 있습니다.

구성 매개변수를 지원하는 시계 화면에서는 사용자가 활동을 사용하여 시계 화면을 맞춤설정할 수 있습니다. 사용자는 웨어러블 기기에서 웨어러블 구성 활동을 시작할 수 있습니다. 휴대기기 앱(설치된 경우)에서 호환 구성 활동을 시작할 수도 있습니다. 또한 사용자는 Wear OS 3 기기의 기기 호환 앱에서 시계 화면을 구성할 수 있습니다.

참고: 기기 호환 앱의 구성은 API 수준 30 이상을 타겟팅하는 기기에서 사용할 수 있습니다. 휴대기기 앱의 구성은 모든 기기에서 사용할 수 있습니다.

편집기 세션 사용

사용자가 호환 기기 없이도 시계 화면을 맞춤설정할 수 있도록 스마트시계에서 구성을 지원하는 것이 좋습니다.

이를 지원하기 위해 시계 화면에서는 Activity 구성을 제공하고 사용자가 EditorSession.createOnWatchEditorSession에서 반환된 EditorSession을 사용하여 설정을 변경하도록 허용할 수 있습니다. 사용자가 변경할 때 EditorSession.renderWatchFaceToBitmap을 호출하면 편집기 Activity에서 시계 화면의 실시간 미리보기가 제공됩니다.

구성 활동의 인텐트 지정

시계 화면에 구성 활동이 포함되어 있고 기기 호환 앱에서 시계 화면을 구성하는 경우 웨어러블 앱의 매니페스트 파일에서 서비스 선언에 다음 메타데이터 항목을 추가합니다.

<service>
    <meta-data
        android:name="com.google.android.wearable.watchface.wearableConfigurationAction"
        android:value="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
    <meta-data
        android:name="com.google.android.wearable.watchface.companionBuiltinConfigurationEnabled"
        android:value="true" />
</service>

구성 활동은 이 인텐트에 관한 인텐트 필터를 등록하며, 시스템에서 사용자가 시계 화면을 구성하고자 할 때 이 인텐트를 실행합니다.

시계 화면에 호환 또는 웨어러블 구성 활동만 포함된 경우 위의 예에서 관련 메타데이터 항목만 포함해야 합니다.

웨어러블 구성 활동 생성

작은 화면에서는 복잡한 메뉴를 탐색하기가 어렵기 때문에, 웨어러블 구성 활동은 제한된 세트의 맞춤설정 옵션을 시계 화면에 제공합니다. 웨어러블 구성 활동에서는 시계 화면의 주요 부분을 맞춤설정하기 위한 바이너리 옵션과 몇 가지 선택항목을 제공합니다.

웨어러블 구성 활동을 생성하려면 새 활동을 웨어러블 앱 모듈에 추가하고 다음과 같은 인텐트 필터를 웨어러블 앱의 매니페스트 파일에서 선언합니다.

<activity
    android:name=".DigitalWatchFaceWearableConfigActivity"
    android:label="@string/digital_config_name">
    <intent-filter>
        <action android:name="androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR" />
        <category android:name=
        "com.google.android.wearable.watchface.category.WEARABLE_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

이 인텐트 필터의 작업 이름은 androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR여야 합니다.

구성 활동에서 시계 화면을 맞춤설정하는 옵션을 사용자에게 제공하기 위한 간단한 UI를 빌드합니다.

컴패니언 구성 활동 만들기

큰 화면의 휴대기기에서는 복잡한 메뉴와 상호작용하는 것이 더 쉽기 때문에, 컴패니언 구성 활동은 사용자에게 시계 화면의 전체 구성 옵션에 액세스할 수 있는 권한을 제공합니다. 예를 들어, 휴대기기에서 구성 활동을 사용할 경우 시계 모드의 배경 색상을 선택할 수 있는 정교한 색상 선택 도구를 사용자에게 표시할 수 있습니다.

참고: 구성 활동은 스마트폰, 태블릿, 폴더블과 같이 Android를 실행하는 휴대기기에만 작성할 수 있습니다.

컴패니언 구성 활동을 만들려면 새 활동을 휴대기기 앱 모듈에 추가하고 다음과 같은 인텐트 필터를 휴대기기 앱의 매니페스트 파일에 선언합니다.

<activity
    android:name=".DigitalWatchFaceCompanionConfigActivity"
    android:label="@string/app_name">
    <intent-filter>
        <action android:name=
            "com.example.android.wearable.watchface.CONFIG_DIGITAL" />
        <category android:name=
        "com.google.android.wearable.watchface.category.COMPANION_CONFIGURATION" />
        <category android:name="android.intent.category.DEFAULT" />
    </intent-filter>
</activity>

구성 활동에서 시계 화면의 모든 구성 가능 요소를 맞춤설정하는 옵션을 제공하는 UI를 빌드합니다. 사용자가 옵션을 선택한 후 구성 변경사항을 시계 화면 활동에 전달하려면 Wearable Data Layer API를 사용합니다.

다음 관련 리소스를 참고하세요.