如何支持游戏切后台运行后继续下载的能力

你一身傲骨怎能输

于 2024-10-30 04:56:30 发布

阅读量885

点赞数 17

分类专栏： Unity游戏性能优化文章标签：游戏

本文链接：https://blog.csdn.net/qq_33060405/article/details/143353967

版权

Unity游戏性能优化专栏收录该内容

101 篇文章 5 订阅

订阅专栏

要支持游戏切后台后继续下载的能力，需要考虑以下几个方面：

1. 使用后台服务

在移动平台（如Android和iOS）上，可以使用后台服务来处理下载任务。

Android: 使用Service或WorkManager来在后台执行下载任务。
iOS: 使用NSURLSession的后台配置来支持后台下载。

2. 持久化下载状态

在切换到后台时，可能会中断下载。因此，需要持久化下载状态，以便在恢复时继续下载。

存储下载进度: 将已下载的字节数和总字节数存储在本地存储中（如数据库或文件）。
恢复下载: 在应用恢复时，读取存储的状态并继续下载。

3. 处理系统限制

移动操作系统可能会限制后台任务的执行时间和资源使用。

Android: 使用Foreground Service来提高后台任务的优先级。
iOS: 使用Background Fetch或Push Notifications来唤醒应用。

4. 网络变化处理

处理网络连接的变化，如从Wi-Fi切换到移动数据或网络中断。

监听网络状态: 使用系统API监听网络状态变化，并根据需要暂停或恢复下载。

示例代码

以下是一个简单的Android示例，展示如何使用WorkManager进行后台下载：

public class DownloadWorker extends Worker {

    public DownloadWorker(@NonNull Context context, @NonNull WorkerParameters params) {
        super(context, params);
    }

    @NonNull
    @Override
    public Result doWork() {
        String url = getInputData().getString("url");
        String filePath = getInputData().getString("filePath");

        try {
            downloadFile(url, filePath);
            return Result.success();
        } catch (Exception e) {
            return Result.retry();
        }
    }

    private void downloadFile(String url, String filePath) throws IOException {
        // 下载文件的实现
    }
}

// 启动下载任务
WorkManager workManager = WorkManager.getInstance(context);
Data inputData = new Data.Builder()
        .putString("url", "https://example.com/file.zip")
        .putString("filePath", "file.zip")
        .build();

OneTimeWorkRequest downloadRequest = new OneTimeWorkRequest.Builder(DownloadWorker.class)
        .setInputData(inputData)
        .build();

workManager.enqueue(downloadRequest);

5. 用户通知

在后台下载时，向用户显示通知，以便用户知道下载正在进行。

Android: 使用NotificationManager来显示下载进度通知。
iOS: 使用UILocalNotification来通知用户。

6. 处理后台任务中断

确保在后台任务被系统中断时能够正确处理，例如保存当前进度并在下次启动时恢复。

总结

通过使用后台服务、持久化下载状态、处理系统限制和网络变化，可以实现游戏切后台后继续下载的能力。具体实现会因平台而异，需要根据目标平台的特性进行调整。

好的，继续深入探讨如何在不同平台上实现游戏切后台后继续下载的能力。

Android 平台

1. 使用 `Foreground Service`

在 Android 上，Foreground Service 是一种可以在后台长时间运行的服务，并且会在通知栏显示一个持续的通知。这样可以确保下载任务在后台不会被系统杀死。

public class DownloadService extends Service {

    private static final int NOTIFICATION_ID = 1;

    @Override
    public int onStartCommand(Intent intent, int flags, int startId) {
        String url = intent.getStringExtra("url");
        String filePath = intent.getStringExtra("filePath");

        // 创建前台通知
        Notification notification = new NotificationCompat.Builder(this, "download_channel")
                .setContentTitle("Downloading")
                .setContentText("Download in progress")
                .setSmallIcon(R.drawable.ic_download)
                .build();

        startForeground(NOTIFICATION_ID, notification);

        // 启动下载任务
        new Thread(() -> {
            try {
                downloadFile(url, filePath);
                stopForeground(true);
                stopSelf();
            } catch (Exception e) {
                e.printStackTrace();
            }
        }).start();

        return START_NOT_STICKY;
    }

