מחליף פלט

החלפת פלט היא תכונה של Cast SDK שמאפשרת העברה חלקה בין הפעלה מקומית של תוכן להפעלה מרחוק, החל מגרסה 13 של Android. המטרה היא לעזור לאפליקציות של השולחים לשלוט בקלות ובמהירות במקום שבו התוכן מושמע. מתג המעבר למכשיר אחר משתמש בספרייה MediaRouter כדי להעביר את הפעלת התוכן בין הרמקול של הטלפון, מכשירי Bluetooth מותאמים ומכשירים מרוחקים שתומכים ב-Cast. אפשר לפלח את התרחישים לדוגמה לפי התרחישים הבאים:

כדי להבין איך מטמיעים את החלפת הפלט באפליקציה, כדאי להוריד את האפליקציה לדוגמה CastVideos-android ולהשתמש בה.

צריך להפעיל את Output Switcher כדי לתמוך בהעברה מקומית-מרוחקת, מרחוק-מקומי ומרוחק-מרחוק, לפי השלבים שמפורטים במדריך הזה. אין צורך לבצע שלבים נוספים כדי לתמוך בהעברה בין הרמקולים המקומיים של המכשיר לבין מכשירי Bluetooth מותאמים.

ממשק המשתמש של Output Switcher

במתג היציאות מוצגים המכשירים המקומיים והמרוחקים שזמינים, וגם מצבי המכשירים הנוכחיים, כולל אם המכשיר נבחר, אם הוא מתחבר ורמת עוצמת הקול הנוכחית. אם יש מכשירים אחרים בנוסף למכשיר הנוכחי, לחיצה על 'מכשיר אחר' תאפשר להעביר את הפעלת המדיה למכשיר שנבחר.

בעיות מוכרות

  • סשנים של מדיה שנוצרו להפעלה מקומית ייסגרו וייווצרו מחדש כשעוברים להתרעה של Cast SDK.

נקודות כניסה

התראת מדיה

אם אפליקציה מפרסמת התראה על מדיה עם MediaSession להפעלה מקומית (הפעלה מקומית), בפינה השמאלית העליונה של ההתראה על המדיה יופיע צ'יפ התראה עם שם המכשיר (למשל, רמקול הטלפון) שבו התוכן מופעל כרגע. הקשה על צ'יפ ההתראה פותחת את ממשק המשתמש של תיבת הדו-שיח של Output Switcher.

הגדרות עוצמת הקול

אפשר גם להפעיל את ממשק המשתמש של תיבת הדו-שיח של Output Switcher בלחיצה על לחצני עוצמת הקול הפיזיים במכשיר, בהקשה על סמל ההגדרות בתחתית המסך ובהקשה על הטקסט 'הפעלת <שם האפליקציה> ב-<מכשיר ההעברה>'.

סיכום השלבים

דרישות מוקדמות

  1. העברת האפליקציה הקיימת ל-Android ל-AndroidX.
  2. מעדכנים את build.gradle של האפליקציה כך שייעשה שימוש בגרסה המינימלית הנדרשת של Android Sender SDK למתג הפלט:
    dependencies {
      ...
      implementation 'com.google.android.gms:play-services-cast-framework:21.2.0'
      ...
    }
  3. האפליקציה תומכת בהתראות על מדיה.
  4. מכשיר עם Android 13.

הגדרת התראות מדיה

כדי להשתמש בבורר הפלט, אפליקציות האודיו והווידאו צריכות ליצור התראה על מדיה כדי להציג את סטטוס ההפעלה ואת אמצעי הבקרה של המדיה שלהן להפעלה מקומית. לשם כך צריך ליצור MediaSession, להגדיר את MediaStyle עם הטוקן של MediaSession ולהגדיר את אמצעי הבקרה של המדיה בהתראה.

אם אתם לא משתמשים כרגע ב-MediaStyle וב-MediaSession, בקטע הקוד שבהמשך מוסבר איך להגדיר אותם. יש גם מדריכים להגדרת קריאות החזרה (callbacks) של סשן המדיה לאפליקציות אודיו ווידאו:

Kotlin
// Create a media session. NotificationCompat.MediaStyle
// PlayerService is your own Service or Activity responsible for media playback.
val mediaSession = MediaSessionCompat(this, "PlayerService")

