ms-tonepicker URI 스키마를 사용하여 톤 선택 및 저장

이 항목에서는 ms-tonepicker: URI 체계를 사용하는 방법에 대해 설명합니다. 이 URI 체계를 사용하여 다음을 수행할 수 있습니다.

• 장치에서 톤 선택기를 사용할 수 있는지 확인합니다.
• 사용 가능한 벨소리, 시스템 소리, 텍스트 톤 및 알람 소리를 나열하는 톤 선택기를 표시합니다. 사용자가 선택한 소리를 나타내는 톤 토큰을 가져옵니다.
• 사운드 파일 토큰을 입력으로 사용하여 디바이스에 저장하는 톤 보호기를 표시합니다. 저장된 톤은 톤 선택기를 통해 사용할 수 있습니다. 사용자는 톤에 친숙한 이름을 지정할 수도 있습니다.
• 톤 토큰을 친숙한 이름으로 변환합니다.

ms-tonepicker: URI 체계 참조

이 URI 체계는 URI 스키마 문자열을 통해 인수를 전달하지 않고 대신 ValueSet통해 인수를 전달합니다. 모든 문자열은 대소문자를 구분한다.

아래 섹션에서는 지정된 작업을 수행하기 위해 전달해야 하는 인수를 나타냅니다.

작업: 장치에서 톤 선택기를 사용할 수 있는지 확인

var status = await Launcher.QueryUriSupportAsync(new Uri("ms-tonepicker:"),     
                                     LaunchQuerySupportType.UriForResults,
                                     "Microsoft.Tonepicker_8wekyb3d8bbwe");

if (status != LaunchQuerySupportStatus.Available)
{
    // the tone picker is not available
}

작업: 톤 선택기 표시

톤 선택기를 표시하기 위해 전달할 수 있는 인수는 다음과 같습니다.

LaunchUriResults.Result반환되는 값은 다음과 같습니다.

예: 사용자가 톤 선택할 수 있도록 톤 선택기를 엽니다.

LauncherOptions options = new LauncherOptions();
options.TargetApplicationPackageFamilyName = "Microsoft.Tonepicker_8wekyb3d8bbwe";

ValueSet inputData = new ValueSet() {
    { "Action", "PickRingtone" },
    { "TypeFilter", "Ringtones" } // Show only ringtones
};

LaunchUriResult result = await Launcher.LaunchUriForResultsAsync(new Uri("ms-tonepicker:"), options, inputData);

if (result.Status == LaunchUriStatus.Success)
{
     Int32 resultCode =  (Int32)result.Result["Result"];
     if (resultCode == 0)
     {
         string token = result.Result["ToneToken"] as string;
         string name = result.Result["DisplayName"] as string;
     }
     else
     {
           // handle failure
     }
}

작업: 톤 세이버 표시

톤 보호기를 표시하기 위해 전달할 수 있는 인수는 다음과 같습니다.

LaunchUriResults.Result반환되는 값은 다음과 같습니다.

예: 로컬 음악 파일을 벨소리로 저장

LauncherOptions options = new LauncherOptions();
options.TargetApplicationPackageFamilyName = "Microsoft.Tonepicker_8wekyb3d8bbwe";

ValueSet inputData = new ValueSet() {
    { "Action", "SaveRingtone" },
    { "ToneFileSharingToken", SharedStorageAccessManager.AddFile(myLocalFile) }
};

LaunchUriResult result = await Launcher.LaunchUriForResultsAsync(new Uri("ms-tonepicker:"), options, inputData);

if (result.Status == LaunchUriStatus.Success)
{
     Int32 resultCode = (Int32)result.Result["Result"];

     if (resultCode == 0)
     {
         // no issues
     }
     else
     {
          switch (resultCode)
          {
             case 2:
              // The specified file was invalid
              break;
              case 3:
              // The specified file's content type is invalid
              break;
              case 4:
              // The specified file was too big
              break;
              case 5:
              // The specified file was too long
              break;
              case 6:
              // The file was protected by DRM
              break;
              case 7:
              // The specified parameter was incorrect
              break;
          }
      }
 }

작업: 톤 토큰을 친근한 이름으로 변환

톤의 친숙한 이름을 얻기 위해 전달할 수 있는 인수는 다음과 같습니다.

LaunchUriResults.Result반환되는 값은 다음과 같습니다.

예: Contact.RingToneToken에서 톤 토큰을 검색하여 연락처 카드에 친숙한 이름을 표시합니다.

using (var connection = new AppServiceConnection())
{
    connection.AppServiceName = "ms-tonepicker-nameprovider";
    connection.PackageFamilyName = "Microsoft.Tonepicker_8wekyb3d8bbwe";
    AppServiceConnectionStatus connectionStatus = await connection.OpenAsync();
    if (connectionStatus == AppServiceConnectionStatus.Success)
    {
        var message = new ValueSet() {
            { "Action", "GetToneName" },
            { "ToneToken", token)
        };
        AppServiceResponse response = await connection.SendMessageAsync(message);
        if (response.Status == AppServiceResponseStatus.Success)
        {
            Int32 resultCode = (Int32)response.Message["Result"];
            if (resultCode == 0)
            {
                string name = response.Message["DisplayName"] as string;
            }
            else
            {
                // handle failure
            }
        }
        else
        {
            // handle failure
        }
    }
}