KYBarrageKit

Это библиотека для рендеринга баражжей (заголовков, титров) с расширенными возможностями для iOS. Она предназначена для использования в прямых трансляциях и позволяет создавать различные анимационные эффекты.

Причины создания

Компания занимается прямыми трансляциями, и её продукты должны взаимодействовать с баражжами в режиме реального времени. В соответствии с потребностями продуктов были созданы колёса на основе некоторых проектов с открытым исходным кодом. Библиотека KYBarrageKit была разработана для удовлетворения функциональных требований продуктов компании.

Особенности

• Поддержка четырёх направлений прокрутки баражжей.
• Возможность настраивать скорость прокрутки.
• Поддержка информации типа NSMutableAttributedString, включая картинки и текст, эмодзи и смайлики.
• При использовании типа KYBarrageDisplayTypeImage можно настроить высоту баражжа.
• Типы могут быть расширены (в настоящее время поддерживаются обычный текст и графика).
• Использование CABasicAnimation для достижения анимационных эффектов в баражжах.
• Поддерживает пакетную отправку баражжей, паузу, перезапуск, удаление и запуск.
• Предотвращает потерю данных при нехватке памяти.

Для реализации некоторых основных функций планируется дальнейшее улучшение функциональности.

Эффект

Наглядный пример эффекта:

Обратная связь

Если вам нужна помощь, вы можете связаться со мной или использовать QQ: 362108564.

При обнаружении ошибки создайте задачу на GitHub.

Если у вас есть запрос на новую функцию, также создайте задачу на GitHub.

Если вы хотите внести свой вклад, отправьте запрос на изменение кода.

Вы можете обратиться ко мне, если считаете, что что-то не так или у вас есть лучшее предложение.

Установка

Требования

Xcode 7 и выше. iOS 7.0 и выше.

Инструкция по установке

Скачайте проект с GitHub и импортируйте папку KYBarrageKit в свой проект. Затем импортируйте файл заголовка KYBarrageKit.h.

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

Добавьте следующую строку кода в Podfile, чтобы использовать CocoaPods:

pod 'KYBarrageKit'

Используйте CocoaPods для управления сторонними библиотеками. Если на вашем компьютере не установлен CocoaPods, установите его. Метод установки можно найти здесь: [последняя версия установки CocoaPods] (http://blog.sina.com.cn/s/blog_6ff6523d0102x8dq.html).

Применение

Чтобы использовать локальный рендеринг баражжей:

1. Импортируйте «KYBarrageKit».
2. Создайте объект KYBarrageManager *manager и добавьте представление, в которое вы хотите добавить анимацию баражжей. Пример кода:

@interface ViewController ()
@property (strong, nonatomic) KYBarrageManager *manager;

@end

@implementation ViewController

- (void)viewDidLoad {
  [super viewDidLoad];
  // Do any additional setup after loading the view, typically from a nib.
   self.view.backgroundColor = [UIColor whiteColor];
    _manager = [KYBarrageManager manager];
    _manager.bindingView = self.view;
    _manager.scrollSpeed = 30;     
    _manager.refreshInterval = 1.0;  
}

3. Отправьте баражж:

int a = arc4random() % 100000;
NSString *str = [NSString stringWithFormat:@"I'm coming %d ",a];

NSMutableAttributedString *attr = [[NSMutableAttributedString alloc] initWithString:str];
[attr addAttribute:NSForegroundColorAttributeName value:RandomColor() range:NSMakeRange(0, str.length)];

KYBarrageModel *m = [[KYBarrageModel alloc] initWithBarrageContent:attr];
[_manager showBarrageWithDataSource:m]; // Scroll Barrage 

4. Настройте область отображения баражжей. Поддерживается четыре направления, по умолчанию используется вся область отображения KYBarrageDisplayLocationTypeDefault.

Глобальная настройка:

_manager.displayLocation = KYBarrageDisplayLocationTypeTop;  

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

KYBarrageModel *m = [[KYBarrageModel alloc] initWithBarrageContent:attr];
m.displayLocation       = _manager.