Fotoğraflarla kişiselleştirme

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

Kullanıcının kadrana dahil edilecek fotoğrafları 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 zaten açıklanmaktadır. Kullanıcının önceden tanımlanmış resimler 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:

<UserConfigurations>
  <PhotosConfiguration id="photoConfig" configType="SINGLE"/>
</UserConfigurations>

configType, kullanıcının tamamlayıcı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 durumunda, fotoğraf aşağıdaki gibi bir PartImage öğesinde kullanılabilir:

<PartImage ...>
  <Photos source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>
</PartImage>

Kullanıcı, tamamlayıcıda fotoğraf seçmemişse gösterilen ve gerekli bir özellik olan defaultImageResource değerine 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 desteği

PhotosConfiguration ile configType="MULTIPLE"'ü birlikte kullandığınızda kadran, koleksiyondaki bir fotoğrafı gösterir. Bu fotoğraflar, dokunarak veya belirli bir görüntüleme sayısına ulaşıldığında otomatik olarak değiştirilebilir.

<Photos change="ON_VISIBLE TAP" changeAfterEvery="5"
    source="[CONFIGURATION.photoConfig]" defaultImageResource="default_image"/>

Önceki örnekte, MULTIPLE kullanıldığında sunulan iki seçenek gösterilmektedir:

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

Önceki örnekte hem TAP hem de ON_VISIBLE belirtilmiştir. Bu, fotoğrafın kullanıcı fotoğrafa dokunduğunda veya fotoğrafın görünür hale geldiğinde 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 kaç kez görünmesi gerektiğini belirtir. Örneğin, kullanıcı kol saatini her açtığı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.