Como desarrollador, puedes definir accesos directos para realizar acciones específicas en tu app. Se pueden mostrar esos accesos directos en un selector o asistente compatibles, como Asistente de Google, y ayudan a los usuarios a iniciar rápidamente tareas comunes o recomendadas dentro de la app.
Este conjunto de guías te enseña cómo crear y administrar accesos directos a aplicaciones. Además, aprenderás algunas prácticas recomendadas que mejorarán la efectividad de tus accesos directos.
Tipos de accesos directos
Cada acceso directo hace referencia a uno o más intents, cada uno de los cuales inicia una acción específica en tu app cuando los usuarios lo seleccionan. Los tipos de accesos directos que creas para tu app dependen de sus casos de uso clave. Entre los ejemplos de acciones que puedes expresar como accesos directos, se incluyen los siguientes:
- Redactar un nuevo correo electrónico en una app de ese tipo
- Llevar a los usuarios a una ubicación específica en una app de mapas.
- Enviar mensajes a un amigo en una app de comunicación.
- Reproducir el siguiente episodio de un programa de TV en una app multimedia.
- Cargar el último punto obtenido en una app de videojuegos
- Pedir un trago en una app de comida mediante comandos por voz
Nota: Solo las actividades principales (las que procesan la acción Intent.ACTION_MAIN y la categoría Intent.CATEGORY_LAUNCHER) pueden tener accesos directos. Si una app tiene varias actividades principales, debes definir el conjunto de accesos directos para cada actividad.
Puedes publicar los siguientes tipos de accesos directos para tu app:
- Los accesos directos estáticos se definen en un archivo de recursos que se empaqueta en un APK o paquete de aplicación.
- Los accesos directos dinámicos se pueden enviar, actualizar y quitar solo cuando tu app está en ejecución.
-
Se pueden agregar accesos directos fijos a los selectores admitidos durante la ejecución si el usuario otorga permiso.
Nota: Los usuarios también pueden crear accesos directos fijos copiando los accesos directos estáticos y dinámicos de tu app en el selector.
Cómo mostrar accesos directos en asistentes mediante funciones
Las funciones de shortcuts.xml te permiten declarar los tipos de acciones que los usuarios pueden realizar para iniciar tu app y pasar directamente a una tarea específica. Por ejemplo, puedes permitir que los usuarios tengan control por voz de tu app mediante Asistente de Google declarando elementos capability que extiendan la funcionalidad de la app a las Acciones de apps de Asistente. Para obtener más información, consulta Cómo agregar funciones.
Limitaciones de accesos directos
La mayoría de los selectores compatibles muestran hasta cuatro accesos directos a la vez y cuentan tanto los accesos directos estáticos como dinámicos. Cuando envíes accesos directos dinámicos para mostrar en plataformas de Google, como Asistente de Google, usa la Biblioteca de integración de accesos directos de Google para evitar que estén sujetos al límite de accesos directos.
Si decides no usar la Biblioteca de integración de accesos directos de Google, tu app solo podrá enviar la cantidad máxima de accesos directos que admita el dispositivo en simultáneo. Los accesos directos que se publican de esta manera solo aparecen dentro de los selectores de Android y no son detectables en las plataformas de Google, como Asistente.
Nota: La cantidad máxima de accesos directos que admite un dispositivo puede variar. Usa el método getMaxShortcutCountPerActivity() para determinar la cantidad de accesos directos que admite un dispositivo en particular.
No hay límite para la cantidad de accesos directos fijos que pueden crear los usuarios. Aunque tu app no puede quitar los accesos directos fijos, puede inhabilitarlos.
Nota: Aunque otras apps no pueden acceder a los metadatos dentro de tus accesos directos, el selector sí puede hacerlo. Por lo tanto, estos metadatos deben ocultar la información sensible del usuario.
A fin de comenzar a crear accesos directos para tu app, consulta las siguientes páginas:
- Cómo crear accesos directos
- Cómo administrar accesos directos
- Prácticas recomendadas para accesos directos
Para obtener más detalles sobre las operaciones que se pueden realizar en los accesos directos, consulta la referencia de la API ShortcutManager.