서비스 메타데이터 개요

MBAE 사용 중단 경고

중요

Windows 10 버전 1803부터 MBAE 앱 환경은 MO UWP 앱으로 대체됩니다. MO UWP 앱에 대한 자세한 내용은 UWP 모바일 광대역 앱을 참조하세요.

서비스 메타데이터 패키지를 만들고 제출하여 Windows와 긴밀하게 통합된 환경을 만들 수 있습니다. Windows가 운영자의 서비스 메타데이터 패키지와 일치하는 모바일 광대역 하드웨어를 감지하면 서비스 메타데이터 및 지정된 모바일 광대역 앱을 자동으로 다운로드합니다.

서비스 메타데이터에는 다음을 포함하여 서비스를 설명하는 정보가 포함됩니다.

  • 서비스 공급자 이름

  • 하나 이상의 서비스 범주

  • 모바일 광대역 관련 정보

  • 모바일 광대역 앱

  • 모바일 광대역 프로필

  • XML 프로비저닝을 위한 신뢰할 수 있는 인증서

  • DeviceNotificationHandler 요소

  • PrivilegedApplications 요소

메타데이터의 정보는 Windows 8, Windows 8.1 및 Windows 10 사용자 환경의 측면을 사용자 지정하고 이전에 통신사 앱이라고 하는 모바일 광대역 앱과의 통합을 제공하는 데 사용됩니다.

서비스 메타데이터 패키지는 .devicemetadata-ms 파일 내에 저장된 여러 XML 문서로 구성됩니다. 각 문서에서는 서비스 특성의 다양한 구성 요소를 지정합니다. 이러한 XML 문서는 Windows 연결 관리자 사용자에게 표시되는 사용자 지정과 네트워크 구성 정보를 제공합니다.

서비스 메타데이터 패키지의 XML 문서에 대한 참조 정보는 서비스 메타데이터 패키지 스키마 참조를 참조하세요.

서비스 메타데이터 콘텐츠

