Fotoğraflarla kişiselleştirme

Not: Bu özellik, Saat Yüzü Formatı'nın 4 ve sonraki sürümlerinde kullanılabilir.

Kullanıcının kadrana eklemek için fotoğraf seçmesine izin vermek, kadran deneyiminize kişisel bir dokunuş katabilir.

Resimlerle çalışma bölümünde, kadranınızda resimlerin nasıl gösterileceği açıklanmıştı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 bir 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>

configType, kullanıcının yardımcıda tek bir resim mi yoksa bir fotoğraf koleksiyonu mu seçebileceğini belirten SINGLE veya MULTIPLE olabilir.

Tek bir fotoğrafı destekleme

Tek resim söz konusu olduğunda fotoğraf, PartImage öğesi içinde aşağıdaki gibi kullanılabilir:

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

Kullanıcı, tamamlayıcıda bir fotoğraf seçmediğinde gösterilen ve zorunlu bir özellik olan defaultImageResource öğesine dikkat edin.

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

Birden fazla fotoğrafı destekleme

PhotosConfiguration ile configType="MULTIPLE" kullanıldığında kadran, bir koleksiyondaki fotoğrafları gösterebilir. Bu fotoğraflar, dokunarak veya belirli sayıda görüntülemeden 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>

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

  1. change özelliği, geliştiricinin hangi etkinliklerin fotoğrafın mevcut resimler arasında geçiş yapmasına neden olacağını belirtmesine olanak tanır.

Yukarıdaki örnekte hem TAP hem de ON_VISIBLE belirtilmiştir. Bu, fotoğrafın kullanıcının fotoğrafa dokunmasına veya fotoğrafın görünür hale gelmesine yanıt olarak değiştiği anlamına gelir.

  1. changeAfterEvery özelliği yalnızca ON_VISIBLE değişiklik etkinliği için geçerlidir ve fotoğraf değiştirilmeden önce fotoğrafın kaç kez görünür hale gelmesi gerektiğini belirtir. Örneğin, kullanıcı saatini her uyandırdığında fotoğrafın değişmesinin ç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 göz atın.