OSCHINA-MIRROR/HarmonyOS-tpc-circular-music-progressbar

Данную библиотеку с открытым исходным кодом взяли с GitHub, выполнив форк. В основном изменили реализацию вызовов интерфейса нижнего уровня на реализацию интерфейса Хунмэн. Библиотека была «хунмэнизирована» для использования разработчиками приложений Хунмэн.

Версия форка: 1.4.0. Дата: 25 апреля 2018 года.

Circular Music ProgressBar

Описание: demo демонстрация.

Адрес оригинального Readme проекта: https://github.com/aliab/circular-music-progressbar/blob/master/README.md.

Состояние переноса проекта: поддерживается вся основная функциональность компонентов.

Степень готовности: 100%.

Различия в вызовах: из-за того, что интерфейс Path в Хунмэн не предоставляет метод approximate, в динамическом индикаторе различий невозможно использовать индикатор различий Path.

Данный Circular Progress Bar разработан и создан для музыкальных проигрывателей, которым нужен красивый индикатор выполнения музыки.

Использование

Чтобы использовать Circular Music ProgressBar, необходимо добавить его как зависимость в сборку Gradle:

Шаг 1. Добавьте репозиторий JitPack в файл сборки. Добавьте его в корневой файл build.gradle в конце репозиториев:

allprojects {
    repositories {
        mavenCentral()
    }
}

или

dependencies {
       compile project(path: ':library')
}

Затем добавьте представление в свой макет:

<info.abdolahi.CircularMusicProgressBar
                ohos:id="$+id:album_art"
                ohos:height="300vp"
                ohos:width="match_parent"
                ohos:image_src="$media:maron5"
                ohos:layout_alignment="center"
                ohos:top_margin="40vp"
                ohos:border_color="#00796B"
                ohos:border_width="2vp"
                ohos:centercircle_diammterer=".97"
                ohos:draw_anticlockwise="false"
                ohos:enable_touch="true"
                ohos:progress_music_color="#80CBC4"
                ohos:progress_startAngle="-90"
/>

Имя	Тип	По умолчанию	Описание
border_color	Цвет	Color.BLACK	Цвет фона индикатора выполнения
border_width	размер	2	Толщина индикатора выполнения
centercircle_diameterer	Float	0.805f	Число от 0 до 1, которое изменяет диаметр изображения обложки альбома
progress_music_color	Цвет	Color.BLUE	Активный цвет состояния индикатора выполнения
progress_startAngle	Float	0	Число от 0 до 360, описывающее начальный угол активного состояния индикатора выполнения
draw_anticlockwise	Логическое значение	false	Если установлено значение true, прогресс будет против часовой стрелки
enable_touch	Логическое значение	false	Если установлено значение true, прогресс будет отслеживаться при касании

Общедоступные методы

Имя	Описание
setValue(float)	Изменить значение прогресса с анимацией
setValueWithNoAnimation(float)	Изменить значение прогресса без анимации
setBorderProgressColor(Color)	Установить активный цвет состояния progressbar
setBorderColor(Color)	Установить неактивный цвет состояния progressbar
setProgressAnimationState(boolean)	Измените состояние анимации значения прогресса. Установите значение «false», если вы не хотите анимации
setProgressAnimatorInterpolator(TimeInterpolator)	Измените интерполятор анимации, чтобы получить больший эффект от анимации
setOnCircularBarChangeListener(OnCircularSeekBarChangeListener listener)	Получайте обновления, если пользователь хочет перейти к позиции или нажать на изображение

Примечание: поскольку я расширил ImageView, вы также можете использовать все общедоступные методы ImageView.

Ограничения

ScaleType всегда ScaleMode.CLIP_CENTER, и вы получите исключение, если попытаетесь изменить его. Это (в настоящее время) сделано намеренно, так как это идеально подходит для обложек музыкальных альбомов.
Если вы используете библиотеку загрузки изображений, такую как Picasso или Glide, вам необходимо отключить их анимацию затухания, чтобы избежать искажённых изображений. Для Picasso используйте опцию noFade(), для Glide используйте dontAnimate(). Если вы хотите сохранить анимацию fadeIn, вы должны загрузить изображение в Target и применить собственную анимацию при получении Bitmap.
Использование TransitionDrawable с CircleImageView работает неправильно и приводит к искажённым изображениям.

Лицензия

   The MIT License (MIT)
   
   Copyright (c) 2017 Ali Abdolahi
   
   Permission is hereby granted, free of charge, to any person obtaining a copy
   of this software and associated documentation files (the "Software"), to deal
   in the Software without restriction, including without limitation the rights
   to use, copy, modify, merge, publish, distribute, sublicense,

...
``` и/или продавать
копии ПО, а также разрешать лицам, которым ПО предоставлено, делать это при соблюдении следующих условий:

В каждую копию или значительную часть ПО должны быть включены вышеуказанное уведомление об авторских правах и данное уведомление о разрешении.

ПО ПРЕДОСТАВЛЯЕТСЯ «КАК ЕСТЬ», БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ, ЯВНЫХ ИЛИ ПОДРАЗУМЕВАЕМЫХ, ВКЛЮЧАЯ, НО НЕ ОГРАНИЧИВАЯСЬ ГАРАНТИЯМИ ТОВАРНОЙ ПРИГОДНОСТИ, СООТВЕТСТВИЯ КОНКРЕТНОЙ ЦЕЛИ И НАЛИЧИЯ ПРАВ. НИ ПРИ КАКИХ ОБСТОЯТЕЛЬСТВАХ АВТОРЫ ИЛИ ПРАВООБЛАДАТЕЛИ НЕ НЕСУТ ОТВЕТСТВЕННОСТИ ЗА ЛЮБЫЕ ПРЕТЕНЗИИ, УЩЕРБ ИЛИ ДРУГИЕ ОБЯЗАТЕЛЬСТВА, ВОЗНИКАЮЩИЕ ИЗ, СВЯЗАННЫЕ С ПО ИЛИ ИСПОЛЬЗОВАНИЕМ ПО ИЛИ ИНЫМИ ОПЕРАЦИЯМИ, СОВЕРШАЕМЫМИ В ОТНОШЕНИИ ПО.