廣告插播時間點
Android Sender SDK 支援特定媒體串流中的廣告插播時間點和隨播廣告。
如要進一步瞭解廣告插播的運作方式,請參閱網站接收端廣告插播總覽。
雖然你可以在傳送端和接收器上指定休息時間,但建議在網路接收器和 Android TV 接收器中指定廣告插播時間點,以便在不同平台上維持一致的行為。
在 Android 上,使用 AdBreakClipInfo
和 AdBreakInfo
在載入指令中指定廣告插播:
val breakClip1: AdBreakClipInfo = AdBreakClipInfo.Builder("bc0") .setTitle("Clip title") .setPosterUrl("https://www.some.url") .setDuration(60000) .setWhenSkippableInMs(5000) // Set this field so that the ad is skippable .build() val breakClip2: AdBreakClipInfo = … val breakClip3: AdBreakClipInfo = … val break1: AdBreakClipInfo = AdBreakInfo.Builder(/* playbackPositionInMs= */ 10000) .setId("b0") .setBreakClipIds({"bc0","bc1","bc2"}) … .build() val mediaInfo: MediaInfo = MediaInfo.Builder() … .setAdBreaks({break1}) .setAdBreakClips({breakClip1, breakClip2, breakClip3}) .build() val mediaLoadRequestData: MediaLoadRequestData = MediaInfo.Builder() … .setMediaInfo(mediaInfo) .build() remoteMediaClient.load(mediaLoadRequestData)
AdBreakClipInfo breakClip1 = new AdBreakClipInfo.Builder("bc0") .setTitle("Clip title") .setPosterUrl("https://www.some.url") .setDuration(60000) .setWhenSkippableInMs(5000) // Set this field so that the ad is skippable .build(); AdBreakClipInfo breakClip2 = … AdBreakClipInfo breakClip3 = … AdBreakInfo break1 = new AdBreakInfo.Builder(/* playbackPositionInMs= */ 10000) .setId("b0") .setBreakClipIds({"bc0","bc1","bc2"}) … .build(); MediaInfo mediaInfo = new MediaInfo.Builder() … .setAdBreaks({break1}) .setAdBreakClips({breakClip1, breakClip2, breakClip3}) .build(); MediaLoadRequestData mediaLoadRequestData = new MediaInfo.Builder() … .setMediaInfo(mediaInfo) .build(); remoteMediaClient.load(mediaLoadRequestData);
新增自訂動作
傳送端應用程式可以擴充 MediaIntentReceiver
來處理自訂動作或覆寫其行為。如果您已實作自己的 MediaIntentReceiver
,則必須將其新增至資訊清單,並在 CastMediaOptions
中設定其名稱。這個範例提供自訂動作,可用於覆寫遠端媒體播放、按下媒體按鈕和其他類型的動作。
// In AndroidManifest.xml
<receiver android:name="com.example.MyMediaIntentReceiver" />
// In your OptionsProvider var mediaOptions = CastMediaOptions.Builder() .setMediaIntentReceiverClassName(MyMediaIntentReceiver::class.java.name) .build() // Implementation of MyMediaIntentReceiver internal class MyMediaIntentReceiver : MediaIntentReceiver() { override fun onReceiveActionTogglePlayback(currentSession: Session) { } override fun onReceiveActionMediaButton(currentSession: Session, intent: Intent) { } override fun onReceiveOtherAction(context: Context?, action: String, intent: Intent) { } }
// In your OptionsProvider CastMediaOptions mediaOptions = new CastMediaOptions.Builder() .setMediaIntentReceiverClassName(MyMediaIntentReceiver.class.getName()) .build(); // Implementation of MyMediaIntentReceiver class MyMediaIntentReceiver extends MediaIntentReceiver { @Override protected void onReceiveActionTogglePlayback(Session currentSession) { } @Override protected void onReceiveActionMediaButton(Session currentSession, Intent intent) { } @Override protected void onReceiveOtherAction(Context context, String action, Intent intent) { } }
新增自訂管道
如要讓傳送端應用程式與接收器應用程式通訊,您的應用程式需要建立自訂管道。傳送者可以使用自訂管道,傳送字串訊息給接收器。每個自訂管道都是由不重複的命名空間定義,而且開頭必須是 urn:x-cast:
,例如 urn:x-cast:com.example.custom
。可以有多個自訂管道,而每個管道的命名空間都不重複。接收器應用程式也可以使用相同的命名空間收發訊息。
自訂管道是透過 Cast.MessageReceivedCallback
介面實作:
class HelloWorldChannel : MessageReceivedCallback { val namespace: String get() = "urn:x-cast:com.example.custom" override fun onMessageReceived(castDevice: CastDevice, namespace: String, message: String) { Log.d(TAG, "onMessageReceived: $message") } }
class HelloWorldChannel implements Cast.MessageReceivedCallback { public String getNamespace() { return "urn:x-cast:com.example.custom"; } @Override public void onMessageReceived(CastDevice castDevice, String namespace, String message) { Log.d(TAG, "onMessageReceived: " + message); } }
傳送方應用程式連線至接收器應用程式後,您可以使用 setMessageReceivedCallbacks
方法建立自訂管道:
try { mCastSession.setMessageReceivedCallbacks( mHelloWorldChannel.namespace, mHelloWorldChannel) } catch (e: IOException) { Log.e(TAG, "Exception while creating channel", e) }
try { mCastSession.setMessageReceivedCallbacks( mHelloWorldChannel.getNamespace(), mHelloWorldChannel); } catch (IOException e) { Log.e(TAG, "Exception while creating channel", e); }
建立自訂管道後,傳送方可以使用 sendMessage
方法,透過該管道向接收器傳送字串訊息:
private fun sendMessage(message: String) { if (mHelloWorldChannel != null) { try { mCastSession.sendMessage(mHelloWorldChannel.namespace, message) .setResultCallback { status -> if (!status.isSuccess) { Log.e(TAG, "Sending message failed") } } } catch (e: Exception) { Log.e(TAG, "Exception while sending message", e) } } }
private void sendMessage(String message) { if (mHelloWorldChannel != null) { try { mCastSession.sendMessage(mHelloWorldChannel.getNamespace(), message) .setResultCallback( status -> { if (!status.isSuccess()) { Log.e(TAG, "Sending message failed"); } }); } catch (Exception e) { Log.e(TAG, "Exception while sending message", e); } } }
支援自動播放
請參閱「自動播放與佇列 API」一節。
覆寫使用者體驗小工具的圖片選取設定
架構的各個元件 (包括 Cast 對話方塊、小控制器和 UIMediaController,如有設定) 會顯示目前投放媒體的圖片。圖片的 MediaMetadata
中通常會包含圖片圖片的網址,但傳送端應用程式可能具有網址的替代來源。
ImagePicker
類別會根據圖片使用情形 (例如通知縮圖或全螢幕背景),定義從 MediaMetadata
圖片清單中選取適當圖片的方法。預設的 ImagePicker
實作一律會選擇第一張圖片;如果 MediaMetadata
中沒有圖片,則會傳回空值。您的應用程式可以對 ImagePicker
建立子類別,並覆寫 onPickImage(MediaMetadata, ImageHints)
方法以提供替代實作項目,然後使用 CastMediaOptions.Builder
的 setImagePicker
方法選取該子類別。ImageHints
針對要在 UI 中顯示的圖片類型和大小,向 ImagePicker
提供提示。
自訂 Cast 對話方塊
管理工作階段生命週期
SessionManager
是管理工作階段生命週期的核心。SessionManager
會監聽 Android MediaRouter
路徑選取狀態,變更開始、繼續和結束工作階段。選取路徑時,SessionManager
會建立 Session
物件,並嘗試啟動或繼續該物件。在取消選取路徑時,SessionManager
會結束目前的工作階段。
因此,為確保 SessionManager
妥善管理工作階段生命週期,您必須確保:
- 請在路徑選取器對話方塊中,在使用者選取裝置時呼叫
MediaRouter.selectRoute(MediaRouter.RouteInfo)
。 - 當使用者停止投放時,請在路徑控制器對話方塊 (處於連線狀態或投放狀態) 中呼叫
MediaRouter.unselect(int)
。
視建立 Cast 對話方塊的方式而定,可能需要完成其他動作:
- 如果您使用
MediaRouteChooserDialog
和MediaRouteControllerDialog
建立 Cast 對話方塊,這些對話方塊會自動更新MediaRouter
中的路徑選取項目,您無需採取任何動作。 - 如果您使用
CastButtonFactory.setUpMediaRouteButton(Context, Menu, int)
或CastButtonFactory.setUpMediaRouteButton(Context, MediaRouteButton)
設定「投放」按鈕,系統實際上會使用MediaRouteChooserDialog
和MediaRouteControllerDialog
建立對話方塊,因此您不必執行任何操作。 - 在其他情況下,您必須建立自訂 Cast 對話方塊,因此,您需要按照上述操作說明,更新
MediaRouter
中的路徑選取狀態。
零裝置狀態
如果您建立自訂 Cast 對話方塊,自訂 MediaRouteChooserDialog
應能妥善處理找不到裝置的情況。當應用程式仍嘗試尋找裝置,以及探索嘗試已失效時,對話方塊應向使用者清楚說明。
如果您使用預設的 MediaRouteChooserDialog
,表示系統已處理零的裝置狀態。
後續步驟
以上是可新增至 Android 寄件者應用程式的功能。您現在可以為其他平台 (iOS 或網頁版) 建構傳送端應用程式,或是建構Web Receiver 應用程式。