Nesta parte da s\u00e9rie, configuraremos um sistema de armazenamento de dados do jogo para permitir que voc\u00ea armazene o estado do jogo do jogador ao longo de sua experi\u00eancia com o jogo. Para isso, criaremos alguns pontos de extremidade \/state e \/states que representar\u00e3o blocos individuais de dados de estado. Permitiremos v\u00e1rios blocos de estado nomeados para permitir que o jogo divida os dados de estado em blocos atualiz\u00e1veis separadamente para evitar a necessidade de gravar muitos blocos de estado quando apenas uma parte tiver sido alterada.<\/p>\n
Se voc\u00ea ainda n\u00e3o leu Parte 1<\/a> e Parte 2<\/a> desta s\u00e9rie, sugiro que voc\u00ea o fa\u00e7a, pois esta parte e as futuras se baseiam nelas!<\/p>\n Algo que deveria estar na minha postagem anterior do blog, mas que \u00e9 importante, \u00e9 a renova\u00e7\u00e3o da sess\u00e3o dos usu\u00e1rios sempre que eles a acessam. Sem isso, \u00e9 garantido que a sess\u00e3o expire ap\u00f3s 60 minutos, independentemente de o jogador ainda estar jogando. Obviamente, essa n\u00e3o \u00e9 a nossa inten\u00e7\u00e3o, portanto, vamos corrigir isso!<\/p>\n Primeiro, precisamos adicionar uma nova fun\u00e7\u00e3o ao nosso SessionModel, portanto, abra o arquivo sessionmodel.js e vamos adicionar o seguinte bloco. \u00c9 uma fun\u00e7\u00e3o bastante simples; ela recebe um ID de sess\u00e3o e executa uma opera\u00e7\u00e3o de toque para redefinir o tempo de expira\u00e7\u00e3o para 3600 novamente (a partir do momento da execu\u00e7\u00e3o do toque, n\u00e3o quando a chave foi originalmente inserida).<\/p>\n SessionModel.toque<\/span> =<\/span> fun\u00e7\u00e3o<\/span>(<\/span>lado,<\/span> retorno de chamada)<\/span> {<\/span> db.toque<\/span>(<\/span>sessDocName,<\/span> {<\/span>expira\u00e7\u00e3o:<\/span> 3600<\/span>}<\/span>,<\/span> fun\u00e7\u00e3o<\/span>(<\/span>erro,<\/span> resultado)<\/span> {<\/span> Agora que temos nossa fun\u00e7\u00e3o de modelo para atualizar a sess\u00e3o, vamos encontrar um bom lugar para cham\u00e1-la. Nosso m\u00e9todo authUser parece ser uma boa op\u00e7\u00e3o, pois \u00e9 executado em qualquer endpoint que exija que o usu\u00e1rio seja autenticado. Vamos fazer isso agora. Aqui est\u00e1 nossa nova fun\u00e7\u00e3o authUser com nossa chamada de toque adicionada.<\/p>\n Como parte dessa corre\u00e7\u00e3o de expira\u00e7\u00e3o de sess\u00e3o, talvez seja necess\u00e1rio extrair a vers\u00e3o do couchnode diretamente do GitHub devido a um erro em nossa implementa\u00e7\u00e3o de toque que foi corrigido antes da publica\u00e7\u00e3o deste blog, mas ap\u00f3s o lan\u00e7amento do ciclo mais recente.<\/p>\n Agora que j\u00e1 resolvemos o pequeno problema da parte anterior, vamos implementar o salvamento do estado do jogo! Como eu disse acima, vamos permitir que os jogos armazenem dados em v\u00e1rios blocos de estado para reduzir o tr\u00e1fego de rede. Do ponto de vista do armazenamento, armazenaremos todos esses blocos de estado em um \u00fanico documento do Couchbase, e esse documento ser\u00e1 criado de forma pregui\u00e7osa na primeira solicita\u00e7\u00e3o para salvar informa\u00e7\u00f5es para o usu\u00e1rio. At\u00e9 o momento em que houver algo salvo, emularemos uma lista de estados vazia para o usu\u00e1rio, como voc\u00ea ver\u00e1 em breve.<\/p>\n Para come\u00e7ar, vamos configurar nosso layout de arquivo de modelo padr\u00e3o em model\/statemodel.js. Importamos nossos m\u00f3dulos necess\u00e1rios e configuramos um modelo sem m\u00e9todos chamado StateModel.<\/p>\n var<\/span> db =<\/span> exigir(<\/span>'.\/..\/database'<\/span>)<\/span>.mainBucket<\/span>;<\/span> fun\u00e7\u00e3o<\/span> Modelo de Estado(<\/span>)<\/span> {<\/span> m\u00f3dulo.exporta\u00e7\u00f5es<\/span> =<\/span> Modelo de Estado;<\/span><\/p>\n<\/div>\n<\/div>\n Agora que temos os fundamentos do nosso modelo, vamos come\u00e7ar a implementar alguns dos m\u00e9todos que ser\u00e3o necess\u00e1rios. Vamos come\u00e7ar com um modelo que nos permita salvar um novo bloco de estado. Essa fun\u00e7\u00e3o tratar\u00e1 tanto da cria\u00e7\u00e3o quanto da atualiza\u00e7\u00e3o de um bloco de estado. Isso torna a l\u00f3gica do lado do cliente muito mais simples, pois n\u00e3o precisamos nos preocupar se o bloco de estado j\u00e1 existe em um n\u00edvel de API. Usaremos uma forma de bloqueio otimista em que um n\u00famero de vers\u00e3o ser\u00e1 armazenado com cada bloco de estado. Sempre que um bloco de estado for atualizado, voc\u00ea precisar\u00e1 passar o n\u00famero da vers\u00e3o existente no servidor antes que o servidor aceite os novos dados. Isso serve para evitar que v\u00e1rias c\u00f3pias do jogo em execu\u00e7\u00e3o simult\u00e2nea atropelem os dados umas das outras. Esse tamb\u00e9m \u00e9 o primeiro lugar em que usaremos a fun\u00e7\u00e3o bloqueio otimista<\/a> para garantir que n\u00e3o estejamos fazendo altera\u00e7\u00f5es simult\u00e2neas em nosso objeto de estados a partir de duas chamadas de endpoint.<\/p>\n Vamos come\u00e7ar com nosso prot\u00f3tipo de fun\u00e7\u00e3o de salvamento.<\/p>\n Nossa primeira etapa real \u00e9 criar um nome para o nosso documento de armazenamento de estado e, em seguida, solicitar esse documento ao Couchbase para verificar se ele j\u00e1 existe.<\/p>\n Agora, verificamos se houve algum erro ao solicitar um documento de estado existente. Se encontrarmos um erro, verificaremos se n\u00e3o foi um erro \"n\u00e3o encontrado\". Se o documento n\u00e3o foi encontrado, ignoramos esse erro e continuamos, pois isso se deve \u00e0 natureza de cria\u00e7\u00e3o pregui\u00e7osa do nosso documento de estados.<\/p>\n Em seguida, movemos nosso documento de estado existente (ou um novo documento, caso n\u00e3o tenha sido encontrado) para uma vari\u00e1vel separada para facilitar o acesso e para que possamos lidar com os documentos existentes e com o novo documento da mesma maneira.<\/p>\n Agora, faremos a mesma coisa com nosso bloco de estado. Voc\u00ea notar\u00e1 que garantimos que nossa vari\u00e1vel stateBlock fa\u00e7a refer\u00eancia \u00e0 matriz de estados dos documentos de estado reais. Outro ponto que vale a pena mencionar \u00e9 que nossa vers\u00e3o padr\u00e3o do bloco de estado \u00e9 0. Isso significa que, ao executar um salvamento pela primeira vez, espera-se que o cliente especifique a vers\u00e3o 0 para esclarecer que est\u00e1 ciente de que esse ser\u00e1 um novo bloco de estado.<\/p>\nAjuda r\u00e1pida - Renova\u00e7\u00e3o da sess\u00e3o<\/h1>\n
\nvar<\/span> sessDocName =<\/span> 'sess-'<\/span> +<\/span> lado;<\/span><\/p>\n
\nretorno de chamada(<\/span>erro)<\/span>;<\/span>
\n}<\/span>)<\/span>;<\/span>
\n}<\/span>;<\/span><\/p>\n<\/div>\n<\/div>\n
\nreq.uid<\/span> =<\/span> nulo<\/span>;<\/span>
\nse<\/span> (<\/span>req.cabe\u00e7alhos<\/span>.autoriza\u00e7\u00e3o<\/span>)<\/span> {<\/span>
\nvar<\/span> authInfo =<\/span> req.cabe\u00e7alhos<\/span>.autoriza\u00e7\u00e3o<\/span>.dividir<\/span>(<\/span>‘ ‘<\/span>)<\/span>;<\/span>
\nse<\/span> (<\/span>authInfo[<\/span>0<\/span>]<\/span> ===<\/span> \"Portador<\/span>)<\/span> {<\/span>
\nvar<\/span> lado =<\/span> authInfo[<\/span>1<\/span>]<\/span>;<\/span>
\nsessionModel.obter<\/span>(<\/span>lado,<\/span> fun\u00e7\u00e3o<\/span>(<\/span>erro,<\/span> uid)<\/span> {<\/span>
\nse<\/span> (<\/span>erro)<\/span> {<\/span>
\npr\u00f3xima(<\/span>'Seu ID de sess\u00e3o \u00e9 inv\u00e1lido'<\/span>)<\/span>;<\/span>
\n}<\/span> mais<\/span> {<\/span>
\nsessionModel.toque<\/span>(<\/span>lado,<\/span> fun\u00e7\u00e3o<\/span>(<\/span>)<\/span>{<\/span>}<\/span>)<\/span>;<\/span>
\nreq.uid<\/span> =<\/span> uid;<\/span>
\npr\u00f3xima(<\/span>)<\/span>;<\/span>
\n}<\/span>
\n}<\/span>)<\/span>;<\/span>
\n}<\/span> mais<\/span> {<\/span>
\npr\u00f3xima(<\/span>'Deve ser autorizado a acessar esse endpoint'<\/span>)<\/span>;<\/span>
\n}<\/span>
\n}<\/span> mais<\/span> {<\/span>
\npr\u00f3xima(<\/span>'Deve ser autorizado a acessar esse endpoint'<\/span>)<\/span>;<\/span>
\n}<\/span>
\n}<\/span><\/div>\n<\/div>\nEstados do jogo - O modelo<\/h1>\n
\nvar<\/span> couchbase =<\/span> exigir(<\/span>'couchbase'<\/span>)<\/span>;<\/span><\/p>\n
\n}<\/span><\/p>\n
\n}<\/span>;<\/span><\/div>\n<\/div>\n
\ndb.obter<\/span>(<\/span>stateDocName,<\/span> fun\u00e7\u00e3o<\/span>(<\/span>erro,<\/span> resultado)<\/span> {<\/span>
\n\/\/ O c\u00f3digo abaixo vai para c\u00e1!<\/span>
\n}<\/span>)<\/span>;<\/span><\/div>\n<\/div>\n
\nse<\/span> (<\/span>err.c\u00f3digo<\/span> !==<\/span> couchbase.erros<\/span>.keyNotFound<\/span>)<\/span> {<\/span>
\nretorno<\/span> retorno de chamada(<\/span>erro)<\/span>;<\/span>
\n}<\/span>
\n}<\/span><\/div>\n<\/div>\n
\ntipo:<\/span> \"estado<\/span>,<\/span>
\nuid:<\/span> uid,<\/span>
\nestados:<\/span> {<\/span>}<\/span>
\n}<\/span>;<\/span>
\nse<\/span> (<\/span>resultado.valor<\/span>)<\/span> {<\/span>
\ndocumento de estado =<\/span> resultado.valor<\/span>;<\/span>
\n}<\/span><\/div>\n<\/div>\n
\nvers\u00e3o:<\/span> 0<\/span>,<\/span>
\ndados:<\/span>