UWP デバイスアプリでの印刷通知の操作

Important

デバイスメタデータは非推奨となり、Windows の今後のリリースで削除される予定です。この機能の置き換えについては、「 ドライバーパッケージコンテナーメタデータ」を参照してください。

UWP デバイスアプリは、v4 印刷ドライバーから送信される双方向通信 (Bidi) イベントに応答できます。この記事では、印刷通知について説明し、印刷設定と印刷通知のサンプルの C# バージョンでバックグラウンドタスクを使用して印刷通知に応答する方法について説明します。バックグラウンドタスクでは、通知の詳細をローカルアプリデータストアに保存し、トーストを送信し、タイルとバッジを更新する方法を示します。 UWP デバイスアプリ全般の詳細については、「UWP デバイスアプリを使用する」を参照してください。

C# バージョンの印刷設定と印刷通知のサンプルでは、BackgroundTask プロジェクトのアプリ (バックグラウンドタスク) のバックグラウンド部分を示します。バックグラウンドタスクのコードは 、PrintBackgroundTask.cs ファイルにあります。スタート画面から起動できる全画面表示アプリである フォアグラウンドアプリは、 DeviceAppForPrinters プロジェクトにあります。 InkLevel.xaml.cs ファイルは、フォアグラウンドアプリから通知の詳細にアクセスできる 1 つの方法を示しています。印刷通知を操作するために、このサンプルでは PrinterExtensionLibrary プロジェクトのプリンター拡張ライブラリを使用します。プリンター拡張ライブラリは、v4 印刷ドライバーのプリンター拡張インターフェイスにアクセスするための便利な方法を提供します。詳細については、プリンター拡張ライブラリの概要を参照してください。

この記事に示すコード例は、C# バージョンの印刷設定と印刷通知のサンプルに基づいています。このサンプルは、JavaScript と C++ でも使用できます。 C++ は COM に直接アクセスできるため、サンプルの C++ バージョンにはコードライブラリプロジェクトは含まれません。サンプルをダウンロードして、最新バージョンのコードを確認します。

通知を印刷する

印刷通知を使用すると、UWP デバイスアプリは、紙詰まり、開いているプリンタードア、インクレベルの低い、プリンターの用紙切れエラーなど、印刷中に重要なプリンターイベントをユーザーに通知できます。プリンターが通知をトリガーすると、システムイベントブローカーによってアプリのバックグラウンドタスクが実行されます。バックグラウンドタスクは、通知の詳細を保存したり、トーストを送信したり、タイルを更新したり、バッジを更新したり、あるいは何もしないこともできます。通知の詳細を保存することで、アプリはユーザーがプリンターの問題を理解して修正するのに役立つエクスペリエンスを提供できます。

プリンターの製造元は、UWP デバイスアプリで印刷通知を使用するために、v4 印刷ドライバーに Bidi と DriverEvent XML ファイルを実装する必要があります。詳細については、「双方向通信」を参照してください。

DriverEvent が発生し、UWP デバイスアプリのバックグラウンドタスクが開始されると、アプリには続行方法に関するいくつかのオプションがあります。タスクの起動につながるフローの詳細については、「カスタマイズされた UI のドライバーサポート」を参照してください。

バックグラウンドタスクでは、次のことができます。

何もしない
通知の詳細をローカルアプリデータストアに保存する
UWP アプリのタイル通知を更新する
UWP アプリ通知バッジを更新する
UWP アプリのトースト通知を送信する

タイル通知またはトースト通知を使用すると、ユーザーはフォアグラウンドアプリを簡単に起動できます。フォアグラウンドアプリを起動すると、App.xaml.csの OnLaunched メソッドを使用して、タイルまたはトーストによって起動されたかどうかを確認できます。その場合、フォアグラウンドアプリはローカルアプリデータストア内の印刷通知の詳細にアクセスできます。

Prerequisites

開始する前に、以下の操作を行います。

