AYUDA EN LÍNEA
 WINDEVWEBDEV Y WINDEV MOBILE

Este contenido se ha traducido automáticamente.  Haga clic aquí  para ver la versión en inglés.
Ayuda / WLanguage / Funciones WLanguage / Funciones específicas para móviles / Funciones de descarga
  • Presentación
  • ¿Cómo proceder?
  • Añadir una descarga
  • Seguimiento de una descarga
  • Eliminar una descarga
  • Funciones de WLanguage
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaReportes y ConsultasCódigo de Usuario (UMC)
WEBDEV
WindowsLinuxPHPWEBDEV - Código Navegador
WINDEV Mobile
AndroidWidget Android iPhone/iPadIOS WidgetApple WatchMac CatalystUniversal Windows 10 App
Otros
Procedimientos almacenados
Presentación
A partir de la versión 27, los archivos pueden descargarse en Background, utilizando el gestor de descargas del sistema. Por lo tanto, ya no es necesario mantener la aplicación abierta para pedir al usuario que descargue un archivo. El gestor de descargas permite descargar archivos de gran tamaño y generar una Notification cuando las descargas se han completado.
¿Cómo proceder?

Añadir una descarga

Para proponer una descarga en su aplicación Android:
  1. Definir una solicitud de descarga con una Variable de tipo DownloadParameter. Esta Variable contiene múltiples propiedades, pero sólo una es realmente necesaria: el Fuente Property que corresponde al URI del archivo a descargar.
  2. Añade la descarga en el gestor de descargas con DownloadAdd. Una vez añadido, el gestor de descargas iniciará la descarga lo antes posible.
Observación: Descargar final Procedure
Para que se le notifique cuando se complete una descarga, puede especificar una Procedure que se llamará al final de la descarga. Para ello, es necesario especificar el procedimiento a llamar en el ProcedureEnd Property del DownloadParameter Variable.
  • Si la aplicación se cerró antes de finalizar la descarga, se reiniciará para ejecutar la Procedure cuando se complete la descarga.
  • Si el Procedure devuelve True, la descarga será eliminada así como el archivo descargado. En caso contrario, la descarga se mantendrá en el gestor de descargas y el archivo no se borrará.

Seguimiento de una descarga

Para supervisar la descarga en la aplicación Android, recupere los detalles de la descarga con DownloadAdd, especificando el identificador de descarga proporcionado por DownloadGetInfo. Esta información se almacena en una Variable de tipo DownloadInfo.
Si hay un error durante la descarga, se inicia el final de la descarga Procedure. La propiedad Status de la variable DownloadInfo se establece en downloadStatusFailed. En este caso, se puede utilizar el StatusDetails Property para determinar la causa del error.
Para recuperar todas las descargas iniciadas por la aplicación en el gestor de descargas, utilice DownloadList.

Eliminar una descarga

Para eliminar una descarga del gestor de descargas, utilice DownloadRemove y especifique el identificador de la descarga que desea eliminar. Esta función Cancel la descarga y la elimina del gestor de descargas, así como el archivo descargado, si existe.
Funciones de WLanguage
Las siguientes funciones de WLanguage se utilizan para gestionar las descargas:
DownloadAddAñade una nueva descarga en el gestor de descargas del dispositivo.
DownloadGetInfoRecupera los detalles de una descarga presente en el gestor de descargas.
DownloadListEnumera las descargas de la aplicación actual en el gestor de descargas.
DownloadRemoveCancela una descarga eliminándola del gestor de descargas, y borra los archivos existentes.
Observaciones:
  • La utilización de las funciones de descarga añade automáticamente la Permission INTERNET a la lista de Permission s requeridas por la aplicación. El permiso DOWNLOAD_WITHOUT_NOTIFICATION también se agrega si se utiliza la constante downloadNotifNone con la propiedad NotificationMode de la variable DownloadParameter.
  • Cuando se ejecuta la aplicación en el simulador, las funciones de descarga no tendrán efecto.
Versión mínima requerida
  • Versión 27
Comentarios
Haga clic en [Agregar] para publicar un comentario

Última modificación: 27/01/2023

Señalar un error o enviar una sugerencia | Ayuda local