Kelas GCKSessionManager

Referensi Class GCKSessionManager

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 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 kembali perangkat tersebut. Jika berhasil, aplikasi akan mencoba menghubungkan kembali ke perangkat tersebut dan membuat sesi kembali secara otomatis.

Jika aplikasi telah membuat GCKUICastButton tanpa memberikan target dan pemilih, pengguna mengetuk tombol akan menampilkan dialog Cast default, yang juga akan otomatis memulai dan menghentikan sesi berdasarkan pemilihan pengguna atau pemutusan koneksi perangkat. Namun, jika aplikasi menyediakan UI dialog pemilihan/kontrol perangkat sendiri, aplikasi tersebut 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.

Sejak
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 bergabung atau memulai sesi dengan opsi yang diberikan 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, dapat 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 sedang terhubung. Selengkapnya...
 
(void) - setDefaultSessionOptions:forDeviceCategory:
 Menetapkan opsi sesi default untuk kategori perangkat yang ditentukan.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

GCKSessioncurrentSession
 Sesi saat ini, jika ada. Selengkapnya...
 
GCKCastSessioncurrentCastSession
 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
deviceThe device to use for this session.
Hasil
YES jika operasi berhasil dimulai, NO jika ada sesi yang sedang dibuat atau jika operasi tidak dapat dimulai.
- (BOOL) startSessionWithDevice: (GCKDevice *)  device
sessionOptions: (nullable GCKSessionOptions *)  options 

Memulai sesi baru dengan perangkat dan opsi yang diberikan.

Ini adalah operasi asinkron.

Parameters
deviceThe device to use for this session.
optionsThe options for this session, if any. May be nil.
Hasil
YES jika operasi berhasil dimulai, NO jika ada sesi yang sedang dibuat atau jika operasi tidak dapat dimulai.
Sejak
4,0
- (BOOL) startSessionWithOpenURLOptions: (GCKOpenURLOptions *)  openURLOptions
sessionOptions: (nullable GCKSessionOptions *)  sessionOptions 

Berupaya bergabung atau memulai sesi dengan opsi yang diberikan ke metode UIApplicationDelegate::application:openURL:options:.

Biasanya ini adalah permintaan untuk bergabung dengan sesi Cast yang sudah ada di perangkat tertentu yang dimulai oleh aplikasi lain.

Parameters
openURLOptionsThe options that were extracted from the URL.
sessionOptionsThe options for this session, if any. May be nil.
Hasil
YES jika operasi berhasil dimulai, NO jika ada sesi yang sedang dibuat, atau opsi openURL tidak berisi opsi Cast yang diperlukan.
Sejak
4,0
- (BOOL) suspendSessionWithReason: (GCKConnectionSuspendReason reason

Menangguhkan sesi saat ini.

Ini adalah operasi asinkron.

Parameters
reasonThe reason for the suspension.
Hasil
YES jika operasi berhasil dimulai, NO jika tidak ada sesi yang sedang dibuat, atau jika operasi tidak dapat dimulai.
- (BOOL) endSession

Mengakhiri sesi saat ini.

Ini adalah operasi asinkron.

Hasil
YES jika operasi berhasil dimulai, NO jika tidak ada sesi yang sedang dibuat, atau jika operasi tidak dapat dimulai.
- (BOOL) endSessionAndStopCasting: (BOOL)  stopCasting

Mengakhiri sesi saat ini dan menghentikan transmisi jika satu perangkat pengirim terhubung; jika tidak, dapat 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 aktif dengan perangkat penerima yang sama.

  • Jika Anda menyetel stopCasting ke YES, aplikasi penerima akan menghentikan transmisi saat beberapa perangkat terhubung.
  • Jika stopCasting adalah NO dan perangkat lainnya memiliki sesi aktif, penerima akan terus memutar video.
  • Jika hanya satu perangkat pengirim yang terhubung, aplikasi penerima akan berhenti mentransmisikan media dan mengabaikan nilai stopCasting, meskipun aplikasi disetel ke NO.
Parameters
stopCastingWhether 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 dibuat, atau jika operasi tidak dapat 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 sedang terhubung.

Ini akan menjadi YES jika status sesi adalah GCKConnectionStateConnected dan sesi adalah sesi Transmisi.

- (void) setDefaultSessionOptions: (nullable GCKSessionOptions *)  sessionOptions
forDeviceCategory: (NSString *)  category 

Menetapkan opsi sesi default untuk kategori perangkat yang ditentukan.Opsi sesi diteruskan ke metode createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) saat pengguna memilih perangkat dari dialog Cast.

Untuk sesi Transmisi, opsi sesi dapat menentukan aplikasi penerima yang akan diluncurkan.

Parameters
sessionOptionsThe session options. May be nil to remove any previously set options.
categoryThe device category.
Sejak
4,0
- (nullable GCKSessionOptions *) defaultSessionOptionsForDeviceCategory: (NSString *)  category

Mendapatkan opsi sesi default untuk kategori perangkat tertentu.

Parameters
categoryThe device category.
Hasil
Opsi sesi default, atau nil jika tidak ada.
Sejak
4,0
- (void) addListener: (id< GCKSessionManagerListener >)  listener

Menambahkan pemroses untuk menerima notifikasi.

Pemroses yang ditambahkan ditahan dengan lemah, dan harus dipertahankan untuk menghindari dealokasi yang tidak terduga.

Parameters
listenerThe listener to add.
- (void) removeListener: (id< GCKSessionManagerListener >)  listener

Menghapus pemroses yang sebelumnya ditambahkan dengan addListener:.

Parameters
listenerThe listener to remove.

Detail Properti

- (GCKSession*) currentSession
readnonatomicstrong

Sesi saat ini, jika ada.

- (GCKCastSession*) currentCastSession
readnonatomicstrong

Sesi Transmisi saat ini, jika ada.

- (GCKConnectionState) connectionState
readnonatomicassign

Status koneksi sesi saat ini.