// Create a MediaStyle object and supply your media session token to it.
val mediaStyle = Notification.MediaStyle().setMediaSession(mediaSession.sessionToken)

// Create a Notification which is styled by your MediaStyle object.
// This connects your media session to the media controls.
// Don't forget to include a small icon.
val notification = Notification.Builder(this@PlayerService, CHANNEL_ID)
    .setStyle(mediaStyle)
    .setSmallIcon(R.drawable.ic_app_logo)
    .build()

// Specify any actions which your users can perform, such as pausing and skipping to the next track.
val pauseAction: Notification.Action = Notification.Action.Builder(
        pauseIcon, "Pause", pauseIntent
    ).build()
notification.addAction(pauseAction)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    // Create a media session. NotificationCompat.MediaStyle
    // PlayerService is your own Service or Activity responsible for media playback.
    MediaSession mediaSession = new MediaSession(this, "PlayerService");

    // Create a MediaStyle object and supply your media session token to it.
    Notification.MediaStyle mediaStyle = new Notification.MediaStyle().setMediaSession(mediaSession.getSessionToken());

    // Specify any actions which your users can perform, such as pausing and skipping to the next track.
    Notification.Action pauseAction = Notification.Action.Builder(pauseIcon, "Pause", pauseIntent).build();

    // Create a Notification which is styled by your MediaStyle object.
    // This connects your media session to the media controls.
    // Don't forget to include a small icon.
    String CHANNEL_ID = "CHANNEL_ID";
    Notification notification = new Notification.Builder(this, CHANNEL_ID)
        .setStyle(mediaStyle)
        .setSmallIcon(R.drawable.ic_app_logo)
        .addAction(pauseAction)
        .build();
}

בנוסף, כדי לאכלס את ההתראה במידע על המדיה, צריך להוסיף את המטא-נתונים ומצב ההפעלה של המדיה ל-MediaSession.

כדי להוסיף מטא-נתונים ל-MediaSession, משתמשים ב-setMetaData() ומספקים את כל הקבועים הרלוונטיים של MediaMetadata של המדיה ב-MediaMetadataCompat.Builder().

Kotlin
mediaSession.setMetadata(MediaMetadataCompat.Builder()
    // Title
    .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title)

    // Artist
    // Could also be the channel name or TV series.
    .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist)

    // Album art
    // Could also be a screenshot or hero image for video content
    // The URI scheme needs to be "content", "file", or "android.resource".
    .putString(
        MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri)
    )

    // Duration
    // If duration isn't set, such as for live broadcasts, then the progress
    // indicator won't be shown on the seekbar.
    .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration)

    .build()
)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    mediaSession.setMetadata(
        new MediaMetadataCompat.Builder()
        // Title
        .putString(MediaMetadata.METADATA_KEY_TITLE, currentTrack.title)

        // Artist
        // Could also be the channel name or TV series.
        .putString(MediaMetadata.METADATA_KEY_ARTIST, currentTrack.artist)

        // Album art
        // Could also be a screenshot or hero image for video content
        // The URI scheme needs to be "content", "file", or "android.resource".
        .putString(MediaMetadata.METADATA_KEY_ALBUM_ART_URI, currentTrack.albumArtUri)

        // Duration
        // If duration isn't set, such as for live broadcasts, then the progress
        // indicator won't be shown on the seekbar.
        .putLong(MediaMetadata.METADATA_KEY_DURATION, currentTrack.duration)

        .build()
    );
}

כדי להוסיף את מצב ההפעלה ל-MediaSession, משתמשים ב-setPlaybackState() ומספקים את כל הקבועים הרלוונטיים של PlaybackStateCompat של המדיה ב-PlaybackStateCompat.Builder().

