iOS Gönderen Kullanıcı Arayüzünü Özelleştirme

Widget'ları yayınlama işlevini özelleştirmek için renkleri ayarlayabilir, düğmelerin, metnin ve küçük resmin görünmesini sağlayabilir ve görüntülenecek düğme türlerini seçebilirsiniz.

Widget temasını özelleştirin

Yayın çerçevesi widget'ları, uygulamanızın genelinde bir düğmenin konumu veya kenarlığı gibi görünümünü değiştirmek için UIKit'teki Apple Kullanıcı Arayüzü Protokolü'nü destekler. Yayın çerçevesi widget'larının stilini mevcut bir uygulama stiliyle eşleşecek şekilde ayarlamak için bu protokolü kullanın.

Yayınla düğmesi örneği

Swift
GCKUICastButton.appearance().tintColor = UIColor.gray
Amaç C
[GCKUICastButton appearance].tintColor = [UIColor grayColor];

Widget'ı doğrudan özelleştirin

Bir widget'ı üst sınıfın özelliklerini kullanarak doğrudan özelleştirebilirsiniz. Örneğin, GCKUICastButton rengini tintColor: özelliğini kullanarak özelleştirmek yaygın bir durumdur.

Yayınla düğmesi örneği

Swift
castButton.tintColor = UIColor.gray
Amaç C
castButton.tintColor = [UIColor grayColor];

Kumanda düğmelerini seçin

Hem genişletilmiş kumanda sınıfı (GCKUIExpandedMediaControlsViewController) hem de mini kumanda sınıfı (GCKUIMiniMediaControlsViewController) bir düğme çubuğu içerir ve müşteriler bu çubuklarda hangi düğmelerin sunulacağını yapılandırabilir. Bu, GCKUIMediaButtonBarProtocol şartlarına uyan her iki sınıf tarafından da sağlanır.

Mini kumanda çubuğunda düğmeler için 3 adet yapılandırılabilir yuva bulunur:

SLOT  SLOT  SLOT
  1     2     3

Genişletilmiş kumanda çubuğunda, çubuğun ortasında kalıcı bir oynat/duraklat düğmesi yer alır ve ayrıca 4 yapılandırılabilir yuva bulunur:

SLOT  SLOT  PLAY/PAUSE  SLOT  SLOT
  1     2     BUTTON      3     4

Uygulamanız, genişletilmiş kumandayı referans olarak GCKCastContext özelliğinin -[defaultExpandedMediaControlsViewController] özelliğiyle alabilir ve -[createMiniMediaControlsViewController] özelliğini kullanarak mini kumanda oluşturabilir.

Her alan bir çerçeve düğmesi, özel bir düğme içerebilir veya boş olabilir. Çerçeve kontrol düğmeleri listesi şu şekilde tanımlanır:

Düğme Türü Açıklama
GCKUIMediaButtonTypeNone Bu yuvaya düğme yerleştirmeyin
GCKUIMediaButtonTypeCustom Özel düğme
GCKUIMediaButtonTypePlayPauseToggle Oynatma ve duraklatma arasında geçiş yapar
GCKUIMediaButtonTypeSkipPrevious Sıradaki bir önceki öğeye atlar
GCKUIMediaButtonTypeSkipNext Sıradaki bir sonraki öğeye atlar
GCKUIMediaButtonTypeRewind30Seconds Oynatmayı 30 saniye geri sarar
GCKUIMediaButtonTypeForward30Seconds Oynatmayı 30 saniye ileri sarar
GCKUIMediaButtonTypeMuteToggle Uzak Web Alıcısı'nın sesini kapatır ve açar
GCKUIMediaButtonTypeClosedCaptions Metin ve ses parçalarını seçmek için bir iletişim kutusu açar

Her düğmenin ne yaptığına dair ayrıntılı açıklamaları GCKUIMediaButtonBarProtocol.h sayfasında bulabilirsiniz.

GCKUIMediaButtonBarProtocol üzerinde yöntemleri kullanarak aşağıdaki gibi bir düğme ekleyin:

  • Çubuka çerçeve düğmesi eklemek için yalnızca -[setButtonType:atIndex:] çağrısı gerekir.

  • Bir çubuğa özel düğme eklemek için uygulamanızın buttonType politikası GCKUIMediaButtonTypeCustom olacak şekilde -[setButtonType:atIndex:] çağırması ve ardından aynı dizinden UIButton değerini ileten -[setCustomButton:atIndex:] numarasını çağırması gerekir.

iOS uygulamanıza özel stiller uygulama

