מחליף פלט

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

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

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

ממשק משתמש של מתג מעבר למכשיר אחר

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

בעיות מוכרות

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

נקודות כניסה

התראות מדיה

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

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

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

סיכום השלבים

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

  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, בקטע הקוד שבהמשך מוסבר איך להגדיר אותם. בנוסף, יש מדריכים להגדרת קריאות חוזרות (callback) של סשן מדיה באפליקציות אודיו ווידאו:

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>

‫The MediaTransferReceiver is a broadcast receiver that enables media transfer among devices with system UI. מידע נוסף זמין במאמר בנושא MediaTransferReceiver.

מקומי למרוחק

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

עדכון של SessionManagerListener להפעלת Cast ברקע

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

בגרסה החדשה של ההפעלה של Cast באמצעות הכלי להחלפת פלט, אפליקציות יכולות להתחיל להפעיל Cast כשהן פועלות ברקע. האפשרות הזו שימושית במיוחד לאפליקציות אודיו ששולחות התראות כשהן פועלות ברקע. אפליקציות יכולות לרשום את מאזיני SessionManager ב-onCreate() של השירות ולבטל את הרישום ב-onDestroy() של השירות. אפליקציות צריכות תמיד לקבל את הקריאות החוזרות (callbacks) המקומיות והמרוחקות (כמו 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.

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

הגדרת הדגל setRemoteToLocalEnabled

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

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 שלה ולהאזין לקריאות חוזרות (callback) של onTransferred ושל onTransferFailed כששולחים העברה להפעלה מקומית.

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

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

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

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

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

באפליקציות שתומכות בהפעלה ברקע (בדרך כלל אפליקציות אודיו), מומלץ להשתמש ב-Service (לדוגמה, MediaBrowserService). השירותים צריכים להאזין לקריאה החוזרת 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.
        }
    }
}

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

באפליקציות שלא תומכות בהפעלה ברקע (בדרך כלל אפליקציות וידאו), מומלץ להאזין לקריאה החוזרת 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 לאודיו בהגדרות של Receiver App ב-Google Cast SDK Developer Console

הוספת רמקולים

אפליקציות אודיו שמשתמשות בכלי להחלפת פלט יכולות להרחיב את האודיו למספר רמקולים עם Cast במהלך הפעלת 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 של התוכן במכשיר שתומך ב-Cast באמצעות Cast רגיל או באמצעות local-to-remote.
  2. פותחים את הכלי להחלפת פלט באמצעות אחת מנקודות הכניסה.
  3. מקישים על מכשיר אחר עם Cast, ואפליקציות האודיו ירחיבו את התוכן למכשיר הנוסף, וייצרו קבוצה דינמית.
  4. מקישים שוב על המכשיר שתומך ב-Cast והוא יוסר מהקבוצה הדינמית.