클라이언트 데스크톱 설정 방법

이 가이드는 고객이 PC에서 보는 앱 메뉴를 구성하고, 시각적 테마를 적용하고, 대기 화면을 설정하고, 공지사항을 게시하는 방법을 안내합니다. 서버에서 변경한 모든 사항은 TCP를 통해 연결된 클라이언트에 즉시 푸시됩니다.

앱 메뉴 구성 방법

앱 메뉴는 세션 중 고객이 상호 작용하는 인터페이스입니다. 카테고리로 구성되며 각 카테고리에는 하나 이상의 앱이 포함됩니다. 전체 카탈로그를 서버에서 관리합니다.

필요한 것

HandyCafe Server가 실행 중이고 최소 하나의 클라이언트가 연결된 상태
클라이언트 PC에 이미 설치된 앱 실행 파일(Game 및 App 유형의 경우)
업로드할 아이콘 이미지(PNG, JPG 또는 WebP). 권장 크기는 128x128 픽셀

단계

HandyCafe Server 애플리케이션을 열고 왼쪽 사이드바에서 설정으로 이동합니다.
상단의 클라이언트 탭을 선택한 다음 콘텐츠 하위 탭으로 전환합니다.
왼쪽 카테고리 패널에서 카테고리 추가 버튼을 클릭합니다.
"게임" 또는 "브라우저" 같은 카테고리 이름을 입력하고 확인합니다. 새 카테고리가 목록에 나타납니다.
방금 만든 카테고리를 선택합니다. 오른쪽 패널에서 앱 추가를 클릭합니다.
앱 세부 정보를 입력합니다. 이름(예: "Counter-Strike 2"), 선택적 설명을 입력하고 유형 필드를 적절한 유형으로 설정합니다: Game, Browser, Link, File 또는 App.
실행 파일 경로 필드에 클라이언트 PC의 애플리케이션 전체 경로를 입력합니다. 예: C:\Program Files\Steam\steamapps\common\CS2\cs2.exe. Link 유형의 경우 URL을 입력합니다.
아이콘 영역을 클릭하여 아이콘을 업로드합니다. URL을 붙여넣어 웹에서 이미지를 가져오거나 로컬 파일을 탐색할 수 있습니다. 아이콘은 클라이언트 앱 그리드에 표시됩니다.
선택적으로 더 풍부한 시각적 카드를 위해 포스터 이미지를 업로드합니다. 이것은 포스터 우선 표시 모드에서 보이는 대형 아트워크입니다. 히어로 캐러셀 토글을 활성화하여 클라이언트 데스크톱 상단의 회전 배너에 이 앱을 표시할 수도 있습니다.
카테고리 목록이나 앱 목록에서 항목을 드래그하여 순서를 변경합니다. 앱 옆의 표시 토글을 전환하여 삭제하지 않고 숨길 수 있습니다. 완료 후 저장을 클릭합니다.

예상 결과

연결된 모든 클라이언트 데스크톱이 몇 초 이내에 업데이트됩니다. 새 카테고리와 앱이 클라이언트 앱 그리드에 나타납니다. 고객이 카드를 클릭하여 앱을 실행할 수 있습니다.

일반적인 실수

클라이언트 PC에 존재하지 않는 경로를 입력하는 경우. 앱 카드는 나타나지만 실행에 실패합니다. 항상 실제 클라이언트 컴퓨터에서 실행 파일 경로를 확인합니다.
변경 후 저장을 잊는 경우. 저장되지 않은 편집은 클라이언트에 푸시되지 않습니다.
압축 없이 너무 큰 이미지를 사용하는 경우. 모든 해상도가 작동하지만 512x512보다 큰 이미지는 카드 크기에서 시각적 이점 없이 동기화 속도를 저하시킵니다.

데스크톱 테마 설정 방법

테마는 활성 세션 중 클라이언트 데스크톱의 전체적인 외관을 제어합니다. 색상 테마, 레이아웃 프리셋, 카드 밀도, 배경 설정을 선택합니다.

필요한 것

HandyCafe Server가 실행 중인 상태
이미지 또는 비디오 배경의 경우: PNG, JPG, WebP, MP4 또는 WebM 형식의 미디어 파일

단계

설정 > 클라이언트 > 외관 탭으로 이동합니다.
테마에서 사용 가능한 색상 테마 중 하나를 선택합니다: Neon Arena(블루퍼플 게이밍 미학), Crimson Pulse(레드다크 톤), Emerald Depth(그린틸 팔레트). 선택에 따라 미리보기가 업데이트됩니다.
레이아웃 프리셋에서 화면에 콘텐츠가 배치되는 방식을 선택합니다. Split Classic(왼쪽 카테고리, 오른쪽 앱), Hero Wide Top(상단 대형 히어로 캐러셀, 하단 앱), Catalog Wide Bottom(컴팩트 히어로, 넓은 앱 그리드), Compact Focus(최소 크롬, 최대 앱 공간) 중에서 선택합니다.
카드 밀도를 설정하여 한 화면에 표시되는 앱 수를 제어합니다. 대형은 더 자세한 큰 카드를 표시합니다. 중형은 크기와 수량의 균형을 맞춥니다. 소형은 행당 가장 많은 앱을 표시합니다.
배경을 구성합니다. 유형을 선택합니다: 단색(색상 선택), 그라데이션(두 색상 선택), 이미지(파일 업로드), 비디오(MP4/WebM 업로드). 이미지 및 비디오 유형의 경우 오버레이 불투명도 슬라이더를 조정하여 카드 뒤의 배경을 어둡게 하고, 블러 슬라이더로 배경을 부드럽게 합니다.
저장을 클릭합니다. 테마가 연결된 모든 클라이언트에 즉시 푸시됩니다.