v4 プリンタードライバーを使用してプリンターがインストールされていることを確認します。詳細については、「 v4 印刷ドライバーの開発」を参照してください。
開発用 PC をセットアップします。ツールのダウンロードと開発者アカウントの作成については、「作業の開始」を参照してください。
アプリをストアに関連付けます。詳細については、「 UWP デバイスアプリの作成」を参照してください。
プリンターをアプリに関連付けるプリンターのデバイスメタデータを作成します。詳細については、「デバイスメタデータの作成」を参照してください。
アプリのメインページの UI をビルドします。すべての UWP デバイスアプリはスタート画面から起動でき、全画面表示で表示されます。スタートエクスペリエンスを使用して、デバイスの特定のブランドと機能に一致する方法で製品またはサービスを強調表示します。使用できる UI コントロールの種類に特別な制限はありません。全画面表示エクスペリエンスの設計を開始するには、 Microsoft Store の設計原則を参照してください。
C# または JavaScript を使用してアプリを作成する場合は、 PrinterExtensionLibrary プロジェクトと DeviceAppForPrintersLibrary プロジェクトを UWP デバイスアプリソリューションに追加します。これらの各プロジェクトは、印刷設定と印刷通知のサンプルで確認できます。

C++ は COM に直接アクセスできるため、C++ アプリでは、COM ベースのプリンターデバイスコンテキストを操作するために別のライブラリは必要ありません。

手順 1: バックグラウンドタスクを登録する

Windows でアプリが印刷通知を処理できることを認識するには、印刷通知のバックグラウンドタスク拡張機能を登録する必要があります。この拡張機能は Extension 要素で宣言され、 Category 属性は windows.backgroundTasks に設定され、 EntryPoint 属性は BackgroundTask.PrintBackgroundTask に設定されます。拡張機能には、タスクの種類Taskサポートしていることを示すsystemEvent要素も含まれています。

印刷バックグラウンドタスク拡張機能は、Microsoft Visual Studioのマニフェストデザイナーの [宣言] タブに追加できます。 XML (テキスト) エディターを使用して、アプリパッケージマニフェスト XML を手動で編集することもできます。ソリューションエクスプローラーで Package.appxmanifest ファイルを右クリックして、オプションを編集します。

この例では、アプリパッケージマニフェストファイル Extension に表示される、要素のバックグラウンドタスク拡張機能を示します。

<?xml version="1.0" encoding="utf-8"?>
<Package xmlns="http://schemas.microsoft.com/appx/2010/manifest">
  <Identity Name="Microsoft.SDKSamples.DeviceAppForPrinters.CS" Publisher="CN=Microsoft Corporation, O=Microsoft Corporation, L=Redmond, S=Washington, C=US" Version="1.0.0.0" />
  <Properties>
    <DisplayName>Device App For Printers C# sample</DisplayName>
    <PublisherDisplayName>Microsoft Corporation</PublisherDisplayName>
    <Logo>Assets\storeLogo-sdk.png</Logo>
  </Properties>
  <Prerequisites>
    <OSMinVersion>6.3.0</OSMinVersion>
    <OSMaxVersionTested>6.3.0</OSMaxVersionTested>
  </Prerequisites>
  <Resources>
    <Resource Language="x-generate" />
  </Resources>
  <Applications>
    <Application Id="DeviceAppForPrinters" Executable="$targetnametoken$.exe" EntryPoint="DeviceAppForPrinters.App">
      <VisualElements DisplayName="Device App For Printers C# sample" Logo="Assets\squareTile-sdk.png"
                      SmallLogo="Assets\smallTile-sdk.png" Description="DeviceAppForPrinters C# sample"
                      ForegroundText="light" BackgroundColor="#00b2f0" ToastCapable="true">
        <DefaultTile ShowName="allLogos" ShortName="App4PrinterCS" WideLogo="Assets\tile-sdk.png" />
        <SplashScreen Image="Assets\splash-sdk.png" BackgroundColor="#00b2f0" />
      </VisualElements>
      <Extensions>
        <Extension Category="windows.backgroundTasks" EntryPoint="BackgroundTask.PrintBackgroundTask">
          <BackgroundTasks>
            <Task Type="systemEvent" />
          </BackgroundTasks>
        </Extension>
        <Extension Category="windows.printTaskSettings" Executable="$targetnametoken$.exe" EntryPoint="DeviceAppForPrinters.App" />
      </Extensions>
    </Application>
  </Applications>
</Package>

手順 2: デバイスメタデータを構成する

デバイスメタデータ作成ウィザードを使用してアプリをデバイスに関連付ける場合は、[UWP デバイスアプリ情報の指定] ページの [通知ハンドラー] ボックスを必ず完了してください。これにより、印刷通知中にアプリのバックグラウンドタスクが確実に呼び出されます。

デバイスメタデータを編集する方法の詳細な手順については、「テスト」セクションを参照してください。

手順 3: UI をビルドする

アプリをビルドする前に、デザイナーやマーケティングチームと協力してユーザーエクスペリエンスを設計する必要があります。ユーザーエクスペリエンスは、会社のブランド化の側面を投影し、ユーザーとの接続を構築するのに役立ちます。