Kotlin
mediaSession.setPlaybackState(
    PlaybackStateCompat.Builder()
        .setState(
            PlaybackStateCompat.STATE_PLAYING,

            // Playback position
            // Used to update the elapsed time and the progress bar.
            mediaPlayer.currentPosition.toLong(),

            // Playback speed
            // Determines the rate at which the elapsed time changes.
            playbackSpeed
        )

        // isSeekable
        // Adding the SEEK_TO action indicates that seeking is supported
        // and makes the seekbar position marker draggable. If this is not
        // supplied seek will be disabled but progress will still be shown.
        .setActions(PlaybackStateCompat.ACTION_SEEK_TO)
        .build()
)
Java
if (android.os.Build.VERSION.SDK_INT >= android.os.Build.VERSION_CODES.O) {
    mediaSession.setPlaybackState(
        new PlaybackStateCompat.Builder()
            .setState(
                 PlaybackStateCompat.STATE_PLAYING,

                // Playback position
                // Used to update the elapsed time and the progress bar.
                mediaPlayer.currentPosition.toLong(),

                // Playback speed
                // Determines the rate at which the elapsed time changes.
                playbackSpeed
            )

        // isSeekable
        // Adding the SEEK_TO action indicates that seeking is supported
        // and makes the seekbar position marker draggable. If this is not
        // supplied seek will be disabled but progress will still be shown.
        .setActions(PlaybackStateCompat.ACTION_SEEK_TO)
        .build()
    );
}

אופן הפעולה של התראות באפליקציית וידאו

באפליקציות וידאו או באפליקציות אודיו שלא תומכות בהפעלה מקומית ברקע, צריך להגדיר התנהגות ספציפית להתראות מדיה כדי למנוע בעיות בשליחת פקודות מדיה במצבים שבהם אין תמיכה בהפעלה:

  • שליחת ההתראה על מדיה כשמפעילים מדיה באופן מקומי והאפליקציה בחזית.
  • להשהות את ההפעלה המקומית ולסגור את ההתראה כשהאפליקציה פועלת ברקע.
  • כשהאפליקציה תעבור חזרה לחזית, ההפעלה המקומית אמורה להימשך וההתראה אמורה להתפרסם מחדש.

הפעלת מתג מעבר למכשיר אחר בקובץ AndroidManifest.xml

כדי להפעיל את מתג המעבר למכשיר אחר, צריך להוסיף את MediaTransferReceiver ל-AndroidManifest.xml של האפליקציה. אם לא, התכונה לא תופעל ודגל התכונה מרחוק אל המקומי לא יהיה תקף.

<application>
    ...
    <receiver
         android:name="androidx.mediarouter.media.MediaTransferReceiver"
         android:exported="true">
    </receiver>
    ...
</application>

MediaTransferReceiver הוא מקלט שידור שמאפשר העברת מדיה בין מכשירים עם ממשק משתמש של מערכת. מידע נוסף זמין במאמר העזרה בנושא MediaTransferReceiver.

ממקומי למרוחק

כשהמשתמש עובר מהפעלת תוכן באופן מקומי להפעלה מרחוק, ה-SDK של Cast מפעיל את סשן ההעברה באופן אוטומטי. עם זאת, האפליקציות צריכות לטפל במעבר ממצב מקומי למצב מרחוק, למשל להפסיק את ההפעלה המקומית ולטעון את המדיה במכשיר ה-Cast. אפליקציות צריכות להאזין להודעות Cast SessionManagerListener באמצעות פונקציות הקריאה החוזרת onSessionStarted() ו-onSessionEnded(), ולטפל בפעולה כשהן מקבלות את פונקציות הקריאה החוזרת SessionManager של Cast. האפליקציות צריכות לוודא שהקריאות החוזרות האלה עדיין פעילות כשתיבת הדו-שיח של החלפת הפלט נפתחת והאפליקציה לא בחזית.

עדכון של SessionManagerListener להעברה (cast) ברקע

הגרסה הקודמת של Cast כבר תומכת בהעברה מקומית מרחוק כשהאפליקציה פועלת בחזית. חוויית ה-Cast הרגילה מתחילה כשמשתמשים לוחצים על סמל ה-Cast באפליקציה ובוחרים מכשיר להעברת מדיה בסטרימינג. במקרה כזה, האפליקציה צריכה להירשם ל-SessionManagerListener ב-onCreate() או ב-onStart(), ולבטל את הרישום של ה-listener ב-onStop() או ב-onDestroy() של הפעילות של האפליקציה.