다음 요약에서는 서비스 메타데이터 패키지 내에 포함되고 정의된 가장 흥미로운 필드 중 일부에 대해 설명합니다.

  • 하드웨어 ID
    GSM 네트워크의 경우 서비스 메타데이터 패키지와 일치시킬 IMSI 또는 ICCID 범위를 설명하는 메타데이터 패키지를 제출할 수 있습니다. MVNO인 경우 MNO에서 임대한 IMSI 또는 SIM ICC ID 범위를 하나 이상 지정할 수 있습니다. CDMA 네트워크의 경우 공급자 ID(SID/NID) 또는 공급자 이름을 사용하여 패키지를 제출할 수 있습니다. 하드웨어 ID는 서비스 메타데이터 패키지 스키마의 HardwareID 요소에 해당합니다. MNO 및 MVNO 시나리오에 대한 HWID(하드웨어 식별) 범위를 계획하는 방법에 대한 자세한 내용은 MVNO에 대한 환경 제공을 참조하세요.

  • 서비스 번호
    모바일 광대역 서비스 공급자의 고유 ID입니다. 이 GUID는 계정 프로비저닝 메타데이터를 사용할 때 연산자를 식별하는 데도 사용됩니다. 디바이스 메타데이터 패키지를 업데이트하는 경우 이 GUID는 동일하게 유지되어야 합니다. 서비스 번호는 서비스 메타데이터 패키지 스키마의 ServiceNumber 요소에 해당합니다.

  • 연산자 로고 Windows에 표시되는 사용자 지정 로고는 네트워크 항목 옆에 연결 관리자. (사용자가 로밍 네트워크에 있을 때 로고가 숨겨집니다.) 연산자 로고는 서비스 메타데이터 패키지 스키마의 ServiceIconFile 요소에 해당합니다. 로고 요구 사항에 대한 자세한 내용은 서비스 아이콘 요구 사항을 참조하세요.

    중요

    Windows 10 버전 1709 이상에서 이 필드는 COSA를 통한 브랜딩으로 대체되었습니다. 브랜딩을 위한 COSA의 필드는 데스크톱 COSA/APN 데이터베이스 제출 계획에 설명되어 있습니다. Windows 10 버전 1709 이전 버전의 Windows를 대상으로 하는 경우에도 이 섹션에 설명된 대로 메타데이터 패키지를 만듭니다. COSA에 대한 자세한 내용은 COSA 개요를 참조하세요.

  • 모바일 광대역 앱
    자동으로 다운로드되어 컴퓨터에 적용되는 UWP 디바이스 앱입니다. 이 앱은 계획 구매, 데이터 사용량, 도움말 및 지원과 같은 주요 환경을 제공하고 부가 가치 서비스를 강조 표시할 수 있습니다.

  • MB 구매 프로필
    구독 구매에 대한 제한된 연결을 설정하는 데 사용되는 구매 프로필입니다.

    모든 구독자에 대해 구매 APN이 하나만 있는 GSM 운영자인 경우 서비스 메타데이터를 사용하여 컴퓨터에 프로비전할 수 있습니다. 구매 APN이 여러 대 있는 경우 계정 프로비저닝 메타데이터를 사용하여 적절한 구매 APN을 설정해야 합니다. 또는 아무 것도 수행하지 않으며 APN 데이터베이스에 저장된 항목을 사용하여 APN 연결 정보를 제공할 수 있습니다.

  • MB 인터넷 프로필
    모든 모바일 광대역 구독에는 홈 네트워크 운영자에 연결하는 데 사용되는 하나의 기본 프로필이 있을 수 있습니다. Windows 연결 관리자 이 프로필을 사용하여 네트워크에 자동 연결합니다.

    모든 구독자에 대해 인터넷 APN이 하나만 있는 GSM 운영자인 경우 서비스 메타데이터를 사용하여 컴퓨터를 프로비전할 수 있습니다. 인터넷 APN이 여러 대 있는 경우 계정 프로비저닝 메타데이터를 사용하여 적절한 인터넷 APN을 설정해야 합니다. 또는 아무 것도 수행하지 않으며 APN 데이터베이스에 저장된 항목을 사용하여 APN 연결 정보를 제공할 수 있습니다.

  • 인증서 데이터
    프로비저닝에 사용되는 인증서 정보입니다. 여기에는 인증서 발급자 이름 및 주체 이름이 포함됩니다. 이 정보는 웹 사이트에서 시작된 계정 프로비저닝 작업이 신뢰할 수 있는 운영자에 의해 발급되도록 하는 데 사용됩니다.

  • 사용자 지정 연산자 이름
    모바일 광대역 디바이스는 일반적으로 Windows 연결 관리자 Windows에 표시되는 운영자 이름을 제공합니다. 메타데이터에서 사용자 지정 이름을 지정하여 이 이름을 재정의할 수 있습니다. 이 이름은 사용자가 홈 네트워크에 있고 로밍 네트워크에 없는 경우에만 표시됩니다. 표시된 로밍 네트워크 이름은 디바이스에서 받은 정보를 기반으로 합니다. 이는 서비스 패키지 메타데이터 스키마의 ServiceProvider 요소에 해당합니다.

    중요

    Windows 10 버전 1709 이상에서 이 필드는 COSA를 통해 브랜딩으로 대체되었습니다. 브랜딩을 위한 COSA의 필드는 데스크톱 COSA/APN 데이터베이스 제출 계획에 설명되어 있습니다. 버전 1709를 Windows 10 전에 Windows 버전을 대상으로 하는 경우에도 이 섹션에 설명된 대로 메타데이터 패키지를 만듭니다. COSA에 대한 자세한 내용은 COSA 개요를 참조하세요.

  • 디바이스 알림 처리기
    일반적으로 시스템 이벤트 브로커에 작업 항목을 등록하려면 먼저 사용자가 앱을 한 번 이상 실행해야 합니다. 그러나 모바일 광대역 앱은 사용자가 앱을 실행하기 전에 중요한 이벤트를 수신해야 할 수 있습니다. Windows에서 몇 가지 중요한 이벤트를 등록하는 데 사용할 서비스 메타데이터에서 DeviceNotificationHandler 요소를 지정할 수 있습니다. SMS 알림에 대한 자세한 내용은 MVNO에 대한 환경 제공을 참조하세요.

  • 모바일 광대역 제한 인터페이스에 액세스할 수 있는 권한 있는 앱 목록
    모바일 광대역 API 및 인터페이스(계정 프로비저닝 및 SMS 포함)는 제한되며 모바일 광대역 앱에서만 사용할 수 있습니다. 이러한 권한 있는 API에 액세스할 수 있는 권한 있는 앱 목록은 PrivilegedApplications 요소의 서비스 메타데이터 패키지에 지정할 수 있습니다. 권한 있는 앱은 디버깅하거나 앱을 테스트할 수 있습니다. Microsoft Store를 통해 배포할 필요는 없습니다.

