Construir una aplicación de lista de tareas de voz en Ios con integración de Siri

Creando el AddTaskIntent

1. Abrir TodoIntents.intentdefinition]. Haga clic en + en la parte inferior izquierda del lienzo y seleccione Nueva Intención].
2. Nombra la intención .
3. Bajo Parameters], agregue un nuevo parámetro llamado de tipo ].Acceda. Opcionalmente, agregue un parámetro si su aplicación soporta múltiples listas.
4. Establecer el parámetro ] Nombre de la pantalla (por ejemplo, "Nombre de la pestaña") y Promptar (por ejemplo, "¿Cuál tarea debo añadir?").Este aviso aparece cuando Siri necesita aclaración.
5. En la sección Response], elija ]] éxito y defina una plantilla de respuesta como "Añadir {{taskName} a su lista de tareas".
6. Asegúrese de Clase de fondo] se verifica y el nombre de clase es .

Crear el RemoveTaskIntent

Repita el proceso para un con un parámetro . La respuesta podría ser "Removido {{taskName}}" o "{{taskName}} no se encuentra." También puede añadir un ]Failure] tipo de respuesta para cuando la tarea no existe.

Creando el ShowTasksIntent

Para , es posible que no necesite ningún parámetro. En lugar de ello, confíe en la respuesta para contener una lista de tareas. En la sección de respuesta, agregue una Content] propiedad de tipo .Canción]. Usa una plantilla de respuesta como “Tienes {cont} tareas: {contenido}” [Finalmente”

Generando clases de intención

Después de definir todos los intentos, construir su proyecto. Xcode generará automáticamente clases de Swift para cada intención y su respuesta. Estas clases viven en la carpeta DerivedData pero son visibles en el editor. Los utilizarás en tu código de manipulador.

Implementar el manejo de intención en su aplicación y extensión

Ahora que las intenciones están definidas, usted necesita escribir el código que los maneja cuando Siri invoca su aplicación.

Manejo de las Intenciones en la extensión de las Intenciones

El objetivo de extensión de las intenciones incluye un archivo predeterminado . Abrelo y reemplaza su contenido con una clase que se ajusta a los protocolos de manipulación de intenciones generados. Cada intención tendrá su propio método de manipulador.

import Intents

class IntentHandler: INExtension, AddTaskIntentHandling, RemoveTaskIntentHandling, ShowTasksIntentHandling {

 override func handler(for intent: INIntent) -> Any? {
 return self
 }

 // MARK: - Add Task
 func handle(intent: AddTaskIntent, completion: @escaping (AddTaskIntentResponse) -> Void) {
 guard let taskName = intent.taskName else {
 completion(AddTaskIntentResponse.failure(taskName: "unknown"))
 return
 }
 // Persist the task to your data store (Core Data, UserDefaults, etc.)
 // For simplicity, we'll assume a shared data manager
 TaskDataManager.shared.addTask(taskName: taskName, listName: intent.listName ?? "Default")
 completion(AddTaskIntentResponse.success(taskName: taskName))
 }

 func resolveTaskName(for intent: AddTaskIntent, with completion: @escaping (INStringResolutionResult) -> Void) {
 if let taskName = intent.taskName, !taskName.isEmpty {
 completion(.success(with: taskName))
 } else {
 // Prompt user for a task name
 completion(.needsValue())
 }
 }

 // MARK: - Remove Task
 func handle(intent: RemoveTaskIntent, completion: @escaping (RemoveTaskIntentResponse) -> Void) {
 guard let taskName = intent.taskName else {
 completion(.failure(taskName: "unknown"))
 return
 }
 let removed = TaskDataManager.shared.removeTask(taskName: taskName)
 if removed {
 completion(.success(taskName: taskName))
 } else {
 completion(.notFound(taskName: taskName))
 }
 }

 // MARK: - Show Tasks
 func handle(intent: ShowTasksIntent, completion: @escaping (ShowTasksIntentResponse) -> Void) {
 let tasks = TaskDataManager.shared.allTasks()
 let taskList = tasks.map { $0.name }.joined(separator: ", ")
 let count = tasks.count
 let response = ShowTasksIntentResponse.success(count: count, content: taskList)
 completion(response)
 }
}

Tienda de datos compartida

El código anterior hace referencia a un hipotético . Debido a que la extensión de las patentes se ejecuta en un proceso separado, no puede acceder directamente al modelo de datos principal de su aplicación. Necesita utilizar un contenedor compartido (App Group) para almacenar tareas en un lugar común como un UserDefaults] suite o una tienda de datos núcleo que vive en el directorio de grupo de aplicaciones.

Manejo de Intents en la Aplicación Principal

Cuando su aplicación es frontal y el usuario activa un acceso directo a Siri, también puede querer manejar los intentos directamente en la aplicación principal (sin la extensión). Puede ajustar su delegado de aplicación o delegado de escena a los mismos protocolos de intención. Sin embargo, para la mayoría de los casos de uso, la extensión es suficiente porque funciona independientemente de si la aplicación está en primer plano.

