사진으로 맞춤설정하기

참고: 이 기능은 버전 4 이상의 시계 화면 형식에서 사용할 수 있습니다.

사용자가 시계 화면에 포함할 사진을 선택할 수 있도록 하면 시계 화면 환경에 개인적인 느낌을 더할 수 있습니다.

이미지 작업 섹션에서는 이미지를 시계 화면에 표시하는 방법을 이미 다루었습니다. 사용자가 미리 정의된 다양한 이미지 중에서 선택하도록 하려면 사용자 구성 정의 섹션에 표시된 대로 ListConfiguration를 사용하세요.

사용자가 구성할 수 있는 이미지를 시계 화면에서 사용하려면 <PhotosConfiguration> 요소를 사용하세요. 예를 들면 다음과 같습니다.

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

configType는 SINGLE 또는 MULTIPLE일 수 있으며, 이는 사용자가 컴패니언 내에서 단일 이미지 또는 사진 모음을 선택할 수 있는지 여부를 나타냅니다.

단일 사진 지원

단일 이미지의 경우 다음과 같이 PartImage 요소 내에서 사진을 사용할 수 있습니다.

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

사용자가 앱에서 사진을 선택하지 않은 경우 표시되며 필수 속성인 defaultImageResource에 유의하세요.

사용자가 다른 사진을 선택하려면 기존 선택 항목을 다른 사진으로 바꾸는 데 동반 앱을 사용해야 합니다.

여러 사진 지원

configType="MULTIPLE"와 함께 PhotosConfiguration를 사용하면 시계 화면에서 컬렉션의 사진을 표시할 수 있으며, 이 사진은 탭하거나 일정 횟수 조회 후 자동으로 순환할 수 있습니다.

<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

앞의 예시에서는 MULTIPLE 사용 시 도입되는 두 가지 옵션을 보여줍니다.

  1. change 속성을 사용하면 개발자가 사진이 사용 가능한 이미지를 순환하도록 하는 이벤트를 지정할 수 있습니다.

위의 예에서는 TAP와 ON_VISIBLE가 모두 지정되어 있습니다. 즉, 사용자가 사진을 탭하는 경우 또는 사진이 표시되는 경우에 둘 중 하나에 따라 사진이 변경됩니다.

  1. changeAfterEvery 속성은 ON_VISIBLE 변경 이벤트에만 적용되며 사진이 변경되기 전에 사진이 표시되어야 하는 횟수를 지정합니다. 예를 들어 사용자가 시계를 깨울 때마다 사진을 변경하는 것은 너무 빈번하다고 생각할 수 있습니다. 여기서 기본값은 3입니다.

PhotosConfiguration 작업에 관한 자세한 내용은 GitHub의 샘플을 참고하세요.