設計ガイドライン

タイルとバッジのエクスペリエンスを設計する前に、Microsoft Store アプリのガイドラインを確認することが重要です。このガイドラインは、アプリが他の UWP アプリと一貫性のある直感的なエクスペリエンスを提供するのに役立ちます。

アプリのメインページでは、Windows 8.1 で複数のアプリをさまざまなサイズで 1 つのモニターに表示できることに注意してください。画面サイズ、ウィンドウサイズ、向きの間でアプリを適切にリフローする方法の詳細については、次のガイドラインを参照してください。

ベストプラクティス

通知にアクションワードを含めないでください。 通知メッセージでは、ユーザーに通知をプッシュ、押す、または選択するように指示するテキストを使用しないでください。ユーザーは、トーストをタップすれば詳細情報を確認できることをすでに理解しています。たとえば、"プリンターがインクが少ない" のではなく、"インクが少ない" と書き込むだけです。ボタンを押してトラブルシューティングを行います。
操作をシンプルに保ちます。 通知エクスペリエンスに表示されるすべての内容は、通知に関連している必要があります。たとえば、紙詰まりに関する通知ページには、その問題の解決に関するリンクと情報のみが含まれている必要があります。インクの購入やその他のサポート情報など、関係のないエクスペリエンスへのリンクを含めることはできません。
マルチメディアを使用します。 デバイスの実際の写真、ビデオ、またはイラストを使用して、ユーザーがデバイスの問題をすばやく解決できるようにします。
ユーザーをアプリのコンテキスト内に保持します。 問題に関する情報を提供する場合は、オンラインまたはその他のサポート資料にリンクしないでください。ユーザーをアプリのコンテキストに保持します。

手順 4: バックグラウンドタスクを作成する

アプリが印刷通知のバックグラウンドタスクを登録する場合は、バックグラウンドタスクのアクティブ化のハンドラーを提供する必要があります。印刷設定と印刷通知のサンプルでは、PrintBackgroundTask クラスが印刷通知を処理します。

プリンターの状態がユーザーの介入をすぐに必要するものではない場合は、トーストを表示するのではなく、タイルを更新します。たとえば、インクの状態が低い場合は、タイルの更新で十分です。ただし、プリンターのインクが切れている場合は、アプリで短いポップアップ通知が表示されます。

通知の詳細の保存

バックグラウンドタスクはフォアグラウンドアプリを直接起動できません。ユーザーのみが、タイル、トースト、またはスタートからアプリを起動できます。そのため、フォアグラウンドアプリが印刷通知の詳細に確実にアクセスできるように、バックグラウンドタスクによってローカルストレージに保存されます。ローカルストレージの使用の詳細については、「クイックスタート: ローカルアプリデータ」を参照してください。

印刷通知がトリガーされると、Windows は Run メソッドを呼び出してバックグラウンドタスクを実行します。通知データは、Windows.Devices.Printers.Extensions.PrintNotificationEventDetails 型にキャストする必要があるメソッドパラメーターを使用してバックグラウンドタスクに渡されます。そのオブジェクトの PrinterName プロパティと EventData プロパティには、それぞれプリンター名と Bidi メッセージが含まれます。

この例では、バックグラウンドタスクの Run メソッドを PrintBackgroundTask.cs ファイルに示します。このファイルでは、トースト、タイル、バッジの各メソッドが呼び出される前に、印刷通知の詳細がアプリ設定に保存されます。

public void Run(Windows.ApplicationModel.Background.IBackgroundTaskInstance taskInstance)
{
    // Save notification details to local storage
    PrintNotificationEventDetails details = (PrintNotificationEventDetails)taskInstance.TriggerDetails;
    settings.Values[keyPrinterName] = details.PrinterName;
    settings.Values[keyAsyncUIXML] = details.EventData;

    // Demonstrate possible actions
    ShowToast(details.PrinterName, details.EventData);
    UpdateTile(details.PrinterName, details.EventData);
    UpdateBadge();
}

タイルの更新

印刷通知の詳細が UpdateTile メソッドに送信されると、サンプルのバックグラウンドタスクでタイルに表示する方法が示されます。タイルの詳細については、「タイルとタイルの通知の概要」を参照してください。

この例では、バックグラウンドタスクの UpdateTile メソッドを PrintBackgroundTask.cs ファイルに示します。

