Fotoğraflarla kişiselleştirme

Not: Bu özellik, Watch Face Format'ın 4. sürümü ve sonraki sürümlerinde kullanılabilir.

Kullanıcının kadranına dahil edilecek fotoğrafları seçmesine izin vermek, kadran deneyiminize kişisel bir dokunuş katmanıza yardımcı olabilir.

Resimlerle çalışma bölümünde, resimlerin saat yüzünüzde nasıl gösterileceği açıklanmaktadır. Kullanıcının önceden tanımlanmış bir dizi resim arasından seçim yapmasına izin vermek istiyorsanız Kullanıcı yapılandırmalarını tanımlama bölümünde gösterildiği gibi ListConfiguration kullanın.

Kadranınızda kullanıcının yapılandırabileceği resimler kullanmak için <PhotosConfiguration> öğesini kullanın. Örneğin:

<!-- Under WatchFace element -->
<UserConfigurations>
    <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>
watchface_photos.xml

configType, kullanıcının yardımcıdaki tek bir resmi mi yoksa bir fotoğraf koleksiyonunu mu seçeceğini belirten SINGLE veya MULTIPLE olabilir.

Tek bir fotoğrafı destekleme

Tek resim için fotoğraf, PartImage öğesinde aşağıdaki şekilde kullanılabilir:

<PartImage x="100" y="50" width="100" height="100">
    <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos.xml

Kullanıcı, yardımcı uygulamada fotoğraf seçmediğinde gösterilen ve zorunlu bir özellik olan defaultImageResource özelliğine dikkat edin.

Kullanıcı farklı bir fotoğraf seçmek isterse mevcut seçimi başka bir fotoğrafla değiştirmek için yardımcı uygulamayı kullanmalıdır.

Birden fazla fotoğrafı destekleme

PhotosConfiguration ile configType="MULTIPLE" kullanıldığında saat yüzü, bir koleksiyondaki fotoğrafı gösterebilir. Bu fotoğraflar, dokunarak veya belirli sayıda görüntüleme yapıldıktan sonra otomatik olarak değiştirilebilir.

<PartImage x="100" y="250" width="100" height="100">
    <Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
        source="[CONFIGURATION.galleryConfig]" defaultImageResource="default_image"/>
</PartImage>
watchface_photos_multi.xml

Yukarıdaki örnekte, MULTIPLE kullanılırken sunulan iki seçenek gösterilmektedir:

  1. change özelliği, geliştiricinin fotoğrafın hangi etkinlikler nedeniyle mevcut resimler arasında geçiş yapacağını belirtmesine olanak tanır.

Önceki örnekte hem TAP hem de ON_VISIBLE belirtiliyor. Bu da fotoğrafın, kullanıcının fotoğrafa dokunması veya fotoğrafın görünür hale gelmesi üzerine değişeceği anlamına geliyor.

  1. changeAfterEvery özelliği yalnızca ON_VISIBLE değişikliği etkinliği için geçerlidir ve fotoğraf değiştirilmeden önce kaç kez görünür olması gerektiğini belirtir. Örneğin, kullanıcının kol saatini her uyandırdığında fotoğrafı değiştirmenin çok sık olduğunu düşünebilirsiniz. Buradaki varsayılan değer 3'tür.

PhotosConfiguration ile çalışma hakkında daha fazla bilgi için GitHub'daki örneklere bakın.