Перенос приложения Android Sender из Cast SDK v2 в Cast Application Framework (CAF)

Следующая процедура позволяет преобразовать приложение Android-отправителя из Cast SDK v2 в CAF Sender, основанное на синглтоне CastContext .

SDK Cast CAF Sender использует CastContext для управления GoogleAPIClient от вашего имени. CastContext управляет жизненными циклами, ошибками и обратными вызовами, что значительно упрощает разработку приложения Cast.

Введение

  • CAF Sender по-прежнему распространяется в составе сервисов Google Play с помощью менеджера Android SDK.
  • Добавлены новые пакеты, которые берут на себя ответственность за соблюдение контрольного списка Google Cast Design ( com.google.android.gms.cast.framework.* ).
  • CAF Sender предоставляет виджеты, соответствующие требованиям Cast UX; Версия 2 не содержала никаких компонентов пользовательского интерфейса и требовала реализации этих виджетов.
  • Для использования Cast API больше не требуется использование GoogleApiClient.
  • Скрытые субтитры в CAF Sender аналогичны версии 2.

Зависимости

V2 и CAF имеют те же зависимости от библиотек поддержки и служб Google Play (9.2.0 или более поздних версий), как описано в Руководстве по функциям библиотеки поддержки.

Минимальная версия Android SDK, которую поддерживает CAF, — 9 (Gingerbread).

Инициализация

В CAF для платформы Cast требуется явный шаг инициализации. Это включает в себя инициализацию синглтона CastContext с использованием соответствующего OptionsProvider для указания идентификатора приложения веб-приемника и любых других глобальных параметров.

public class CastOptionsProvider implements OptionsProvider {

    @Override
    public CastOptions getCastOptions(Context context) {
        return new CastOptions.Builder()
                .setReceiverApplicationId(context.getString(R.string.app_id))
                .build();
    }

    @Override
    public List<SessionProvider> getAdditionalSessionProviders(Context context) {
        return null;
    }
}

Объявите OptionsProvider в теге application файла AndroidManifest.xml приложения:

<application>
...
    <meta-data
        android:name=
            "com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
        android:value="com.google.sample.cast.refplayer.CastOptionsProvider" />
</application>

Лениво инициализируйте CastContext в методе onCreate каждого действия:

private CastContext mCastContext;

protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.video_browser);
    setupActionBar();

    mCastContext = CastContext.getSharedInstance(this);
}

Эти шаги не были необходимы в v2.

Обнаружение устройства

В CAF процесс обнаружения запускается и останавливается платформой автоматически, когда приложение переходит на передний план и переходит в фоновый режим соответственно. MediaRouteSelector и MediaRouter.Callback не следует использовать.

Кнопка трансляции и диалоговое окно трансляции

Как и в v2, эти компоненты предоставляются библиотекой поддержки MediaRouter .

Кнопка Cast по-прежнему реализуется с помощью MediaRouteButton и может быть добавлена ​​в вашу активность (с помощью ActionBar или Toolbar ) в качестве пункта меню в вашем меню.

<item
    android:id="@+id/media_route_menu_item"
    android:title="@string/media_route_menu_title"
    app:actionProviderClass="android.support.v7.app.MediaRouteActionProvider"
    app:showAsAction="always"/>

Переопределите метод onCreateOptionMenu() каждого действия, используя CastButtonFactory для подключения MediaRouteButton к платформе Cast:

private MenuItem mediaRouteMenuItem;

public boolean onCreateOptionsMenu(Menu menu) {
    super.onCreateOptionsMenu(menu);
    getMenuInflater().inflate(R.menu.browse, menu);
    mediaRouteMenuItem =
        CastButtonFactory.setUpMediaRouteButton(getApplicationContext(),
                                                menu,
                                                R.id.media_route_menu_item);
    return true;
}

Когда кто-то нажимает кнопку, автоматически открывается диалоговое окно трансляции.

Управление устройством

В CAF управление устройствами в основном осуществляется платформой. Приложению-отправителю не нужно обрабатывать (и не должно пытаться это делать) подключение к устройству и запуск приложения веб-приемника с помощью GoogleApiClient . Взаимодействие между отправителем и веб-получателем теперь представлено как «сеанс». Класс SessionManager управляет жизненным циклом сеанса и автоматически запускает и останавливает сеансы в ответ на жесты пользователя: сеанс запускается, когда пользователь выбирает устройство трансляции в диалоговом окне трансляции, и завершается, когда пользователь нажимает кнопку «Остановить трансляцию» в диалоговом окне трансляции. диалоговое окно или когда само приложение-отправитель завершает работу. Приложение-отправитель может быть уведомлено о событиях жизненного цикла сеанса, зарегистрировав SessionManagerListener с помощью SessionManager . Обратные вызовы SessionManagerListener определяют методы обратного вызова для всех событий жизненного цикла сеанса.

Класс CastSession представляет сеанс с устройством Cast. В классе есть методы для управления громкостью устройства и состояниями отключения звука, что ранее было сделано в версии 2 с использованием методов Cast.CastApi .

В версии 2 обратные вызовы Cast.Listener предоставляли уведомления об изменениях состояния устройства, включая громкость, состояние отключения звука, состояние ожидания и т. д.

В CAF уведомления об изменении состояния громкости/отключения звука по-прежнему доставляются через методы обратного вызова в Cast.Listener ; эти прослушиватели зарегистрированы в CastSession . Все остальные уведомления о состоянии устройства доставляются через обратные вызовы CastStateListener ; эти прослушиватели зарегистрированы в CastSession . Убедитесь, что вы по-прежнему отменяете регистрацию прослушивателей, когда связанные фрагменты, действия или приложения переходят в фоновый режим.