void UpdateTile(string printerName, string bidiMessage)
{
    TileUpdater tileUpdater = TileUpdateManager.CreateTileUpdaterForApplication();
    tileUpdater.Clear();

    XmlDocument tileXml = TileUpdateManager.GetTemplateContent(TileTemplateType.TileWide310x150Text09);
    XmlNodeList tileTextAttributes = tileXml.GetElementsByTagName("text");
    tileTextAttributes[0].InnerText = printerName;
    tileTextAttributes[1].InnerText = bidiMessage;

    TileNotification tileNotification = new TileNotification(tileXml);
    tileNotification.Tag = "tag01";
    tileUpdater.Update(tileNotification);
}

バッジの更新

UpdateBadge メソッドは、BadgeNotification クラスを使用してバッジを更新する方法を示しています。タイルの詳細については、「バッジの概要」を参照してください。

この例では、バックグラウンドタスクの UpdateBadge メソッドを PrintBackgroundTask.cs ファイルに示します。

void UpdateBadge()
{
    XmlDocument badgeXml = BadgeUpdateManager.GetTemplateContent(BadgeTemplateType.BadgeGlyph);
    XmlElement badgeElement = (XmlElement)badgeXml.SelectSingleNode("/badge");
    badgeElement.SetAttribute("value", "error");

    var badgeNotification = new BadgeNotification(badgeXml);
    BadgeUpdateManager.CreateBadgeUpdaterForApplication().Update(badgeNotification);
}

乾杯をする

トースト通知は、関連する時間の機密情報を含み、アプリ内の関連コンテンツにすばやくアクセスできる、ユーザーへの一時的なメッセージです。トースト通知は、ユーザーが興味のある内容をフォローするためにアプリに戻るよう促すものとして表示されるべきです。詳細については、「トースト通知の概要」を参照してください。

トースト通知を有効にするには、アプリがトースト対応であることをアプリパッケージマニフェストに登録する必要があります。 VisualElements要素で、ToastCapable属性を true に設定します。

Important

トーストを常に表示することはお勧めしません。特に、操作ができないイベントの場合です。これはユーザーにとって煩わしくなる場合があり、そのアプリからのすべてのトースト通知をオフにしてしまう可能性があります。ユーザーの即時の注意を必要としないイベントの場合は、タイルとバッジのみを更新し、トーストを表示しないことをお勧めします。

この例では、アプリパッケージマニフェストファイル ToastCapable に表示されるVisualElements要素の属性を示します。

<VisualElements DisplayName="Device App For Printers C# sample" Logo="Assets\squareTile-sdk.png"
                SmallLogo="Assets\smallTile-sdk.png" Description="DeviceAppForPrinters C# sample"
                ForegroundText="light" BackgroundColor="#00b2f0" ToastCapable="true">
  <DefaultTile ShowName="allLogos" ShortName="App4PrinterCS" WideLogo="Assets\tile-sdk.png" />
  <SplashScreen Image="Assets\splash-sdk.png" BackgroundColor="#00b2f0" />
</VisualElements>

この例は、PrintBackgroundTask.cs ファイルの ShowToast メソッドの例です。 titleとbodyという名前の 2 つの文字列に基づいてトーストを生成する方法を示します。

void ShowToast(string title, string body)
{
    //
    // Get Toast template
    //
    XmlDocument toastXml = ToastNotificationManager.GetTemplateContent(ToastTemplateType.ToastText02);

    //
    // Pass to app as eventArgs.detail.arguments
    //
    ((XmlElement)toastXml.SelectSingleNode("/toast")).SetAttribute("launch", title);

    //
    // The ToastText02 template has 2 text nodes (a header and a body)
    // Assign title to the first one, and body to the second one
    //
    XmlNodeList textList = toastXml.GetElementsByTagName("text");
    textList[0].AppendChild(toastXml.CreateTextNode(title));
    textList[1].AppendChild(toastXml.CreateTextNode(body));

    //
    // Show the Toast
    //
    ToastNotification toast = new ToastNotification(toastXml);
    ToastNotificationManager.CreateToastNotifier().Show(toast);
}

手順 5: アクティブ化の手続きを行う

印刷通知によってバックグラウンドタスクがトリガーされた後は、トースト通知またはタイルをタップしてアプリを起動できます。アプリがいずれかから起動された場合、プロパティ LaunchActivatedEventArgs.arguments を介してパラメーターがアプリに渡されます。アクティブ化とMicrosoft Storeアプリのライフサイクルの詳細については、「アプリケーションのライフサイクル」を参照してください。

