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