자동화 문서

URL 스킴 참조

다른 Mac 앱에서 캘린더 윈도우, 지정 위치의 팝업 또는 전체 화면 오버레이를 여세요.

이 가이드는 popCalendar 1.3 이상을 다룹니다. 일부 동작에는 아래에 명시된 더 최신 시스템 버전이 필요합니다.

다른 앱에서 캘린더 열기

이 인터페이스는 macOS 12 이상용입니다. 먼저 외부 앱 및 CLI 제어를 켜세요. 표준 버전은 popcalendar, Setapp은 popcalendar-setapp을 사용합니다. URLComponents와 URLQueryItem으로 URL을 만들고 중첩된 콜백 URL을 하나의 값으로 퍼센트 인코딩하세요.

popcalendar://integration/open?v=1&session=com.example.calendar&presentation=window&mode=two-years&date=2027-01-01
popcalendar://integration/toggle?v=1&session=com.example.picker&presentation=popup&mode=month&anchor=400,850,40,24&width=520&height=720&arrow=top
목차로 돌아가기

명령과 세션

모든 URL에는 v=1과 1~128자의 ASCII 영문자, 숫자, 마침표, 밑줄 또는 하이픈으로 된 세션 이름이 필요합니다. 팝업 또는 전체 화면 오버레이 하나를 포함해 최대 8개 세션을 열 수 있습니다. 다른 임시 보기를 열면 기존 임시 보기가 대체됩니다. 일반 윈도우는 열린 상태를 유지합니다.

명령 또는 옵션기능
/open세션을 열거나 기존 세션을 갱신해 앞으로 가져옵니다.
/toggle세션이 있으면 닫고 없으면 엽니다.
/update없는 세션을 열거나 포커스를 가져오지 않고 내용 또는 위치와 크기를 갱신합니다.
/move없는 세션을 열거나 포커스를 가져오지 않고 위치와 크기만 변경합니다.
/close세션을 닫습니다. 없는 세션을 닫아도 아무 효과가 없습니다.
목차로 돌아가기

내용과 배치

명령 또는 옵션기능
presentation기본값은 window이며 popup 또는 fullscreen을 사용할 수 있습니다. 표시 방식을 바꾸기 전에 열린 세션을 닫으세요.
modemonth, two-months, year, two-years, month-year 또는 month-two-years. 기본값은 year입니다.
date앱 시간대의 그레고리력 YYYY-MM-DD입니다. 기본값은 범위의 첫 날짜 또는 오늘입니다.
start, end양 끝을 포함하는 YYYY-MM-DD 범위입니다. 둘 다 지정하며 start는 end보다 늦을 수 없습니다.
selectionclear로 선택을 지웁니다. start 및 end와 함께 사용할 수 없습니다.
calendar-set저장된 세트 UUID 또는 현재 필터를 복사하는 current입니다. CLI나 단축어에서 ID를 얻으세요. 알 수 없는 ID는 거부됩니다.
display전체 화면 전용입니다. current는 포인터가 있는 디스플레이, main은 기본 디스플레이를 사용합니다. 디스플레이 UUID도 지정할 수 있습니다. 연결되지 않은 디스플레이는 사용 가능한 화면으로 대체됩니다.
width, height콘텐츠 크기를 논리 포인트로 지정하며 각 값은 240부터 8192까지입니다. 두 값을 모두 제공하세요. 팝업은 처음 표시되는 순간부터 요청한 크기를 유지합니다. 일반적인 크기 조절 가능 윈도우는 읽기 쉬운 최소 크기까지 커질 수 있습니다. 화면 경계가 우선합니다. CLI는 --size WIDTHxHEIGHT도 지원합니다.
anchor전역 화면 좌표의 x,y,width,height로 팝업 앵커 사각형을 지정합니다. x 및 y와 함께 쓸 수 없습니다.
x, y앵커 대신 명시적 위치를 지정합니다. 둘 다 필요합니다. 위치를 명시한 팝업에는 화살표가 없습니다.
coordinatesappkit은 기본 화면의 왼쪽 아래를 원점으로 사용합니다. top-left는 왼쪽 위에서 아래로 측정합니다. 보조 디스플레이에는 음수 좌표가 있을 수 있습니다. 단위는 픽셀이 아닌 포인트입니다.
arrowauto, top, bottom, left, right 또는 none입니다. 화살표가 있는 팝업 가장자리를 지정합니다. 패널을 보이게 유지하려고 배치가 반전될 수 있습니다.
callback명시적으로 확인한 날짜를 반환할 등록된 사용자 지정 URL 스킴입니다.

CLI는 같은 이름에 -- 접두사를 붙입니다. 단, selection=clear는 --clear-selection이 됩니다. 전체 화면은 display 외의 모든 배치 옵션을 거부합니다. 알 수 없거나 중복된 매개변수, 잘못된 날짜 및 16 KiB가 넘는 URL은 전체가 거부됩니다.

목차로 돌아가기

포커스와 윈도우 수명

세션은 자체 날짜, 레이아웃, 선택 및 필터를 가집니다. 일반 캘린더 윈도우를 대체하지 않으며 앱 종료 후 복원되지 않습니다. update와 move는 앱을 활성화하지 않습니다. 팝업은 바깥 클릭, 포커스 상실, Escape 또는 스페이스 변경으로 닫힙니다. 하위 팝오버가 먼저 닫힙니다. 전체 화면 오버레이도 앱을 전환하면 닫힙니다.

네이티브 호출 앱에서는 앱 URL을 명시한 NSWorkspace.open을 사용하고 popup, fullscreen, update, move, close 요청의 OpenConfiguration.activates를 false로 설정하세요. 호출 앱 윈도우가 움직이면 move를, 닫히면 close를 보내세요. URL 전달 성공은 프로토콜 수락 확인이 아닙니다. 확인된 결과가 필요하면 CLI나 단축어를 사용하세요.

목차로 돌아가기

선택한 날짜 받기

콜백을 실행하기 전에 사용자가 확인해야 합니다. 취소, 포커스 상실 및 종료는 아무것도 반환하지 않습니다. 날짜, 시간대 및 세션 식별자만 전송합니다. 이벤트나 캘린더 내용은 포함하지 않습니다. HTTP, HTTPS, file, data, JavaScript 및 popCalendar 콜백은 거부됩니다.

popcalendar://integration/open?v=1&session=choose-trip&mode=month&callback=my-app%3A%2F%2Fcalendar-selection%3Ftoken%3Dexample

기존 콜백 쿼리 매개변수는 유지됩니다. 아래의 예약된 결과 이름을 콜백 URL에 사용하지 마세요. 결과를 받을 때 예상 세션과 직접 만든 불투명 토큰을 확인하세요. URL에 인증 정보를 넣지 마세요.

명령 또는 옵션기능
pc-session원래 세션 이름입니다.
pc-start, pc-end선택한 첫날과 마지막 날이며 양 끝을 포함합니다.
pc-ranges최대 128개의 별도 범위를 유지하는 [start, end] 쌍의 JSON 배열입니다.
pc-time-zone반환된 날짜의 시간대 식별자입니다.
목차로 돌아가기