iOS'teki Cast SDK'sı, iOS göndereninizdeki varsayılan widget'ların yazı tipi, renk ve resimlerini stil belirleyerek uygulamanızın geri kalanıyla uyumlu bir görünüm ve tarz sunar.

Aşağıdaki bölümde Cast widget'larına veya widget grubuna özel stillerin nasıl uygulanacağı gösterilmektedir.

Bir widget'ın kullanıcı arayüzü öğesine bir stil uygulama

Bu prosedür, uygulamanızın mini kumandasının gövde metni rengini kırmızıya ayarlama örneğini kullanır.

  1. Stil oluşturmak istediğiniz widget'ın veya widget grubunun görünüm adını bulmak için görünüm ve stiller tablosuna bakın. Grup adları ▼ ile işaretlenir.

    Örnek: miniController widget görünümü

  2. Bu tabloda listelenen ilgili stil sınıfındaki özellikler listesinden değiştirmek istediğiniz özelliklerin adlarını bulun.

    Örnek: bodyTextColor, GCKUIStyleAttributesMiniController sınıfının bir özelliğidir.

  3. Kodu yazın.

    Örnek:

İsviçre
// Get the shared instance of GCKUIStyle
let castStyle = GCKUIStyle.sharedInstance()
// Set the property of the desired cast widget.
castStyle.castViews.mediaControl.miniController.bodyTextColor = UIColor.red
// Refresh all currently visible views with the assigned styles.
castStyle.apply()
Amaç C
// Get the shared instance of GCKUIStyle.
GCKUIStyle *castStyle = [GCKUIStyle sharedInstance];
// Set the property of the desired cast widget.
castStyle.castViews.mediaControl.miniController.bodyTextColor = [UIColor redColor];
// Refresh all currently visible views with the assigned styles.
[castStyle applyStyle];

Herhangi bir widget'ın herhangi bir kullanıcı arayüzü öğesine herhangi bir stili uygulamak için bu kalıbı kullanın.

Görünüm ve stil tablosu

Bu tabloda, stilleri uygulayabileceğiniz yedi widget görünümü ve üç grup (▼ ile işaretlenmiştir) gösterilmektedir.

Görünüm adı Tür Sınıf stilini belirle
castViews Grup GCKUIStyleAttributesCastView'lar
deviceControl Grup GCKUIStyleAttributesCihaz Denetimi
deviceChooser Widget GCKUIStyleAttributesCihazSeçici
noDevicesAvailableController Widget GCKUIStyleAttributesNoDeviceAvailableController
connectionController Grup GCKUIStyleAttributesConnectionController
navigation Widget GCKUIStyleAttributesConnectionNavigasyon
toolbar Widget GCKUIStyleAttributesConnectionAraç Çubuğu
guestModePairingDialog Widget GCKUIStyleAttributes davetli modu eşleme iletişim kutusu
mediaControl Grup GCKUIStyleAttributesMediaControl
miniController Widget GCKUIStyleAttributesMiniController
expandedController Widget GCKUIStyleAttributesExpandedController
trackSelector Widget GCKUIStyleAttributesTrackSeçici
instructions Widget GCKUIStyleAttributesTalimatlar

Stil hiyerarşisi

GCKUIStyle tek tip stili, tüm stil ayarları için API giriş noktasıdır. Aşağıda gösterildiği gibi stil hiyerarşisinin kökü olan castViews özelliğine sahiptir. Bu şema, önceki tabloda gösterilen aynı görünüm ve gruplara bakmanın farklı bir yoludur.

Bir stili tek bir widget'a veya bir widget grubuna uygulayabilirsiniz. Stil hiyerarşisinde üç widget grubu vardır: castViews, deviceControl ve mediaControl. Her grubun widget'ı, widget'larını içine alır. Bir stile uygulanan stil, o gruptaki tüm widget'lara uygulanır.

Örneğin, castViews grubu, tüm widget'lara bir stil uygulamanıza ve deviceControl grubu da bir stili yalnızca üç cihaz kontrol widget'ına uygulamanıza olanak tanır. instructions widget'ı herhangi bir gruba ait değil.

castViews
cihaz kontrolü medya kontrolü
talimatlar

cihaz
Seçici
noDevicesKullanılabilir ekran
bağlantı
Kumanda
mini
Kumanda
genişletilmiş
Kumanda
parça
Seçici
misafirMode
Eşleme İletişimi
gezinme / araç çubuğu

Dipnot: Bu şemada, iki satırda gösterilen widget adları bir kod olarak, tek satır halinde, boşluk olmadan yazılmalıdır. Örneğin, device Chooser yazılmalıdır deviceChooser. Resimleri büyütmek için resimlerin üzerine gelin.