Você pode ler em português (https://github.com/welbert6/MaterialStoryView/edit/master/ReadmePT.md) Capturas de pantalla Introducción MaterialStoryView es una biblioteca de Android para implementar un carrusel de historias, similar a las que se encuentran en redes sociales como Instagram y Facebook. . Esta biblioteca facilita la adición de un componente de visualización de historias a su aplicación de Android, lo que permite una integración rápida y sencilla. ✅ Guarda la historia como se ve en SharedPreferences: garantiza que los usuarios no vean repetidamente la misma historia, lo que mejora la experiencia del usuario. ✅ Botón de acción en la historia: permite interacciones directas, como visitar un enlace o realizar una acción específica, directamente desde la historia. ✅ Navegación entre historias tocando en el lado derecho e izquierdo de la pantalla: Facilita la navegación por las historias, permitiendo a los usuarios avanzar o retroceder con un simple toque. ✅ Admite RTL y LTR: se adapta a usuarios de idiomas que se leen de derecha a izquierda (RTL) y de izquierda a derecha (LTR), lo que garantiza una experiencia de usuario global e inclusiva. ✅ Admite historias con y sin títulos: ofrece flexibilidad para mostrar historias tanto con títulos para contexto como sin títulos para un diseño más limpio. ✅ Personalización 100%: permite una personalización completa de la apariencia de la historia, incluida la duración, el color del indicador, el tamaño del radio de la imagen, el color del texto, etc., para que coincida perfectamente con la identidad visual de su aplicación. Configuración 1. Agregue la dependencia de gradle. Agregue el repositorio JitPack a su build.gradle raíz al final de los repositorios: allprojects { repositories { … maven { url ‘https://jitpack.io’ } } } Agregue la dependencia: dependencies { implementación ‘com.github.welbert6:MaterialStoryView:1.0.0’ } 2. Uso Agregue CarouselStoryView a su diseño XML:
Inicialice y configure CarouselStoryView en su actividad: val carrosselStoryView: CarouselStoryView = findViewById(R.id.carouselStoryView) //Asegúrese de llamar a init With Activity para iniciar lib carrosselStoryView.initWithActivity(this) // Puede agregarStory o addStories si tiene una lista de historias carrosselStoryView.addStory(getCopasaStories()) carrosselStoryView.addStory(getCemigStories()) carrosselStoryView.addStory(getCminStories()) carrosselStoryView.addStories(getModelStorys()) Personalización MaterialStoryView ofrece varias opciones de personalización a través de atributos XML, permitiendo modificaciones de: Texto tamaño y color Colores de los indicadores de historias visitadas y pendientes Radio de la imagen de la historia Ancho del indicador del elemento de la historia Duración de la historia Para obtener más detalles sobre las opciones de personalización, consulte las opciones disponibles en la sección de atributos XML declarables. miniStoryTextSize (Tamaño del texto de la mini historia): establece el tamaño del texto de los subtítulos de la mini historia, lo que permite personalizar la escala del texto para una mejor legibilidad. miniStoryTextColor (Color del texto de la mini historia): especifica el color del texto para los subtítulos de la mini historia, ofreciendo la posibilidad de hacer coincidir el color del texto con el tema de la aplicación. miniStoryTextFont (fuente de texto para mini historias): permite configurar la fuente del texto para mini historias a través de una referencia, lo que permite personalizar la tipografía para alinearla con la identidad visual. miniStoryVisitedIndicatorColor (Color del indicador de minihistoria visitada): define el color del indicador de las historias que ha visto el usuario, lo que ayuda a distinguir entre contenido nuevo y revisado. miniStoryPendingIndicatorColor (Color indicador pendiente de mini historia): Especifica el color del indicador para las historias que aún no han sido vistas, facilitando la identificación de contenido nuevo. miniStoryImageRadius (Radio de imagen de mini historia): determina el radio de las imágenes en mini historias, lo que permite redondear las esquinas de las imágenes para una apariencia más suave. miniStorySpaceBetweenImageAndIndicator (Espacio entre la imagen de la mini historia y el indicador): establece el espacio Créditos/StoriesProgressView: esta biblioteca se utilizó para mostrar el progreso de las historias desarrolladas por Welbert Moreira. No dudes en contribuir con mejoras, correcciones de errores o nuevas funciones. ¡Tu contribución es bienvenida! Licencia Licencia MIT Copyright (c) 2024 Welbert Moreira Por el presente se concede permiso, de forma gratuita, a cualquier persona que obtenga una copia de este software y los archivos de documentación asociados (el «Software») para operar con el Software sin restricciones, incluidas, entre otras, los derechos de usar, copiar, modificar, fusionar, publicar, distribuir, sublicenciar y/o vender copias del Software, y de permitir que las personas a quienes se les proporciona el Software lo hagan, sujeto a las siguientes condiciones: El aviso de derechos de autor anterior y este aviso de permiso se incluirá en todas las copias o partes sustanciales del Software. EL SOFTWARE SE PROPORCIONA «TAL CUAL», SIN GARANTÍA DE NINGÚN TIPO, EXPRESA O IMPLÍCITA, INCLUYENDO PERO NO LIMITADO A LAS GARANTÍAS DE COMERCIABILIDAD, IDONEIDAD PARA UN PROPÓSITO PARTICULAR Y NO INFRACCIÓN. EN NINGÚN CASO LOS AUTORES O TITULARES DE DERECHOS DE AUTOR SERÁN RESPONSABLES DE NINGÚN RECLAMO, DAÑO U OTRA RESPONSABILIDAD, YA SEA EN UNA ACCIÓN CONTRACTUAL, AGRAVIO O DE OTRA MANERA, QUE SURJA DE, FUERA DE O EN RELACIÓN CON EL SOFTWARE O EL USO U OTRAS NEGOCIOS EN EL SOFTWARE.
