123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545 |
- #if UNITY_ANDROID
- #pragma warning disable 0642 // Possible mistaken empty statement
- namespace GooglePlayGames.Android
- {
- using System;
- using System.Collections.Generic;
- using System.Text.RegularExpressions;
- using GooglePlayGames.BasicApi;
- using GooglePlayGames.BasicApi.SavedGame;
- using GooglePlayGames.OurUtils;
- using UnityEngine;
- internal class AndroidSavedGameClient : ISavedGameClient
- {
- // Regex for a valid filename. Valid file names are between 1 and 100 characters (inclusive)
- // and only include URL-safe characters: a-z, A-Z, 0-9, or the symbols "-", ".", "_", or "~".
- // This regex is guarded by \A and \Z which guarantee that the entire string matches this
- // regex. If these were omitted, then illegal strings containing legal subsequences would be
- // allowed (since the regex would match those subsequences).
- private static readonly Regex ValidFilenameRegex = new Regex(@"\A[a-zA-Z0-9-._~]{1,100}\Z");
- private volatile AndroidJavaObject mSnapshotsClient;
- private volatile AndroidClient mAndroidClient;
- public AndroidSavedGameClient(AndroidClient androidClient, AndroidJavaObject account)
- {
- mAndroidClient = androidClient;
- using (var gamesClass = new AndroidJavaClass("com.google.android.gms.games.Games"))
- {
- mSnapshotsClient = gamesClass.CallStatic<AndroidJavaObject>("getSnapshotsClient",
- AndroidHelperFragment.GetActivity(), account);
- }
- }
- public void OpenWithAutomaticConflictResolution(string filename, DataSource source,
- ConflictResolutionStrategy resolutionStrategy,
- Action<SavedGameRequestStatus, ISavedGameMetadata> completedCallback)
- {
- Misc.CheckNotNull(filename);
- Misc.CheckNotNull(completedCallback);
- bool prefetchDataOnConflict = false;
- ConflictCallback conflictCallback = null;
- completedCallback = ToOnGameThread(completedCallback);
- if (conflictCallback == null)
- {
- conflictCallback = (resolver, original, originalData, unmerged, unmergedData) =>
- {
- switch (resolutionStrategy)
- {
- case ConflictResolutionStrategy.UseOriginal:
- resolver.ChooseMetadata(original);
- return;
- case ConflictResolutionStrategy.UseUnmerged:
- resolver.ChooseMetadata(unmerged);
- return;
- case ConflictResolutionStrategy.UseLongestPlaytime:
- if (original.TotalTimePlayed >= unmerged.TotalTimePlayed)
- {
- resolver.ChooseMetadata(original);
- }
- else
- {
- resolver.ChooseMetadata(unmerged);
- }
- return;
- default:
- OurUtils.Logger.e("Unhandled strategy " + resolutionStrategy);
- completedCallback(SavedGameRequestStatus.InternalError, null);
- return;
- }
- };
- }
- conflictCallback = ToOnGameThread(conflictCallback);
- if (!IsValidFilename(filename))
- {
- OurUtils.Logger.e("Received invalid filename: " + filename);
- completedCallback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- InternalOpen(filename, source, resolutionStrategy, prefetchDataOnConflict, conflictCallback,
- completedCallback);
- }
- public void OpenWithManualConflictResolution(string filename, DataSource source, bool prefetchDataOnConflict,
- ConflictCallback conflictCallback, Action<SavedGameRequestStatus, ISavedGameMetadata> completedCallback)
- {
- Misc.CheckNotNull(filename);
- Misc.CheckNotNull(conflictCallback);
- Misc.CheckNotNull(completedCallback);
- conflictCallback = ToOnGameThread(conflictCallback);
- completedCallback = ToOnGameThread(completedCallback);
- if (!IsValidFilename(filename))
- {
- OurUtils.Logger.e("Received invalid filename: " + filename);
- completedCallback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- InternalOpen(filename, source, ConflictResolutionStrategy.UseManual, prefetchDataOnConflict,
- conflictCallback, completedCallback);
- }
- private void InternalOpen(string filename, DataSource source, ConflictResolutionStrategy resolutionStrategy,
- bool prefetchDataOnConflict, ConflictCallback conflictCallback,
- Action<SavedGameRequestStatus, ISavedGameMetadata> completedCallback)
- {
- int conflictPolicy; // SnapshotsClient.java#RetentionPolicy
- switch (resolutionStrategy)
- {
- case ConflictResolutionStrategy.UseLastKnownGood:
- conflictPolicy = 2 /* RESOLUTION_POLICY_LAST_KNOWN_GOOD */;
- break;
- case ConflictResolutionStrategy.UseMostRecentlySaved:
- conflictPolicy = 3 /* RESOLUTION_POLICY_MOST_RECENTLY_MODIFIED */;
- break;
- case ConflictResolutionStrategy.UseLongestPlaytime:
- conflictPolicy = 1 /* RESOLUTION_POLICY_LONGEST_PLAYTIME*/;
- break;
- case ConflictResolutionStrategy.UseManual:
- conflictPolicy = -1 /* RESOLUTION_POLICY_MANUAL */;
- break;
- default:
- conflictPolicy = 3 /* RESOLUTION_POLICY_MOST_RECENTLY_MODIFIED */;
- break;
- }
- using (var task =
- mSnapshotsClient.Call<AndroidJavaObject>("open", filename, /* createIfNotFound= */ true,
- conflictPolicy))
- {
- AndroidTaskUtils.AddOnSuccessListener<AndroidJavaObject>(
- task,
- dataOrConflict =>
- {
- if (dataOrConflict.Call<bool>("isConflict"))
- {
- var conflict = dataOrConflict.Call<AndroidJavaObject>("getConflict");
- AndroidSnapshotMetadata original =
- new AndroidSnapshotMetadata(conflict.Call<AndroidJavaObject>("getSnapshot"));
- AndroidSnapshotMetadata unmerged =
- new AndroidSnapshotMetadata(
- conflict.Call<AndroidJavaObject>("getConflictingSnapshot"));
- // Instantiate the conflict resolver. Note that the retry callback closes over
- // all the parameters we need to retry the open attempt. Once the conflict is
- // resolved by invoking the appropriate resolution method on
- // AndroidConflictResolver, the resolver will invoke this callback, which will
- // result in this method being re-executed. This recursion will continue until
- // all conflicts are resolved or an error occurs.
- AndroidConflictResolver resolver = new AndroidConflictResolver(
- this,
- mSnapshotsClient,
- conflict,
- original,
- unmerged,
- completedCallback,
- () => InternalOpen(filename, source, resolutionStrategy,
- prefetchDataOnConflict,
- conflictCallback, completedCallback));
- var originalBytes = original.JavaContents.Call<byte[]>("readFully");
- var unmergedBytes = unmerged.JavaContents.Call<byte[]>("readFully");
- conflictCallback(resolver, original, originalBytes, unmerged, unmergedBytes);
- }
- else
- {
- using (var snapshot = dataOrConflict.Call<AndroidJavaObject>("getData"))
- {
- AndroidJavaObject metadata = snapshot.Call<AndroidJavaObject>("freeze");
- completedCallback(SavedGameRequestStatus.Success,
- new AndroidSnapshotMetadata(metadata));
- }
- }
- });
- AddOnFailureListenerWithSignOut(
- task,
- exception => {
- OurUtils.Logger.d("InternalOpen has failed: " + exception.Call<string>("toString"));
- var status = mAndroidClient.IsAuthenticated() ?
- SavedGameRequestStatus.InternalError :
- SavedGameRequestStatus.AuthenticationError;
- completedCallback(status, null);
- }
- );
- }
- }
- public void ReadBinaryData(ISavedGameMetadata metadata,
- Action<SavedGameRequestStatus, byte[]> completedCallback)
- {
- Misc.CheckNotNull(metadata);
- Misc.CheckNotNull(completedCallback);
- completedCallback = ToOnGameThread(completedCallback);
- AndroidSnapshotMetadata convertedMetadata = metadata as AndroidSnapshotMetadata;
- if (convertedMetadata == null)
- {
- OurUtils.Logger.e("Encountered metadata that was not generated by this ISavedGameClient");
- completedCallback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- if (!convertedMetadata.IsOpen)
- {
- OurUtils.Logger.e("This method requires an open ISavedGameMetadata.");
- completedCallback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- byte[] data = convertedMetadata.JavaContents.Call<byte[]>("readFully");
- if (data == null)
- {
- completedCallback(SavedGameRequestStatus.BadInputError, null);
- }
- else
- {
- completedCallback(SavedGameRequestStatus.Success, data);
- }
- }
- public void ShowSelectSavedGameUI(string uiTitle, uint maxDisplayedSavedGames, bool showCreateSaveUI,
- bool showDeleteSaveUI, Action<SelectUIStatus, ISavedGameMetadata> callback)
- {
- Misc.CheckNotNull(uiTitle);
- Misc.CheckNotNull(callback);
- callback = ToOnGameThread(callback);
- if (!(maxDisplayedSavedGames > 0))
- {
- OurUtils.Logger.e("maxDisplayedSavedGames must be greater than 0");
- callback(SelectUIStatus.BadInputError, null);
- return;
- }
- AndroidHelperFragment.ShowSelectSnapshotUI(
- showCreateSaveUI, showDeleteSaveUI, (int) maxDisplayedSavedGames, uiTitle, callback);
- }
- public void CommitUpdate(ISavedGameMetadata metadata, SavedGameMetadataUpdate updateForMetadata,
- byte[] updatedBinaryData, Action<SavedGameRequestStatus, ISavedGameMetadata> callback)
- {
- Misc.CheckNotNull(metadata);
- Misc.CheckNotNull(updatedBinaryData);
- Misc.CheckNotNull(callback);
- callback = ToOnGameThread(callback);
- AndroidSnapshotMetadata convertedMetadata = metadata as AndroidSnapshotMetadata;
- if (convertedMetadata == null)
- {
- OurUtils.Logger.e("Encountered metadata that was not generated by this ISavedGameClient");
- callback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- if (!convertedMetadata.IsOpen)
- {
- OurUtils.Logger.e("This method requires an open ISavedGameMetadata.");
- callback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- if (!convertedMetadata.JavaContents.Call<bool>("writeBytes", updatedBinaryData))
- {
- OurUtils.Logger.e("This method requires an open ISavedGameMetadata.");
- callback(SavedGameRequestStatus.BadInputError, null);
- }
- using (var convertedMetadataChange = AsMetadataChange(updateForMetadata))
- using (var task = mSnapshotsClient.Call<AndroidJavaObject>("commitAndClose", convertedMetadata.JavaSnapshot,
- convertedMetadataChange))
- {
- AndroidTaskUtils.AddOnSuccessListener<AndroidJavaObject>(
- task,
- /* disposeResult= */ false,
- snapshotMetadata =>
- {
- Debug.Log("commitAndClose.succeed");
- callback(SavedGameRequestStatus.Success,
- new AndroidSnapshotMetadata(snapshotMetadata, /* contents= */null));
- });
- AddOnFailureListenerWithSignOut(
- task,
- exception =>
- {
- Debug.Log("commitAndClose.failed: " + exception.Call<string>("toString"));
- var status = mAndroidClient.IsAuthenticated() ?
- SavedGameRequestStatus.InternalError :
- SavedGameRequestStatus.AuthenticationError;
- callback(status, null);
- });
- }
- }
- public void FetchAllSavedGames(DataSource source,
- Action<SavedGameRequestStatus, List<ISavedGameMetadata>> callback)
- {
- Misc.CheckNotNull(callback);
- callback = ToOnGameThread(callback);
- using (var task =
- mSnapshotsClient.Call<AndroidJavaObject>("load", /* forecReload= */
- source == DataSource.ReadNetworkOnly))
- {
- AndroidTaskUtils.AddOnSuccessListener<AndroidJavaObject>(
- task,
- annotatedData =>
- {
- using (var buffer = annotatedData.Call<AndroidJavaObject>("get"))
- {
- int count = buffer.Call<int>("getCount");
- List<ISavedGameMetadata> result = new List<ISavedGameMetadata>();
- for (int i = 0; i < count; ++i)
- {
- using (var metadata = buffer.Call<AndroidJavaObject>("get", i))
- {
- result.Add(new AndroidSnapshotMetadata(
- metadata.Call<AndroidJavaObject>("freeze"), /* contents= */null));
- }
- }
- buffer.Call("release");
- callback(SavedGameRequestStatus.Success, result);
- }
- });
- AddOnFailureListenerWithSignOut(
- task,
- exception => {
- OurUtils.Logger.d("FetchAllSavedGames failed: " + exception.Call<string>("toString"));
- var status = mAndroidClient.IsAuthenticated() ?
- SavedGameRequestStatus.InternalError :
- SavedGameRequestStatus.AuthenticationError;
- callback(status, new List<ISavedGameMetadata>());
- }
- );
- }
- }
- public void Delete(ISavedGameMetadata metadata)
- {
- AndroidSnapshotMetadata androidMetadata = metadata as AndroidSnapshotMetadata;
- Misc.CheckNotNull(androidMetadata);
- using (mSnapshotsClient.Call<AndroidJavaObject>("delete", androidMetadata.JavaMetadata)) ;
- }
- private void AddOnFailureListenerWithSignOut(AndroidJavaObject task, Action<AndroidJavaObject> callback)
- {
- AndroidTaskUtils.AddOnFailureListener(
- task,
- exception =>
- {
- if (Misc.IsApiException(exception))
- {
- var statusCode = exception.Call<int>("getStatusCode");
- if (statusCode == /* CommonStatusCodes.SignInRequired */ 4 ||
- statusCode == /* GamesClientStatusCodes.CLIENT_RECONNECT_REQUIRED */ 26502)
- {
- mAndroidClient.SignOut();
- }
- }
- callback(exception);
- });
- }
- private ConflictCallback ToOnGameThread(ConflictCallback conflictCallback)
- {
- return (resolver, original, originalData, unmerged, unmergedData) =>
- {
- OurUtils.Logger.d("Invoking conflict callback");
- PlayGamesHelperObject.RunOnGameThread(() =>
- conflictCallback(resolver, original, originalData, unmerged, unmergedData));
- };
- }
- /// <summary>
- /// A helper class that encapsulates the state around resolving a file conflict. It holds all
- /// the state that is necessary to invoke <see cref="SnapshotManager.Resolve"/> as well as a
- /// callback that will re-attempt to open the file after the resolution concludes.
- /// </summary>
- private class AndroidConflictResolver : IConflictResolver
- {
- private readonly AndroidJavaObject mSnapshotsClient;
- private readonly AndroidJavaObject mConflict;
- private readonly AndroidSnapshotMetadata mOriginal;
- private readonly AndroidSnapshotMetadata mUnmerged;
- private readonly Action<SavedGameRequestStatus, ISavedGameMetadata> mCompleteCallback;
- private readonly Action mRetryFileOpen;
- private readonly AndroidSavedGameClient mAndroidSavedGameClient;
- internal AndroidConflictResolver(AndroidSavedGameClient androidSavedGameClient, AndroidJavaObject snapshotClient, AndroidJavaObject conflict,
- AndroidSnapshotMetadata original, AndroidSnapshotMetadata unmerged,
- Action<SavedGameRequestStatus, ISavedGameMetadata> completeCallback, Action retryOpen)
- {
- this.mAndroidSavedGameClient = androidSavedGameClient;
- this.mSnapshotsClient = Misc.CheckNotNull(snapshotClient);
- this.mConflict = Misc.CheckNotNull(conflict);
- this.mOriginal = Misc.CheckNotNull(original);
- this.mUnmerged = Misc.CheckNotNull(unmerged);
- this.mCompleteCallback = Misc.CheckNotNull(completeCallback);
- this.mRetryFileOpen = Misc.CheckNotNull(retryOpen);
- }
- public void ResolveConflict(ISavedGameMetadata chosenMetadata, SavedGameMetadataUpdate metadataUpdate,
- byte[] updatedData)
- {
- AndroidSnapshotMetadata convertedMetadata = chosenMetadata as AndroidSnapshotMetadata;
- if (convertedMetadata != mOriginal && convertedMetadata != mUnmerged)
- {
- OurUtils.Logger.e("Caller attempted to choose a version of the metadata that was not part " +
- "of the conflict");
- mCompleteCallback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- using (var contentUpdate = mConflict.Call<AndroidJavaObject>("getResolutionSnapshotContents"))
- {
- if (!contentUpdate.Call<bool>("writeBytes", updatedData))
- {
- OurUtils.Logger.e("Can't update snapshot contents during conflict resolution.");
- mCompleteCallback(SavedGameRequestStatus.BadInputError, null);
- }
- using (var convertedMetadataChange = AsMetadataChange(metadataUpdate))
- using (var task = mSnapshotsClient.Call<AndroidJavaObject>(
- "resolveConflict",
- mConflict.Call<string>("getConflictId"),
- convertedMetadata.JavaMetadata.Call<string>("getSnapshotId"),
- convertedMetadataChange,
- contentUpdate))
- {
- AndroidTaskUtils.AddOnSuccessListener<AndroidJavaObject>(
- task,
- dataOrConflict => mRetryFileOpen());
- mAndroidSavedGameClient.AddOnFailureListenerWithSignOut(
- task,
- exception => {
- OurUtils.Logger.d("ResolveConflict failed: " + exception.Call<string>("toString"));
- var status = mAndroidSavedGameClient.mAndroidClient.IsAuthenticated() ?
- SavedGameRequestStatus.InternalError :
- SavedGameRequestStatus.AuthenticationError;
- mCompleteCallback(status, null);
- }
- );
- }
- }
- }
- public void ChooseMetadata(ISavedGameMetadata chosenMetadata)
- {
- AndroidSnapshotMetadata convertedMetadata = chosenMetadata as AndroidSnapshotMetadata;
- if (convertedMetadata != mOriginal && convertedMetadata != mUnmerged)
- {
- OurUtils.Logger.e("Caller attempted to choose a version of the metadata that was not part " +
- "of the conflict");
- mCompleteCallback(SavedGameRequestStatus.BadInputError, null);
- return;
- }
- using (var task = mSnapshotsClient.Call<AndroidJavaObject>(
- "resolveConflict", mConflict.Call<string>("getConflictId"), convertedMetadata.JavaSnapshot))
- {
- AndroidTaskUtils.AddOnSuccessListener<AndroidJavaObject>(
- task,
- dataOrConflict => mRetryFileOpen());
- mAndroidSavedGameClient.AddOnFailureListenerWithSignOut(
- task,
- exception => {
- OurUtils.Logger.d("ChooseMetadata failed: " + exception.Call<string>("toString"));
- var status = mAndroidSavedGameClient.mAndroidClient.IsAuthenticated() ?
- SavedGameRequestStatus.InternalError :
- SavedGameRequestStatus.AuthenticationError;
- mCompleteCallback(status, null);
- }
- );
- }
- }
- }
- internal static bool IsValidFilename(string filename)
- {
- if (filename == null)
- {
- return false;
- }
- return ValidFilenameRegex.IsMatch(filename);
- }
- private static AndroidJavaObject AsMetadataChange(SavedGameMetadataUpdate update)
- {
- using (var builder =
- new AndroidJavaObject("com.google.android.gms.games.snapshot.SnapshotMetadataChange$Builder"))
- {
- if (update.IsCoverImageUpdated)
- {
- using (var bitmapFactory = new AndroidJavaClass("android.graphics.BitmapFactory"))
- using (var bitmap = bitmapFactory.CallStatic<AndroidJavaObject>(
- "decodeByteArray", update.UpdatedPngCoverImage, /* offset= */0,
- update.UpdatedPngCoverImage.Length))
- using (builder.Call<AndroidJavaObject>("setCoverImage", bitmap))
- ;
- }
- if (update.IsDescriptionUpdated)
- {
- using (builder.Call<AndroidJavaObject>("setDescription", update.UpdatedDescription)) ;
- }
- if (update.IsPlayedTimeUpdated)
- {
- using (builder.Call<AndroidJavaObject>("setPlayedTimeMillis",
- Convert.ToInt64(update.UpdatedPlayedTime.Value.TotalMilliseconds))) ;
- }
- return builder.Call<AndroidJavaObject>("build");
- }
- }
- private static Action<T1, T2> ToOnGameThread<T1, T2>(Action<T1, T2> toConvert)
- {
- return (val1, val2) => PlayGamesHelperObject.RunOnGameThread(() => toConvert(val1, val2));
- }
- }
- }
- #endif
|