UPnP 기반 디바이스 설명 디바이스의 속성 및 디바이스 내 중첩된 디바이스의 계층 구조를 설명하는 XML 문서입니다. 디바이스에 대한 UPnP 템플릿 언어(UTL)라고 하는 UPnP 기반 디바이스 설명에 대한 스키마는 UPnP 디바이스 아키텍처에 정의되어 있습니다. 디바이스 설명에는서비스 설명에 대한 링크가 포함되어 있습니다. 서비스 설명에 대한 스키마 및 서비스용 UTL도 "UPnP 디바이스 아키텍처" 사양에 정의되어 있습니다.
디바이스 개발자는 디바이스에 대한 디바이스 및 서비스 설명을 제공해야 합니다.
호스트된 디바이스의 개발자가 제공해야 하는 디바이스 설명의 요소는 다음 예외를 제외하고 "UPnP 디바이스 아키텍처" 사양에 정의된 요소와 동일합니다.
- controlURL 및 eventSubURL 요소가 필요하며 비어 있어야 합니다. 디바이스 호스트는 디바이스가 게시되고 발표될 때 이러한 필드에 대한 값을 채웁니다.
- UDN 요소는 디바이스 설명 문서에 고유한 식별자를 포함해야 합니다( 즉, 전역적으로 고유할 필요는 없음). 이 식별자는 디바이스 호스트에서 생성된 UDN을 조회하는 데 사용됩니다.
- SCPDURL 요소에는 서비스 설명에 대한 URL이 포함되어서는 안 됩니다. 대신 서비스 설명 파일의 이름을 포함해야 합니다. 서비스 설명 파일은 리소스 디렉터리있어야 합니다. 설치 프로그램 사용과 같이 등록 프로세스 중에 이 디렉터리의 위치를 디바이스 호스트에 제공해야 합니다. 이 경로와 그 아래의 모든 경로는 등록된 경로를 기반으로 하는 상대 경로입니다.
- 아이콘 요소 내의 url 요소에는 디바이스 아이콘에 대한 URL이 포함되어서는 안 됩니다. 대신 아이콘 파일의 이름을 포함해야 합니다. 있는 경우 아이콘 파일이 리소스 디렉터리에 있어야 합니다. 이 경로와 그 아래의 모든 경로는 등록된 경로를 기반으로 하는 상대 경로입니다.
- URLBase 요소가 없어야 합니다.
메모
디바이스 호스트에서 생성된 모든 URL은 상대 URL입니다. URL은 초기 디바이스 알림에서 전송되는 디바이스 설명 문서의 위치를 기준으로 합니다.
중요하다
유니버설 플러그 앤 플레이 디바이스 호스트가 문서를 구문 분석하려고 할 때 등록 오류가 발생할 수 있으므로 디바이스 설명 문서에 메모를 추가하지 마세요.
문자열 길이 제한 사항
UPnP 기술과 함께 디바이스 호스트 API에서 사용되는 문자열 길이는 다음과 같습니다.
- deviceType – 64바이트
- friendlyName – 64 바이트
- 제조업체 – 64바이트
- modelDescription – 128바이트
- modelName – 32바이트
- modelNumber － 32바이트
- serialNumber – 64 바이트
- UPC – 12바이트
- 서비스 유형 – 64바이트
- serviceId – 64바이트