בגרסה החדשה של העברה (cast) באמצעות מתג הפלט, אפשר להתחיל העברה (cast) של אפליקציות כשהן פועלות ברקע. האפשרות הזו שימושית במיוחד לאפליקציות אודיו ששולחות התראות כשהן מופעלות ברקע. אפליקציות יכולות לרשום את המאזינים של SessionManager ב-onCreate() של השירות ולבטל את הרישום ב-onDestroy() של השירות. אפליקציות צריכות תמיד לקבל את הקריאות החוזרות המקומיות-מרוחקות (למשל onSessionStarted) כשהן פועלות ברקע.

אם האפליקציה משתמשת ב-MediaBrowserService, מומלץ לרשום שם את SessionManagerListener.

Kotlin
class MyService : Service() {
    private var castContext: CastContext? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext
            .getSessionManager()
            .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext
                .getSessionManager()
                .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
        }
    }
}
Java
public class MyService extends Service {
  private CastContext castContext;

  @Override
  protected void onCreate() {
     castContext = CastContext.getSharedInstance(this);
     castContext
        .getSessionManager()
        .addSessionManagerListener(sessionManagerListener, CastSession.class);
  }

  @Override
  protected void onDestroy() {
    if (castContext != null) {
       castContext
          .getSessionManager()
          .removeSessionManagerListener(sessionManagerListener, CastSession.class);
    }
  }
}

בעזרת העדכון הזה, העברה מקומית מרחוק פועלת כמו העברה רגילה כשהאפליקציה פועלת ברקע, ולא נדרשת פעולה נוספת כדי לעבור ממכשירי Bluetooth למכשירי Cast.

מרחוק למקומי

מתג המעבר למכשיר אחר מאפשר להעביר את ההפעלה מרחוק לרמקול הטלפון או למכשיר Bluetooth מקומי. כדי להפעיל את האפשרות הזו, מגדירים את הדגל setRemoteToLocalEnabled לערך true ב-CastOptions.

במקרים שבהם מכשיר השולח הנוכחי מצטרף לסשן קיים עם מספר שולחים, והאפליקציה צריכה לבדוק אם מותר להעביר את המדיה הנוכחית באופן מקומי, האפליקציות צריכות להשתמש ב-callback‏ onTransferred של SessionTransferCallback כדי לבדוק את SessionState.

הגדרת הדגל setRemoteToLocalEnabled

ב-CastOptions.Builder מופיע הלחצן setRemoteToLocalEnabled להצגה או להסתרה של רמקול הטלפון ומכשירי Bluetooth מקומיים כיעדים להעברה בתיבת הדו-שיח של החלפת הפלט כשיש סשן העברה פעיל.

Kotlin
class CastOptionsProvider : OptionsProvider {
    fun getCastOptions(context: Context?): CastOptions {
        ...
        return Builder()
            ...
            .setRemoteToLocalEnabled(true)
            .build()
    }
}
Java
public class CastOptionsProvider implements OptionsProvider {
    @Override
    public CastOptions getCastOptions(Context context) {
        ...
        return new CastOptions.Builder()
            ...
            .setRemoteToLocalEnabled(true)
            .build()
  }
}

המשך ההפעלה באופן מקומי

אפליקציות שתומכות בהעברה מרחוק למכשיר המקומי צריכות לרשום את האירוע SessionTransferCallback כדי לקבל התראה כשהאירוע מתרחש, וכך לבדוק אם צריך לאפשר העברת מדיה ולהמשיך את ההפעלה באופן מקומי.

CastContext#addSessionTransferCallback(SessionTransferCallback) מאפשר לאפליקציה לרשום את SessionTransferCallback שלה ולהאזין להודעות חזרה (callbacks) מסוג onTransferred ו-onTransferFailed כששולח מועבר להפעלה מקומית.

אחרי שהאפליקציה תבטל את הרישום של SessionTransferCallback, היא לא תקבל יותר אירועי SessionTransferCallback.

הקריאה החוזרת SessionTransferCallback היא הרחבה של הקריאות החוזרות הקיימות SessionManagerListener, והיא מופעלת אחרי ההפעלה של onSessionEnded. הסדר של קריאות החזרה מרחוק אל המקומי הוא:

  1. onTransferring
  2. onSessionEnding
  3. onSessionEnded
  4. onTransferred

