Kodi에서 ResolveURL을 사용하는 방법 (URLResolver 포크)

ResolveURL은 Kodi의 백그라운드 종속성 라이브러리이며, 비디오 카탈로그나 독립 실행형 플레이어가 아닙니다. 대부분의 사용자는 신뢰할 수 있는 저장소에서 필요한 애드온을 설치해야 합니다. 그러면 Kodi가 ResolveURL을 종속성으로 설치합니다. 설치 여부를 확인하려면 Kodi의 종속성 관리자를 열어보세요. 애드온 개발자는 script.module.resolveurl매니페스트 파일에 ResolveURL을 선언하고 현재 제공되는 Python API를 사용할 수 있습니다.

ResolveURL은 URLResolver의 포크 버전입니다. 유지 관리되는 프로젝트는 해당 패키지를 script.module.resolveurl별도의 Kodi 저장소를 통해 배포합니다. 2026년 10월 27일 기준으로 프로젝트 인덱스에는 버전이 5.1.212로 표시되어 있지만, 버전은 변경될 수 있으므로 최신 버전을 확인하려면 라이브 인덱스를 참조하세요. ResolveURL은 자체 코드에서 지원하는 링크만 처리하며 웹에서 영화나 TV 프로그램을 검색하지 않습니다. 접근 권한이 있는 콘텐츠에만 사용하세요.

Kodi에서 ResolveURL이 하는 일

Kodi 애드온은 직접 재생 가능한 스트림이 아닌 페이지 또는 파일 호스트 URL을 수신할 수 있습니다. ResolveURL은 지원되는 링크를 Kodi에서 열 수 있는 스트림 URL로 변환하려고 시도합니다. 이는 다른 애드온에서 공유하는 라이브러리이므로 일반적으로 Kodi 홈 화면에서 ResolveURL을 열기보다는 상위 애드온과 상호 작용하게 됩니다.

ResolveURL과 이전 버전인 URLResolver는 별개의 추가 기능 패키지입니다. 포크를 한다고 해서 모든 이전 종속성이 자동으로 교체되거나 작동이 중단된 추가 기능이 복구되는 것은 아닙니다. 변경 또는 제거하기 전에 해당 추가 기능의 문서를 확인하십시오.

일반적인 방법으로 설치하세요

1. 먼저 필요한 애드온부터 시작하세요. Kodi에서 '애드온'을 열고 '저장소에서 설치'를 선택한 다음, 애드온 게시자 또는 신뢰할 수 있는 다른 저장소를 선택하고 호환되는 애드온을 설치합니다. 매니페스트에 ResolveURL이 필요하고 해당 종속성이 설치된 저장소에 있는 경우 Kodi는 설치 과정에서 종속성 설치를 처리합니다.
2. 개발자 저장소는 필요한 경우에만 사용하십시오. 게시자가 ResolveURL 자체 저장소를 특별히 지정하는 경우, 관리자의 ZIP 저장소 에서 저장소 ZIP 파일을 다운로드하십시오 . 해당 ZIP 압축 폴더를 열고 현재 repository.resolveurl패키지를 선택하십시오. 저장소 ZIP 파일은 업데이트 소스를 등록하는 파일이며, ResolveURL 모듈 자체가 아닙니다.
3. 해당 ZIP 파일을 Kodi에 설치하세요. 애드온 브라우저에서 'ZIP 파일에서 설치'를 선택하고 , ZIP 파일을 저장하거나 복사한 위치로 이동하여 파일을 선택하세요. Kodi에서 '알 수 없는 소스'를 허용할지 묻는 메시지가 나타날 수 있습니다 . 출처를 신뢰하는 경우에만 계속 진행하세요. Kodi는 알 수 없는 출처의 애드온이 기기의 개인 데이터에 접근할 수 있다고 경고합니다. 정확한 메뉴 레이아웃은 Kodi 버전이나 스킨에 따라 다를 수 있습니다.
4. 종속 애드온이 모듈을 다운로드하도록 한 다음, 이를 확인하십시오. ResolveURL을 선언하는 애드온을 설치하거나 업데이트하세요. 결과를 확인하려면 설정 > 시스템 > 애드온 > 종속성 관리 로 이동하여 ResolveURL을 찾으세요. 해당 설정이 숨겨져 있으면 왼쪽 하단의 설정 수준을 고급 으로 변경하세요 . 목록에 활성화된 종속성이 표시되면 Kodi에 해당 모듈이 설치되어 있음을 의미하지만, 모든 호스트 링크가 정상적으로 작동한다는 것을 보장하는 것은 아닙니다.

