Procedimiento para elegir recibir notificaciones del sistema (aplicaciones de Windows en tiempo de ejecución)
[ Este artículo está destinado a desarrolladores de Windows 8.x y Windows Phone 8.x que escriben aplicaciones de Windows en tiempo de ejecución. Si estás desarrollando para Windows 10, consulta la documentación más reciente
Nota ¿No usas JavaScript? Consulta Cómo elegir recibir notificaciones del sistema (XAML).
En este tema se explica cómo especificar que la aplicación es capaz de generar notificaciones del sistema.
Lo que debes saber
Tecnologías
- Windows Runtime
Requisitos previos
Para comprender este tema, necesitas:
- Conocimientos prácticos sobre los términos y conceptos relacionados con las notificaciones del sistema. Para más información, consulta el tema de introducción a las notificaciones del sistema.
- Estar familiarizado con el esquema XML de las notificaciones del sistema, así como también con XML y su manipulación mediante API de Document Object Model (DOM). Para más información, consulta el tema sobre el esquema de notificaciones del sistema.
Instrucciones
Paso 1: Declara la capacidad de las notificaciones del sistema
La capacidad para producir notificaciones del sistema está declarada en el archivo package.appxmanifest de la aplicación. Si usas el editor de manifiestos de Microsoft Visual Studio, establece la opción Capacidad de aviso en "Sí" en la sección Notificaciones de la pestaña Aplicación.
El siguiente ejemplo muestra el código XML que se inserta en el archivo package.appxmanifest como resultado de esta opción elegida. El atributo ToastCapable se agrega al elemento VisualElements del manifiesto.
En este ejemplo también se muestra lo que hay que agregar si creas el archivo package.appxmanifest manualmente, fuera de Visual Studio. Para más información, consulta el tema sobre cómo crear un manifiesto del paquete manualmente. Ten en cuenta que, aunque la opción de Visual Studio es "Sí", lo que se escribe en el archivo package.appxmanifest es “true”.
<VisualElements
...
ToastCapable="true">
</VisualElements>
Paso 2: Declara un color de fondo y texto para las notificaciones del sistema (solo Windows)
Puedes declarar un color de fondo y un texto claro u oscuro para la notificación del sistema. Ten en cuenta que esta opción también se aplica a los iconos —los colores del texto y el fondo de la notificación del sistema y del icono siempre están vinculados.
Si usas el editor de manifiestos de Visual Studio, selecciona la opción Texto en primer plano en la pestaña Visual Assets (Activos visuales). Establece la opción Color de fondo con una cadena de color W3DC (por ejemplo, "#FFFFFF").
Nota Las aplicaciones de la Tienda de Windows Phone no te permiten establecer un color de texto o de fondo. El color de fondo de la notificación del sistema es el color de énfasis del sistema, que puede elegir el usuario en Configuración, y el del texto siempre es claro.
El siguiente ejemplo muestra el código XML que se inserta en el archivo package.appxmanifest como resultado de estas opciones elegidas. Los atributos ForegroundText y BackgroundColor se agregan al elemento VisualElements del manifiesto.
<VisualElements
...
ForegroundText="dark"
BackgroundColor="#FFFFFF">
</VisualElements>
Paso 3: Especifica una imagen de logotipo
La imagen de logotipo pequeño de la aplicación se muestra en la esquina inferior derecha de cada notificación del sistema para mostrar al usuario qué aplicación la ha generado.
Nota Windows Phone 8.1 no usa esta imagen de logotipo. El icono refleja únicamente el nombre para mostrar de la aplicación (tal y como aparece en el manifiesto) o nada.
Si usas el editor de manifiestos de Visual Studio, define la ruta de la imagen como Logotipo cuadrado de 30x30 (Windows) o Logotipo cuadrado de 44x44 (Windows Phone) en la pestaña Activos visuales. La imagen especificada debe estar incluida en el paquete de la aplicación.
El siguiente ejemplo muestra el código XML que se inserta en el archivo package.appxmanifest como resultado de estas opciones elegidas. El atributo SmallLogo se agrega al elemento VisualElements del manifiesto.
<VisualElements
...
SmallLogo="images\smallTile-sdk.png">
</VisualElements>
Observaciones
Después de completar los pasos anteriores, la aplicación puede enviar notificaciones del sistema al usuario.
Ejemplo completo
En el siguiente ejemplo, se muestra el código XML completo para un elemento VisualElements de muestra de la aplicación de Windows en su archivo package.appxmanifest, incluidos los atributos que se tratan en este tema.
<VisualElements
DisplayName="ToastsSample"
Logo="images\squareTile-sdk.png"
SmallLogo="images\smallTile-sdk.png"
Description="SDK Sample"
ForegroundText="dark"
BackgroundColor="#FFFFFF"
ToastCapable="true">
<DefaultTile ShortName="ToastsSample" ShowName="allLogos"/>
<SplashScreen BackgroundColor="white" Image="images\splash-sdk.png"/>
</VisualElements>
Temas relacionados
Introducción a las notificaciones del sistema
Directrices y lista de comprobación de notificaciones del sistema