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

Bazı kadranlar, kullanıcıların kadranın nasıl görüneceğini özelleştirebilmeleri için yapılandırma parametrelerini destekler. nasıl davrandığını gösterir. Örneğin, bazı kadranlar kullanıcıların özel bir arka plan rengi seçmesine olanak tanır. Diğer İki farklı saat dilimi için saati belirten kadranlar, kullanıcıların hangi saat dilimini seçmelerini sağlar? yardımcı olur.

Kullanıcıların kadranları aşağıdaki gibi özelleştirmelerini sağlayan yapılandırma parametrelerini destekleyen kadranlar bir etkinliktir. Kullanıcılar giyilebilir cihazda giyilebilir cihaz yapılandırma etkinliğini başlatabilir. Şunları yapabilirler: Ayrıca, yüklenmişse avuç içi uygulamadan tamamlayıcı yapılandırma etkinliğini de başlatabilir. Ayrıca kullanıcılar, Wear OS 3 için cihazın tamamlayıcı uygulamasında kadranı yapılandırabilir. cihazlar.

Not: Cihazın tamamlayıcı uygulamasındaki yapılandırma şurada kullanılabilir: cihazlar. Avuç içi uygulamalarda yapılandırma cihazlar.

Düzenleyici oturumunu kullan

Akıllı saatte yapılandırmayı desteklemenizi önemle tavsiye ederiz. Kullanıcı, tamamlayıcı cihaz gerekmeden kadranını özelleştirebilir.

Kadranı, bu işlevi desteklemek için Activity yapılandırması sağlayabilir ve kullanıcı değiştirmek için bir EditorSession EditorSession.createOnWatchEditorSession. Kullanıcı değişiklik yaptıkça, EditorSession.renderWatchFaceToBitmap Düzenleyicide Activity kadranının canlı önizlemesini sunar.

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

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

<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 sistem bu isteği tetikler. kullanıcıların kadranınızı yapılandırmak istemelerini sağlayın.

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

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

Giyilebilir cihaz yapılandırma etkinlikleri, küçük ekranlarda karmaşık menülerde gezinmek zor olduğu için kadran. Giyilebilir cihazınızda ikili seçimler sunun ve özelleştirme için yalnızca birkaç seçim yapın. temel özellikleri gösterilir.

Giyilebilir cihaz yapılandırma etkinliği oluşturmak için giyilebilir cihaz uygulama modülünize yeni bir etkinlik ekleyin ve giyilebilir cihaz uygulamasının manifest dosyasında şu 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 intent filtresindeki işlemin adı şu olmalıdır: androidx.wear.watchface.editor.action.WATCH_FACE_EDITOR

Yapılandırma etkinliğinizde, kullanıcıların erişebileceği seçimleri sunan basit bir kullanıcı arayüzü derleyin. saat yüzünüzü özelleştirebilirsiniz.

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

Tamamlayıcı yapılandırma etkinlikleri, kullanıcıların yapılandırma seçeneklerinin tamamına erişmesine olanak tanır Bu özellik, kadranın büyük ekranında karmaşık menülerle etkileşimde bulunmak daha kolay olduğu için elde edebiliyorlar. Örneğin, bir avuç içi cihazdaki yapılandırma etkinliği, şunları yapmanızı sağlar: kullanıcılara, kadranın arka plan rengini seçmeleri için ayrıntılı renk seçiciler sunma.

Not: Yapılandırma etkinlikleri yalnızca avuç içi cihazlar için yazılabilir Android çalıştıran cihazlar (ör. telefonlar, tabletler ve katlanabilir cihazlar).

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 uygulamanın manifest dosyasında aşağıdaki intent filtresini tanımlayın:

<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, tüm verilerinizi özelleştirmek için kullanabileceğiniz yapılandırabileceğiniz öğeler kullanabilirsiniz. Kullanıcılar seçim yaptıktan sonra aşağıdaki işlemler için Giyilebilir Veri Katmanı API'sini kullanın: yapılandırma değişikliğini kadran etkinliğine iletme

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