서비스 메타데이터 패키지 구조

서비스 메타데이터 패키지의 구성 요소는 압축된 캐비닛 파일에 저장되며 .devicemetadata-ms의 파일 확장명이 있어야 합니다. 서비스 메타데이터 패키지는 디바이스 메타데이터 패키지와 동일한 기본 플랫폼을 사용하므로 이 파일 확장자를 사용합니다. .devicemetadata-ms 파일을 만들기 전에 먼저 메타데이터 패키지에 대한 GUID(Globally Unique Identifier)를 만들어야 합니다. 그런 다음 .devicemetadata-ms 파일을 <만들 때 GUID.devicemetadata-ms>라는 명명 규칙을 사용해야 합니다.

참고 캐비닛 파일의 일반적인 파일 확장명은 .cab서비스 메타데이터 패키지 파일의 파일 확장명은 .devicemetadata-ms여야 합니다. 이는 최종 사용자가 이러한 패키지를 압축 해제하거나 수정해서는 안 됨을 강조하기 위한 것입니다.

서비스 메타데이터 패키지에는 단일 로캘 서비스 메타데이터 패키지와 여러 로캘 서비스 메타데이터 패키지의 두 가지 유형이 있습니다.

단일 로캘 서비스 메타데이터 패키지

서비스 메타데이터 패키지의 지역화 가능한 리소스는 Windows 연결 관리자 표시되는 운영자 이름 및 옆에 표시되는 서비스 아이콘입니다. 이름을 지역화하거나 PC의 로캘 정보에 따라 아이콘을 변경할 필요가 없는 경우 단일 로캘 서비스 메타데이터 패키지를 만듭니다. 사용자가 PC에서 사용하는 로캘에 관계없이 단일 로캘 서비스 메타데이터 패키지에 정의된 운영자 이름 및 서비스 아이콘을 가져옵니다.

단일 로캘 서비스 메타데이터 패키지에는 다음 파일 구조가 있어야 합니다.

단일 로캘 서비스 메타데이터 패키지의 파일 구조를 보여 주는 다이어그램

단일 로캘 메타데이터 패키지에 대한 몇 가지 고려 사항:

  • 아이콘 파일에는 파일 이름이 있을 수 있습니다. 그러나 개별 XML 문서의 이름은 ,ServiceInfo.xml, WindowsInfo.xmlSoftwareInfo.xmlPackageInfo.xml.

  • MobileBroadbandInfo.xml 파일의 이름은 ServiceInfo.xml에 정의되어 있습니다. 이 문서에 나열된 이름을 해당 파일에 사용해야 합니다.

  • .devicemetadata-ms 파일은 이름에 "{" 또는 "}"를 포함할 수 없습니다. 각 메타데이터 패키지 파일 이름에 대한 GUID는 고유해야 합니다. 새 서비스 메타데이터 또는 수정된 서비스 메타데이터 패키지를 만들 때 변경 내용이 사소한 경우에도 새 GUID를 만들어야 합니다.

  • Windows는 파일 확장명 .devicemetadata-ms를 사용하여 서비스 메타데이터 패키지를 인식합니다.

다중 로캘 서비스 메타데이터 패키지 구조

서비스 메타데이터 패키지는 하나의 패키지에서 여러 로캘 파일을 지원합니다. 서비스에 대해 둘 이상의 로캘을 지원하는 경우 여러 로캘 파일을 하나의 서비스 메타데이터 패키지에 넣을 수 있습니다.