    private void downloadFile(String url, String filePath) throws IOException {
        // 下载文件的实现
    }

    @Override
    public IBinder onBind(Intent intent) {
        return null;
    }
}

启动服务：

Intent serviceIntent = new Intent(context, DownloadService.class);
serviceIntent.putExtra("url", "https://example.com/file.zip");
serviceIntent.putExtra("filePath", "file.zip");
context.startForegroundService(serviceIntent);

2. 使用 `WorkManager`

WorkManager 是一个适用于定期和一次性任务的 API，能够在应用切换到后台时继续执行任务。

public class DownloadWorker extends Worker {

    public DownloadWorker(@NonNull Context context, @NonNull WorkerParameters params) {
        super(context, params);
    }

    @NonNull
    @Override
    public Result doWork() {
        String url = getInputData().getString("url");
        String filePath = getInputData().getString("filePath");

        try {
            downloadFile(url, filePath);
            return Result.success();
        } catch (Exception e) {
            return Result.retry();
        }
    }

    private void downloadFile(String url, String filePath) throws IOException {
        // 下载文件的实现
    }
}

// 启动下载任务
WorkManager workManager = WorkManager.getInstance(context);
Data inputData = new Data.Builder()
        .putString("url", "https://example.com/file.zip")
        .putString("filePath", "file.zip")
        .build();

OneTimeWorkRequest downloadRequest = new OneTimeWorkRequest.Builder(DownloadWorker.class)
        .setInputData(inputData)
        .build();

workManager.enqueue(downloadRequest);

iOS 平台

1. 使用 `NSURLSession` 的后台配置

在 iOS 上，可以使用 NSURLSession 的后台配置来支持后台下载。后台会话允许下载任务在应用切换到后台时继续运行。

import Foundation

class DownloadManager: NSObject, URLSessionDownloadDelegate {
    static let shared = DownloadManager()
    private var session: URLSession!

    private override init() {
        super.init()
        let config = URLSessionConfiguration.background(withIdentifier: "com.example.download")
        session = URLSession(configuration: config, delegate: self, delegateQueue: nil)
    }

    func startDownload(url: URL) {
        let task = session.downloadTask(with: url)
        task.resume()
    }

    // URLSessionDownloadDelegate methods
    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
        // 将下载的文件移动到目标位置
    }

    func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didWriteData bytesWritten: Int64, totalBytesWritten: Int64, totalBytesExpectedToWrite: Int64) {
        let progress = Double(totalBytesWritten) / Double(totalBytesExpectedToWrite)
        print("Download progress: \(progress)")
    }
}

启动下载：

let url = URL(string: "https://example.com/file.zip")!
DownloadManager.shared.startDownload(url: url)

2. 使用 `Background Fetch` 和 `Push Notifications`

在某些情况下，可以使用 Background Fetch 或 Push Notifications 来唤醒应用并继续下载任务。

Background Fetch: 允许应用在后台定期执行任务。需要在应用的 Info.plist 文件中启用 fetch 能力，并实现 UIApplicationDelegate 的 application(_:performFetchWithCompletionHandler:) 方法。

import UIKit

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        application.setMinimumBackgroundFetchInterval(UIApplication.backgroundFetchIntervalMinimum)
        return true
    }

    func application(_ application: UIApplication, performFetchWithCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
        // 执行下载任务
        let url = URL(string: "https://example.com/file.zip")!
        DownloadManager.shared.startDownload(url: url)
        completionHandler(.newData)
    }
}

Push Notifications: 可以使用推送通知来唤醒应用并执行下载任务。需要在推送通知的 payload 中包含特定的 content-available 字段。

import UserNotifications