מכיוון שאפשר לפתוח את מתג הפלט באמצעות צ'יפ ההתראות של המדיה כשהאפליקציה פועלת ברקע ומבצעת העברה (cast), האפליקציות צריכות לטפל בהעברה למכשיר המקומי באופן שונה בהתאם לכך שהן תומכות בהפעלה ברקע או לא. במקרה של העברה שנכשלה, האירוע onTransferFailed יופעל בכל פעם שתופיע השגיאה.

אפליקציות שתומכות בהפעלה ברקע

באפליקציות שתומכות בהפעלה ברקע (בדרך כלל אפליקציות אודיו), מומלץ להשתמש ב-Service (לדוגמה, MediaBrowserService). השירותים צריכים להקשיב להודעת החזרה (callback) של onTransferred ולהמשיך את ההפעלה באופן מקומי גם כשהאפליקציה בחזית וגם כשהיא ברקע.

Kotlin
class MyService : Service() {
    private var castContext: CastContext? = null
    private var sessionTransferCallback: SessionTransferCallback? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
        sessionTransferCallback = MySessionTransferCallback()
        castContext.addSessionTransferCallback(sessionTransferCallback)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback)
            }
        }
    }

    class MySessionTransferCallback : SessionTransferCallback() {
        fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) {
            // Perform necessary steps prior to onTransferred
        }

        fun onTransferred(@SessionTransferCallback.TransferType transferType: Int,
                          sessionState: SessionState?) {
            if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.
                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int,
                             @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) {
            // Handle transfer failure.
        }
    }
}
Java
public class MyService extends Service {
    private CastContext castContext;
    private SessionTransferCallback sessionTransferCallback;

    @Override
    protected void onCreate() {
        castContext = CastContext.getSharedInstance(this);
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession.class);
        sessionTransferCallback = new MySessionTransferCallback();
        castContext.addSessionTransferCallback(sessionTransferCallback);
    }

    @Override
    protected void onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession.class);
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback);
            }
        }
    }

    public static class MySessionTransferCallback extends SessionTransferCallback {
        public MySessionTransferCallback() {}

        @Override
        public void onTransferring(@SessionTransferCallback.TransferType int transferType) {
            // Perform necessary steps prior to onTransferred
        }

        @Override
        public void onTransferred(@SessionTransferCallback.TransferType int transferType,
                                  SessionState sessionState) {
            if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.
                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        @Override
        public void onTransferFailed(@SessionTransferCallback.TransferType int transferType,
                                     @SessionTransferCallback.TransferFailedReason int transferFailedReason) {
            // Handle transfer failure.
        }
    }
}

אפליקציות שלא תומכות בהפעלה ברקע

באפליקציות שלא תומכות בהפעלה ברקע (בדרך כלל אפליקציות וידאו), מומלץ להקשיב להודעת החזרה (callback) של onTransferred ולהמשיך את ההפעלה באופן מקומי אם האפליקציה נמצאת בחזית.

אם האפליקציה פועלת ברקע, היא אמורה להשהות את ההפעלה ולשמור את המידע הנדרש מ-SessionState (לדוגמה, מטא-נתונים של מדיה ומיקום ההפעלה). כשהאפליקציה עוברת לחזית מהרקע, ההפעלה המקומית אמורה להמשיך עם המידע שנשמר.

Kotlin
class MyActivity : AppCompatActivity() {
    private var castContext: CastContext? = null
    private var sessionTransferCallback: SessionTransferCallback? = null
    protected fun onCreate() {
        castContext = CastContext.getSharedInstance(this)
        castContext.getSessionManager()
                   .addSessionManagerListener(sessionManagerListener, CastSession::class.java)
        sessionTransferCallback = MySessionTransferCallback()
        castContext.addSessionTransferCallback(sessionTransferCallback)
    }

    protected fun onDestroy() {
        if (castContext != null) {
            castContext.getSessionManager()
                       .removeSessionManagerListener(sessionManagerListener, CastSession::class.java)
            if (sessionTransferCallback != null) {
                castContext.removeSessionTransferCallback(sessionTransferCallback)
            }
        }
    }

    class MySessionTransferCallback : SessionTransferCallback() {
        fun onTransferring(@SessionTransferCallback.TransferType transferType: Int) {
            // Perform necessary steps prior to onTransferred
        }