Windows 연결 관리자 네트워크 목록에 서비스의 지역화된 이름을 표시하거나 네트워크에 대한 Windows 연결 관리자 다른 로고를 표시하려는 경우 여러 로컬 서비스 메타데이터 패키지를 사용할 수 있습니다. Windows는 일반적으로 Windows 설치 중에 구성된 시스템 기본 설정 언어에 따라 지역화된 네트워크 이름 및 로고를 표시합니다. 현재 사용자의 언어가 시스템 기본 설정 언어와 다르더라도 아이콘 및 네트워크 이름은 항상 시스템 기본 설정 언어로 표시됩니다. 서비스 메타데이터 패키지에 로캘이 포함되어 있지 않으면 서비스 메타데이터 패키지 루트의 언어 중립적 설명이 표시됩니다. 대부분의 사용자에게 해당 언어는 시스템 기본 설정 언어와 일치합니다.

여러 로캘 서비스 메타데이터 패키지에는 다음 파일 구조가 있어야 합니다.

다중 로캘 서비스 메타데이터 패키지의 파일 구조를 보여 주는 다이어그램

여러 로캘 메타데이터 패키지에 대한 몇 가지 고려 사항:

  • 각 폴더에 로캘 이름 폴더를 만들고 XML 파일 또는 관련 파일을 로캘 이름 폴더에 넣습니다.

  • 여전히 최상위 XML 파일과 아이콘 파일과 같은 관련 파일이 각 폴더의 최상위 수준에 있어야 합니다. 이는 로캘이 서비스 메타데이터 패키지에 포함되지 않은 경우 대체 메커니즘을 제공합니다.

  • 모든 필수 파일과 해당 파일 내의 필드가 사용자가 만든 각 로캘 관련 폴더 내에 완전히 채워져 있는지 확인합니다. 이는 각 폴더의 최상위 수준에 있는 콘텐츠에 추가됩니다. 예를 들어 ServiceInfo.xml ServiceNumber 요소는 최상위 폴더와 사용자가 만든 모든 로캘별 폴더에서 채워지고 복제되어야 합니다. 이렇게 하지 않으면 오류가 발생합니다.

  • SoftwareInformation XML 문서는 로캘당 다른 SoftwareInfo.xml 파일을 지정할 수 없으므로 여러 로캘을 지원하지 않습니다.

서비스 메타데이터 제출 및 유지 관리

Windows 개발자 센터 대시보드 – 하드웨어에 서비스 메타데이터 패키지를 제출하는 방법에 대한 자세한 내용은 서비스 메타데이터를 만들기 위한 개발자 가이드를 참조하세요.

메타데이터 패키지가 설명되는 방식과 일치하는 IMSI 및 ICCID 또는 CDMA 공급자 이름 또는 SID 값과 관련하여 메타데이터 패키지를 최신 상태로 유지하는 것이 중요합니다. 이렇게 하려면 MNO 또는 MVNO가 SIM 또는 디바이스 획득의 일부인 새 워크플로를 구현하여 새 SIM 주문과 해당 ICCID 또는 IMSI가 제공되는 MNO 또는 MVNO를 추적해야 할 수 있습니다.

MNO 및 MVNO에 대해 ICCID 또는 IMSI 범위(또는 CDMA SIM/공급자 이름)를 미리 예약하여 서비스 메타데이터를 자주 변경하지 않는 것이 좋습니다. 따라서 새 SIM(또는 CDMA 디바이스)이 조달될 때 서비스 메타데이터 패키지에서 이미 고려됩니다.

Windows 개발자 센터 하드웨어 dashboard 등록된 서비스 식별자를 업데이트해야 하는 경우 서비스 식별자 소유권 업데이트를 참조하세요.

메타데이터 업데이트는 Windows가 업데이트된 메타데이터 업데이트가 있는지 여부를 WMIS에 쿼리할 때 내부 Windows 논리(일반적으로 8일마다)에 따라 자동으로 적용됩니다.

앱은 최신 메타데이터가 시스템에 적용될 때까지 참조하는 이전 버전의 메타데이터를 처리하도록 설계되어야 합니다.

모바일 광대역 앱의 사용자 환경을 디자인하면 디바이스가 없거나 인식되지 않는 경우와 같은 일반적인 오류 사례를 해결하기 위해 사용자 환경을 디자인하는 방법에 대한 지침을 제공합니다.