사진으로 맞춤설정하기

참고: 이 기능은 워치 페이스 형식 버전 4 이상에서 사용할 수 있습니다.

사용자가 워치 페이스에 포함할 사진을 선택할 수 있도록 하면 워치 페이스 환경에 개인적인 감성을 더할 수 있습니다.

이미지 작업 섹션에서는 워치 페이스에 이미지를 표시하는 방법을 이미 다루고 있습니다. 사용자가 사전 정의된 이미지 범위에서 선택할 수 있도록 하려면 사용자 구성 정의 섹션에 표시된 대로 ListConfiguration를 사용합니다.

사용자가 구성할 수 있는 워치 페이스에서 이미지를 사용하려면 <PhotosConfiguration> 요소를 사용합니다. 예를 들면 다음과 같습니다.

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

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

사진 한 장 지원

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

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

defaultImageResource는 사용자가 컴패니언에서 사진을 선택하지 않은 경우 표시되며 필수 속성입니다.

사용자가 다른 사진을 선택하려면 호환 기기를 사용하여 기존 선택 항목을 다른 항목으로 바꿔야 합니다.

여러 사진 지원

PhotosConfiguration를 configType="MULTIPLE"와 함께 사용하면 워치 페이스가 컬렉션의 사진을 표시할 수 있으며, 이 사진은 탭을 통해 또는 여러 번 조회한 후 자동으로 순환될 수 있습니다.

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

위의 예시는 MULTIPLE를 사용할 때 도입되는 두 가지 옵션을 보여줍니다.

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

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

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

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