Início rápido da Content Delivery Network - XBOX Game Development Documentation

A CDN do PlayFab é um recurso herdado com suporte para contas com pelo menos um título que já tenha configurado a CDN anteriormente. Para novos desenvolvedores do PlayFab interessados em uma solução de gerenciamento de conteúdo, recomendamos usar a Azure CDN. Para começar, consulte a documentação da Azure CDN.

A Content Delivery Network (CDN) do PlayFab armazena ativos individuais como arquivos identificados exclusivamente pelo nome do arquivo (também chamado de chave). Isso significa que você adiciona, atualiza, remove e recupera ativos por chave. A CDN do PlayFab permite separar ativos por pastas. O caminho da pasta até o ativo passa a fazer parte da chave do ativo. O exemplo a seguir é uma chave de ativo válida armazenada dentro da pasta chamada Android. Android/Image.png. Quando o usuário busca ativos, as solicitações são roteadas automaticamente para o local de borda mais próximo, de modo que o conteúdo seja entregue com o melhor desempenho possível. No entanto, isso pode introduzir atrasos em ações de gerenciamento de arquivos, como as encontradas nos exemplos a seguir:

Upload de arquivo: seu arquivo fica disponível imediatamente.
Substituição de arquivo: o arquivo antigo aparece para os usuários por até 24 horas, até ser substituído pelo novo arquivo.
Exclusão de arquivo: o arquivo continua existindo por até 24 horas, enquanto o comando de exclusão o remove de todos os locais de borda.

Fazendo upload de ativos

Antes que seus usuários possam buscar um ativo, ele precisa ser carregado na CDN. Isso pode ser feito no Game Manager:

Selecione Content no menu à esquerda.
Escolha a guia File Management.
Em seguida, selecione Upload Files.

Game Manager - Conteúdo - Gerenciamento de arquivos - Upload de arquivos

Você pode:

Selecionar vários Files (1).
Cada arquivo selecionado aparece na lista (2).
Enviar seus arquivos selecionando o botão Upload Files (3).

Game Manager - Escolher e fazer upload de arquivos

Os arquivos carregados aparecem na lista (1).
Lembre-se de que você também pode gerenciar pastas.
- Para criar uma pasta, selecione o botão New Folder (2).
Preencha o Folder name (1).
Selecione o botão Create Folder (2).

Isso cria uma nova pasta na árvore. Em seguida, você pode selecionar essa pasta e fazer upload dos arquivos normalmente. Como alternativa, você pode fazer upload de ativos via código usando o SDK de administração. Esse é um processo de duas etapas:

Primeiro, chame GetContentUploadUrl e obtenha a URL pré-assinada que autoriza o upload.
Em seguida, use a URL para fazer uma solicitação HTTP PUT, fornecer seus dados e (opcionalmente) o tipo de conteúdo.

Considere usar o snippet fornecido abaixo, que mostra como obter uma URL pré-assinada.

public void UploadFileToCDN(string key, byte[] content, string contentType = "binary/octet-stream") {
    GetUploadUrl(key, contentType, presignedUrl => {
        PutFile(presignedUrl, content, contentType);
    });
}

void GetUploadUrl(string key, string contentType, Action<string> onComplete) {
    PlayFabAdminAPI.GetContentUploadUrl(new GetContentUploadUrlRequest() {
        ContentType = contentType,
        Key = key
    }, result => onComplete(result.URL),
    error => Debug.LogError(error.GenerateErrorReport()));
}

void PutFile(string presignedUrl, byte[] content, string contentType = "binary/octet-stream") {
    // Implement your own PUT HTTP request here.
    // - Must use PUT method
    // - Must set content type Header
}

Em seguida, você pode verificar o resultado no Game Manager do PlayFab. Certifique-se de que o arquivo esteja na lista.

Buscando ativos

Baixar o ativo via código é idêntico a fazer upload do ativo. Como mencionado anteriormente, é um processo de duas etapas.

Primeiro, faça uma chamada para GetContentDownloadUrl e obtenha uma URL pré-assinada que autoriza o download.
Em seguida, use a URL pré-assinada para fazer uma solicitação HTTP GET e buscar os dados.

Considere usar o snippet fornecido abaixo, que mostra o básico do processo.

public void DownloadFileFromCDN(string key) {
    GetDownloadUrl(key, presignedUrl =>
    {
        GetFile(presignedUrl);
    });
}

void GetDownloadUrl(string key, Action<string> onComplete) {
    PlayFabClientAPI.GetContentDownloadUrl(new GetContentDownloadUrlRequest() {
        Key = key,
        ThruCDN = true
    }, result => onComplete(result.URL),
    error => Debug.LogError(error.GenerateErrorReport()));
}

void GetFile(string preauthorizedUrl) {
    // Implement your own GET HTTP request here.
}

Como mencionado antes, a CDN pode envolver latência em relação a atualizações de arquivos. Durante o desenvolvimento, às vezes é útil forçar a busca dos arquivos mais recentes. A chamada GetContentDownloadUrl permite definir o parâmetro ThruCDN como False. A URL retornada aponta para arquivos novos, sem cache.

Seu cliente de jogo publicado nunca deve usar essa opção!

​Fazendo upload de ativos

​Buscando ativos

Fazendo upload de ativos

Buscando ativos