        fun onTransferred(@SessionTransferCallback.TransferType transferType: Int,
                          sessionState: SessionState?) {
            if (transferType == SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
                // Remote stream is transferred to the local device.

                // Retrieve information from the SessionState to continue playback on the local player.
            }
        }

        fun onTransferFailed(@SessionTransferCallback.TransferType transferType: Int,
                             @SessionTransferCallback.TransferFailedReason transferFailedReason: Int) {
            // Handle transfer failure.
        }
    }
}
Java
public class MyActivity extends AppCompatActivity {
  private CastContext castContext;
  private SessionTransferCallback sessionTransferCallback;

  @Override
  protected void onCreate() {
     castContext = CastContext.getSharedInstance(this);
     castContext
        .getSessionManager()
        .addSessionManagerListener(sessionManagerListener, CastSession.class);
     sessionTransferCallback = new MySessionTransferCallback();
     castContext.addSessionTransferCallback(sessionTransferCallback);
  }

  @Override
  protected void onDestroy() {
    if (castContext != null) {
       castContext
          .getSessionManager()
          .removeSessionManagerListener(sessionManagerListener, CastSession.class);
      if (sessionTransferCallback != null) {
         castContext.removeSessionTransferCallback(sessionTransferCallback);
      }
    }
  }

  public static class MySessionTransferCallback extends SessionTransferCallback {
    public MySessionTransferCallback() {}

    @Override
    public void onTransferring(@SessionTransferCallback.TransferType int transferType) {
        // Perform necessary steps prior to onTransferred
    }

    @Override
    public void onTransferred(@SessionTransferCallback.TransferType int transferType,
                               SessionState sessionState) {
      if (transferType==SessionTransferCallback.TRANSFER_TYPE_FROM_REMOTE_TO_LOCAL) {
        // Remote stream is transferred to the local device.

        // Retrieve information from the SessionState to continue playback on the local player.
      }
    }

    @Override
    public void onTransferFailed(@SessionTransferCallback.TransferType int transferType,
                                 @SessionTransferCallback.TransferFailedReason int transferFailedReason) {
      // Handle transfer failure.
    }
  }
}

מרחוק אל מרחוק

מתג המעבר למכשיר אחר תומך ביכולת להרחיב את השימוש בכמה מכשירי רמקול שתומכים ב-Cast לאפליקציות אודיו באמצעות התכונה 'הרחבת שידור'.

אפליקציות אודיו הן אפליקציות שתומכות ב-Google Cast for Audio בהגדרות של אפליקציית המקלט במסוף הפיתוח של Google Cast SDK.

הרחבת הסטרימינג באמצעות רמקולים

אפליקציות אודיו שמשתמשות במתג הפלט יכולות להרחיב את האודיו למספר מכשירי רמקולים שתומכים ב-Cast במהלך סשן העברה באמצעות התכונה 'הרחבת שידור'.

הפלטפורמה של Cast תומכת בתכונה הזו, ואין צורך לבצע שינויים נוספים אם האפליקציה משתמשת בממשק המשתמש שמוגדר כברירת מחדל. אם משתמשים בממשק משתמש מותאם אישית, האפליקציה צריכה לעדכן את ממשק המשתמש כך שישקף שהאפליקציה מבצעת העברה (cast) לקבוצה.

כדי לקבל את שם הקבוצה המורחב החדש במהלך הרחבת הסטרימינג, צריך לרשום אירוע Cast.Listener באמצעות CastSession#addCastListener. לאחר מכן, מתקשרים למספר CastSession#getCastDevice() במהלך השיחה החוזרת onDeviceNameChanged.

Kotlin
class MyActivity : Activity() {
    private var mCastSession: CastSession? = null
    private lateinit var mCastContext: CastContext
    private lateinit var mSessionManager: SessionManager
    private val mSessionManagerListener: SessionManagerListener<CastSession> =
        SessionManagerListenerImpl()
    private val mCastListener = CastListener()

