gpg:: SnapshotManager
#include <snapshot_manager.h>
Obtiene y establece varios datos relacionados con las instantáneas.
Resumen
Si la app no habilita las instantáneas en el momento de la autenticación (consulta GameServices::Builder::EnableSnapshots), la mayoría de los métodos de SnapshotManager
fallarán.
Tipos públicos |
|
---|---|
CommitCallback
|
typedefstd::function< void(const CommitResponse &)>
Define un tipo de devolución de llamada que recibe un CommitResponse . |
FetchAllCallback
|
typedefstd::function< void(const FetchAllResponse &)>
Define un tipo de devolución de llamada que recibe un FetchAllResponse . |
MaxSizeCallback
|
typedefstd::function< void(const MaxSizeResponse &)>
Define un tipo de devolución de llamada que recibe un MaxSizeResponse . |
OpenCallback
|
typedefstd::function< void(const OpenResponse &)>
Define un tipo de devolución de llamada que recibe un OpenResponse . |
ReadCallback
|
typedefstd::function< void(const ReadResponse &)>
Define un tipo de devolución de llamada que recibe un ReadResponse . |
SnapshotSelectUICallback
|
typedefstd::function< void(const SnapshotSelectUIResponse &)>
Define una devolución de llamada que puede recibir un SnapshotSelectUIResponse de ShowSelectUIOperation . |
Funciones públicas |
|
---|---|
Commit(const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > data, CommitCallback callback)
|
void
Confirma de manera asíncrona los datos proporcionados a la instantánea y actualiza los metadatos de la instantánea con el objeto de metadatos proporcionado.
|
CommitBlocking(const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents)
|
Confirma de manera síncrona los datos proporcionados a la instantánea y actualiza los metadatos mediante el objeto de metadatos proporcionado.
|
CommitBlocking(Timeout timeout, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents)
|
Confirma de manera síncrona los datos proporcionados a la instantánea y actualiza los metadatos de la instantánea mediante el objeto de metadatos proporcionado.
|
Delete(const SnapshotMetadata & snapshot_metadata)
|
void
Borra la instantánea especificada.
|
FetchAll(FetchAllCallback callback)
|
void
Carga de forma asíncrona todos los datos de la instantánea para el jugador actualmente conectado.
|
FetchAll(DataSource data_source, FetchAllCallback callback)
|
void
Carga de forma asíncrona todos los datos de la instantánea para el jugador actualmente conectado.
|
FetchAllBlocking()
|
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente
FetchAllResponse . |
FetchAllBlocking(DataSource data_source)
|
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente
FetchAllResponse . |
FetchAllBlocking(Timeout timeout)
|
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente
FetchAllResponse . |
FetchAllBlocking(DataSource data_source, Timeout timeout)
|
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente
FetchAllResponse . |
GetMaxSize(MaxSizeCallback callback) const
|
void
Obtiene de manera asíncrona el tamaño máximo de los datos y el tamaño máximo de la imagen de portada por instantánea en bytes.
|
GetMaxSizeBlocking() const
|
De forma síncrona, obtiene el tamaño máximo de datos y el tamaño máximo de la imagen de portada por instantánea en bytes, lo que muestra directamente
MaxSizeResponse . |
GetMaxSizeBlocking(Timeout timeout) const
|
De forma síncrona, obtiene el tamaño máximo de datos y el tamaño máximo de la imagen de portada por instantánea en bytes, lo que muestra directamente
MaxSizeResponse . |
Open(const std::string & file_name, SnapshotConflictPolicy conflict_policy, OpenCallback callback)
|
void
Abre de forma asíncrona una instantánea con el nombre determinado.
|
Open(DataSource data_source, const std::string & file_name, SnapshotConflictPolicy conflict_policy, OpenCallback callback)
|
void
data_source se ignora. En su lugar, usa Open(file_name, conflict_policy, callback) . Abre de forma asíncrona una instantánea con el nombre determinado. |
OpenBlocking(const std::string & file_name, SnapshotConflictPolicy conflict_policy)
|
Abre de forma síncrona una instantánea con el nombre determinado.
|
OpenBlocking(Timeout timeout, const std::string & file_name, SnapshotConflictPolicy conflict_policy)
|
Abre de forma síncrona una instantánea con el nombre determinado.
|
OpenBlocking(DataSource data_source, const std::string & file_name, SnapshotConflictPolicy conflict_policy)
|
Obsoleto.
data_source se ignora. En su lugar, usa OpenBlocking(file_name, conflict_policy) . Abre de forma síncrona una instantánea con el nombre determinado. |
OpenBlocking(DataSource data_source, Timeout timeout, const std::string & file_name, SnapshotConflictPolicy conflict_policy)
|
Obsoleto.
data_source se ignora. En su lugar, usa OpenBlocking(timeout, file_name, conflict_policy) . Abre de forma síncrona una instantánea con el nombre determinado. |
Read(const SnapshotMetadata & snapshot_metadata, ReadCallback callback)
|
void
Lee de manera asíncrona una instantánea del disco y la copia en la memoria.
|
ReadBlocking(const SnapshotMetadata & snapshot_metadata)
|
Lee de manera síncrona una instantánea del disco y la copia en la memoria.
|
ReadBlocking(Timeout timeout, const SnapshotMetadata & snapshot_metadata)
|
Lee de manera síncrona una instantánea del disco y la copia en la memoria.
|
ResolveConflict(const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, OpenCallback callback)
|
void
Resuelve un conflicto de forma asíncrona con los datos de la instantánea proporcionada.
|
ResolveConflict(const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents, OpenCallback callback)
|
void
Resuelve un conflicto de forma asíncrona con los datos proporcionados.
|
ResolveConflictBlocking(const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata)
|
Resuelve un conflicto de forma síncrona con los datos de la instantánea proporcionada.
|
ResolveConflictBlocking(const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents)
|
Resuelve un conflicto de forma síncrona con los datos proporcionados.
|
ResolveConflictBlocking(Timeout timeout, const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata)
|
Resuelve un conflicto de forma síncrona con los datos de la instantánea proporcionada.
|
ResolveConflictBlocking(Timeout timeout, const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents)
|
Resuelve un conflicto de forma síncrona con los datos proporcionados.
|
ShowSelectUIOperation(bool allow_create, bool allow_delete, uint32_t max_snapshots, const std::string & title, SnapshotSelectUICallback callback)
|
void
Muestra la IU de la instantánea de forma asíncrona, lo que permite al reproductor seleccionar una instantánea o solicitar una nueva.
|
ShowSelectUIOperationBlocking(Timeout timeout, bool allow_create, bool allow_delete, uint32_t max_snapshots, const std::string & title)
|
Versión de bloqueo de ShowSelectUIOperation.
|
ShowSelectUIOperationBlocking(bool allow_create, bool allow_delete, uint32_t max_snapshots, const std::string & title)
|
Hay una sobrecarga de ShowSelectUIOperationBlocking, que usa un tiempo de espera predeterminado de 10 años.
|
Structs |
|
---|---|
gpg:: |
Contiene los datos de una instantánea actualizada, junto con el estado de la respuesta. |
gpg:: |
Contiene todos los datos de todas las instantáneas, junto con un estado de respuesta. |
gpg:: |
Contiene el tamaño máximo para los datos de la instantánea y la imagen de portada de la instantánea. |
gpg:: |
Contiene los datos de una instantánea solicitada en particular junto con el estado de la respuesta. |
gpg:: |
Lee el estado de la respuesta y los datos de instantáneas que se muestran en una operación de lectura de instantáneas. |
gpg:: |
|
Tipos públicos
CommitCallback
std::function< void(const CommitResponse &)> CommitCallback
Define un tipo de devolución de llamada que recibe un CommitResponse
.
Este tipo de devolución de llamada se proporciona a las funciones Commit(*)
y ResolveConflict(*)
a continuación.
FetchAllCallback
std::function< void(const FetchAllResponse &)> FetchAllCallback
Define un tipo de devolución de llamada que recibe un FetchAllResponse
.
Este tipo de devolución de llamada se proporciona a las funciones FetchAll(*)
a continuación.
MaxSizeCallback
std::function< void(const MaxSizeResponse &)> MaxSizeCallback
Define un tipo de devolución de llamada que recibe un MaxSizeResponse
.
Este tipo de devolución de llamada se proporciona al GetMaxSize.
OpenCallback
std::function< void(const OpenResponse &)> OpenCallback
Define un tipo de devolución de llamada que recibe un OpenResponse
.
Este tipo de devolución de llamada se proporciona a las funciones Open(*)
a continuación.
ReadCallback
std::function< void(const ReadResponse &)> ReadCallback
Define un tipo de devolución de llamada que recibe un ReadResponse
.
Este tipo de devolución de llamada se proporciona a las funciones Read(*)
a continuación.
SnapshotSelectUICallback
std::function< void(const SnapshotSelectUIResponse &)> SnapshotSelectUICallback
Define una devolución de llamada que puede recibir un SnapshotSelectUIResponse
de ShowSelectUIOperation
.
Funciones públicas
Confirmar
void Commit( const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > data, CommitCallback callback )
Confirma de manera asíncrona los datos proporcionados a la instantánea y actualiza los metadatos de la instantánea con el objeto de metadatos proporcionado.
Llama al objeto CommitCallback
proporcionado cuando finaliza la operación.
CommitBlocking
CommitResponse CommitBlocking( const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents )
Confirma de manera síncrona los datos proporcionados a la instantánea y actualiza los metadatos mediante el objeto de metadatos proporcionado.
CommitBlocking
CommitResponse CommitBlocking( Timeout timeout, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents )
Confirma de manera síncrona los datos proporcionados a la instantánea y actualiza los metadatos de la instantánea mediante el objeto de metadatos proporcionado.
Especifica timeout
en milisegundos.
Borrar
void Delete( const SnapshotMetadata & snapshot_metadata )
Borra la instantánea especificada.
Esta acción borrará los datos de la instantánea de forma local y en el servidor.
FetchAll
void FetchAll( FetchAllCallback callback )
Carga de forma asíncrona todos los datos de la instantánea para el jugador actualmente conectado.
Llama al objeto FetchAllCallback
proporcionado cuando finaliza la operación. Si no se especifica data_source
, esta llamada a función será equivalente a llamar a FetchAll(DataSource data_source, FetchAllCallback callback)
, con data_source
especificado como CACHE_OR_NETWORK.
FetchAll
void FetchAll( DataSource data_source, FetchAllCallback callback )
Carga de forma asíncrona todos los datos de la instantánea para el jugador actualmente conectado.
Llama al objeto FetchAllCallback
proporcionado cuando finaliza la operación. Especifica data_source
como CACHE_OR_NETWORK
o NETWORK_ONLY
.
FetchAllBlocking
FetchAllResponse FetchAllBlocking()
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente FetchAllResponse
.
No especificar data_source
ni timeout
hace que esta llamada a función sea equivalente a llamar a FetchAllResponse FetchAllBlocking(DataSource data_source,
Timeout timeout)
, con data_source
especificado como CACHE_OR_NETWORK
y timeout
especificado como 10 años.
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source )
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente FetchAllResponse
.
Especifica data_source
como CACHE_OR_NETWORK
o NETWORK_ONLY
. Si no especificas timeout
, esta llamada a función será equivalente a llamar a FetchAllBlocking FetchAllResponse(DataSource data_source,
Timeout timeout)
, con el valor data_source
especificado y timeout
especificado como 10 años.
FetchAllBlocking
FetchAllResponse FetchAllBlocking( Timeout timeout )
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente FetchAllResponse
.
Especifica timeout
en milisegundos. Si no especificas data_source
, esta llamada a función será equivalente a llamar a FetchAllResponse FetchAllBlocking(DataSource data_source,
Timeout timeout)
, con data_source
especificado como CACHE_OR_NETWORK
y timeout
que contenga el valor que especificaste.
FetchAllBlocking
FetchAllResponse FetchAllBlocking( DataSource data_source, Timeout timeout )
Carga de manera síncrona todos los datos de instantáneas del jugador que accedió y muestra directamente FetchAllResponse
.
Especifica data_source
como CACHE_OR_NETWORK
o NETWORK_ONLY
. Especifica timeout
en milisegundos.
GetMaxSize
void GetMaxSize( MaxSizeCallback callback ) const
Obtiene de manera asíncrona el tamaño máximo de los datos y el tamaño máximo de la imagen de portada por instantánea en bytes.
Llama al objeto MaxSizeCallback
proporcionado cuando finaliza la operación.
El tamaño máximo de datos por instantánea garantizado es de 3 MB como mínimo. Puede aumentar en el futuro.
El tamaño máximo de datos por imagen de portada de la instantánea debe ser de 800 KB como mínimo. Puede aumentar en el futuro.
GetMaxSizeBlocking
MaxSizeResponse GetMaxSizeBlocking() const
De forma síncrona, obtiene el tamaño máximo de datos y el tamaño máximo de la imagen de portada por instantánea en bytes, lo que muestra directamente MaxSizeResponse
.
El tamaño máximo de datos por instantánea garantizado es de 3 MB como mínimo. Puede aumentar en el futuro.
El tamaño máximo de datos por imagen de portada de la instantánea debe ser de 800 KB como mínimo. Puede aumentar en el futuro.
GetMaxSizeBlocking
MaxSizeResponse GetMaxSizeBlocking( Timeout timeout ) const
De forma síncrona, obtiene el tamaño máximo de datos y el tamaño máximo de la imagen de portada por instantánea en bytes, lo que muestra directamente MaxSizeResponse
.
El tamaño máximo de datos por instantánea garantizado es de 3 MB como mínimo. Puede aumentar en el futuro.
El tamaño máximo de datos por imagen de portada de la instantánea debe ser de 800 KB como mínimo. Puede aumentar en el futuro.
Especifica timeout
en milisegundos.
Abrir
void Open( const std::string & file_name, SnapshotConflictPolicy conflict_policy, OpenCallback callback )
Abre de forma asíncrona una instantánea con el nombre determinado.
Se creará la instantánea especificada si es que no existe. Llama al objeto OpenCallback
proporcionado cuando finaliza la operación.
Los nombres de las instantáneas deben tener entre 1 y 100 caracteres no reservados para URLs (a-z, A-Z, 0-9 o los símbolos "-", ".", "_" o "~").
Pueden producirse conflictos si otro dispositivo confirma una instantánea entre la carga y la confirmación de una instantánea en el dispositivo actual. Debes resolver estos conflictos. Consulta OpenResponse más arriba para obtener más detalles sobre los conflictos.
conflict_policy
puede tener uno de los siguientes valores:
SnapshotConflictPolicy::MANUAL
: En caso de conflicto, la respuesta tiene el estado OpenResponse::VALID_WITH_CONFLICT
. Debes resolver el conflicto usando SnapshotManager::ResolveConflict
. Es posible que veas varios conflictos seguidos, por lo que debes verificarlo cada vez que llames a Open
. Esta es la única política en la que se mostrará el conflicto. La resolución del resto del controlador por ti. Esta política garantiza que no se pierda ningún cambio de usuario en el estado del juego guardado.
SnapshotConflictPolicy::LONGEST_PLAYTIME
: En caso de conflicto, se usará el resumen con el mayor valor de tiempo de reproducción. Esta política es una buena opción si la duración del tiempo de juego es un proxy razonable para el "mejor" juego guardado. Ten en cuenta que, para que esta política sea significativa, debes usar SnapshotMetadataChange::Builder::SetPlayedTime()
cuando guardes juegos.
SnapshotConflictPolicy::LAST_KNOWN_GOOD
: En caso de conflicto, se utilizará la instantánea base. Esta política es una opción razonable si tu juego requiere estabilidad de los datos de la instantánea. Esta política garantiza que el jugador solo vea las escrituras que no se cuestionan, lo que garantiza la convergencia de todos los clientes. Nota: Antes SnapshotManager::BASE_WINS
SnapshotConflictPolicy::MOST_RECENTLY_MODIFIED
: En caso de conflicto, se utilizará el control remoto. Esta política es una opción razonable si tu juego puede tolerar que los jugadores que usen múltiples dispositivos rompan sus propios cambios. Debido a que esta política elige a ciegas los datos más recientes, es posible que se pierdan los cambios de un jugador. Nota: Antes SnapshotManager::REMOTE_WINS
SnapshotConflictPolicy::HIGHEST_PROGRESS
En caso de conflicto, se usará la instantánea con el valor de progreso más alto. En caso de empate, en su lugar se elegirá la última instantánea buena conocida. Esta política es una buena opción si el juego usa el valor de progreso de la instantánea para determinar el mejor juego guardado. Ten en cuenta que, para que esta política sea significativa, debes usar SnapshotMetadataChange::Builder::SetPlayedTime()
cuando guardes juegos.
Abrir
void Open( DataSource data_source, const std::string & file_name, SnapshotConflictPolicy conflict_policy, OpenCallback callback )
Abre de forma asíncrona una instantánea con el nombre determinado.
Obsoleto.
data_source
se ignora. En su lugar, usa Open(file_name, conflict_policy, callback)
.
OpenBlocking
OpenResponse OpenBlocking( const std::string & file_name, SnapshotConflictPolicy conflict_policy )
Abre de forma síncrona una instantánea con el nombre determinado.
Se creará la instantánea especificada si es que no existe.
Consulta Abrir para obtener más detalles.
OpenBlocking
OpenResponse OpenBlocking( Timeout timeout, const std::string & file_name, SnapshotConflictPolicy conflict_policy )
Abre de forma síncrona una instantánea con el nombre determinado.
Se creará la instantánea especificada si es que no existe.
Especifica timeout
en milisegundos.
Consulta Abrir para obtener más detalles.
OpenBlocking
OpenResponse OpenBlocking( DataSource data_source, const std::string & file_name, SnapshotConflictPolicy conflict_policy )
Abre de forma síncrona una instantánea con el nombre determinado.
Obsoleto.
data_source
se ignora. En su lugar, usa OpenBlocking(file_name, conflict_policy)
.
OpenBlocking
OpenResponse OpenBlocking( DataSource data_source, Timeout timeout, const std::string & file_name, SnapshotConflictPolicy conflict_policy )
Abre de forma síncrona una instantánea con el nombre determinado.
Obsoleto.
data_source
se ignora. En su lugar, usa OpenBlocking(timeout, file_name, conflict_policy)
.
Leer
void Read( const SnapshotMetadata & snapshot_metadata, ReadCallback callback )
Lee de manera asíncrona una instantánea del disco y la copia en la memoria.
Los datos se pasan por valor para facilitar la modificación. Cada llamada a esta función da como resultado una lectura completa. Esto significa que, por lo general, es mejor leer una instantánea una sola vez. Llama al objeto ReadCallback
proporcionado cuando finaliza la operación.
ReadBlocking
ReadResponse ReadBlocking( const SnapshotMetadata & snapshot_metadata )
Lee de manera síncrona una instantánea del disco y la copia en la memoria.
Los datos se pasan por valor para facilitar la modificación. Cada llamada a esta función da como resultado una lectura completa. Esto significa que, por lo general, es mejor leer una instantánea una sola vez. Si no especificas timeout
, esta llamada a función será equivalente a llamar a ReadBlocking ReadBlocking(Timeout timeout,
const SnapshotMetadata& snapshot_metadata)
, con timeout
especificado como 10 años.
ReadBlocking
ReadResponse ReadBlocking( Timeout timeout, const SnapshotMetadata & snapshot_metadata )
Lee de manera síncrona una instantánea del disco y la copia en la memoria.
Los datos se pasan por valor para facilitar la modificación. Cada llamada realiza una lectura completa, por lo que, por lo general, solo lee una instantánea una vez. Especifica timeout
en milisegundos.
ResolveConflict
void ResolveConflict( const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, OpenCallback callback )
Resuelve un conflicto de forma asíncrona con los datos de la instantánea proporcionada.
Esto reemplazará los datos en el servidor con la instantánea especificada. Ten en cuenta que esta operación puede generar un conflicto, en cuyo caso la resolución debe repetirse.
Llamar a este método con una instantánea ya confirmada o que no se abrió a través de Open fallará con el estado BaseStatus::ERROR_INTERNAL.
Llama al objeto OpenCallback
proporcionado cuando finaliza la operación.
ResolveConflict
void ResolveConflict( const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents, OpenCallback callback )
Resuelve un conflicto de forma asíncrona con los datos proporcionados.
Esto reemplazará los datos en el servidor con los cambios de metadatos especificados y contents
. Ten en cuenta que esta operación puede generar un conflicto, en cuyo caso la resolución debe repetirse.
Los valores que no se incluyan en el cambio de metadatos se resolverán en la versión que se encuentra actualmente en el servidor.
Ten en cuenta que el tamaño total del elemento contents
no puede superar el valor de maxDataSize
que proporciona GetMaxSize.
Llamar a este método con una instantánea ya confirmada o que no se abrió a través de Open fallará con el estado BaseStatus::ERROR_INTERNAL.
Llama al objeto OpenCallback
proporcionado cuando finaliza la operación.
ResolveConflictBlocking
OpenResponse ResolveConflictBlocking( const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata )
Resuelve un conflicto de forma síncrona con los datos de la instantánea proporcionada.
Esto reemplazará los datos en el servidor con la instantánea especificada. Ten en cuenta que esta operación puede generar un conflicto, en cuyo caso la resolución debe repetirse.
Llamar a este método con una instantánea ya confirmada o que no se abrió a través de Open fallará con el estado BaseStatus::ERROR_INTERNAL.
ResolveConflictBlocking
OpenResponse ResolveConflictBlocking( const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents )
Resuelve un conflicto de forma síncrona con los datos proporcionados.
Esto reemplazará los datos en el servidor con los cambios de metadatos especificados y contents
. Ten en cuenta que esta operación puede generar un conflicto, en cuyo caso la resolución debe repetirse.
Los valores que no se incluyan en el cambio de metadatos se resolverán en la versión que se encuentra actualmente en el servidor.
Ten en cuenta que el tamaño total del elemento contents
no puede superar el valor de maxDataSize
que proporciona GetMaxSize.
Llamar a este método con una instantánea ya confirmada o que no se abrió a través de Open fallará con el estado BaseStatus::ERROR_INTERNAL.
ResolveConflictBlocking
OpenResponse ResolveConflictBlocking( Timeout timeout, const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata )
Resuelve un conflicto de forma síncrona con los datos de la instantánea proporcionada.
Esto reemplazará los datos en el servidor con la instantánea especificada. Ten en cuenta que esta operación puede generar un conflicto, en cuyo caso la resolución debe repetirse.
Llamar a este método con una instantánea ya confirmada o que no se abrió a través de Open fallará con el estado BaseStatus::ERROR_INTERNAL.
Especifica timeout
en milisegundos.
ResolveConflictBlocking
OpenResponse ResolveConflictBlocking( Timeout timeout, const std::string & conflict_id, const SnapshotMetadata & snapshot_metadata, const SnapshotMetadataChange & metadata_change, std::vector< uint8_t > contents )
Resuelve un conflicto de forma síncrona con los datos proporcionados.
Esto reemplazará los datos en el servidor con los cambios de metadatos especificados y contents
. Ten en cuenta que esta operación puede generar un conflicto, en cuyo caso la resolución debe repetirse.
Los valores que no se incluyan en el cambio de metadatos se resolverán en la versión que se encuentra actualmente en el servidor.
Ten en cuenta que el tamaño total del elemento contents
no puede superar el valor de maxDataSize
que proporciona GetMaxSize.
Llamar a este método con una instantánea ya confirmada o que no se abrió a través de Open fallará con el estado BaseStatus::ERROR_INTERNAL.
Especifica timeout
en milisegundos.
ShowSelectUIOperation
void ShowSelectUIOperation( bool allow_create, bool allow_delete, uint32_t max_snapshots, const std::string & title, SnapshotSelectUICallback callback )
Muestra la IU de la instantánea de forma asíncrona, lo que permite al reproductor seleccionar una instantánea o solicitar una nueva.
Cuando finaliza, la instantánea seleccionada o la solicitud de instantánea nueva se muestran a través de SnapshotSelectUICallback
.
ShowSelectUIOperationBlocking
SnapshotSelectUIResponse ShowSelectUIOperationBlocking( Timeout timeout, bool allow_create, bool allow_delete, uint32_t max_snapshots, const std::string & title )
Versión de bloqueo de ShowSelectUIOperation.
Permite que el emisor especifique un tiempo de espera en ms. Una vez transcurrido el tiempo especificado, la función muestra ERROR_TIMEOUT
.
ShowSelectUIOperationBlocking
SnapshotSelectUIResponse ShowSelectUIOperationBlocking( bool allow_create, bool allow_delete, uint32_t max_snapshots, const std::string & title )
Hay una sobrecarga de ShowSelectUIOperationBlocking, que usa un tiempo de espera predeterminado de 10 años.