Elegir y guardar tonos mediante el esquema de URI ms-tonepicker

En este tema se describe cómo usar el esquema URI ms-tonepicker:. Este esquema de URI se puede usar para:

• Determine si el selector de tono está disponible en el dispositivo.
• Mostrar el selector de tono para enumerar tonos disponibles, sonidos del sistema, tonos de texto y sonidos de alarma; y obtienen un token de tono que representa el sonido seleccionado por el usuario.
• Muestra el protector de tono, que toma un token de archivo de sonido como entrada y lo guarda en el dispositivo. A continuación, los tonos guardados están disponibles a través del selector de tonos. Los usuarios también pueden asignar un nombre descriptivo al tono.
• Convierta un token de tono en su nombre amigable.

ms-tonepicker: referencia del esquema de URI

Este esquema de URI no pasa argumentos a través de la cadena de esquema de URI, sino que pasa argumentos a través de un ValueSet. Todas las cadenas son sensibles a mayúsculas y minúsculas.

Las secciones siguientes indican qué argumentos se deben pasar para realizar la tarea especificada.

Tarea: determinar si el selector de tono está disponible en el 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
}

Tarea: mostrar el selector de tono

Los argumentos que puede pasar para mostrar el selector de tono son los siguientes:

Los valores que se devuelven en LaunchUriResults.Result:

Ejemplo: abra el selector de tono para que el usuario pueda seleccionar un tono

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

Tarea: mostrar el protector de tono

Los argumentos que puede pasar para mostrar el protector de tono son los siguientes:

Los valores que se devuelven en LaunchUriResults.Result:

ejemplo: Guardar un archivo de música local como tono de llamada

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

Tarea: Convertir un token de tono en su nombre descriptivo

Los argumentos que puede pasar para obtener el nombre descriptivo de un tono son los siguientes:

Los valores que se devuelven en LaunchUriResults.Result:

Ejemplo: Recupere un token de tono de Contact.RingToneToken y muestre su nombre descriptivo en la tarjeta de contacto.

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