Skip to main content
En este tema se describe cómo usar características y recetas para mejorar los tiempos de instalación inicial y posteriores del juego para el usuario. Las características y las recetas funcionan conjuntamente para definir grupos de contenido dentro del juego base que los usuarios pueden agregar y quitar durante la instalación inicial, así como desde el shell más adelante. También puede usar las API en tiempo de ejecución para consultar dinámicamente el estado de instalación de las características y desencadenar la adición y eliminación de características. Una característica es un elemento XML que especifica un atributo de cadena de identificador orientado al desarrollador. También especifica el nombre para mostrar localizable orientado al usuario y la imagen que se muestra en el shell. La característica especifica una o varias etiquetas. En el momento de la instalación y la actualización, el sistema busca todas las etiquetas a las que hacen referencia las características instaladas e instala todos los fragmentos (chunks) que contienen esas etiquetas. Una receta es un elemento XML que especifica una lista de características que deben instalarse. Siempre hay una receta predeterminada, y las características que incluye esa receta siempre se instalan. Se pueden definir recetas adicionales. Estas se activan en el momento de la instalación si el usuario o la consola actual tienen derechos sobre cualquiera de los StoreIds especificados, como se muestra en el código siguiente.
Las características pueden contener más de un atributo de etiqueta, separados por punto y coma. Un fragmento se incluye para la instalación si cualquiera de las etiquetas del fragmento está incluida en una característica activa. El símbolo # instala una etiqueta si las etiquetas de ambos lados del # están activas.

Localización de los nombres para mostrar de las características

La localización de los DisplayNames se realiza de la misma manera que la localización de los atributos de nombre dentro del archivo MicrosoftGame.config. Esto se hace mediante el formato ms-resource:name, junto con los archivos .resw que están en el directorio strings del juego y las cadenas por configuración regional en subdirectorios con los nombres adecuados. Para obtener más información, consulte Localización de MicrosoftGame.Config
Los valores de cadena localizados y las imágenes que se usan con MicrosoftGame.config e Intelligent Delivery no se cifran en los paquetes publicados, ni en los sandboxes de desarrollador ni en la versión comercial. Use valores de marcador de posición en su juego para el título, los iconos y cualquier contenido confidencial. El contenido confidencial incluye cualquier contenido al que haga referencia Intelligent Delivery durante el desarrollo, antes de la divulgación pública de su título, o contenido específico que se encuentre dentro de su título.

Características ocultas

Las características se marcan como ocultas, lo que impide que los usuarios decidan si se muestran como opciones seleccionables en el momento de la instalación o al administrarlas desde el shell después de instalar el título. Tenga cuidado al usar características ocultas, porque la única manera de agregarlas o quitarlas es mediante las API dentro de su título. Cualquier error detectado en su título podría dar lugar a contenido inaccesible hasta que proporcione una actualización de contenido para corregir esos errores. El código siguiente es un ejemplo de una característica marcada como oculta.

Comprobación del estado de instalación de las características

Puede usar las características para comprobar la presencia de todos los fragmentos con las etiquetas especificadas por esa característica. Al realizar estas consultas en tiempo de ejecución, se tienen en cuenta los especificadores de dispositivo y de idioma. Si tiene contenido específico de dispositivo o de idioma dentro de la característica, seguirá devolviendo true siempre que estén instalados un idioma y todos los fragmentos aplicables al dispositivo actual dentro de esa característica. Por ejemplo, si los recursos de la característica de campaña están contenidos en los fragmentos 8000, 8001 y 8002, en lugar de llamar al método XPackageFindChunkAvailability para determinar si ese conjunto de fragmentos está totalmente instalado y listo para jugar, puede etiquetar los tres fragmentos con la etiqueta personalizada “campaign1” y hacer referencia a “campaign1” en la característica de campaña. A continuación, puede llamar al método XPackageFindChunkAvailability mediante XPackageChunkSelector con el identificador de la característica de campaña para obtener fácilmente el estado de instalación de ese conjunto de datos.

Documentación de referencia de la API

Consulte también

Introducción a Intelligent Delivery XPackageChunkSelector XPackageInstallChunks Localización de MicrosoftGame.Config
Última modificación el 28 de agosto de 2026