@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate, UNUserNotificationCenterDelegate {

    var window: UIWindow?

    func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        UNUserNotificationCenter.current().delegate = self
        return true
    }

    func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
        // 处理推送通知
        let url = URL(string: "https://example.com/file.zip")!
        DownloadManager.shared.startDownload(url: url)
        completionHandler()
    }
}

3. 持久化下载状态

无论是 Android 还是 iOS，都需要在应用切换到后台时持久化下载状态，以便在恢复时继续下载。可以使用本地存储（如 SQLite、SharedPreferences、UserDefaults）来存储下载进度。

Android 示例

// 保存下载进度
SharedPreferences prefs = context.getSharedPreferences("download_prefs", Context.MODE_PRIVATE);
SharedPreferences.Editor editor = prefs.edit();
editor.putLong("downloaded_bytes", downloadedBytes);
editor.putLong("total_bytes", totalBytes);
editor.apply();

// 恢复下载进度
long downloadedBytes = prefs.getLong("downloaded_bytes", 0);
long totalBytes = prefs.getLong("total_bytes", -1);

iOS 示例

// 保存下载进度
UserDefaults.standard.set(downloadedBytes, forKey: "downloaded_bytes")
UserDefaults.standard.set(totalBytes, forKey: "total_bytes")

// 恢复下载进度
let downloadedBytes = UserDefaults.standard.integer(forKey: "downloaded_bytes")
let totalBytes = UserDefaults.standard.integer(forKey: "total_bytes")

4. 处理网络变化

需要监听网络状态变化，并根据网络状态暂停或恢复下载任务。

Android 示例

public class NetworkChangeReceiver extends BroadcastReceiver {
    @Override
    public void onReceive(Context context, Intent intent) {
        ConnectivityManager cm = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
        NetworkInfo activeNetwork = cm.getActiveNetworkInfo();
        boolean isConnected = activeNetwork != null && activeNetwork.isConnectedOrConnecting();

        if (isConnected) {
            // 恢复下载
        } else {
            // 暂停下载
        }
    }
}

// 注册广播接收器
IntentFilter filter = new IntentFilter(ConnectivityManager.CONNECTIVITY_ACTION);
context.registerReceiver(new NetworkChangeReceiver(), filter);

iOS 示例

import Network

class NetworkMonitor {
    static let shared = NetworkMonitor()
    private let monitor = NWPathMonitor()
    private let queue = DispatchQueue.global()

    private init() {
        monitor.pathUpdateHandler = { path in
            if path.status == .satisfied {
                // 恢复下载
            } else {
                // 暂停下载
            }
        }
        monitor.start(queue: queue)
    }
}

好的，继续深入探讨如何在后台下载时向用户显示通知。

5. 用户通知

Android 示例

在 Android 上，可以使用 NotificationManager 来显示下载进度通知。

import android.app.NotificationChannel;
import android.app.NotificationManager;
import android.content.Context;
import android.os.Build;
import androidx.core.app.NotificationCompat;

public class DownloadNotification {

    private static final String CHANNEL_ID = "download_channel";
    private NotificationManager notificationManager;
    private Context context;

    public DownloadNotification(Context context) {
        this.context = context;
        notificationManager = (NotificationManager) context.getSystemService(Context.NOTIFICATION_SERVICE);
        createNotificationChannel();
    }

    private void createNotificationChannel() {
        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
            CharSequence name = "Download Channel";
            String description = "Channel for download notifications";
            int importance = NotificationManager.IMPORTANCE_LOW;
            NotificationChannel channel = new NotificationChannel(CHANNEL_ID, name, importance);
            channel.setDescription(description);
            notificationManager.createNotificationChannel(channel);
        }
    }

    public void showProgressNotification(int progress) {
        NotificationCompat.Builder builder = new NotificationCompat.Builder(context, CHANNEL_ID)
                .setSmallIcon(R.drawable.ic_download)
                .setContentTitle("Downloading")
                .setContentText("Download in progress")
                .setPriority(NotificationCompat.PRIORITY_LOW)
                .setProgress(100, progress, false);

        notificationManager.notify(1, builder.build());
    }

    public void showCompletionNotification() {
        NotificationCompat.Builder builder = new NotificationCompat.Builder(context, CHANNEL_ID)
                .setSmallIcon(R.drawable.ic_download)
                .setContentTitle("Download Complete")
                .setContentText("The download has been completed.")
                .setPriority(NotificationCompat.PRIORITY_LOW);

        notificationManager.notify(1, builder.build());
    }
}

