Saat yüzü hizmeti oluşturma

Kadran bir hizmettir Wear OS uygulamasında paket haline getirilir. Kullanıcı kullanılabilir bir kadranı seçtiğinde, kadran açılır ve hizmet geri çağırma yöntemleri çağrılır.

Bir kullanıcı, kadranları olan bir Wear uygulaması yüklediğinde kol saati kadran seçici aracılığıyla kol saatinde mevcut olduğundan emin olun. Alternatif olarak kullanıcı, eşlenen telefondaki tamamlayıcı uygulamadan bir kadran seçebilir.

Bu sayfada, bir Wear OS projesinin kadranları içerecek şekilde nasıl yapılandırılacağı ve .

Kadran projesi oluşturma

Not: Wear OS geliştirme için Android Studio'yu kullanmanızı öneririz. proje kurulumu, kitaplığa dahil olma ve paketleme kolaylığı sağlar.

Aşağıdaki adımları uygulayarak proje oluştur kadranınız için Android Studio'da:

1. Dosya > Yeni > Yeni proje.
2. Proje şablonu seçin penceresinde Wear sekmesini tıklayın, ardından Seçenekler listesinden Kadran'ı seçip İleri'yi tıklayın.
3. Projenizi yapılandırın penceresinde şunu kabul edin: varsayılan değerleri belirleyip Son'u tıklayın.

Android Studio, kadran hizmetiniz için app modülüyle bir proje oluşturur.

Bağımlılıklar

Android Studio, gerekli bağımlılıkları build.gradle dosyanıza otomatik olarak ekler. dosyası olarak da kaydedebilir. Bağımlılıklar arasında AndroidX kadran kitaplığı; bkz. kod örneğini ziyaret edin.

Giyilebilir cihaz destek kitaplığı API referansı

Referans dokümanlarda, Google Dokümanlar'da kullandığınız sınıflar hakkında saat yüzlerini uygulayabilirsiniz. Göz atın: API referansı dokümanlarına bakın.

İzinleri bildirme

Kadran için WAKE_LOCK izni gereklidir. Hem Wear OS uygulamasının manifest dosyalarına aşağıdaki izni ekle ve manifest öğesinin altındaki cep telefonu uygulaması:

<manifest ...>
    <uses-permission
        android:name="android.permission.WAKE_LOCK" />

    <!-- Required for complications to receive complication data and open the provider chooser. -->
    <uses-permission
        android:name="com.google.android.wearable.permission.RECEIVE_COMPLICATION_DATA"/>
    ...
</manifest>

Doğrudan başlatma desteği

Kullanıcı kilidini açmadan önce aşağıdaki adımları uygulayarak kadranınızı kullanılabilir hale getirmeniz gerekir Doğrudan Başlatma kılavuzu:

1. Şuradaki hizmetiniz için android:directBootAware özelliğini true olarak ayarlayın: manifest dosyanız.
2. Kadranınız bilgileri içinde depolamalıdır Şifrelenmiş depolama alanı.

Hizmet ve geri çağırma yöntemlerini uygulama

Wear OS'teki kadranlar WatchFaceService. Bir WatchFaceService uygulamak için üç nesne oluşturmak gerekir: a UserStyleSchema, bir ComplicationSlotsManager ve bir WatchFace.

Bu üç nesne, WatchFaceService, aşağıdaki örnekte gösterilmiştir:

class CustomWatchFaceService : WatchFaceService() {

    /**
     * The specification of settings the watch face supports.
     * This is similar to a database schema.
     */
    override fun createUserStyleSchema(): UserStyleSchema = // ...

    /**
     * The complication slot configuration for the watchface.
     */
    override fun createComplicationSlotsManager(
        currentUserStyleRepository: CurrentUserStyleRepository
    ): ComplicationSlotsManager = // ...

    /**
     * The watch face itself, which includes the renderer for drawing.
     */
    override suspend fun createWatchFace(
        surfaceHolder: SurfaceHolder,
        watchState: WatchState,
        complicationSlotsManager: ComplicationSlotsManager,
        currentUserStyleRepository: CurrentUserStyleRepository
    ): WatchFace = // ...

}

<service
    android:name=".AnalogWatchFaceService"
    android:label="@string/analog_name"
    android:permission="android.permission.BIND_WALLPAPER" >
    <meta-data
        android:name="android.service.wallpaper"
        android:resource="@xml/watch_face" />
    <meta-data
        android:name="com.google.android.wearable.watchface.preview_circular"
        android:resource="@drawable/preview_analog_circular" />
    <intent-filter>
        <action android:name="android.service.wallpaper.WallpaperService" />
        <category
            android:name=
            "com.google.android.wearable.watchface.category.WATCH_FACE" />
    </intent-filter>
</service>

<?xml version="1.0" encoding="UTF-8"?>
<wallpaper xmlns:android="http://schemas.android.com/apk/res/android" />