book_path: /distribute/other-docs/_book.yaml project_path: /distribute/other-docs/_project.yaml
В этом руководстве описано, как начать работу с интеграцией Engage SDK для телевизоров. После выполнения подготовительных действий, описанных на этой странице, вы сможете интегрировать одну или несколько функций телевизора:
- Опубликовать Продолжить просмотр данных
- Публикация прав доступа к устройствам
- Опубликовать рекомендации
Предварительная работа
Прежде чем начать, выполните следующие шаги:
Проявите заинтересованность в разработке API для поиска видео , чтобы, при наличии соответствующих условий, записаться на программу.
Убедитесь, что ваше приложение ориентировано на Android 4.4 (уровень API 19) или выше для этой интеграции.
Добавьте библиотеку
com.google.android.engageв свое приложение:Для интеграции используются отдельные SDK: один для мобильных приложений и один для приложений для телевизоров.
Мобильный
dependencies { implementation 'com.google.android.engage:engage-core:1.5.11' }ТВ
dependencies { implementation 'com.google.android.engage:engage-tv:1.0.5' }Добавить разрешение
WRITE_EPG_DATAдля APK-файла ТВ<uses-permission android:name="com.android.providers.tv.permission.WRITE_EPG_DATA" />Для проверки надежности публикации контента используйте фоновую службу, например
androidx.work, для планирования.Проверьте свою реализацию, используя приложение для проверки, как описано в разделе «Тестирование» .
В рабочем приложении установите для среды службы Engage значение production в файле
AndroidManifest.xml.<meta-data android:name="com.google.android.engage.service.ENV" android:value="PRODUCTION" />
Общие этапы интеграции
Инициализация клиента
Для взаимодействия со службой используйте AppEngagePublishClient . Всегда проверяйте доступность службы перед публикацией.
val client = AppEngagePublishClient(context)
client.isServiceAvailable().addOnCompleteListener { task ->
if (task.isSuccessful && task.result) {
// Service is available, proceed with publishing
} else {
// Service is not available or call failed
}
}
Создать профиль учетной записи
AccountProfile идентифицирует пользователя. Вы можете указать идентификатор учетной записи, а также, при необходимости, идентификатор профиля и языковые настройки.
val accountProfile = AccountProfile.Builder()
.setAccountId("your_users_account_id")
.setProfileId("your_users_profile_id") // Optional
.setLocale(Locale.US.toLanguageTag()) // Optional, e.g., "en-US"
.build()
Тестирование
Чтобы проверить интеграцию, скачайте приложение для проверки:
Скачайте приложение для верификации
Приложение для проверки — это приложение для Android, обладающее возможностями для тестирования вашей интеграции. Оно позволяет проверить точность данных и корректность работы, подтверждая опубликованные данные и транслируемые намерения перед запуском.
- Установите и откройте приложение Engage Verification.
- Если значение параметра
isServiceAvailableв приложении для проверки равноfalse, нажмите кнопку «Переключить» в приложении для проверки, чтобы установить его значение равнымtrue. - Введите название пакета вашего приложения. Оно автоматически отобразит опубликованные данные.
- Запустите приложение и выполняйте действия по его публикации, например, вход в систему или просмотр видео.
- Убедитесь, что данные отображаются в приложении для проверки.
Скачать
Перед загрузкой вы должны согласиться со следующими условиями.