在下载过程中更新通知：

DownloadNotification downloadNotification = new DownloadNotification(context);

// 在下载过程中更新进度
int progress = (int) ((totalBytesWritten * 100) / totalBytesExpectedToWrite);
downloadNotification.showProgressNotification(progress);

// 下载完成后显示完成通知
downloadNotification.showCompletionNotification();

iOS 示例

在 NSURLSession 的 URLSessionDownloadDelegate 中处理任务中断：

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didCompleteWithError error: Error?) {
    if let error = error as NSError?, error.domain == NSURLErrorDomain && error.code == NSURLErrorCancelled {
        // 下载任务被取消，保存当前下载进度
        let resumeData = error.userInfo[NSURLSessionDownloadTaskResumeData] as? Data
        UserDefaults.standard.set(resumeData, forKey: "resumeData")
    } else if error == nil {
        // 下载完成，清除保存的进度数据
        UserDefaults.standard.removeObject(forKey: "resumeData")
    }
}

在应用重新启动时恢复下载任务：

func resumeDownload() {
    if let resumeData = UserDefaults.standard.data(forKey: "resumeData") {
        let task = session.downloadTask(withResumeData: resumeData)
        task.resume()
    } else {
        let url = URL(string: "https://example.com/file.zip")!
        let task = session.downloadTask(with: url)
        task.resume()
    }
}

7. 处理下载完成后的文件操作

在下载完成后，需要将下载的文件从临时位置移动到目标位置，并进行必要的文件操作。

Android 示例

在 Service 或 WorkManager 中处理下载完成后的文件操作：

@Override
public void onDestroy() {
    super.onDestroy();
    // 下载完成后移动文件
    File tempFile = new File(getCacheDir(), "temp_file.zip");
    File targetFile = new File(getFilesDir(), "file.zip");
    if (tempFile.renameTo(targetFile)) {
        // 文件移动成功
    } else {
        // 文件移动失败
    }
}

iOS 示例

在 NSURLSession 的 URLSessionDownloadDelegate 中处理下载完成后的文件操作：

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
    let fileManager = FileManager.default
    let documentsURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
    let destinationURL = documentsURL.appendingPathComponent("file.zip")

    do {
        try fileManager.moveItem(at: location, to: destinationURL)
        // 文件移动成功
    } catch {
        // 文件移动失败
        print("File move error: \(error)")
    }
}

8. 处理下载错误和重试机制

在下载过程中可能会遇到网络错误或其他问题，需要实现错误处理和重试机制。

Android 示例

在 Service 或 WorkManager 中处理下载错误和重试：

private void downloadFile(String url, String filePath) throws IOException {
    int retryCount = 0;
    boolean success = false;

    while (retryCount < MAX_RETRY_COUNT && !success) {
        try {
            // 执行下载任务
            success = true;
        } catch (IOException e) {
            retryCount++;
            if (retryCount >= MAX_RETRY_COUNT) {
                throw e;
            }
        }
    }
}

iOS 示例

在 NSURLSession 的 URLSessionDownloadDelegate 中处理下载错误和重试：

func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
    if let error = error {
        // 处理下载错误
        print("Download error: \(error)")
        // 实现重试机制
        if retryCount < MAX_RETRY_COUNT {
            retryCount += 1
            resumeDownload()
        } else {
            // 达到最大重试次数，处理失败
        }
    } else {
        // 下载成功
        retryCount = 0
    }
}

