Ringkasan
Class yang mengelola sesi.
Metode startSessionWithDevice: (GCKSessionManager) digunakan untuk membuat sesi baru dengan GCKDevice tertentu. Pengelola sesi menggunakan GCKDeviceProvider untuk jenis perangkat tersebut guna membuat objek GCKSession baru, yang kemudian mendelegasikan semua permintaan sesi.
GCKSessionManager menangani dimulainya kembali sesi yang ditangguhkan secara otomatis (yaitu, melanjutkan sesi yang berakhir saat aplikasi beralih ke latar belakang, atau jika aplikasi mengalami error atau dihentikan secara paksa oleh pengguna). Saat aplikasi dilanjutkan atau dimulai ulang, pengelola sesi akan menunggu beberapa saat agar penyedia perangkat dari perangkat sesi yang ditangguhkan menemukan perangkat itu lagi, dan jika berhasil, aplikasi akan mencoba menghubungkan kembali ke perangkat tersebut dan membuat kembali sesi secara otomatis.
Jika aplikasi telah membuat GCKUICastButton tanpa memberikan target dan pemilih, ketukan pengguna pada tombol akan menampilkan dialog Cast default dan aplikasi akan otomatis memulai dan menghentikan sesi berdasarkan pemilihan pengguna atau pemutusan koneksi perangkat. Namun, jika aplikasi menyediakan UI dialog pemilihan/kontrol perangkatnya sendiri, aplikasi harus menggunakan GCKSessionManager secara langsung untuk membuat dan mengontrol sesi.
Baik aplikasi menggunakan GCKSessionManager untuk mengontrol sesi maupun tidak, aplikasi dapat melampirkan GCKSessionManagerListener untuk mendapatkan notifikasi peristiwa sesi, dan juga dapat menggunakan KVO untuk memantau properti connectionState untuk melacak status siklus proses sesi saat ini.
- Since
- 3,0
Mewarisi NSObject.
Ringkasan Metode Instance | |
(instancetype) | - init |
Penginisialisasi default tidak tersedia. Selengkapnya... | |
(BOOL) | - startSessionWithDevice: |
Memulai sesi baru dengan perangkat tertentu, menggunakan opsi sesi default yang terdaftar untuk kategori perangkat, jika ada. Selengkapnya... | |
(BOOL) | - startSessionWithDevice:sessionOptions: |
Memulai sesi baru dengan perangkat dan opsi yang diberikan. Selengkapnya... | |
(BOOL) | - startSessionWithOpenURLOptions:sessionOptions: |
Berupaya untuk bergabung atau memulai sesi dengan opsi yang disediakan ke metode UIApplicationDelegate::application:openURL:options:. Selengkapnya... | |
(BOOL) | - suspendSessionWithReason: |
Menangguhkan sesi saat ini. Selengkapnya... | |
(BOOL) | - endSession |
Mengakhiri sesi saat ini. Selengkapnya... | |
(BOOL) | - endSessionAndStopCasting: |
Mengakhiri sesi saat ini dan menghentikan transmisi jika satu perangkat pengirim terhubung; jika tidak, secara opsional menghentikan transmisi jika beberapa perangkat pengirim terhubung. Selengkapnya... | |
(BOOL) | - hasConnectedSession |
Menguji apakah sesi saat ini dikelola oleh pengelola sesi ini, dan saat ini terhubung. Selengkapnya... | |
(BOOL) | - hasConnectedCastSession |
Menguji apakah sesi Cast saat ini dikelola oleh pengelola sesi ini, dan saat ini terhubung. Selengkapnya... | |
(void) | - setDefaultSessionOptions:forDeviceCategory: |
Menetapkan opsi sesi default untuk kategori perangkat tertentu.Opsi sesi diteruskan ke metode createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) saat pengguna memilih perangkat dari dialog Cast. Selengkapnya... | |
(nullable GCKSessionOptions *) | - defaultSessionOptionsForDeviceCategory: |
Mendapatkan opsi sesi default untuk kategori perangkat tertentu. Selengkapnya... | |
(void) | - addListener: |
Menambahkan pemroses untuk menerima notifikasi. Selengkapnya... | |
(void) | - removeListener: |
Menghapus pemroses yang sebelumnya ditambahkan dengan addListener:. Selengkapnya... | |
Ringkasan Properti | |
GCKSession * | currentSession |
Sesi saat ini, jika ada. Selengkapnya... | |
GCKCastSession * | currentCastSession |
Sesi Transmisi saat ini, jika ada. Selengkapnya... | |
GCKConnectionState | connectionState |
Status koneksi sesi saat ini. Selengkapnya... | |
Detail Metode
- (instancetype) init |
Penginisialisasi default tidak tersedia.
- (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
Memulai sesi baru dengan perangkat tertentu, menggunakan opsi sesi default yang terdaftar untuk kategori perangkat, jika ada.
Ini adalah operasi asinkron.
- Parameters
-
device The device to use for this session.
- Hasil
YES
jika operasi berhasil dimulai,NO
jika ada sesi yang sedang berlangsung, atau jika operasi tidak bisa dimulai.
- (BOOL) startSessionWithDevice: | (GCKDevice *) | device | |
sessionOptions: | (nullable GCKSessionOptions *) | options | |
Memulai sesi baru dengan perangkat dan opsi yang diberikan.
Ini adalah operasi asinkron.
- Parameters
-
device The device to use for this session. options The options for this session, if any. May be nil
.
- Hasil
YES
jika operasi berhasil dimulai,NO
jika ada sesi yang sedang berlangsung, atau jika operasi tidak dapat dimulai.
- Since
- 4,0
- (BOOL) startSessionWithOpenURLOptions: | (GCKOpenURLOptions *) | openURLOptions | |
sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
Berupaya untuk bergabung atau memulai sesi dengan opsi yang disediakan ke metode UIApplicationDelegate::application:openURL:options:.
Biasanya ini adalah permintaan untuk bergabung dengan sesi Cast yang ada di perangkat tertentu yang dimulai oleh aplikasi lain.
- Parameters
-
openURLOptions The options that were extracted from the URL. sessionOptions The options for this session, if any. May be nil
.
- Hasil
YES
jika operasi berhasil dimulai,NO
jika ada sesi yang sedang berlangsung, atau opsi openURL tidak berisi opsi Cast yang diperlukan.
- Since
- 4,0
- (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
Menangguhkan sesi saat ini.
Ini adalah operasi asinkron.
- Parameters
-
reason The reason for the suspension.
- Hasil
YES
jika operasi berhasil dimulai,NO
jika tidak ada sesi yang sedang berlangsung, atau jika operasi tidak bisa dimulai.
- (BOOL) endSession |
Mengakhiri sesi saat ini.
Ini adalah operasi asinkron.
- Hasil
YES
jika operasi berhasil dimulai,NO
jika tidak ada sesi yang sedang berlangsung, atau jika operasi tidak bisa dimulai.
- (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
Mengakhiri sesi saat ini dan menghentikan transmisi jika satu perangkat pengirim terhubung; jika tidak, secara opsional menghentikan transmisi jika beberapa perangkat pengirim terhubung.
Gunakan parameter stopCasting
untuk menunjukkan apakah transmisi pada penerima harus berhenti saat sesi berakhir. Parameter ini hanya berlaku saat beberapa perangkat pengirim terhubung. Misalnya, aplikasi yang sama terbuka di beberapa perangkat pengirim dan setiap perangkat pengirim memiliki sesi Transmisi yang aktif dengan perangkat penerima yang sama.
- Jika Anda menyetel
stopCasting
keYES
, aplikasi penerima akan menghentikan transmisi saat beberapa perangkat terhubung. - Jika
stopCasting
adalahNO
dan perangkat lain memiliki sesi yang aktif, penerima akan terus diputar. - Jika hanya satu perangkat pengirim yang terhubung, aplikasi penerima akan menghentikan transmisi media dan mengabaikan nilai
stopCasting
, meskipun disetel keNO
.
- Parameters
-
stopCasting Whether casting on the receiver should stop when the session ends. Only used when multiple sender devices are connected.
- Hasil
YES
jika operasi untuk mengakhiri sesi berhasil dimulai,NO
jika tidak ada sesi yang sedang berlangsung, atau jika operasi tidak bisa dimulai.
- (BOOL) hasConnectedSession |
Menguji apakah sesi saat ini dikelola oleh pengelola sesi ini, dan saat ini terhubung.
Ini akan menjadi YES
jika status sesi adalah GCKConnectionStateConnected.
- (BOOL) hasConnectedCastSession |
Menguji apakah sesi Cast saat ini dikelola oleh pengelola sesi ini, dan saat ini terhubung.
Ini akan menjadi YES
jika status sesi adalah GCKConnectionStateConnected dan sesi adalah sesi Cast.
- (void) setDefaultSessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
forDeviceCategory: | (NSString *) | category | |
Menetapkan opsi sesi default untuk kategori perangkat tertentu.Opsi sesi diteruskan ke metode createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) saat pengguna memilih perangkat dari dialog Cast.
Untuk sesi Cast, opsi sesi dapat menentukan aplikasi penerima yang akan diluncurkan.
- Parameters
-
sessionOptions The session options. May be nil
to remove any previously set options.category The device category.
- Since
- 4,0
- (nullable GCKSessionOptions *) defaultSessionOptionsForDeviceCategory: | (NSString *) | category |
Mendapatkan opsi sesi default untuk kategori perangkat tertentu.
- Parameters
-
category The device category.
- Hasil
- Opsi sesi default, atau
nil
jika tidak ada.
- Since
- 4,0
- (void) addListener: | (id< GCKSessionManagerListener >) | listener |
Menambahkan pemroses untuk menerima notifikasi.
Pemroses yang ditambahkan dipegang dengan lemah, dan harus dipertahankan untuk menghindari dealokasi yang tidak terduga.
- Parameters
-
listener The listener to add.
- (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
Menghapus pemroses yang sebelumnya ditambahkan dengan addListener:.
- Parameters
-
listener The listener to remove.
Detail Properti
|
readnonatomicstrong |
Sesi saat ini, jika ada.
|
readnonatomicstrong |
Sesi Transmisi saat ini, jika ada.
|
readnonatomicassign |
Status koneksi sesi saat ini.