Подключение и настройка Android SDK

Этот раздел описывает шаги по подключению библиотек Teleport SDK к вашему Android-проекту и базовую конфигурацию сетевой безопасности.

1. Подключение библиотек

Для использования Teleport SDK необходимо добавить репозиторий и соответствующие зависимости в ваш проект.

Добавление репозитория

Перед добавлением зависимостей убедитесь, что в вашем файле build.gradle (уровня проекта или модуля) добавлен репозиторий Teleport:

// build.gradle (Project-level) или settings.gradle
repositories {
    maven("https://sdk.teleport.media/artifactory/android/")
}

Добавление зависимостей

В файле build.gradle вашего модуля (app/build.gradle) добавьте следующие зависимости:

• TeleportCore: для работы с основными методами SDK.
• TeleportExoPlayer или TeleportMedia3: для интеграции с соответствующим плеером.

implementation("com.teleport:core:0.7.0") // Основной SDK

// Выберите один из вариантов в зависимости от используемого плеера:
implementation("com.teleport:exoplayer:0.7.0") // Для интеграции с ExoPlayer
// или
implementation("com.teleport:media3:0.7.0")    // Для интеграции с Media3

Актуальные версии

Убедитесь, что вы используете актуальные версии библиотек. Актуальные версии всегда указаны в обзоре Android SDK.

2. Конфигурация сетевой безопасности

Depricated начиная с версии 0.7.0

Teleport SDK может выполнять сетевые запросы к localhost для оптимизации работы. Для этого необходимо разрешить незашифрованный трафик для адреса 127.0.0.1 через настройки сетевой безопасности вашего приложения.

Важно

Неправильная настройка сетевой безопасности может привести к проблемам с подключением и функционированием Teleport SDK.

Вариант 1: Использование network_security_config.xml (рекомендуется)

Создайте файл res/xml/network_security_config.xml со следующим содержимым:

<!-- res/xml/network_security_config.xml -->
<?xml version="1.0" encoding="utf-8"?>
<network-security-config>
    <domain-config cleartextTrafficPermitted="true">
        <domain includeSubdomains="true">127.0.0.1</domain>
    </domain-config>
</network-security-config>

Затем добавьте ссылку на этот файл в тег <application> вашего AndroidManifest.xml:

<!-- AndroidManifest.xml -->
<application
    android:networkSecurityConfig="@xml/network_security_config"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.YourApp">
    <!-- ... другие элементы ... -->
</application>

Вариант 2: Использование флага android:usesCleartextTraffic (менее безопасно)

В качестве альтернативы вы можете добавить флаг android:usesCleartextTraffic="true" непосредственно в тег <application> вашего AndroidManifest.xml. Этот метод менее предпочтителен, так как он разрешает весь незашифрованный трафик для всего приложения.

<!-- AndroidManifest.xml -->
<application
    android:usesCleartextTraffic="true"
    android:icon="@mipmap/ic_launcher"
    android:label="@string/app_name"
    android:roundIcon="@mipmap/ic_launcher_round"
    android:supportsRtl="true"
    android:theme="@style/Theme.YourApp">
    <!-- ... другие элементы ... -->
</application>