TubeMusicPlayer config.json 옵션 변경 차이 설명표
작성자 정보
- 최고관리자 작성
- 192.♡.0.1 아이피
- 작성일
컨텐츠 정보
- 406 조회
- 1 댓글
- 목록
링크
첨부
본문
📊 TubeMusicPlayer config.json 옵션 변경 차이 설명표
🔹 기본 정보 영역
| 항목 | 예제 값 | 변경 시 영향 | 주의사항 |
|---|---|---|---|
name | "TubeMusicPlayer" | 애드온 표시 이름 변경 | 기능 영향 없음 |
version | "2.4.1" | HA 업데이트 감지 | 변경 안 하면 업데이트 안 뜸 |
slug | "tubemusicplayer" | 애드온 고유 ID 변경 | 변경 시 다른 애드온으로 인식 |
description | "설명" | 스토어 설명 변경 | JSON 줄바꿈 주의 |
📊 arch (지원 CPU)
| 값 | 대상 장치 | 특징 |
|---|---|---|
armhf | Raspberry Pi 32bit | 구형 Pi |
armv7 | ARMv7 장치 | 중간 세대 ARM |
aarch64 | ARM 64bit | Pi 4/5 등 |
amd64 | x86_64 PC | NUC/PC |
📊 Ingress 설정 차이
| 옵션 | 값 | 동작 변화 |
|---|---|---|
ingress | true | HA 내부 패널 사용 |
ingress | false | 외부 URL 직접 접속 필요 |
ingress_port | 4006 | 내부 웹서버 연결 포트 변경 |
📊 panel UI 설정 차이
| 항목 | 변경 효과 |
|---|---|
panel_icon | 사이드바 아이콘 변경 |
panel_title | 사이드바 표시 이름 변경 |
📊 startup 설정 차이
| 값 | 의미 | 특징 |
|---|---|---|
application | 일반 앱 | UI 기반 애드온 |
services | 백그라운드 서비스 | daemon 성격 |
📊 boot 설정 차이
| 값 | 동작 |
|---|---|
auto | HA 시작 시 자동 실행 |
manual | 수동 실행 필요 |
📊 audio 옵션 차이
| 값 | 의미 |
|---|---|
true | 오디오 장치 접근 허용 |
false | 오디오 출력 불가 |
📊 API 권한 차이
| 옵션 | true | false |
|---|---|---|
hassio_api | Supervisor API 접근 허용 | 접근 차단 |
homeassistant_api | HA Core API 사용 가능 | API 사용 불가 |
📊 options 영역 차이
🔹 token
| 값 | 동작 |
|---|---|
"homeassistant" | 기본 문자열 |
| 실제 Long-Lived Token | HA API 인증 가능 |
schema 차이
| schema 값 | 의미 |
|---|---|
"str" | 일반 텍스트 표시 |
"password" | ●●● 숨김 표시 |
📊 local_ip 차이
| 값 | 동작 |
|---|---|
"192.168.x.x" | 고정 내부 IP 사용 |
"" | 자동 IP 감지 |
schema 차이
| schema | 의미 |
|---|---|
"str" | 필수 입력 |
"str?" | 선택 입력 |
📊 allowed_local_ips 차이
| 값 | 동작 |
|---|---|
[] | 제한 없음 |
["192.168.0.31"] | 특정 IP만 허용 |
| 여러 IP | 화이트리스트 방식 |
schema 차이
| schema | 의미 |
|---|---|
["str"] | 문자열 배열 입력 |
📊 disable_public_ip_check 차이
| 값 | 의미 | 보안 |
|---|---|---|
false | 외부 접근 차단 | 안전 |
true | 외부 접근 허용 | 위험 가능 |
schema 차이
| schema | UI 형태 |
|---|---|
"bool" | ON/OFF 토글 |
📊 youtube_api_key 차이
| 값 | 동작 |
|---|---|
"" | API 없이 동작 |
| API KEY 입력 | 검색/메타데이터 향상 |
schema 차이
| schema | UI |
|---|---|
"str?" | 일반 텍스트 |
"password?" | 숨김 입력 |
📊 schema 타입별 차이
| 타입 | 필수 여부 | UI 형태 | 특징 |
|---|---|---|---|
str | 필수 | 텍스트 입력 | 값 필요 |
str? | 선택 | 텍스트 입력 | 빈값 가능 |
bool | 필수 | ON/OFF 토글 | true/false |
["str"] | 선택 | 리스트 입력 | 여러 문자열 |
password | 필수 | 숨김 입력 | ●●● |
password? | 선택 | 숨김 입력 | API 키 추천 |
📊 자주 발생하는 오류 차이
| 문제 | 원인 |
|---|---|
| 애드온 목록 안 뜸 | JSON 문법 오류 |
| 업데이트 안 보임 | version 미변경 |
| 저장 실패 | schema/options 불일치 |
| 외부 접속 안됨 | public IP 차단 |
| API 인증 실패 | token 오류 |
| 설정 저장 불가 | bool/배열 타입 오류 |
📊 추천 운영 설정
| 항목 | 추천값 |
|---|---|
| token | password |
| youtube_api_key | password? |
| disable_public_ip_check | false |
| local_ip | 자동 또는 내부 고정 IP |
| allowed_local_ips | 내부망 제한 권장 |
📌 핵심 요약
| 핵심 | 설명 |
|---|---|
options | 기본값 |
schema | UI + 타입 정의 |
version | 업데이트 트리거 |
slug | 애드온 고유 ID |
bool | 토글 UI |
? | 선택 입력 의미 |
첨부 파일을 스킨보드에 구성 PDF보기( W:\g5\skin\board\BS4-Basic-Webzine_11q_pdf_php82\view.skin.php + view_pdf.php구성)
관련자료
-
이전
-
다음
댓글 1
빨강모자님의 댓글
- 빨강모자
- 아이피 121.♡.126.148
- 작성일
어렵네요....
구문이 어려운건 아니지만 글이 잘 안보이다보니........
수고하셨습니다...꾸벅~~
구문이 어려운건 아니지만 글이 잘 안보이다보니........
수고하셨습니다...꾸벅~~