    private inner class SessionManagerListenerImpl : SessionManagerListener<CastSession?> {
        override fun onSessionStarting(session: CastSession?) {}

        override fun onSessionStarted(session: CastSession?, sessionId: String) {
            addCastListener(session)
        }

        override fun onSessionStartFailed(session: CastSession?, error: Int) {}

        override fun onSessionSuspended(session: CastSession?, reason Int) {
            removeCastListener()
        }

        override fun onSessionResuming(session: CastSession?, sessionId: String) {}

        override fun onSessionResumed(session: CastSession?, wasSuspended: Boolean) {
            addCastListener(session)
        }

        override fun onSessionResumeFailed(session: CastSession?, error: Int) {}

        override fun onSessionEnding(session: CastSession?) {}

        override fun onSessionEnded(session: CastSession?, error: Int) {
            removeCastListener()
        }
    }

    private inner class CastListener : Cast.Listener() {
        override fun onDeviceNameChanged() {
            mCastSession?.let {
                val castDevice = it.castDevice
                val deviceName = castDevice.friendlyName
                // Update UIs with the new cast device name.
            }
        }
    }

    private fun addCastListener(castSession: CastSession) {
        mCastSession = castSession
        mCastSession?.addCastListener(mCastListener)
    }

    private fun removeCastListener() {
        mCastSession?.removeCastListener(mCastListener)
    }

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        mCastContext = CastContext.getSharedInstance(this)
        mSessionManager = mCastContext.sessionManager
        mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession::class.java)
    }

    override fun onDestroy() {
        super.onDestroy()
        mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession::class.java)
    }
}
Java
public class MyActivity extends Activity {
    private CastContext mCastContext;
    private CastSession mCastSession;
    private SessionManager mSessionManager;
    private SessionManagerListener<CastSession> mSessionManagerListener =
            new SessionManagerListenerImpl();
    private Cast.Listener mCastListener = new CastListener();

    private class SessionManagerListenerImpl implements SessionManagerListener<CastSession> {
        @Override
        public void onSessionStarting(CastSession session) {}
        @Override
        public void onSessionStarted(CastSession session, String sessionId) {
            addCastListener(session);
        }
        @Override
        public void onSessionStartFailed(CastSession session, int error) {}
        @Override
        public void onSessionSuspended(CastSession session, int reason) {
            removeCastListener();
        }
        @Override
        public void onSessionResuming(CastSession session, String sessionId) {}
        @Override
        public void onSessionResumed(CastSession session, boolean wasSuspended) {
            addCastListener(session);
        }
        @Override
        public void onSessionResumeFailed(CastSession session, int error) {}
        @Override
        public void onSessionEnding(CastSession session) {}
        @Override
        public void onSessionEnded(CastSession session, int error) {
            removeCastListener();
        }
    }

    private class CastListener extends Cast.Listener {
         @Override
         public void onDeviceNameChanged() {
             if (mCastSession == null) {
                 return;
             }
             CastDevice castDevice = mCastSession.getCastDevice();
             String deviceName = castDevice.getFriendlyName();
             // Update UIs with the new cast device name.
         }
    }

    private void addCastListener(CastSession castSession) {
        mCastSession = castSession;
        mCastSession.addCastListener(mCastListener);
    }

    private void removeCastListener() {
        if (mCastSession != null) {
            mCastSession.removeCastListener(mCastListener);
        }
    }

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        mCastContext = CastContext.getSharedInstance(this);
        mSessionManager = mCastContext.getSessionManager();
        mSessionManager.addSessionManagerListener(mSessionManagerListener, CastSession.class);
    }

    @Override
    protected void onDestroy() {
        super.onDestroy();
        mSessionManager.removeSessionManagerListener(mSessionManagerListener, CastSession.class);
    }
}

בדיקה מרחוק אל מרחוק

כדי לבדוק את התכונה:

  1. להעביר את התוכן למכשיר שתומך ב-Cast באמצעות העברה רגילה או באמצעות העברה מקומית מרחוק.
  2. פותחים את החלפת הפלט באמצעות אחת מנקודות הכניסה.
  3. מקישים על מכשיר אחר שתומך ב-Cast, ואפליקציות האודיו ירחיבו את התוכן למכשיר הנוסף וייצרו קבוצה דינמית.
  4. מקישים שוב על המכשיר שתומך ב-Cast, והוא יוסר מהקבוצה הדינמית.