為 Android 應用程式新增進階功能

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

廣告插播時間點

Android 傳送者 SDK 支援特定媒體串流中的廣告插播和隨播廣告。

如要進一步瞭解廣告插播的運作方式,請參閱網站接收器廣告插播總覽

雖然在傳送者和接收者都能指定中斷點,但我們建議將其在網路接收器Android TV 接收器中指定,以便在各個平台上維持一致的行為。

在 Android 上,使用 AdBreakClipInfoAdBreakInfo 在載入指令中指定廣告插播:

Kotlin
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)
Java
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" />
Kotlin
// 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) {
    }
}
Java
// 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 介面實作自訂管道:

Kotlin
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")
    }
}
Java
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 方法建立自訂管道:

Kotlin
try {
    mCastSession.setMessageReceivedCallbacks(
        mHelloWorldChannel.namespace,
        mHelloWorldChannel)
} catch (e: IOException) {
    Log.e(TAG, "Exception while creating channel", e)
}
Java
try {
    mCastSession.setMessageReceivedCallbacks(
            mHelloWorldChannel.getNamespace(),
            mHelloWorldChannel);
} catch (IOException e) {
    Log.e(TAG, "Exception while creating channel", e);
}

建立自訂管道後,傳送方可以使用 sendMessage 方法,透過管道將字串訊息傳送至接收端:

Kotlin
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)
        }
    }
}
Java
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」一節。

覆寫使用者體驗小工具的圖片選項

架構的各種元件 (也就是投放對話方塊、迷你控制器和 UIMediaController (如有設定) 將會顯示目前投放媒體的藝術品。一般來說,媒體圖片的網址包含於媒體的 MediaMetadata 中,但傳送者應用程式可能會有網址的替代來源。

ImagePicker 類別定義了根據圖片的用途,從 MediaMetadata 的圖片清單中選取適當的圖片,例如通知縮圖或全螢幕背景。預設的 ImagePicker 實作一律選擇第一張圖片,如果 MediaMetadata 中沒有圖片,則傳回空值。應用程式可將 ImagePicker 設為子類別,並覆寫 onPickImage(MediaMetadata, ImageHints) 方法以提供替代實作方式,再使用 CastMediaOptions.BuildersetImagePicker 方法選取該子類別。ImageHintsImagePicker 提供提示,指出要在使用者介面中顯示的圖片類型和大小。

自訂投放對話方塊

SessionManager 是管理工作階段生命週期的核心位置。SessionManager 會監聽 Android MediaRouter 路徑選取狀態變更,以開始、繼續和結束工作階段。選取路徑之後,SessionManager 會建立 Session 物件,並嘗試開始或繼續路徑。取消選取路徑時,SessionManager 會結束目前的工作階段。

因此,為了確保 SessionManager 能正確管理工作階段生命週期,請務必:

視您建立 Cast 對話方塊的方式而定,您可能需要執行其他動作:

後續步驟

以上是您可以新增至 Android 寄件者應用程式的功能。您現在可以為其他平台 (iOSWeb) 建構寄件者應用程式,或建構 Web Receiver 應用程式