추가 기능 브라우저는 ZIP 설치와 설치된 저장소 탐색을 분리합니다.

Kodi는 출처를 알 수 없는 애드온이 개인 정보를 노출시킬 수 있다고 경고합니다.

관리자 아카이브에서 다운로드한 저장소 ZIP 파일을 선택하세요.

종속성 관리에서 ResolveURL이 존재하고 활성화되어 있는지 확인할 수 있습니다.

추가 기능에서 ResolveURL을 사용하세요

개발자의 경우, 애드온의 `.js` 파일에 `ResolveURL`을 필수 종속성으로 추가하세요 addon.xml. `version` 속성은 코드에 필요한 최소 버전입니다. 사용하는 API 및 지원하는 Kodi 버전에 맞춰 설정하십시오.

<requires>
  <import addon="script.module.resolveurl" version="5.1.0" />
</requires>

그런 다음 상위 프로젝트의 HostedMediaFile인터페이스를 사용하여 지원되는 소스 URL을 확인하고 해결하십시오.

import resolveurl

hosted_file = resolveurl.HostedMediaFile(source_url)
playable_url = hosted_file.resolve() if hosted_file else None

if not playable_url:
    # Report an unsupported or unavailable source to the user.
    pass

결과 URL을 Kodi의 재생 흐름에 전달하기 전에 반드시 결과가 사용 가능한지 확인하십시오. 결과가 잘못되었거나 없는 경우 호스트가 지원되지 않거나, 소스 URL이 만료되었거나, 호스트가 페이지를 변경했거나, 요청이 실패했을 수 있습니다. 리졸버는 사용할 수 없거나 승인되지 않은 콘텐츠를 재생할 수 있도록 만들 수 없습니다.

현재 인터페이스 및 종속성 예제는 ResolveURL 소스 저장소 에 문서화되어 있습니다 . Kodi의 애드온 매니페스트 가이드에서는 자동 종속성 해결에 대해 설명하고 있으며, 애드온 설정 참조에서는 종속성 관리 및 알 수 없는 소스에 대해 설명합니다.

다른 추가 기능을 손상시키지 않고 문제를 해결하세요

• "종속성 항목을 사용할 수 없습니다": 상위 애드온을 제공하는 저장소를 새로 고치거나 업데이트하고, Kodi가 인터넷에 연결되어 있는지 확인하고, 애드온이 사용 중인 Kodi 버전을 지원하는지 확인하십시오. Kodi는 구성된 저장소에서 사용 가능하거나 게시자가 지정한 대로 제공된 종속성 항목만 설치할 수 있습니다.
• ResolveURL이 없거나 비활성화되어 있습니다. 추가 기능의 종속성 목록과 설치 메시지를 확인하세요. 추가 기능을 제공한 동일한 신뢰할 수 있는 저장소에서 업데이트하세요. 관련 없는 빌드의 ZIP 파일을 혼합해서 사용하지 마세요.
• 링크가 여전히 작동하지 않는 경우: 소스 링크가 유효하고 지원되는지 확인한 다음 상위 추가 기능의 로그 또는 지원 페이지를 확인하세요. ResolveURL은 특정 호스트의 서비스가 변경될 경우 해당 호스트에서 작동을 멈출 수 있습니다.
• 오래된 리졸버 제거: Kodi의 애드온 폴더를 수동으로 삭제하지 마십시오. Kodi는 다른 애드온에서 해당 종속성을 사용하는 경우 제거를 차단할 수 있습니다. 종속성 관리자가 해당 종속성을 고아로 표시하거나 어떤 애드온에서도 필요로 하지 않는 경우에만 Kodi를 통해 제거하십시오.

요약하자면, ResolveURL이 필요한 애드온은 신뢰할 수 있는 출처에서 설치하고, Kodi가 종속성을 관리하도록 하세요. 애드온을 개발하는 경우, 프로젝트에서 제공하는 공식 문서를 참고하십시오. 저작권이 있는 스트림을 무단으로 제공하는 저장소나 애드온은 사용하지 마세요.