これらのケースでアプリがアクティブ化されたかどうかを判断するには、 OnLaunched イベントを処理し、イベントハンドラーに渡されるイベント引数を調べます。イベント引数が null の場合、アプリは Start からユーザーによってアクティブ化されました。イベント引数が null でない場合、アプリはトーストまたはタイルから起動されました。

この例は、App.xaml.cs ファイルの OnLaunched メソッドの例です。トーストまたはタイルからのアクティブ化を処理する方法を示します。

protected override async void OnLaunched(LaunchActivatedEventArgs args)
{
    Frame rootFrame = Window.Current.Content as Frame;

    // Do not repeat app initialization when the Window already has content,
    // just ensure that the window is active

    if (rootFrame == null)
    {
        // Create a Frame to act as the navigation context and navigate to the first page
        rootFrame = new Frame();
        // Associate the frame with a SuspensionManager key
        SuspensionManager.RegisterFrame(rootFrame, "AppFrame");

        if (args.PreviousExecutionState == ApplicationExecutionState.Terminated)
        {
            // Restore the saved session state only when appropriate
            try
            {
                await SuspensionManager.RestoreAsync();
            }
            catch (SuspensionManagerException)
            {
                //Something went wrong restoring state.
                //Assume there is no state and continue
            }
        }

        // Place the frame in the current Window
        Window.Current.Content = rootFrame;
    }
    if (rootFrame.Content == null || !String.IsNullOrEmpty(args.Arguments))
    {
        // When the navigation stack isn't restored or there are launch arguments
        // indicating an alternate launch (e.g.: via toast or secondary tile),
        // navigate to the appropriate page, configuring the new page by passing required
        // information as a navigation parameter
        if (!rootFrame.Navigate(typeof(MainPage), args.Arguments))
        {
            throw new Exception("Failed to create initial page");
        }
    }
    // Ensure the current window is active
    Window.Current.Activate();
}

手順 6: 通知の詳細にアクセスする

バックグラウンドタスクはフォアグラウンドアプリを直接起動できないため、フォアグラウンドアプリがアクセスできるように、印刷通知の詳細をアプリの設定に保存する必要があります。ローカルストレージの使用の詳細については、「クイックスタート: ローカルアプリデータ」を参照してください。

この例では、印刷設定と印刷通知サンプルのアプリ設定からプリンター名と Bidi メッセージを取得する方法を示します。コードは、InkLevel.xaml.cs ファイルの DisplayBackgroundTaskTriggerDetails メソッドから取得されます。キーインデックス値 ( keyPrinterName、 keyAsyncUIXML) は、バックグラウンドタスクで使用されるのと同じ文字列定数 PrintBackgroundTask.cs。

void DisplayBackgroundTaskTriggerDetails()
{
    String outputText = "\r\n";

    try
    {
        string printerName = settings.Values[keyPrinterName].ToString();
        outputText += ("Printer name from background task triggerDetails: " + printerName);
    }
    catch (Exception)
    {
        outputText += ("No printer name retrieved from background task triggerDetails ");
    }

    outputText += "\r\n";
    try
    {
        string asyncUIXML = settings.Values[keyAsyncUIXML].ToString();
        outputText += ("AsyncUI xml from background task triggerDetails: " + asyncUIXML);
    }
    catch (Exception)
    {
        outputText += ("No asyncUI xml retrieved from background task triggerDetails ");
    }

    ToastOutput.Text += outputText;
}

Testing

UWP デバイスアプリをテストする前に、デバイスメタデータを使用してプリンターにリンクする必要があります。

デバイスアプリ情報をプリンターに追加するには、プリンターのデバイスメタデータパッケージのコピーが必要です。デバイスメタデータがない場合は、「UWP デバイスアプリのデバイスメタデータを作成する」の記事の説明に従って、デバイス メタデータ作成ウィザードを使用して作成できます。

デバイスメタデータ作成ウィザードを使用するには、この記事の手順を完了する前に、Microsoft Visual Studio Professional、Microsoft Visual Studio Ultimate、またはスタンドアロン SDK for Windows 8.1 をインストールする必要があります。 Microsoft Visual Studio Express for Windows をインストールすると、ウィザードを含まないバージョンの SDK がインストールされます。

次の手順では、アプリをビルドし、デバイスメタデータをインストールします。

