Choisir et enregistrer des tonalités à l’aide du schéma d’URI ms-tonepicker

Cette rubrique explique comment utiliser le schéma d'URI ms-tonepicker :. Ce schéma d’URI peut être utilisé pour :

• Déterminez si le sélecteur de tonalités est disponible sur l’appareil.
• Affichez le sélecteur de tonalités pour répertorier les sonneries disponibles, les sons système, les tonalités de texte et les sons d’alarme ; et obtenir un jeton de tonalité qui représente le son sélectionné par l’utilisateur.
• Affichez le sauvegardeur de son, qui utilise un jeton de fichier audio en entrée et l'enregistre sur l'appareil. Les tonalités enregistrées sont ensuite disponibles via le sélecteur de tonalités. Les utilisateurs peuvent également donner au ton un nom convivial.
• Convertissez un jeton de ton en son nom convivial.

ms-tonepicker : informations de référence sur le schéma d’URI

Ce schéma d’URI ne transmet pas d’arguments via la chaîne de schéma d’URI, mais transmet plutôt des arguments via un ValueSet. Toutes les chaînes sont sensibles à la casse.

Les sections ci-dessous indiquent quels arguments doivent être passés pour accomplir la tâche spécifiée.

Tâche : déterminer si le sélecteur de tonalités est disponible sur l’appareil

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

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

Tâche : afficher le sélecteur de tonalités

Les arguments que vous pouvez passer pour afficher le sélecteur de tonalités sont les suivants :

Les valeurs retournées dans LaunchUriResults.Result:

Exemple : ouvrez le sélecteur de tonalités pour permettre à l’utilisateur de sélectionner un ton

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

Tâche : afficher le dispositif de sauvegarde de tonalité

Les arguments que vous pouvez passer pour afficher l’économiseur de tonalité sont les suivants :

Les valeurs retournées dans LaunchUriResults.Result:

exemple : enregistrer un fichier de musique local en tant que

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

Tâche : convertir un jeton de ton en son nom convivial

Les arguments que vous pouvez passer pour obtenir le nom convivial d’un ton sont les suivants :

Les valeurs retournées dans LaunchUriResults.Result:

Exemple : récupérez un jeton de tonalité à partir de Contact.RingToneToken et affichez son nom convivial dans la carte de visite.

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