Tùy chọn truyền

Để định cấu hình phiên Truyền của ứng dụng, hãy cung cấp OptionsProvider. Sử dụng đối tượng CastOptions do nhà cung cấp tạo để đặt mã ứng dụng nhận, quản lý vòng đời của phiên và tuỳ chỉnh hành vi phát nội dung nghe nhìn.

Sử dụng nhà cung cấp tuỳ chọn mặc định

Để thiết lập cơ bản bằng ứng dụng nhận Cast mặc định, hãy thêm DefaultCastOptionsProvider vào tệp AndroidManifest.xml của ứng dụng:

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

Tạo trình cung cấp lựa chọn tuỳ chỉnh

Để có cấu hình nâng cao hơn, chẳng hạn như đặt mã ứng dụng nhận tuỳ chỉnh, bạn cần tạo OptionsProvider của riêng mình.

1. Khai báo nhà cung cấp trong tệp kê khai

Trước tiên, hãy khai báo nhà cung cấp tuỳ chỉnh trong AndroidManifest.xml. Hãy nhớ sử dụng tên lớp đủ điều kiện.

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

2. Triển khai giao diện OptionsProvider

Tiếp theo, hãy tạo một lớp triển khai giao diện OptionsProvider. Trong lớp này, bạn phải ghi đè getCastOptions() để trả về một thực thể CastOptions. Lớp OptionsProvider tuỳ chỉnh là nơi bạn định cấu hình phiên Truyền, ví dụ: bằng cách đặt mã ứng dụng nhận tuỳ chỉnh.

Để biết thêm thông tin, hãy xem 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>"
  }
}

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
  public @Nullable List<SessionProvider> getAdditionalSessionProviders(Context context) {
    return null;
  }
}