예상 결과

클라이언트 데스크톱이 새 시각적 설정으로 새로고침됩니다. 테마, 레이아웃, 카드 크기, 배경이 클라이언트 재시작 없이 모두 업데이트됩니다.

일반적인 실수

매우 큰 파일 크기의 비디오 배경을 사용하는 경우. 빠른 동기화를 위해 비디오를 20 MB 이하로 유지합니다. 길거나 고해상도 비디오는 클라이언트 PC에서 눈에 띄는 로딩 시간을 유발합니다.
복잡한 배경 이미지에서 오버레이 불투명도를 너무 낮게 설정하는 경우. 텍스트와 카드 라벨이 읽기 어려워집니다. 대부분의 이미지에서 40-60%의 오버레이가 잘 작동합니다.

대기 화면 구성 방법

대기 화면은 PC가 사용되지 않을 때 고객에게 표시되는 화면입니다. 이미지나 비디오의 슬라이드쇼, 시계, 카페 이름을 표시할 수 있습니다.

필요한 것

슬라이드쇼용 이미지 파일(PNG, JPG, WebP 또는 GIF) 또는 비디오 파일(MP4, WebM)
HandyCafe Server가 실행 중인 상태

단계

설정 > 클라이언트 > 대기 화면 탭으로 이동합니다.
슬라이드쇼 활성화 토글을 켭니다.
미디어 추가를 클릭하여 이미지 또는 비디오를 업로드합니다. 여러 항목을 추가할 수 있습니다. 지원 형식은 PNG, JPG, WebP, GIF, MP4, WebM입니다.
각 항목의 재생 시간(초)을 설정합니다. 전환 전 각 슬라이드가 표시되는 시간을 제어합니다. 대부분의 설정에서 8~15초가 적합합니다.
전환 효과를 선택합니다: 페이드(부드러운 불투명도 크로스페이드), 슬라이드(수평 슬라이드), 줌(확대 효과).
시계 오버레이 토글을 활성화하여 대기 화면에 디지털 시계를 표시합니다. 색상 선택기를 사용하여 슬라이드쇼 콘텐츠에 대한 최대 대비를 위해 시계 텍스트 색상을 설정합니다.
카페 이름 토글을 활성화하여 대기 화면에 업소 이름을 표시합니다. 이름은 일반 서버 설정에서 가져옵니다.
저장을 클릭합니다. 대기 화면 구성이 연결된 모든 클라이언트에 푸시됩니다.

예상 결과

활성 세션이 아닌 클라이언트 PC에 구성된 전환, 시계 오버레이, 카페 이름과 함께 슬라이드쇼가 표시됩니다. 슬라이드쇼는 연속으로 반복됩니다.

일반적인 실수

동기화 시간을 고려하지 않고 너무 많은 고해상도 이미지를 추가하는 경우. 각 미디어 파일은 모든 클라이언트로 전송되어야 합니다. 전체 슬라이드쇼 크기를 적절하게 유지합니다.
재생 시간을 너무 짧게(3초 미만) 설정하는 경우. 빠른 전환은 불쾌감을 줄 수 있으며 슬라이드의 텍스트를 읽기 어렵게 합니다.
모든 슬라이드쇼 이미지에 대해 시계 색상을 테스트하지 않는 경우. 흰색 시계는 밝은 흰색 슬라이드에서 보이지 않습니다. 전체 슬라이드쇼 세트에서 작동하는 색상을 선택합니다.

공지사항 생성 방법

공지사항은 클라이언트 데스크톱에 표시되며 이벤트를 홍보하거나 뉴스를 공유하거나 광고를 표시할 수 있습니다. 시스템이 노출 수와 클릭 수를 자동으로 추적합니다.

필요한 것

HandyCafe Server가 실행 중이고 최소 하나의 클라이언트가 연결된 상태
시각적 공지를 원하는 경우 배너 이미지(권장 1200x400 픽셀 이상)

단계

설정 > 클라이언트 > 콘텐츠 탭으로 이동합니다.
앱 카테고리 아래의 공지사항 섹션으로 스크롤합니다.
공지사항 추가를 클릭합니다.
공지사항의 제목과 텍스트를 입력합니다. 외부 페이지로 연결하는 경우 링크 URL을 입력합니다.
유형 필드를 설정합니다. 일반 뉴스는 공지사항, 인터랙티브 양식 필드가 있는 기간 한정 프로모션은 이벤트, 간단한 텍스트 전용 메시지는 텍스트를 선택합니다.
카테고리를 설정하여 공지사항을 분류합니다: 링크, 게임, 공지사항, 광고. 이것은 클라이언트 레이아웃에서 표시되는 위치를 결정합니다.
이미지 영역을 클릭하고 파일을 선택하여 배너 이미지를 업로드합니다. 배너는 클라이언트 데스크톱의 공지사항 바에 표시됩니다. 저장을 클릭합니다.

예상 결과

공지사항이 연결된 클라이언트 데스크톱의 공지사항 바에 나타납니다. 고객이 보고 상호 작용할 때 서버가 노출 수(표시된 횟수)와 클릭 수(고객이 클릭한 횟수)를 추적합니다.

일반적인 실수

배너 이미지 없이 공지사항을 생성하는 경우. 이미지가 없는 텍스트 전용 공지사항은 공지사항 바에서 고객이 쉽게 간과합니다.
만료 설정을 잊거나 오래된 공지사항을 제거하지 않는 경우. 활성 상태로 남겨진 오래된 프로모션은 좋지 않은 고객 경험을 만듭니다.
공지사항 본문에 매우 긴 텍스트를 사용하는 경우. 표시 영역이 좁습니다. 텍스트를 간결하게 유지하고 세부 사항은 링크 뒤에 배치합니다.