Windows アプリ SDK デスクトップ アプリで拡張実行を使用する

拡張実行セッションを使用すると、バッテリ駆動デバイスでのリソース削減の候補となる場合でも、特定のシナリオでシステムが実行を維持することをアプリが要求できます。 デスクトップ アプリは自動的に中断されませんが、拡張実行はシステムに意図を通知する場合に引き続き役立ちます。

拡張実行を使用するタイミング

拡張実行セッションは、デスクトップ アプリで次の場合に最も役立ちます。

• 重要なデータの保存 — デバイスがスタンバイ状態になる前に、大きな保存操作が完了していることを確認します。
• 位置情報の追跡 - アプリがラップトップ上で最小化されている間、GPSデータを流し続ける。
• 実行時間の長い計算 - レンダリング、コンパイル、またはデータ分析タスクを完了します。

デスクトップ アプリを実行し続ける必要があるシナリオ (チャット アプリや音楽プレーヤーなど) の場合、延長実行は必要 ありません 。アプリは正常に実行され続けます。

拡張実行セッションを作成する

ExtendedExecutionSession クラスを使用します。

using Windows.ApplicationModel.ExtendedExecution;

private ExtendedExecutionSession? _session;

private async Task StartExtendedSessionAsync()
{
    var session = new ExtendedExecutionSession
    {
        Reason = ExtendedExecutionReason.Unspecified,
        Description = "Completing critical data save"
    };

    session.Revoked += ExtendedSession_Revoked;

    ExtendedExecutionResult result = await session.RequestExtensionAsync();

    if (result == ExtendedExecutionResult.Allowed)
    {
        _session = session;
        // Proceed with the long-running work
    }
    else
    {
        session.Dispose();
        // The system denied the request — handle gracefully
    }
}

private void ExtendedSession_Revoked(object sender,
    ExtendedExecutionRevokedEventArgs args)
{
    // The session was revoked. Save state quickly.
    if (args.Reason == ExtendedExecutionRevokedReason.SystemPolicy)
    {
        // System needs resources — wrap up immediately
    }
}

実行延長の理由

セッションを終了する

作業が完了したら、セッションを破棄して要求を解放します。

private ExtendedExecutionSession? _session;

private void ExtendedSession_Revoked(object sender,
    ExtendedExecutionRevokedEventArgs args)
{
}

private void StopExtendedSession()
{
    if (_session != null)
    {
        _session.Revoked -= ExtendedSession_Revoked;
        _session.Dispose();
        _session = null;
    }
}

UWP との相違点

ベスト プラクティス

• 節電によって中断されない特定の作業がある場合にのみ、延長実行を要求します。
• デスクトップ アプリでも、常に Revoked イベントを処理します。
• 作業が完了したらすぐにセッションを破棄します。
• 延長されたセッションを無期限に保持しないでください。デバイスのバッテリ寿命に影響する可能性があります。

関連するコンテンツ

• Windows アプリ SDKのアプリのライフサイクル
• デスクトップ アプリでのバックグラウンド実行
• ExtendedExecutionSession クラス