Publique seu primeiro conteúdo gerado pelo usuário

​

Requisitos

• Uma conta de desenvolvedor do PlayFab
• Um título com UGC habilitado

​

Por meio de APIs

​

Criar URLs de blob

• O sistema de UGC funciona com o Modelo de Entidades do PlayFab, portanto, precisamos usar tokens de entidade em vez de tíquetes de sessão para chamar essas APIs. Você pode aprender a obter um token de entidade de título no Início rápido das Coleções do Postman.
• O sistema de UGC usa o Armazenamento de Blobs do Azure para armazenar todo o conteúdo (arquivos e imagens) associado ao UGC do seu título. Para carregar o conteúdo, primeiro precisamos chamar a API CreateUploadUrls, passando os nomes e tamanhos dos arquivos (em bytes) para criar os novos blobs. Por exemplo, se eu quisesse carregar um arquivo de texto e uma imagem PNG, passaria o seguinte no corpo da solicitação:
  {
    "Files": [
      {
        "FileName": "HelloWorld.txt",
        "FileSize": 12
      },
      {
        "FileName": "PlayFabLogo.png",
        "FileSize": 20725
      }
    ]
  }
  
• A resposta inclui um Id e uma Url para cada parte do conteúdo:
  {
      "code": 200,
      "status": "OK",
      "data": {
          "UploadUrls": [
              {
                  "Id": "[Content ID]",
                  "Url": "[Content Url + '?' + Token]",
                  "FileName": "HelloWorld.txt"
              },
              {
                  "Id": "[Image ID]",
                  "Url": "[Image Url + '?' + Token]",
                  "FileName": "PlayFabLogo.png"
              }
          ]
      }
  }
  

​

Carregar conteúdo para os blobs

​

Por meio do Postman

• Crie uma solicitação PUT com a URL gerada pela chamada a CreateUploadUrls e adicione comp: blob e x-ms-blob-type: blockblob como cabeçalhos:
• Em seguida, você pode carregar o arquivo selecionando binary como o tipo de corpo:

​

Por meio do AzCopy

• Outra opção é usar a ferramenta AzCopy. Você pode baixar a ferramenta e começar a usar o AzCopy aqui.
• No terminal de sua preferência, chame o azcopy com os seguintes parâmetros:
  [relative path to azcopy.exe] copy [relative path to local content] [Url + '?' + Token]
  

​

Criar o UGC de rascunho

• Agora que os arquivos e imagens foram carregados com êxito, você pode chamar CreateDraftItem, passando as URLs do conteúdo e das imagens, para criar seu primeiro item no catálogo de rascunho:
  {
    "Item": {
      "Type": "ugc",
      "Title": {
        "NEUTRAL": "Hello World!"
      },
      "Description": {
        "NEUTRAL": "My first UGC item (with content!)"
      },
      "ContentType": "Game Item",
      "IsHidden": false,
      "Contents": [
        {
          "Id": "[Content ID]",
          "Url": "[Content Url]"
        }
      ],
      "Images": [
        {
          "Id": "[Image ID]",
          "Type": "Thumbnail",
          "Url": "[Image Url]"
        }
      ]
    },
    "Publish": false,
    "AllowOverwrite": false
  }
  

• A resposta retorna os metadados que você passou, junto com um ID de item:
  {
  "code": 200,
  "status": "OK",
  "data": {
      "Item": {
          ...
          "Id": "e5427509-1b72-4ee1-9e6c-03fc055a94f3",
          ...
      }
    }
  }
  
• O item de UGC de rascunho agora existe no catálogo de rascunho! Enquanto o item de UGC não for publicado, ele não poderá ser pesquisado por meio do catálogo público. Você pode encontrar esse item de UGC chamando qualquer uma das seguintes APIs:
  • GetDraftItem, passando o ID do item obtido na resposta de CreateDraftItem
  • GetDraftItems, passando uma lista de IDs de itens conhecidos
  • GetEntityDraftItems, passando um ID de entidade e/ou o ContinuationToken de cada resposta anterior para percorrer a lista de itens de rascunho

• Quando estiver pronto para publicar o item de UGC, chame PublishDraftItem, passando o ID do item (obtido na resposta de CreateDraftItem).
• Se o seu item de UGC contiver vários arquivos particularmente grandes, a publicação do item poderá levar algum tempo e, quando muitos outros jogadores estiverem carregando conteúdo simultaneamente, esse processo poderá demorar ainda mais. Você pode verificar o status da publicação chamando GetItemPublishStatus, passando o ID do item (obtido na resposta de CreateDraftItem). Há alguns status possíveis:
  • Succeeded - o item de UGC foi publicado com êxito
  • Pending - o item de UGC ainda está em processo de publicação
  • Failed - a publicação do item de UGC falhou e ele não será publicado até que o conteúdo problemático seja modificado
  • Unknown - este é o status padrão e será retornado antes de chamar PublishDraftItem no item de UGC
  • Canceled - ocorreu um erro interno; tente publicar o item novamente (se você vir esse status várias vezes, entre em contato com a equipe de engenharia do PlayFab)
• Depois que o item de UGC for publicado com êxito, você poderá pesquisá-lo por meio de SearchItems ou obtê-lo diretamente por meio de GetItem se tiver o ID do item.
• Você pode fazer alterações no item de UGC antes ou depois da publicação fazendo o seguinte:
  • Chame GetDraftItem, passando o ID do item (obtido na resposta de CreateDraftItem)
  • Copie os dados do item de UGC (tudo no campo data)
  • Chame UpdateDraftItem, passando os dados modificados do item de UGC
  • Se quiser atualizar algum dos arquivos ou imagens, você precisará criar outro blob chamando CreateUploadUrls novamente
  • Publique novamente o item de UGC chamando PublishDraftItem

​

Por meio do Game Manager

​

Criar o item de catálogo de rascunho

• Navegue até a página de UGC selecionando Economy > Catalog (v2).
• Selecione New Item.
• Preencha os metadados apropriados para o seu item de UGC:

  Nome do campo	Valor
  Entity type	title_player_account
  Entity ID	[ID do seu jogador]
  Content type	Game Item
  Start date	[qualquer data no passado]
  Title	{ "NEUTRAL": "Hello World!" }
  Description	{ "NEUTRAL": "My first UGC item (with content!)" }

  
• Nas seções Files e Images, carregue o conteúdo apropriado selecionando o botão Upload.
• Selecione Save and publish.
• O item de UGC agora será criado automaticamente como um item de rascunho e publicado no catálogo público. Você poderá encontrar esse item na tabela com outros itens de UGC publicados.

• Se quiser fazer alterações no item de UGC publicado, você pode fazer o seguinte:
  • Selecione o item de UGC publicado na tabela
  • Faça as edições apropriadas
  • Selecione Save and publish

​

Solução de problemas

• Invalid Request - The content type ‘Game Item’ isn’t supported.
  • Se tipos de conteúdo tiverem sido especificados na configuração do seu título (por meio de GetCatalogConfig/UpdateCatalogConfig ou no Game Manager, na guia Economy Settings), você precisará adicionar Game Item à lista ou alterar o tipo de conteúdo para um que seu título já ofereça suporte
• Invalid Request - This title isn’t configured to use this service.
  • Seu título está com o UGC desabilitado no momento. Você pode habilitá-lo atualizando a configuração do título (por meio de GetCatalogConfig/UpdateCatalogConfig, no Game Manager na guia Economy Settings ou navegando até a guia Economy > Catalog (Preview) e selecionando Enable)

​

Próximas etapas