VLC для Android

Это официальный порт Android приложения VLC.

VLC на Android воспроизводит все те же файлы, что и классическая версия VLC, и имеет медиа-базу данных для аудио- и видеофайлов и потоков.

• Структура проекта
• LibVLC
• Лицензия
• Сборка
  • Создание приложения
  • Сборка LibVLC
• Вклад в проект
  • Запросы на вытягивание
  • Переводы
• Проблемы и запросы функций
• Поддержка

Структура проекта

Вот текущие папки проекта vlc-android:

• extension-api: SDK расширений приложений (ещё не выпущен);
• application: исходный код приложения Android, организованный по модулям;
• buildsystem: скрипты сборки, конфигурация CI и публикации maven;
• libvlc: модуль gradle LibVLC, исходный код VLC будет клонирован в vlc/ на корневом уровне;
• medialibrary: модуль gradle Medialibrary.

LibVLC

LibVLC — это библиотека Android, включающая движок VLC, который предоставляет множество мультимедийных функций, таких как:

• Воспроизведение всех форматов медиафайлов, всех кодеков и всех протоколов потоковой передачи;
• Аппаратное и эффективное декодирование на любой платформе, вплоть до 8K;
• Сетевой просмотр удалённых файловых систем (SMB, FTP, SFTP, NFS...) и серверов (UPnP, DLNA);
• Проигрывание аудио CD, DVD и Bluray с навигацией по меню;
• Поддержка HDR, включая тонирование SDR потоков;
• Аудио сквозная передача с SPDIF и HDMI, включая аудио HD кодеки, такие как DD+, TrueHD или DTS-HD;
• Поддержка видео- и аудиофильтров;
• Поддержка 360-градусного видео и 3D-аудио воспроизведения, включая Ambisonics;
• Возможность трансляции и потоковой передачи на удалённые рендереры, такие как Chromecast и UPnP рендереры.

И многое другое.

Вы можете использовать наш модуль LibVLC для создания собственного медиаплеера Android. Посмотрите наши примеры кода.

Лицензия

VLC for Android лицензирован под GPLv2 (или более поздней версией). Библиотеки Android делают это де-факто приложением GPLv3.

Движок VLC (LibVLC) для Android лицензируется под LGPLv2.

Сборка

Собственные библиотеки публикуются на bintray. Таким образом, вы можете:

• Собрать приложение и получить библиотеки через зависимости gradle (только сборка JVM);
• Собрать всё приложение (LibVLC + Medialibrary + Application);
• Собрать только LibVLC и получить пакет .aar.

Создание приложения

Сборка VLC-Android зависит от режимов сборки gradle:

• Release и Debug получат LibVLC и Medialibrary из Bintray и соберут только исходный код приложения;
• SignedRelease также, но позволит вам подписать apk приложения локальным хранилищем ключей;
• Dev соберёт LibVLC, Medialibrary, а затем создаст приложение с этими двоичными файлами (через скрипты сборки только).

Сборка LibVLC

Вам потребуется недавний дистрибутив Linux для сборки VLC. Он должен работать с Windows 10 и macOS, но официальной поддержки этого нет.

Настройка

Проверьте нашу страницу AndroidCompile wiki, особенно для зависимостей сборки.

Вот основные моменты:

На Debian/Ubuntu установите необходимые зависимости:

sudo apt install automake ant autopoint cmake build-essential libtool-bin \
    patch pkg-config protobuf-compiler ragel subversion unzip git \
    openjdk-8-jre openjdk-8-jdk flex python wget

Настройте среду сборки: Установите $ANDROID_SDK, чтобы он указывал на каталог вашего Android SDK export ANDROID_SDK=/path/to/android-sdk

Установите $ANDROID_NDK, чтобы он указывал на ваш каталог Android NDK export ANDROID_NDK=/path/to/android-ndk

Теперь вы готовы к сборке!

Сборка

buildsystem/compile.sh -l -a <ABI>

ABI может быть arm, arm64, x86, x86_64 или all для мультиаби-сборки.

Можно сделать релизную сборку библиотеки с аргументом -r.

Medialibrary

Соберите Medialibrary с -ml вместо -l.

Вклад

VLC — открытый проект с открытым исходным кодом, мы приветствуем все вклады.

Просто соблюдайте наш Кодекс поведения. ### Пулл реквесты

Пулл реквесты должны быть предложены на нашем сервере GitLab (https://code.videolan.org/videolan/vlc-android/).

Поэтому вы должны создать аккаунт, форкнуть проект vlc-android и предложить свои запросы на слияние оттуда.

За исключением переводов, см. раздел ниже.

Переводы

Вы также можете помочь улучшить переводы, присоединившись к проекту transifex vlc (https://www.transifex.com/yaron/vlc-trans/dashboard/).

Запросы на объединение переводов генерируются на основе работы в Transifex.

Проблемы и запросы функций

Система отслеживания ошибок VLC для Android размещена на GitLab VideoLAN (https://code.videolan.org/videolan/vlc-android/issues).

Пожалуйста, ищите существующие проблемы и предоставьте как можно больше полезной информации (например, версию приложения vlc, устройство и версию Android).

Предоставляется шаблон, пожалуйста, используйте его!

Проблемы без соответствующей информации будут проигнорированы, в этом случае мы не сможем помочь.

Поддержка

— Список рассылки для пользователей Android: android@videolan.org; — Система отслеживания ошибок: https://code.videolan.org/videolan/vlc-android/issues; — IRC: #videolan канал на Freenode (http://freenode.net/); — Форум VideoLAN: https://forum.videolan.org/.