Función de ampliación: Confirmación, Deshacer y Parámetros

Para hacer que su lista de voz sea robusta, agregue soporte para diálogos de confirmación y resolución de parámetros.

Métodos de resolución

Para cada parámetro, puede implementar un método que valida o pide aclaración. Por ejemplo, si el usuario dice "Añadir huevos" sin especificar qué lista, su método puede incitar: "¿A qué lista quieres añadir huevos?" Si usted tiene una lista, resolva automáticamente a esa lista.

Respuestas de confirmación

Puede dejar que Siri le pida al usuario que confirme una acción antes de ejecutarla. Esto es útil para operaciones destructivas como la eliminación de tareas. En su clase de respuesta de intención, agregue un Confirmación] tipo de respuesta. Al manejar la intención, puede devolver una respuesta de confirmación que incluye los detalles. Siri pedirá al usuario que confirme, y si se confirma, su método se llamará de nuevo.

URL Manejo para el enlace profundo

Después de realizar una acción, puede que desee abrir su aplicación para mostrar la lista actualizada. Su manejador de intenciones puede llamar si está disponible, o su aplicación principal puede responder a esquemas de URL. Agregue una propiedad a su definición de intención para permitir un enlace profundo automático.

Prueba tu aplicación de voz

Pruebas de integración Siri requiere alguna configuración porque los comandos hablados no pueden simularse directamente. Utilice los siguientes enfoques:

Usando el Simulador Siri en Xcode

Ejecute su aplicación principal en un simulador, luego detenga la aplicación. A continuación, ejecute el objetivo de extensión de las patentes utilizando un esquema configurado para el simulador. Xcode lanzará una interfaz Siri simulada donde puede escribir su comando. Esta es la forma más rápida de probar sin un dispositivo físico.

Pruebas con un dispositivo real

Para el reconocimiento exacto de tus intenciones específicas, prueba en un dispositivo iOS real que funciona iOS 14 o posterior. Después de instalar tu app, abre Ajustes > Siri & Search > MyToDoApp y asegura que las intenciones se toggled. Diga "Hey Siri, agrega código de escritura a mi lista de tareas en MyToDoApp" y verifica el resultado.

Problemas comunes y depuración

• No se reconoce la intención:] Verificar que la página Info.plist de la extensión de las patentes incluye los nombres de clase de intención bajo IntentsSoportados.
• No se comparte la información:] Asegurar que ambos objetivos pertenecen al mismo Grupo de Aplicación y que la ruta de almacenamiento de datos es correcta.
• Response not spoken: Usa plantillas de respuesta que incluyen variables ; Siri las lee en voz alta.
• Falta el parámetro:] Implementar métodos de resolución para manejar la entrada ambigua.

Implementación y Consideraciones de App Store

Al enviar su aplicación a la App Store, debe declarar la capacidad de Siri. En App Store Connect, agregue una nota en las notas de revisión explicando lo que sus intenciones hacen y proporcionar comandos de prueba. Apple probablemente probará con un dispositivo real, así que asegúrese de que todo funcione correctamente.

Para maximizar la adopción de los usuarios, considere las mejores prácticas siguientes:

• Usuarios a bordo: Mostrar un breve tutorial sobre comandos de voz disponibles cuando la aplicación se lanza por primera vez.
• Atajos de apoyo: Permitir a los usuarios crear atajos vocales personalizados para tareas específicas (por ejemplo, “Hey Siri, añadir comestibles”) a través y ].
• Localizar sus intenciones: Proveer impulsos localizados y plantillas de respuesta para diferentes idiomas.
• Errores de desplazamiento con gracia: Siempre devuelve una respuesta significativa —aunque la tarea no lo haga— para guiar al usuario.

Características avanzadas y pasos siguientes

Una vez que tenga la lista de voz de base que se puede hacer funcionar, puede ampliarla con:

• Fecha de parálisis del lenguaje natural:] Los usuarios dicen “Agregar la leche para mañana” y establecer automáticamente una fecha de debido uso .
• Apoyo de la estructura y la etiqueta: Añada parámetros para categorías como o .
• Integración de la aplicación: Utilizar el trabajo de SiriKit , Media, u otros dominios si su aplicación se expande más allá de las listas de tareas.
• Vocabulario personalizado: Proveer una lista de vocabulario para entrenar a Siri para reconocer frases específicas de la aplicación como “mi lista de comestibles” o “trabaja tareas”.

Conclusión

Construir una aplicación de lista de voz para hacer con la integración de Siri es una manera práctica para mejorar la productividad de los usuarios y la accesibilidad. Al definir las intenciones personalizadas, implementar los controladores en una extensión dedicada, y utilizar una tienda de datos compartida, puede crear una experiencia sin manos. Los pasos descritos en esta guía —desde la configuración de proyectos hasta la prueba y la presentación— le darán una base sólida.

Para más detalles, consulte el documento oficial de Apple SiriKit documentation y la Guía de cortes. Si usted es nuevo en el desarrollo de iOS, también revise Iniciar el desarrollo de aplicaciones iOS (Swift) para conceptos fundacionales