Banner_ohos

This project represents the adaptation and porting of the open-source Banner project to the HarmonyOS platform. The original Android project can be found by tags and on GitHub (https://github.com/youth5201314/banner). A description of this project was published in the community and is available at (https://harmonyos.51cto.com/posts/3341).

Project Description

• Project Name: Controller for smooth switching of advertising images
• Series: Third-party adaptation for HarmonyOS
• Functionality: Cyclical display of advertising images
• Porting Status: Core functions
• Usage Differences: None
• Development Version: DevEco Studio 3.0 Beta2, SDK 5.0
• Project Author: Zhong Xiao
• Email: isrc_hm@iscas.ac.cn
• Original Project Documentation Address: https://github.com/youth5201314/banner

Installation Instructions

1. Download the Banner.har file (located in the output folder).
2. Launch DevEco Studio and import the downloaded .har file into the directory "entry -> libs".
3. In the module-level build.gradle file, add a dependency specifying the path to the libraries in the dependencies directive.

dependencies {
    implementation fileTree(dir: 'libs', include: ['*.jar', '*.har'])
    ...
}

4. Right-click on the imported .har file and select "Add as Library" to add it as a library. Choose the required module and click "OK" to complete the process. Проект может быть запущен напрямую в SDK 5 и DevEco Studio 2.1 Beta3. Если проект не запускается, удалите файлы .gradle, .idea, build, gradle, build.gradle и создайте новый проект, скопировав соответствующие файлы в корневую директорию.

Инструкция по использованию

1. Banner — это компонент, который реализует циклическое отображение нескольких рекламных изображений и возможность ручной прокрутки. В настоящее время он не поддерживает настройку стилей страниц, но основные функции полностью удовлетворяют большинство требований.

В исходном компоненте используется внешний загрузчик изображений, а в данном компоненте изображения передаются через список.

List<Integer> list = new ArrayList<>();
list.add(ResourceTable.Media_b1);
list.add(ResourceTable.Media_b2);
list.add(ResourceTable.Media_b3);
list.add(ResourceTable.Media_4);
list.add(ResourceTable.Media_5);
banner.setImages(list).start();

2. Пример использования

Установка стиля баннера

setBannerStyle(int bannerStyle) — установка стиля баннера (по умолчанию CIRCLE_INDICATOR, доступно пять стилей, среди которых числовой стиль имеет небольшую ошибку, требующую исправления).

isAutoPlay(boolean isAutoPlay) — установка автоматического воспроизведения (по умолчанию включено).

setViewPagerIsScroll(boolean isScroll) — установка возможности ручной прокрутки баннера (по умолчанию true).

update(List<?> imageUrls, List<String> titles) — обновление изображений и заголовков.update(List<?> imageUrls) — обновление изображений.

startAutoPlay() — начало автоматической прокрутки (начиная с версии 1.4 работает только после полной загрузки баннера -> должно выполняться после start()).

stopAutoPlay() — завершение автоматической прокрутки (начиная с версии 1.4 работает только после полной загрузки баннера -> должно выполняться после start()).

start() — начало отрисовки баннера (обязательно последний вызываемый метод).

setBannerTitles(List titles) — установка заголовков для баннера (если они не переданы, заголовки не будут отображаться).

setDelayTime(int time) — установка времени задержки между изображениями (в миллисекундах, по умолчанию 2000).

setImages(Object[]/List<?> images) — установка изображений для баннера (все методы установки параметров должны быть выполнены до этого метода).

setOnBannerClickListener(this) — установка события клика (индексация начинается с 1) (устарело).

setOnBannerListener(this) — установка события клика (индексация начинается с 0).

setImageLoader(Object implements ImageLoader) — установка загрузчика изображений (после доработки сторонних библиотек можно будет загружать сетевые изображения).

Пример работы

Версионирование

• v0.2.0-alpha
  1. Исправлено поведение индикатора баннера.
  2. Исправлена проблема плавности при переходах между экранами.
  3. Исправлены проблемы с названием.
  4. Оптимизирован пример использования.#### Информация о правах и лицензиях banner_ohos распространяется под лицензией Apache License, Version 2.0.