Genel bakış
Oturumları yöneten bir sınıf.
startSessionWithDevice: (GCKSessionManager) yöntemi, belirli bir GCKDevice ile yeni oturum oluşturmak için kullanılır. Oturum yöneticisi, yeni bir GCKSession nesnesi oluşturmak için söz konusu cihaz türü için GCKDeviceProvider öğesini kullanır ve daha sonra, bu nesneye tüm oturum istekleri için yetki verir.
Askıya alınan oturumların (yani uygulama arka plana gittiğinde ya da uygulamanın çökmesi veya kullanıcı tarafından zorla sonlandırıldığı durumlarda sona eren oturumlar devam ettirilmesi) GCKSessionManager tarafından otomatik olarak devam ettirilir. Uygulama devam ettirildiğinde veya yeniden başlatıldığında, oturum yöneticisi, askıya alınan oturumdaki cihazın cihaz sağlayıcısının bu cihazı tekrar keşfetmesi için kısa bir süre bekler. Bağlantı kurulursa bu cihaza yeniden bağlanıp oturumu otomatik olarak yeniden oluşturmayı dener.
Uygulama, bir hedef ve seçici sağlamadan bir GCKUICastButton oluşturduysa kullanıcı düğmeye dokunduğunda varsayılan Yayınlama iletişim kutusu görüntülenir. Kullanıcı seçimine veya cihazın bağlantısının kesilmesine bağlı olarak oturumları otomatik olarak başlatıp durdurur. Uygulama, kendi cihaz seçimi/kontrolü iletişim kutusu kullanıcı arayüzünü sağlıyorsa oturum oluşturmak ve kontrol etmek için doğrudan GCKSessionManager kullanılmalıdır.
Uygulama, oturumları kontrol etmek için GCKSessionManager özelliğini kullanıp kullanmasa da oturum etkinlikleri hakkında bilgilendirilmek üzere bir GCKSessionManagerListener ekleyebilir ve mevcut oturum yaşam döngüsü durumunu izlemek üzere connectionState özelliğini izlemek için KVO'yu da kullanabilir.
- yılından beri
- 3,0
NSObject öğesini devralır.
Örnek Yöntemi Özeti | |
(instancetype) | - init |
Varsayılan başlatıcı kullanılamıyor. Diğer... | |
(BOOL) | - startSessionWithDevice: |
İlgili cihaz kategorisi için kaydedilmiş varsayılan oturum seçeneklerini (varsa) kullanarak söz konusu cihazla yeni bir oturum başlatır. Diğer... | |
(BOOL) | - startSessionWithDevice:sessionOptions: |
Belirtilen cihaz ve seçeneklerle yeni bir oturum başlatır. Diğer... | |
(BOOL) | - startSessionWithOpenURLOptions:sessionOptions: |
UIApplicationMediation::application:openURL:options: yönteme sağlanan seçeneklerle bir oturuma katılma veya oturum başlatma denemeleri. Diğer... | |
(BOOL) | - suspendSessionWithReason: |
Geçerli oturumu askıya alır. Diğer... | |
(BOOL) | - endSession |
Mevcut oturumu sonlandırır. Diğer... | |
(BOOL) | - endSessionAndStopCasting: |
Bir gönderen cihazı bağlıysa mevcut oturumu sonlandırır ve yayını durdurur. Aksi takdirde, birden fazla gönderen cihazı bağlıysa yayını durdurur. Diğer... | |
(BOOL) | - hasConnectedSession |
Bir oturumun şu anda bu oturum yöneticisi tarafından yönetilip yönetilmediğini ve bağlı olup olmadığını test eder. Diğer... | |
(BOOL) | - hasConnectedCastSession |
Bir yayın oturumunun şu anda bu oturum yöneticisi tarafından yönetilip yönetilmediğini ve şu anda bağlı olup olmadığını test eder. Diğer... | |
(void) | - setDefaultSessionOptions:forDeviceCategory: |
Belirtilen cihaz kategorisi için varsayılan oturum seçeneklerini ayarlar.Kullanıcı, Yayınlama iletişim kutusundan bir cihaz seçtiğinde oturum seçenekleri createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) yöntemine aktarılır. Diğer... | |
(nullable GCKSessionOptions *) | - defaultSessionOptionsForDeviceCategory: |
Belirli bir cihaz kategorisi için varsayılan oturum seçeneklerini alır. Diğer... | |
(void) | - addListener: |
Bildirim almak için bir işleyici ekler. Diğer... | |
(void) | - removeListener: |
Daha önce addListener: ile birlikte eklenmiş bir işleyiciyi kaldırır. Diğer... | |
Mülk Özeti | |
GCKSession * | currentSession |
Mevcut oturum (varsa). Diğer... | |
GCKCastSession * | currentCastSession |
Mevcut Yayın oturumu (varsa). Diğer... | |
GCKConnectionState | connectionState |
Geçerli oturum bağlantı durumu. Diğer... | |
Yöntem Ayrıntısı
- (instancetype) init |
Varsayılan başlatıcı kullanılamıyor.
- (BOOL) startSessionWithDevice: | (GCKDevice *) | device |
İlgili cihaz kategorisi için kaydedilmiş varsayılan oturum seçeneklerini (varsa) kullanarak söz konusu cihazla yeni bir oturum başlatır.
Bu, eşzamansız bir işlemdir.
- Parameters
-
device The device to use for this session.
- İlerlemeler
- İşlem başarıyla başlatıldıysa
YES
, şu anda oluşturulmuş bir oturum varsa veya işlem başlatılamadıysaNO
.
- (BOOL) startSessionWithDevice: | (GCKDevice *) | device | |
sessionOptions: | (nullable GCKSessionOptions *) | options | |
Belirtilen cihaz ve seçeneklerle yeni bir oturum başlatır.
Bu, eşzamansız bir işlemdir.
- Parameters
-
device The device to use for this session. options The options for this session, if any. May be nil
.
- İlerlemeler
- İşlem başarıyla başlatıldıysa
YES
, kurulmuş bir oturum varsa veya işlem başlatılamadıysaNO
.
- yılından beri
- 4,0
- (BOOL) startSessionWithOpenURLOptions: | (GCKOpenURLOptions *) | openURLOptions | |
sessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
UIApplicationMediation::application:openURL:options: yönteme sağlanan seçeneklerle bir oturuma katılma veya oturum başlatma denemeleri.
Genellikle bu, başka bir uygulama tarafından başlatılan belirli bir cihazdaki mevcut Cast oturumuna katılma isteğidir.
- Parameters
-
openURLOptions The options that were extracted from the URL. sessionOptions The options for this session, if any. May be nil
.
- İlerlemeler
YES
İşlem başarıyla başlatıldıysa,NO
halihazırda oluşturulmuş bir oturum varsa veya OpenURL seçenekleri gerekli Yayın seçeneklerini içermiyorsa.
- yılından beri
- 4,0
- (BOOL) suspendSessionWithReason: | (GCKConnectionSuspendReason) | reason |
Geçerli oturumu askıya alır.
Bu, eşzamansız bir işlemdir.
- Parameters
-
reason The reason for the suspension.
- İlerlemeler
- İşlem başarıyla başlatıldıysa
YES
, o anda kurulmuş bir oturum yoksa veya işlem başlatılamadıysaNO
.
- (BOOL) endSession |
Mevcut oturumu sonlandırır.
Bu, eşzamansız bir işlemdir.
- İlerlemeler
- İşlem başarıyla başlatıldıysa
YES
, o anda kurulmuş bir oturum yoksa veya işlem başlatılamadıysaNO
.
- (BOOL) endSessionAndStopCasting: | (BOOL) | stopCasting |
Bir gönderen cihazı bağlıysa mevcut oturumu sonlandırır ve yayını durdurur. Aksi takdirde, birden fazla gönderen cihazı bağlıysa yayını durdurur.
Oturum sona erdiğinde alıcıda yayının durup durmayacağını belirtmek için stopCasting
parametresini kullanın. Bu parametre yalnızca birden fazla gönderen cihazı bağlı olduğunda geçerlidir. Örneğin, aynı uygulama birden fazla gönderen cihazında açık ve her gönderen cihazda aynı alıcı cihazda etkin bir yayın oturumu bulunuyor.
stopCasting
öğesiniYES
olarak ayarlarsanız birden fazla cihaz bağlandığında alıcının uygulaması yayın yapmayı durdurur.stopCasting
,NO
ise ve diğer cihazlarda etkin bir oturum varsa alıcı oynamaya devam eder.- Yalnızca bir gönderen cihaz bağlıysa, alıcı uygulama medya yayınını durdurur ve
NO
olarak ayarlanmış olsa bilestopCasting
değerini yoksayar.
- Parameters
-
stopCasting Whether casting on the receiver should stop when the session ends. Only used when multiple sender devices are connected.
- İlerlemeler
- Oturumu sonlandırma işlemi başarıyla başlatıldıysa
YES
, o anda kurulmuş bir oturum yoksa veya işlem başlatılamadıysaNO
.
- (BOOL) hasConnectedSession |
Bir oturumun şu anda bu oturum yöneticisi tarafından yönetilip yönetilmediğini ve bağlı olup olmadığını test eder.
Oturum durumu GCKConnectionStateConnected ise YES
olur.
- (BOOL) hasConnectedCastSession |
Bir yayın oturumunun şu anda bu oturum yöneticisi tarafından yönetilip yönetilmediğini ve şu anda bağlı olup olmadığını test eder.
Oturum durumu GCKConnectionStateConnectedken ve oturum bir yayınlama oturumuysa YES
olur.
- (void) setDefaultSessionOptions: | (nullable GCKSessionOptions *) | sessionOptions | |
forDeviceCategory: | (NSString *) | category | |
Belirtilen cihaz kategorisi için varsayılan oturum seçeneklerini ayarlar.Kullanıcı, Yayınlama iletişim kutusundan bir cihaz seçtiğinde oturum seçenekleri createSessionForDevice:sessionID:sessionOptions: (GCKDeviceProvider) yöntemine aktarılır.
Yayınlama oturumlarında, oturum seçenekleri hangi alıcı uygulamanın başlatılacağını belirtebilir.
- Parameters
-
sessionOptions The session options. May be nil
to remove any previously set options.category The device category.
- yılından beri
- 4,0
- (nullable GCKSessionOptions *) defaultSessionOptionsForDeviceCategory: | (NSString *) | category |
Belirli bir cihaz kategorisi için varsayılan oturum seçeneklerini alır.
- Parameters
-
category The device category.
- İlerlemeler
- Varsayılan oturum seçenekleri veya yoksa
nil
seçeneği.
- yılından beri
- 4,0
- (void) addListener: | (id< GCKSessionManagerListener >) | listener |
Bildirim almak için bir işleyici ekler.
Eklenen işleyici zayıf bir şekilde tutulur ve beklenmedik bir anlaşmanın önüne geçmek için elde tutulmalıdır.
- Parameters
-
listener The listener to add.
- (void) removeListener: | (id< GCKSessionManagerListener >) | listener |
Daha önce addListener: ile birlikte eklenmiş bir işleyiciyi kaldırır.
- Parameters
-
listener The listener to remove.
Mülk Ayrıntısı
|
readnonatomicstrong |
Mevcut oturum (varsa).
|
readnonatomicstrong |
Mevcut Yayın oturumu (varsa).
|
readnonatomicassign |
Geçerli oturum bağlantı durumu.