9. 用户界面更新

在下载过程中，需要更新用户界面以显示下载进度和状态。

Android 示例

在 Activity 或 Fragment 中更新用户界面：

public class DownloadActivity extends AppCompatActivity {

    private ProgressBar progressBar;
    private TextView progressText;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_download);

        progressBar = findViewById(R.id.progressBar);
       好的，继续探讨如何在后台任务中断时处理下载进度的保存和恢复。

### 6. 处理后台任务中断（续）

#### iOS 示例（续）

在 `NSURLSession` 的 `URLSessionDownloadDelegate` 中处理任务中断：

```swift
func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didCompleteWithError error: Error?) {
    if let error = error as NSError?, error.domain == NSURLErrorDomain && error.code == NSURLErrorCancelled {
        // 下载任务被取消，保存当前下载进度
        let resumeData = error.userInfo[NSURLSessionDownloadTaskResumeData] as? Data
        UserDefaults.standard.set(resumeData, forKey: "resumeData")
    } else if error == nil {
        // 下载完成，清除保存的进度数据
        UserDefaults.standard.removeObject(forKey: "resumeData")
    }
}

在应用重新启动时恢复下载任务：

func resumeDownload() {
    if let resumeData = UserDefaults.standard.data(forKey: "resumeData") {
        let task = session.downloadTask(withResumeData: resumeData)
        task.resume()
    } else {
        let url = URL(string: "https://example.com/file.zip")!
        let task = session.downloadTask(with: url)
        task.resume()
    }
}

7. 处理下载完成后的文件操作

在下载完成后，需要将下载的文件从临时位置移动到目标位置，并进行必要的文件操作。

Android 示例

在 Service 或 WorkManager 中处理下载完成后的文件操作：

@Override
public void onDestroy() {
    super.onDestroy();
    // 下载完成后移动文件
    File tempFile = new File(getCacheDir(), "temp_file.zip");
    File targetFile = new File(getFilesDir(), "file.zip");
    if (tempFile.renameTo(targetFile)) {
        // 文件移动成功
    } else {
        // 文件移动失败
    }
}

iOS 示例

在 NSURLSession 的 URLSessionDownloadDelegate 中处理下载完成后的文件操作：

func urlSession(_ session: URLSession, downloadTask: URLSessionDownloadTask, didFinishDownloadingTo location: URL) {
    let fileManager = FileManager.default
    let documentsURL = fileManager.urls(for: .documentDirectory, in: .userDomainMask).first!
    let destinationURL = documentsURL.appendingPathComponent("file.zip")

    do {
        try fileManager.moveItem(at: location, to: destinationURL)
        // 文件移动成功
    } catch {
        // 文件移动失败
        print("File move error: \(error)")
    }
}

8. 处理下载错误和重试机制

在下载过程中可能会遇到网络错误或其他问题，需要实现错误处理和重试机制。

Android 示例

在 Service 或 WorkManager 中处理下载错误和重试：

private void downloadFile(String url, String filePath) throws IOException {
    int retryCount = 0;
    boolean success = false;

    while (retryCount < MAX_RETRY_COUNT && !success) {
        try {
            // 执行下载任务
            success = true;
        } catch (IOException e) {
            retryCount++;
            if (retryCount >= MAX_RETRY_COUNT) {
                throw e;
            }
        }
    }
}

iOS 示例

在 NSURLSession 的 URLSessionDownloadDelegate 中处理下载错误和重试：

func urlSession(_ session: URLSession, task: URLSessionTask, didCompleteWithError error: Error?) {
    if let error = error {
        // 处理下载错误
        print("Download error: \(error)")
        // 实现重试机制
        if retryCount < MAX_RETRY_COUNT {
            retryCount += 1
            resumeDownload()
        } else {
            // 达到最大重试次数，处理失败
        }
    } else {
        // 下载成功
        retryCount = 0
    }
}