플러그인 버전 되돌리기

최근 플러그인 업데이트로 장치의 조명이 정상 작동하지 않는다면, 플러그인 롤백 기능으로 SignalRGB 안에서 바로 이전 버전으로 되돌릴 수 있습니다. 파일을 직접 교체할 필요도, 재시작할 필요도 없습니다. 이 문서에서는 사용 방법과 문제가 생겼을 때의 대처 방법을 설명합니다.

빠른 체크리스트

문제를 해결하기 전에 다음 요건이 충족되었는지 확인하십시오:

• SignalRGB가 최신 버전입니다. 플러그인 롤백은 2.5.74에서 도입되었습니다. 애플리케이션을 재시작하여 자동 업데이트 서비스를 실행하고, 변경 로그에서 최신 버전을 확인하십시오.
• 장치가 인식됩니다. 장치가 장치 목록에 표시되어야 합니다. 전혀 표시되지 않는다면 먼저 장치가 감지되지 않음을 참조하십시오.
• 장치가 CDN 플러그인을 사용합니다. 롤백은 SignalRGB의 플러그인 네트워크를 통해 배포되는 플러그인에서만 사용할 수 있습니다. 기본 제공, 애드온, 수동 설치한 사용자 플러그인은 설정에 플러그인 정보를 표시하지만 버전 선택은 지원하지 않습니다.
• SignalRGB가 인터넷에 연결되어 있습니다. 버전 목록을 열면 앱이 서버에서 사용 가능한 버전을 가져옵니다. 네트워크 문제가 있으면 버전을 불러오지 못할 수 있습니다.

위 요건을 모두 충족했는데도 문제가 계속된다면 아래 해결책으로 진행하십시오.

플러그인 롤백 사용 방법

1. SignalRGB를 열고 장치 탭으로 이동하십시오.
2. 장치를 클릭한 다음 해당 장치의 설정 탭을 여십시오.
3. 아래로 스크롤하여 플러그인 섹션으로 이동하십시오. 플러그인 이름, 소스 유형(Built-in, Addon, CDN 또는 User Plugin), 그리고 롤백이 가능한 경우 버전 드롭다운이 표시됩니다.
4. 드롭다운을 클릭하여 버전 목록을 불러오십시오.
5. 아무 버전이나 선택하면 즉시 적용됩니다. 플러그인이 다시 로드되며 재시작은 필요하지 않습니다.

일반적인 문제 및 해결책

장치 설정에 롤백 옵션이 나타나지 않음

증상: 장치 설정에서 플러그인 섹션은 보이지만 버전 드롭다운이 없거나, 플러그인 옵션이 하나뿐이거나, 드롭다운이 비활성화되어 있거나, 소스 레이블은 표시되는데 그 아래에 선택기가 나타나지 않습니다.

해결책:

• 소스 레이블을 확인하십시오. Built-in, Addon 또는 User Plugin으로 표시되면 해당 플러그인은 롤백을 지원하지 않습니다. Source: CDN으로 표시된 플러그인만 버전 선택을 지원합니다.

• 이 플러그인의 버전이 하나뿐입니다. 기능이 도입된 이후 SignalRGB가 버전을 하나만 게시했다면 되돌릴 대상이 없습니다.
• 버전 목록을 아직 불러오는 중입니다. 드롭다운을 열고 잠시 기다리십시오. “Loading versions…”가 30초 넘게 표시되면 인터넷 연결을 확인한 뒤 다시 시도하십시오.

롤백해도 문제가 해결되지 않음

증상: 이전 버전을 선택해 플러그인이 다시 로드되었는데도 장치에 같은 문제가 남아 있습니다. 색상 오류, 조명 꺼짐, 깜빡임 또는 무반응 등입니다.

해결책:

• 롤백 후 장치를 분리했다가 다시 연결하십시오. 플러그인이 다시 로드되는 동안 장치가 완전히 초기화되지 않는 경우가 있습니다. 분리 후 재연결하면 상태를 초기화할 수 있습니다.
• 플러그인과 무관한 문제일 수 있습니다. 깜빡임, 색상 고정, 무반응은 USB 연결, 충돌하는 RGB 소프트웨어, 드라이버 문제에서도 발생합니다. 장치가 감지되지 않음과 충돌하는 프로그램을 참조하여 원인을 좁히십시오.
• 문제가 새 버전 이전부터 있었을 수 있습니다. 모든 버전에서 동일하게 동작한다면 그 문제는 플러그인 업데이트로 생긴 것이 아닙니다. 버그 보고서를 제출하거나 지원팀 문의 시기와 방법에서 다른 방법을 확인하십시오.

