Wear OS'te yapılandırma etkinlikleri sağlayın

Bazı kadranlar, kullanıcıların kadran görünümünü ve davranışını özelleştirmelerini sağlayan yapılandırma parametrelerini destekler. Örneğin, bazı kadranlar kullanıcıların özel bir arka plan rengi seçmesine olanak tanır. İki farklı saat dilimini gösteren diğer kadranlar, kullanıcıların ilgilendikleri saat dilimlerini seçmelerine olanak tanır.

Yapılandırma parametrelerini destekleyen kadranlar, kullanıcıların bir etkinlik kullanarak kadranları özelleştirmelerine olanak tanır. Kullanıcılar giyilebilir cihazda giyilebilir cihaz yapılandırma etkinliğini başlatabilir. Tamamlayıcı yapılandırma etkinliğini avuç içi uygulamadan da (yüklüyse) başlatabilirler. Buna ek olarak kullanıcılar, Wear OS 3 cihazların tamamlayıcı uygulamasında kadran yapılandırabilirler.

Not: Cihaz tamamlayıcı uygulamasındaki yapılandırma, API düzeyi 30 ve üstünü hedefleyen cihazlarda kullanılabilir. Avuç içi uygulamalarındaki yapılandırma tüm cihazlarda kullanılabilir.

Düzenleyici oturumunu kullan

Kullanıcının tamamlayıcı cihaz kullanmadan kadranını özelleştirebilmesi için akıllı saatte yapılandırmayı desteklemenizi önemle tavsiye ederiz.

Bunu desteklemek için bir kadran, Activity yapılandırması sağlayabilir ve kullanıcının EditorSession.createOnWatchEditorSession tarafından döndürülen bir EditorSession kullanarak ayarları değiştirmesine izin verebilir. Kullanıcı değişiklik yaptıkça EditorSession.renderWatchFaceToBitmap araması yapıldığında kadran Activity düzenleyicide canlı bir şekilde önizlenebilir.

Yapılandırma etkinlikleri için amaç belirtin

Kadranınızda yapılandırma etkinlikleri varsa ve kadranınızı cihaz tamamlayıcı uygulamasından yapılandırıyorsanız aşağıdaki meta veri girişlerini giyilebilir uygulamanın manifest dosyasındaki hizmet beyanına ekleyin:

<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>

Yapılandırma etkinlikleri, bu amaç için intent filtreleri kaydeder ve kullanıcılar kadranınızı yapılandırmak istediğinde sistem bu niyeti etkinleştirir.

Kadranınız yalnızca bir tamamlayıcı veya giyilebilir yapılandırma etkinliği içeriyorsa yalnızca önceki örnekteki ilgili meta veri girişini eklemeniz gerekir.

Giyilebilir cihaz yapılandırma etkinliği oluşturma

Karmaşık menülerin küçük ekranlarda gezinmesi zor olduğundan, giyilebilir yapılandırma etkinlikleri, kadran için sınırlı bir özelleştirme seçeneği sunar. Giyilebilir cihaz yapılandırma etkinliğinizde, kadranınızın ana özelliklerini özelleştirmek için ikili seçenekler ve yalnızca birkaç seçenek sağlayın.

Giyilebilir cihaz yapılandırma etkinliği oluşturmak için giyilebilir uygulama modülünüze yeni bir etkinlik ekleyin ve giyilebilir uygulamanın manifest dosyasında aşağıdaki intent filtresini beyan edin:

<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>

Bu amaç filtresindeki işlemin adı androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR olmalıdır.

Yapılandırma etkinliğinizde, kullanıcılara kadranınızı özelleştirme seçenekleri sunan basit bir kullanıcı arayüzü oluşturun.

Tamamlayıcı yapılandırma etkinliği oluşturma

Tamamlayıcı yapılandırma etkinlikleri, kullanıcıların kadranların tüm yapılandırma seçeneklerine erişmesini sağlar. Çünkü avuç içi cihazların büyük ekranında karmaşık menülerle etkileşimde bulunmak daha kolaydır. Örneğin, avuç içi bir cihazdaki yapılandırma etkinliği, kullanıcılara kadranların arka plan rengini seçebilecekleri ayrıntılı renk seçiciler sunmanıza olanak tanır.

Not: Yapılandırma etkinlikleri yalnızca telefon, tablet ve katlanabilir cihazlar gibi Android çalıştıran el cihazları için yazılabilir.

Tamamlayıcı yapılandırma etkinliği oluşturmak için avuç içi uygulama modülünüze yeni bir etkinlik ekleyin ve avuç içi uygulamasının manifest dosyasında aşağıdaki intent filtresini beyan edin:

<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>

Yapılandırma etkinliğinizde, kadranınızın tüm yapılandırılabilir öğelerini özelleştirme seçenekleri sunan bir kullanıcı arayüzü oluşturun. Kullanıcılar bir seçim yaptıktan sonra, yapılandırma değişikliğini kadran etkinliğine bildirmek için Giyilebilir Veri Katmanı API'sini kullanın.

Aşağıdaki ilgili kaynaklara bakın: