Kies en sla tonen op met behulp van het ms-tonepicker URI-schema

In dit onderwerp wordt beschreven hoe u de ms-tonepicker gebruikt: URI-schema. Dit URI-schema kan worden gebruikt voor het volgende:

• Bepaal of de toonkiezer beschikbaar is op het apparaat.
• De toonkiezer weergeven om beschikbare beltonen, systeemgeluiden, teksttonen en alarmgeluiden weer te geven; en haal een toontoken op dat het geluid aangeeft dat de gebruiker heeft geselecteerd.
• Geef de toonbeveiliging weer, waarbij een geluidsbestandstoken als invoer wordt gebruikt en op het apparaat wordt opgeslagen. Opgeslagen tonen zijn vervolgens beschikbaar via de toonkiezer. Gebruikers kunnen de toon ook een gebruiksvriendelijke naam geven.
• Converteer een toontoken naar de vriendelijke naam.

ms-tonepicker: URI-schemareferentie

Dit URI-schema geeft geen argumenten door via de URI-schematekenreeks, maar geeft in plaats daarvan argumenten door via een ValueSet. Alle tekenreeksen zijn hoofdlettergevoelig.

In de onderstaande secties wordt aangegeven welke argumenten moeten worden doorgegeven om de opgegeven taak uit te voeren.

Taak: Bepalen of de toonkiezer beschikbaar is op het apparaat

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

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

Taak: De toonkiezer weergeven

De argumenten die u kunt doorgeven om de toonkiezer weer te geven, zijn als volgt:

De waarden die worden teruggegeven in LaunchUriResults.Result:

Voorbeeld: Open de toonkiezer zodat de gebruiker een toon kan selecteren

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

Taak: De toonbesparing weergeven

De argumenten die u kunt doorgeven om de toonbesparing weer te geven, zijn als volgt:

De waarden die worden teruggegeven in LaunchUriResults.Result:

Voorbeeld: Een lokaal muziekbestand opslaan als beltoon

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

Taak: Een toontoken converteren naar zijn vriendelijke naam

De argumenten die u kunt doorgeven om de vriendelijke naam van een toon te verkrijgen, zijn als volgt:

De waarden die worden teruggegeven in LaunchUriResults.Result:

Voorbeeld: Een toontoken ophalen uit Contact.RingToneToken en de vriendelijke naam weergeven op de contactkaart.

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