投放選項

如要設定應用程式的 Cast 工作階段，請提供 OptionsProvider。使用供應商建構的 CastOptions 物件設定接收器應用程式 ID、管理工作階段生命週期，以及自訂媒體播放行為。

使用預設選項提供者

如要使用預設 Cast 接收器應用程式進行基本設定，請在應用程式的 AndroidManifest.xml 檔案中新增 DefaultCastOptionsProvider：

<application>
  ...
  <meta-data
    android:name="com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
    android:value="androidx.media3.cast.DefaultCastOptionsProvider" />
  ...
</application>

建立自訂選項供應程式

如要進行更進階的設定，例如設定自訂接收器應用程式 ID，您必須自行建立 OptionsProvider。

1. 在資訊清單中宣告供應器

首先，請在 AndroidManifest.xml 中宣告自訂供應商。請務必使用完整的類別名稱。

<application>
  ...
  <meta-data
    android:name="com.google.android.gms.cast.framework.OPTIONS_PROVIDER_CLASS_NAME"
    android:value="path.to.your.class.MyCustomCastOptionsProvider" />
  ...
</application>

2. 實作 OptionsProvider 介面

接著，請建立實作 OptionsProvider 介面的類別。在這個類別中，您必須覆寫 getCastOptions()，才能傳回 CastOptions 例項。您可以在自訂 OptionsProvider 類別中設定 Cast 工作階段，例如設定自訂接收端應用程式 ID。

詳情請參閱 CastOptions.Builder。

Kotlin

class MyCustomCastOptionsProvider : OptionsProvider {

  override fun getCastOptions(context: Context): CastOptions {
    return CastOptions.Builder()
      .setReceiverApplicationId(APP_ID)
      .setRemoteToLocalEnabled(true)
      .build()
  }

  override fun getAdditionalSessionProviders(context: Context): List<SessionProvider>? {
    return null
  }

  companion object {
    // Add your receiver app ID in <APP_ID>.
    private const val APP_ID = "<APP_ID>"
  }
}
CustomizeCastOptions.kt

Java

public static final class MyCustomCastOptionsProvider implements OptionsProvider {

  // Add your receiver app ID in <APP_ID>.
  public static final String APP_ID = "<APP_ID>";

  @Override
  public CastOptions getCastOptions(Context context) {
    return new CastOptions.Builder()
        .setReceiverApplicationId(APP_ID)
        .setRemoteToLocalEnabled(true)
        .build();
  }

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