배경화면 이벤트
배경화면 이벤트란?
라이브 배경화면을 만들기 위해 사용되는 두 가지 이벤트가 있습니다.
배경화면 설정 이벤트
이 이벤트는 동반 앱에서 배경화면 설정이 변경될 때마다 실행됩니다. 변경된 배경화면 설정은 wallpaper_config 변수에서 확인할 수 있습니다.
wallpaper_config 변수
이 변수는 여러 섹션을 포함하는 구조체입니다. 각 섹션은 그 안에 옵션과 섹션을 포함하는 구조체입니다. 이 구조체에서 옵션에 접근하려면 다음과 같은 문법을 사용합니다:
- 기본 섹션 접근:
wallpaper_config.section_name.option_name - 중첩 섹션 접근:
wallpaper_config.section1_name.section2_name.option_name
예제
다음은 wallpaper_set_config 페이지에서 정의된 동일한 설정을 사용하는 예제입니다:
var _new_colour = wallpaper_config.colours.blendColor;
obj_clock.colour = _new_colour;
배경화면 구독 데이터
이 이벤트는 구독한 메트릭에 대한 정보가 수신될 때 트리거됩니다. 이 이벤트에 포함된 내용에 대한 자세한 정보는 '메트릭 수신'을 참조하세요.
| 이벤트 종류 | 설명 |
|---|---|
| 배경화면 설정 이벤트 | 동반 앱에서 설정이 변경될 때 실행됩니다. |
| 배경화면 구독 데이터 | 구독한 메트릭에 대한 정보가 수신될 때 실행됩니다. |
활용 예제
배경화면 설정 변경 감지
if (wallpaper_config.settings.changed) {
// 설정이 변경되었을 때의 처리
}
색상 업데이트
var new_color = wallpaper_config.colours.primaryColor;
obj_background.color = new_color;
메트릭 수신 처리
if (metric_received) {
// 수신된 메트릭에 대한 처리
}
중첩 섹션 접근 예제
var option_value = wallpaper_config.section1.section2.option_name;
배경화면 설정 초기화
wallpaper_config = default_wallpaper_config;
이 문서에서는 라이브 배경화면을 만들기 위한 이벤트와 변수 사용법을 설명하였습니다. 다양한 활용 예제를 통해 실제 적용 방법을 이해할 수 있습니다.