Escolha e salve tons usando o esquema de URI ms-tonepicker

Este tópico descreve como utilizar o URI scheme ms-tonepicker:. Este esquema de URI pode ser usado para:

• Determine se o seletor de tons está disponível no dispositivo.
• Exiba o seletor de tons para listar toques disponíveis, sons do sistema, tons de texto e sons de alarme; e obter um token de tom que representa o som que o usuário selecionou.
• Mostre o salvador de tom, que recebe um token de arquivo de som como entrada e o salva no dispositivo. Os tons guardados ficam então disponíveis através do seletor de tons. Os usuários também podem dar ao tom um nome amigável.
• Converta um token de tom para a sua designação amigável.

ms-tonepicker: referência para o esquema de URI

Esse esquema de URI não passa argumentos por meio da cadeia de caracteres do esquema de URI, mas passa argumentos por meio de um ValueSet. Todas as cadeias de caracteres diferenciam maiúsculas de minúsculas.

As seções abaixo indicam quais argumentos devem ser passados para realizar a tarefa especificada.

Tarefa: Determinar se o seletor de tons está disponível no dispositivo

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

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

Tarefa: Exibir o seletor de tons

Os argumentos que você pode passar para exibir o seletor de tons são os seguintes:

Os valores retornados em LaunchUriResults.Result:

Exemplo: Abra o seletor de tons para que o usuário possa selecionar um tom

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
     }
}

Tarefa: exibir a economia de tom

Os argumentos que podes utilizar para mostrar o modo de poupança de tom são os seguintes:

Os valores retornados em LaunchUriResults.Result:

Exemplo: Salvar um arquivo de música local como um toque

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;
          }
      }
 }

Tarefa: converter um token de tom para seu nome amigável

Os argumentos que você pode passar para obter o nome amigável de um tom são os seguintes:

Os valores retornados em LaunchUriResults.Result:

Exemplo: Recupere um token de tom de Contact.RingToneToken e exiba seu nome amigável no cartão de visita.

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
        }
    }
}