wallpaper_set_config 함수 설명

wallpaper_set_config 함수는 벽지 설정을 동반 앱에 전송하는 기능을 제공합니다. 이 함수는 여러 옵션 및 섹션을 포함하는 "settings" 배열을 인자로 받습니다. 각 옵션 또는 섹션은 struct.Settings 형식을 따릅니다.

배열 형식

배열은 다음과 같은 형식을 가져야 합니다:

array = [{section_or_option}, {section_or_option}, {section_or_option}];

각 항목은 섹션 또는 옵션 중 하나입니다.

섹션 구조체

섹션 구조체는 다음과 같은 형식을 요구합니다:

{
  type: "section",
  name: "unique_identifier",
  label: "동반 앱에서 이 섹션의 레이블",
  children: [{section}, {option}, ...]
}

children 속성은 배열이며, 각 항목은 다른 섹션 구조체 또는 옵션 구조체일 수 있습니다.

옵션 구조체

옵션 구조체는 다음과 같은 형식을 요구합니다:

{
  type: "return_value의_유형",
  name: "unique_identifier",
  label: "동반 앱에서 이 섹션의 레이블"
}

type 속성에 허용되는 유형은 다음과 같습니다:

• "range"
• "boolean"
• "string"
• "string_multiline"
• "color" (또는 "colour")
• "file"
• "folder"

유형에 따라 추가 속성을 제공해야 합니다.

추가 속성 예시

• range { type: "range", value: <숫자, 기본값>, min: <숫자, 최소값>, max: <숫자, 최대값>, step: <숫자, 가능한 값 간의 거리> }
• boolean { type: "boolean", value: <true 또는 false, 기본값> }
• string { type: "string", value: <문자열, 기본값> }
• string_multiline { type: "string_multiline", value: <여러 줄을 가질 수 있는 문자열, 예: "Line 1\nLine 2\nLine 3\nLine 4"> }
• color (또는 colour) { type: "colour", value: <색상, 기본값> }
• file { type: "file", value: <파일 경로를 포함하는 문자열, 예: "C:\\Users\\MyUser\\Pictures\\MyPicture.png"> }
• folder { type: "folder", value: <폴더 경로를 포함하는 문자열, 예: "C:\\Users\\MyUser\\Pictures\\"> }

함수 문법

wallpaper_set_config(settings_array);

인자 설명

반환값

N/A

예제

var _config = [
  {
    type: "section",
    name: "animation",
    label: "애니메이션",
    children: [
      {type: "range", name: "speed", label: "회전 속도", value: 50, min: 0, max: 200, step: 25},
      {type: "boolean", name: "clockwiseRotation", label: "시계 방향 회전", value: false},
      {type: "boolean", name: "pause", label: "애니메이션 일시 정지", value: true}
    ]
  },
  {
    type: "section",
    name: "colours",
    label: "색상",
    children: [
      {type: "colour", name: "blendColor", label: "혼합 색상", value: #FA1E4E},
      {type: "range", name: "blendAlpha", label: "혼합 알파", value: 100}
    ]
  }
];

wallpaper_set_config(_config);

위 코드는 wallpaper_set_config 함수의 예시로, 두 개의 섹션을 포함하고 있습니다. 첫 번째 섹션은 세 가지 옵션(하나의 범위와 두 개의 불리언)을 포함하고 있으며, 두 번째 섹션은 두 가지 옵션(하나의 색상과 하나의 범위)을 포함하고 있습니다. 이 예시는 배열을 먼저 로컬 변수에 초기화한 후 함수 호출에 전달합니다. 변수를 생략하고 배열을 함수 인자에 직접 초기화할 수도 있습니다.

활용 예제

// 애니메이션 속도 설정
var animation_speed = {
  type: "range",
  name: "animationSpeed",
  label: "애니메이션 속도",
  value: 75,
  min: 0,
  max: 100,
  step: 5
};

// 색상 설정
var background_color = {
  type: "colour",
  name: "backgroundColor",
  label: "배경 색상",
  value: #FFFFFF
};

// 파일 경로 설정
var image_file = {
  type: "file",
  name: "imageFile",
  label: "이미지 파일",
  value: "C:\\Users\\MyUser\\Pictures\\MyImage.png"
};

// 폴더 경로 설정
var image_folder = {
  type: "folder",
  name: "imageFolder",
  label: "이미지 폴더",
  value: "C:\\Users\\MyUser\\Pictures\\"
};

이 예제들은 다양한 설정을 위한 옵션 구조체를 생성하는 방법을 보여줍니다. 각 옵션은 특정한 설정을 정의하며, 이를 통해 사용자 맞춤형 벽지 설정을 구성할 수 있습니다.