Поделиться через


GameSaveProvider.GetSyncOnDemandForUserAsync(User, String) Метод

Определение

Возвращает частично синхронизированный поставщик сохранения игры, который синхронизирует контейнеры по запросу.

public:
 static IAsyncOperation<GameSaveProviderGetResult ^> ^ GetSyncOnDemandForUserAsync(User ^ user, Platform::String ^ serviceConfigId);
/// [Windows.Foundation.Metadata.RemoteAsync]
 static IAsyncOperation<GameSaveProviderGetResult> GetSyncOnDemandForUserAsync(User const& user, winrt::hstring const& serviceConfigId);
[Windows.Foundation.Metadata.RemoteAsync]
public static IAsyncOperation<GameSaveProviderGetResult> GetSyncOnDemandForUserAsync(User user, string serviceConfigId);
function getSyncOnDemandForUserAsync(user, serviceConfigId)
Public Shared Function GetSyncOnDemandForUserAsync (user As User, serviceConfigId As String) As IAsyncOperation(Of GameSaveProviderGetResult)

Параметры

user
User

Тип: Пользователь

Пользователь, для которого сохраняется игра.

serviceConfigId
String

Platform::String

winrt::hstring

Тип: String [JavaScript] | System.String [.NET] | Platform::String [C++]

Идентификатор конфигурации службы (SCID), используемый игрой.

Возвращаемое значение

Тип: IAsyncOperation<; GameSaveProviderGetResult>;

IAsyncOperation<; GameSaveProviderGetResult>; представляет состояние асинхронной операции.

Атрибуты

Комментарии

Поставщик синхронизации по запросу не гарантирует локальную синхронизацию всех контейнеров. Синхронизация требуется при возникновении конфликта, который пользователь должен разрешить, или, чаще всего, когда в контейнере есть новые данные в облаке, которые необходимо скачать. На это условие указывает GameSaveContainerInfo.NeedsSync.

Вызовы для чтения, удаления или запроса больших двоичных объектов из контейнера будут синхронизировать контейнер, если ему требуется синхронизация.

Попытка отправить обновления в контейнер завершится ошибкой (с GameSaveErrorStatus.ContainerNotInSync), пока контейнер по-прежнему должен синхронизироваться.

GetSyncOnDemandForUserAsync получает экземпляр GameSaveProvider для указанного пользователя. После завершения асинхронной операции проверка свойство Status результата, чтобы определить, успешно ли выполнена операция с помощью GameSaveErrorStatus.Ok.

Ваш идентификатор заголовка и идентификатор конфигурации службы (SCID) должны быть правильно настроены, иначе этот метод завершится ошибкой.

Применяется к

См. также раздел