재시작 후 롤백이 초기화됨

증상: 이전 버전으로 되돌려 정상 작동했지만, SignalRGB를 재시작한 뒤 장치가 다시 최신 플러그인 버전으로 돌아갔습니다.

설명: 이는 정상 동작입니다. SignalRGB가 새 플러그인 버전을 게시하면 해당 플러그인에 저장된 롤백은 다음 시작 시 자동으로 해제됩니다. 새 릴리스가 롤백의 원인을 해결했다고 간주하기 때문입니다.

해결 방법: 새 버전에도 문제가 남아 있다면 장치 설정에서 다시 롤백하십시오.

”Applying…”이 표시되지만 롤백이 끝나지 않음

증상: 버전을 선택한 뒤 드롭다운에 “Applying…”이 표시된 채로 1분 넘게 그대로 있습니다.

해결책:

• 인터넷 연결을 확인하십시오. SignalRGB는 선택한 플러그인 버전을 서버에서 내려받습니다. 연결이 느리거나 끊기면 다운로드가 멈춥니다.
• SignalRGB를 재시작한 뒤 다시 시도하십시오. 앱을 완전히 종료했다가 다시 열고, 장치 설정에서 버전을 다시 선택하십시오.
• 몇 분 뒤에 다시 시도하십시오. 플러그인 서버를 일시적으로 사용할 수 없으면 다운로드가 조용히 실패할 수 있습니다. 잠시 기다리면 대개 해결됩니다.

고급 문제 해결

재시작 없이 최신 버전 복원하기

새 릴리스가 롤백을 자동으로 해제하기 전에 최신 플러그인 버전으로 돌아가려면:

1. 장치의 설정 탭을 여십시오.
2. 플러그인 섹션에서 버전 드롭다운을 여십시오.
3. 목록 맨 위에 있는 current 표시 항목을 선택하십시오.

SignalRGB가 최신 CDN 버전을 즉시 다시 적용하고 저장된 롤백을 해제합니다.

현재 로드된 플러그인 버전 확인하기

롤백이 적용 중인지, 어떤 버전이 실행 중인지 확실하지 않다면 장치 설정의 플러그인 섹션을 확인하십시오. 현재 로드된 버전의 CRC 해시와 배포 날짜가 표시됩니다. 표시된 날짜가 예상보다 오래되었다면 롤백이 적용 중일 수 있습니다.

플러그인 수동 교체

최후의 수단으로, 장치에서 플러그인 롤백을 사용할 수 없거나 모든 롤백 버전에 같은 문제가 있다면 사용자 플러그인 폴더에 파일을 넣어 특정 버전을 직접 설치할 수 있습니다. 이 방법은 CDN을 완전히 우회하고 업데이트 후에도 유지되므로, 정식 수정이 배포되면 파일을 제거하십시오.

단계는 플러그인 파일 교체를 참조하십시오.

문제 보고

이 문제 해결 단계를 모두 시도했는데도 장치가 제대로 작동하지 않는다면, 저희 팀이 조사할 수 있도록 버그 보고서를 제출해 주십시오:

버그 보고서에 포함할 내용:

• 장치 이름과 모델
• 장치 설정에 표시된 플러그인 소스 유형(CDN, Built-in 등)
• 되돌린 버전의 CRC 해시(플러그인 섹션에서 확인 가능)
• 장치의 증상: 깜빡임, 조명 꺼짐, 색상 오류 또는 무반응
• 롤백이 적용된 것으로 보였는지(버전 선택 후 플러그인이 다시 로드되었습니까?)
• 이 문서에서 이미 시도한 항목

제출 방법:

• 앱 오른쪽 위의 버그 아이콘 사용
• 버그 보고서 제출
• 고객 지원 문의

지원팀이 연락드려 문제 해결을 도와드리겠습니다!

관련 문서

• 장치가 감지되지 않음 — 장치가 전혀 표시되지 않는 경우
• 충돌하는 프로그램 — 다른 RGB 소프트웨어가 장치를 방해할 수 있는 경우
• 플러그인 파일 교체 — 플러그인을 수동으로 로드하는 방법
• 지원팀 문의 시기와 방법 — 지원팀에 연락하는 방법 안내