テスト署名を有効にします。
1. %ProgramFiles(x86)%\Windows Kits\8.1\bin\x86 から、DeviceMetadataWizard.exe をダブルクリックしてデバイスメタデータ作成ウィザードを起動してください。
2. [ツール] メニューの [テスト署名を有効にする] を選択します。
コンピューターを再起動する
ソリューション (.sln) ファイルを開いてソリューションをビルドします。 F7 キーを押すか、サンプルが読み込まれた後、上部のメニューから Build->Build ソリューション に移動します。
プリンターを取り外してアンインストールします。この手順は、次回デバイスが検出されるときに更新されたデバイスメタデータを Windows が読み取るようにする必要があります。
デバイスメタデータを編集して保存します。デバイスアプリをデバイスにリンクするには、デバイスアプリをデバイスに関連付ける必要があります。

デバイスメタデータがまだ作成されていない場合は、「 UWP デバイスアプリのデバイスメタデータを作成する」を参照してください。
1. デバイスメタデータ作成ウィザードがまだ開いていない場合は、DeviceMetadataWizard.exeをダブルクリックして、%ProgramFiles(x86)%\Windows Kits\8.1\bin\x86 から起動します。
2. [ デバイスメタデータの編集] を選択します。このオプションを使用すると、既存のデバイスメタデータパッケージを編集できます。
3. [ 開く ] ダイアログボックスで、UWP デバイスアプリに関連付けられているデバイスメタデータパッケージを見つけます。 ( devicemetadata-ms ファイル拡張子があります)。
4. [ UWP デバイスアプリ情報の指定 ] ページで、[ UWP デバイス アプリ] ボックスに Microsoft Store アプリ情報を入力します。 [ UWP アプリマニフェストファイルのインポート] を選択すると、 パッケージ名、 発行元名、 UWP アプリ ID が自動的に入力されます。
5. アプリがプリンター通知に登録している場合は、[ 通知ハンドラー ] ボックスに入力します。 [イベント ID] に、印刷イベントハンドラーの名前を入力します。 イベントアセットに、そのコードが存在するファイルの名前を入力します。
6. 完了したら、[完了] ページが表示されるまで [次へ] を選択します。
7. [ デバイスメタデータパッケージの確認 ] ページで、すべての設定が正しいことを確認し、[ ローカルコンピューター上のメタデータストアにデバイスメタデータパッケージをコピー する] チェックボックスをオンにします。次に、保存を選択します。
デバイスが接続されたときに Windows が更新されたデバイスメタデータを読み取るようにプリンターを再接続します。

Troubleshooting

問題: 既定のトースト通知が表示されない

期待されるときに既定の印刷通知が表示されない場合...

考えられる原因: テスト署名が有効になっていません。有効にする方法については、この記事の「デバッグ」セクションを参照してください。
考えられる原因: トースト通知はドメインポリシーによって無効になります。ドメインを離れ、もう一度やり直してください。
考えられる原因: プリンターに DriverEvents が実装されていません。 v4 ドライバーが Bidi および DriverEvents をサポートしていることを確認します。詳細については、「カスタマイズされた UI のドライバーサポート」を参照してください。
考えられる原因: 本機のプリンターキューに最近のジョブがありません。画面の右下隅にプリンターアイコンが表示されていることを確認します。そうでない場合は、別の印刷ジョブを送信します。
考えられる原因: バックグラウンドタスク (IBackgroundTask) のエントリポイントは、フォアグラウンドアプリと同じプロジェクト内にあります。このシナリオは許可されていません。バックグラウンドタスクハンドラーのまったく新しいクラスを分離します。
考えられる原因: アプリ内の通知のエントリポイントであるクラスがマニフェストまたはデバイスメタデータで正しく指定されていないため、アプリはバックグラウンドホスト内でクラッシュし、トーストは表示されません。次の問題を確認してください。
- マニフェストデザイナーの [ 宣言 ] タブでエントリポイントが正しく指定されていることを確認します。これは、C# および C++ の Namespace.ClassName の形式である必要があります。 JavaScript の場合は、.js ファイルへの相対ディレクトリパスにする必要があります。
- JavaScript アプリは、完了後に close() を呼び出す必要があります。
- C# クラスは Windows.ApplicationModel.Background.IBackgroundTask を実装する必要があり、パブリック void Run(Windows.ApplicationModel.Background.IBackgroundTaskInstance taskInstance) メソッドを持っている必要があります。
- C++ クラスは Windows::ApplicationModel::Background::IBackgroundTask を実装する必要があり、 virtual void Run(Windows::ApplicationModel::Background::IBackgroundTaskInstance^ taskInstance) メソッドを持っている必要があります。

フィードバック

このページはお役に立ちましたか?

Last updated on 2026-06-23