Логика переподключения

Как и в версии 2, CAF пытается восстановить сетевые соединения, потерянные из-за временной потери сигнала Wi-Fi или других сетевых ошибок. Теперь это делается на уровне сеанса; сеанс может перейти в «приостановленное» состояние при потере соединения и вернуться в «подключенное» состояние при восстановлении соединения. В рамках этого процесса платформа обеспечивает повторное подключение к приложению веб-приемника и повторное подключение любых каналов Cast.

Кроме того, CAF также добавляет автоматическое возобновление сеанса, которое включено по умолчанию (и может быть отключено с помощью CastOptions . Если приложение-отправитель отправляется в фоновый режим или завершается (путем смахивания или из-за сбоя) во время сеанса Cast в процессе платформа попытается возобновить этот сеанс, когда приложение-отправитель вернется на передний план или перезапустится; это автоматически обрабатывается SessionManager , который выполнит соответствующие обратные вызовы для всех зарегистрированных экземпляров SessionManagerListener .

Регистрация пользовательского канала

В версии 2 пользовательские каналы (реализованные с помощью Cast.MessageReceivedCallback ) регистрируются с помощью Cast.CastApi . В CAF пользовательские каналы вместо этого регистрируются в экземпляре CastSession . Регистрация может быть выполнена в методе обратного вызова SessionManagerListener.onSessionStarted . Для мультимедийных приложений больше нет необходимости явно регистрировать канал управления мультимедиа через Cast.CastApi.setMessageReceivedCallbacks ; более подробную информацию см. в следующем разделе.

Контроль СМИ

Класс RemoteMediaPlayer версии 2 устарел и не должен использоваться. В CAF его заменяет новый класс RemoteMediaClient , который обеспечивает эквивалентную функциональность в более удобном API. Нет необходимости явно инициализировать или регистрировать этот объект; платформа автоматически создаст экземпляр объекта и зарегистрирует базовый медиа-канал во время начала сеанса, если подключаемое приложение веб-приемника поддерживает пространство имен мультимедиа.

Доступ RemoteMediaClient можно получить как метод getRemoteMediaClient объекта CastSession .

В версии 2 все медиа-запросы, отправленные в RemoteMediaPlayer возвращали RemoteMediaPlayer.MediaChannelResult через обратный вызов PendingResult .

В CAF все медиа-запросы, отправленные на RemoteMediaClient возвращают RemoteMediaClient.MediaChannelResult через обратный вызов PendingResult , который можно использовать для отслеживания хода выполнения и конечного результата запроса.

RemoteMediaPlayer v2 будет отправлять уведомления об изменениях в состоянии медиаплеера на веб-приемнике через RemoteMediaPlayer.OnStatusUpdatedListener .

В CAF RemoteMediaClient предоставляет эквивалентные обратные вызовы через интерфейс RemoteMediaClient.Listener . В RemoteMediaClient можно зарегистрировать любое количество прослушивателей, что позволяет нескольким компонентам-отправителям совместно использовать один экземпляр RemoteMediaClient , связанный с сеансом.

В версии 2 приложение-отправитель должно было взять на себя бремя синхронизации пользовательского интерфейса с состоянием медиаплеера на веб-приемнике.

В CAF большую часть этой ответственности берет на себя класс UIMediaController .

Вводное наложение

Версия 2 не предоставляет вводного пользовательского интерфейса.

CAF предоставляет настраиваемое представление IntroductoryOverlay для выделения кнопки трансляции, когда она впервые отображается пользователям.

Мини-контроллер

В версии 2 вам необходимо с нуля реализовать мини-контроллер в приложении-отправителе.

В CAF SDK предоставляет настраиваемое представление MiniControllerFragment , которое можно добавить в файл макета приложения действий, в которых вы хотите отобразить мини-контроллер.

Уведомления и экран блокировки

В версии 2 контроллеры для уведомлений и экрана блокировки не входят в состав SDK. Для этого SDK вам необходимо встроить эти функции в приложение-отправитель с помощью API-интерфейсов платформы Android.

В CAF SDK предоставляет NotificationsOptions.Builder , который поможет вам создать элементы управления мультимедиа для уведомлений и экрана блокировки в приложении-отправителе. Элементы управления уведомлениями и экраном блокировки можно включить с помощью CastOptions при инициализации CastContext .

public CastOptions getCastOptions(Context context) {
    NotificationOptions notificationOptions = new NotificationOptions.Builder()
            .setTargetActivityClassName(VideoBrowserActivity.class.getName())
            .build();
    CastMediaOptions mediaOptions = new CastMediaOptions.Builder()
            .setNotificationOptions(notificationOptions)
            .build();

    return new CastOptions.Builder()
            .setReceiverApplicationId(context.getString(R.string.app_id))
            .setCastMediaOptions(mediaOptions)
            .build();
}

Расширенный контроллер

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

CAF предоставляет вспомогательный класс UIMediaController , который упрощает создание собственного расширенного контроллера.

CAF добавляет предварительно созданный расширенный виджет контроллера ExpandedControllerActivity , который вы можете просто добавить в свое приложение. Вам больше не нужно реализовывать собственный расширенный контроллер с помощью UIMediaController .

Аудио фокус

В версии 2 вам необходимо использовать MediaSessionCompat для управления фокусом звука.

В CAF аудиофокус управляется автоматически.

Ведение журнала отладки

В CAF нет опций ведения журнала.

Примеры приложений

У нас есть учебные пособия по кодированию и примеры приложений , использующих CAF.