Inicio rápido de la red de entrega de contenido - XBOX Game Development Documentation

PlayFab CDN es una característica heredada compatible con las cuentas que tienen al menos un título que haya configurado previamente la CDN. Para los nuevos desarrolladores de PlayFab interesados en una solución de administración de contenido, recomendamos usar Azure CDN. Para empezar, consulte la documentación de Azure CDN.

La red de entrega de contenido (CDN) de PlayFab almacena recursos individuales como archivos identificados de forma única por el nombre de archivo (también denominado clave). Esto implica que los recursos se agregan, actualizan, quitan y recuperan por clave. PlayFab CDN permite segregar los recursos por carpetas. La ruta de la carpeta hasta el recurso pasa a formar parte de la clave del recurso. El ejemplo siguiente es una clave de recurso válida almacenada dentro de la carpeta denominada Android. Android/Image.png. Cuando el usuario captura recursos, sus solicitudes se enrutan automáticamente a la ubicación perimetral más cercana, por lo que el contenido se entrega con el mejor rendimiento posible. Esto, sin embargo, puede introducir retrasos en las acciones de administración de archivos, como las de los ejemplos siguientes:

Carga de archivos: su archivo está disponible inmediatamente.
Sobrescritura de archivos: el archivo antiguo se muestra a los usuarios durante un máximo de 24 horas, hasta que se sobrescribe con el archivo nuevo.
Eliminación de archivos: el archivo sigue existiendo durante un máximo de 24 horas, mientras el comando de eliminación lo quita de todas las ubicaciones perimetrales.

Carga de recursos

Antes de que sus usuarios puedan capturar un recurso, este debe cargarse en la CDN. Esto se puede hacer en Game Manager:

Seleccione Content en el menú de la izquierda.
Elija la pestaña File Management.
A continuación, seleccione Upload Files.

Puede:

Seleccionar varios archivos (1).
Cada archivo seleccionado aparece en la lista (2).
Enviar los archivos seleccionando el botón Upload Files (3).

Los archivos cargados aparecen en la lista (1).
Tenga en cuenta que también puede administrar carpetas.
- Para crear una carpeta, seleccione el botón New Folder (2).
Rellene el nombre de la carpeta (1).
Seleccione el botón Create Folder (2).

Esto crea una carpeta nueva en el árbol. Después puede seleccionar esta carpeta y cargar los archivos con normalidad. Como alternativa, puede cargar recursos mediante código usando el SDK de administración. Es un proceso de dos pasos:

Primero, llame a GetContentUploadUrl y obtenga la URL con firma previa que autoriza la carga.
A continuación, use la URL para realizar una solicitud HTTP PUT, proporcione los datos y (opcionalmente) el tipo de contenido.

Considere la posibilidad de usar el fragmento de código que se proporciona a continuación, que muestra cómo obtener una URL con firma previa.

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
}

Después puede comprobar el resultado a través de Game Manager de PlayFab. Asegúrese de que el archivo aparece en la lista.

Captura de recursos

Descargar el recurso mediante código es idéntico a cargarlo. Como se mencionó anteriormente, es un proceso de dos pasos.

Primero, realice una llamada a GetContentDownloadUrl y obtenga una URL con firma previa que autorice la descarga.
A continuación, use la URL con firma previa para realizar una solicitud HTTP GET y capturar los datos.

Considere la posibilidad de usar el fragmento de código que se proporciona a continuación, que muestra lo esencial del proceso.

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 se mencionó anteriormente, la CDN puede implicar latencia en lo que respecta a las actualizaciones de archivos. Durante el desarrollo, a veces resulta útil forzar la captura de los archivos más recientes y actualizados. La llamada GetContentDownloadUrl le permite establecer el parámetro ThruCDN en False. La URL devuelta apunta a archivos recientes no almacenados en caché.

El cliente publicado de su juego no debe usar nunca esta opción.

​Carga de recursos

​Captura de recursos

Carga de recursos

Captura de recursos