Hướng dẫn dành cho nhà phát triển này mô tả cách thêm tính năng hỗ trợ Google Cast vào ứng dụng gửi trên iOS bằng SDK người gửi trên iOS.
Thiết bị di động hoặc máy tính xách tay là thiết bị gửi điều khiển quá trình phát, còn thiết bị Google Cast là thiết bị nhận hiển thị nội dung trên TV.
Khung người gửi là tệp nhị phân của thư viện lớp Cast và các tài nguyên liên quan có trong thời gian chạy trên người gửi. Ứng dụng của người gửi hoặc ứng dụng Truyền là ứng dụng cũng chạy trên thiết bị của người gửi. Ứng dụng Trình thu nhận web là ứng dụng HTML chạy trên Trình thu nhận web.
Khung người gửi sử dụng thiết kế lệnh gọi lại không đồng bộ để thông báo cho ứng dụng người gửi về các sự kiện và chuyển đổi giữa nhiều trạng thái trong vòng đời của ứng dụng Truyền.
Luồng ứng dụng
Các bước sau đây mô tả quy trình thực thi cấp cao thông thường cho một ứng dụng iOS của người gửi:
- Khung truyền bắt đầu
GCKDiscoveryManagerdựa trên các thuộc tính được cung cấp trongGCKCastOptionsđể bắt đầu quét tìm thiết bị. - Khi người dùng nhấp vào nút Truyền, khung sẽ hiển thị hộp thoại Truyền cùng với danh sách các thiết bị Truyền được phát hiện.
- Khi người dùng chọn một thiết bị Truyền, khung sẽ cố gắng chạy ứng dụng Trình thu nhận web trên thiết bị Truyền.
- Khung này gọi các lệnh gọi lại trong ứng dụng của người gửi để xác nhận rằng ứng dụng Trình nhận web đã được khởi chạy.
- Khung này tạo ra một kênh giao tiếp giữa ứng dụng của người gửi và ứng dụng Trình thu nhận web.
- Khung này sử dụng kênh giao tiếp để tải và điều khiển việc phát nội dung nghe nhìn trên Trình thu nhận web.
- Khung này đồng bộ hoá trạng thái phát nội dung nghe nhìn giữa người gửi và Bộ thu web: khi người dùng thực hiện các thao tác trên giao diện người dùng của người gửi, khung này sẽ chuyển các yêu cầu điều khiển nội dung nghe nhìn đó đến Bộ thu web và khi Bộ thu web gửi thông tin cập nhật về trạng thái nội dung nghe nhìn, khung này sẽ cập nhật trạng thái của giao diện người dùng của người gửi.
- Khi người dùng nhấp vào nút Truyền để ngắt kết nối khỏi thiết bị Truyền, khung sẽ ngắt kết nối ứng dụng của người gửi khỏi Trình nhận web.
Để khắc phục sự cố cho trình gửi, bạn cần bật tính năng ghi nhật ký.
Để xem danh sách đầy đủ tất cả các lớp, phương thức và sự kiện trong khung Google Cast iOS, hãy xem Tài liệu tham khảo về API Google Cast iOS. Các phần sau đây trình bày các bước để tích hợp Cast vào ứng dụng iOS.
Gọi các phương thức từ luồng chính
Khởi chạy bối cảnh Truyền
Khung Cast có một đối tượng singleton chung, GCKCastContext, điều phối tất cả hoạt động của khung. Bạn phải khởi chạy đối tượng này
ở giai đoạn đầu trong vòng đời của ứng dụng, thường là trong
phương thức -[application:didFinishLaunchingWithOptions:] của trình uỷ nhiệm ứng dụng, để
tính năng tự động tiếp tục phiên khi khởi động lại ứng dụng của người gửi có thể kích hoạt đúng cách.
Bạn phải cung cấp đối tượng GCKCastOptions khi khởi chạy GCKCastContext.
Lớp này chứa các tuỳ chọn ảnh hưởng đến hành vi của khung. Quan trọng nhất trong số này là mã ứng dụng Web Receiver, được dùng để lọc kết quả khám phá và chạy ứng dụng Web Receiver khi một phiên truyền bắt đầu.
Phương thức -[application:didFinishLaunchingWithOptions:] cũng là một nơi phù hợp để thiết lập một uỷ quyền ghi nhật ký nhằm nhận thông điệp nhật ký từ khung.
Những thông tin này có thể hữu ích cho việc gỡ lỗi và khắc phục sự cố.
@UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate, GCKLoggerDelegate { let kReceiverAppID = kGCKDefaultMediaReceiverApplicationID let kDebugLoggingEnabled = true var window: UIWindow? func applicationDidFinishLaunching(_ application: UIApplication) { let criteria = GCKDiscoveryCriteria(applicationID: kReceiverAppID) let options = GCKCastOptions(discoveryCriteria: criteria) GCKCastContext.setSharedInstanceWith(options) // Enable logger. GCKLogger.sharedInstance().delegate = self ... } // MARK: - GCKLoggerDelegate func logMessage(_ message: String, at level: GCKLoggerLevel, fromFunction function: String, location: String) { if (kDebugLoggingEnabled) { print(function + " - " + message) } } }
AppDelegate.h
@interface AppDelegate () <GCKLoggerDelegate> @end
AppDelegate.m
@implementation AppDelegate static NSString *const kReceiverAppID = @"AABBCCDD"; static const BOOL kDebugLoggingEnabled = YES; - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { GCKDiscoveryCriteria *criteria = [[GCKDiscoveryCriteria alloc] initWithApplicationID:kReceiverAppID]; GCKCastOptions *options = [[GCKCastOptions alloc] initWithDiscoveryCriteria:criteria]; [GCKCastContext setSharedInstanceWithOptions:options]; // Enable logger. [GCKLogger sharedInstance].delegate = self; ... return YES; } ... #pragma mark - GCKLoggerDelegate - (void)logMessage:(NSString *)message atLevel:(GCKLoggerLevel)level fromFunction:(NSString *)function location:(NSString *)location { if (kDebugLoggingEnabled) { NSLog(@"%@ - %@, %@", function, message, location); } } @end
Tiện ích trải nghiệm người dùng của Cast
SDK Truyền cho iOS cung cấp các tiện ích tuân thủ Danh sách kiểm tra thiết kế của Cast:
Lớp phủ giới thiệu: Lớp
GCKCastContextcó một phương thức,presentCastInstructionsViewControllerOnceWithCastButton, có thể dùng để làm nổi bật nút Truyền trong lần đầu tiên có Bộ thu web. Ứng dụng của người gửi có thể tuỳ chỉnh văn bản, vị trí của văn bản tiêu đề và nút Đóng.Nút Truyền: Kể từ SDK người gửi Cast iOS phiên bản 4.6.0, nút truyền luôn hiển thị khi thiết bị của người gửi kết nối với Wi-Fi. Lần đầu tiên người dùng nhấn vào nút Truyền sau khi khởi động ứng dụng, một hộp thoại cấp quyền sẽ xuất hiện để người dùng có thể cấp cho ứng dụng quyền truy cập mạng cục bộ vào các thiết bị trên mạng. Sau đó, khi người dùng nhấn vào nút truyền, một hộp thoại truyền sẽ xuất hiện và liệt kê các thiết bị được phát hiện. Khi người dùng nhấn vào nút truyền trong khi thiết bị đang kết nối, nút này sẽ hiển thị siêu dữ liệu nội dung nghe nhìn hiện tại (chẳng hạn như tiêu đề, tên của phòng thu âm và hình thu nhỏ) hoặc cho phép người dùng ngắt kết nối khỏi thiết bị truyền. Khi người dùng nhấn vào nút truyền trong khi không có thiết bị nào, một màn hình sẽ hiển thị để cung cấp cho người dùng thông tin về lý do không tìm thấy thiết bị và cách khắc phục sự cố.
Trình điều khiển thu nhỏ: Khi người dùng đang truyền nội dung và đã rời khỏi trang nội dung hiện tại hoặc trình điều khiển mở rộng để chuyển sang một màn hình khác trong ứng dụng của người gửi, trình điều khiển thu nhỏ sẽ xuất hiện ở cuối màn hình để cho phép người dùng xem siêu dữ liệu nội dung nghe nhìn đang truyền và điều khiển chế độ phát.
Bộ điều khiển mở rộng: Khi người dùng đang truyền nội dung, nếu họ nhấp vào thông báo nội dung nghe nhìn hoặc bộ điều khiển thu nhỏ, thì bộ điều khiển mở rộng sẽ khởi chạy, hiển thị siêu dữ liệu nội dung nghe nhìn đang phát và cung cấp một số nút để điều khiển việc phát nội dung nghe nhìn.
Thêm nút Truyền
Khung này cung cấp thành phần nút Truyền dưới dạng lớp con UIButton. Bạn có thể thêm nút này vào thanh tiêu đề của ứng dụng bằng cách gói nút này trong UIBarButtonItem. Một lớp con UIViewController thông thường có thể cài đặt nút Truyền như sau:
let castButton = GCKUICastButton(frame: CGRect(x: 0, y: 0, width: 24, height: 24)) castButton.tintColor = UIColor.gray navigationItem.rightBarButtonItem = UIBarButtonItem(customView: castButton)
GCKUICastButton *castButton = [[GCKUICastButton alloc] initWithFrame:CGRectMake(0, 0, 24, 24)]; castButton.tintColor = [UIColor grayColor]; self.navigationItem.rightBarButtonItem = [[UIBarButtonItem alloc] initWithCustomView:castButton];
Theo mặc định, khi nhấn vào nút này, hộp thoại Truyền do khung cung cấp sẽ mở ra.
Bạn cũng có thể thêm trực tiếp GCKUICastButton vào bảng phân cảnh.
Định cấu hình tính năng khám phá thiết bị
Trong khung, quá trình khám phá thiết bị sẽ tự động diễn ra. Bạn không cần phải bắt đầu hoặc dừng quy trình khám phá một cách rõ ràng, trừ phi bạn triển khai giao diện người dùng tuỳ chỉnh.
Tính năng khám phá trong khung được quản lý bởi lớp
GCKDiscoveryManager,
đây là một thuộc tính của
GCKCastContext. Khung này cung cấp một thành phần hộp thoại Truyền mặc định để lựa chọn và điều khiển thiết bị. Danh sách thiết bị được sắp xếp theo thứ tự bảng chữ cái dựa trên tên dễ nhớ của thiết bị.
Cách hoạt động của tính năng quản lý phiên
SDK Truyền giới thiệu khái niệm về phiên Truyền, việc thiết lập phiên này kết hợp các bước kết nối với thiết bị, khởi chạy (hoặc tham gia) ứng dụng Trình nhận web, kết nối với ứng dụng đó và khởi chạy kênh điều khiển nội dung nghe nhìn. Hãy xem Hướng dẫn về vòng đời ứng dụng của Trình thu nhận web để biết thêm thông tin về phiên truyền và vòng đời của Trình thu nhận web.
Phiên được quản lý bằng lớp
GCKSessionManager,
đây là một thuộc tính của
GCKCastContext.
Các phiên riêng lẻ được biểu thị bằng các lớp con của lớp GCKSession: ví dụ: GCKCastSession biểu thị các phiên có thiết bị Truyền. Bạn có thể truy cập vào phiên Truyền hiện đang hoạt động (nếu có) dưới dạng thuộc tính currentCastSession của GCKSessionManager.
Bạn có thể sử dụng giao diện GCKSessionManagerListener để theo dõi các sự kiện trong phiên, chẳng hạn như tạo, tạm ngưng, tiếp tục và chấm dứt phiên. Khung này tự động tạm ngưng các phiên khi ứng dụng của người gửi chuyển sang chạy trong nền và cố gắng tiếp tục các phiên đó khi ứng dụng quay lại nền trước (hoặc được chạy lại sau khi ứng dụng bị chấm dứt bất thường/đột ngột trong khi một phiên đang hoạt động).
Nếu hộp thoại Truyền đang được sử dụng, thì các phiên sẽ được tạo và huỷ tự động theo cử chỉ của người dùng. Nếu không, ứng dụng có thể bắt đầu và kết thúc phiên một cách rõ ràng thông qua các phương thức trên GCKSessionManager.
Nếu cần xử lý đặc biệt để phản hồi các sự kiện trong vòng đời của phiên, thì ứng dụng có thể đăng ký một hoặc nhiều thực thể GCKSessionManagerListener bằng GCKSessionManager. GCKSessionManagerListener là một giao thức xác định các lệnh gọi lại cho các sự kiện như bắt đầu phiên, kết thúc phiên, v.v.
Chuyển đổi phiên phát trực tuyến
Việc duy trì trạng thái phiên là cơ sở của tính năng chuyển đổi phiên phát trực tuyến, trong đó người dùng có thể di chuyển các luồng âm thanh và video hiện có trên các thiết bị bằng lệnh thoại, ứng dụng Google Home hoặc màn hình thông minh. Nội dung nghe nhìn sẽ dừng phát trên một thiết bị (nguồn) và tiếp tục phát trên một thiết bị khác (đích). Bất kỳ thiết bị Truyền nào có chương trình cơ sở mới nhất đều có thể đóng vai trò là nguồn hoặc đích đến trong quá trình chuyển đổi phiên phát trực tuyến.
Để lấy thiết bị đích mới trong quá trình chuyển đổi phiên phát trực tuyến, hãy sử dụng thuộc tính GCKCastSession#device trong lệnh gọi lại [sessionManager:didResumeCastSession:].
Hãy xem phần Chuyển đổi phiên phát trực tuyến trên Trình thu nhận web để biết thêm thông tin.
Tự động kết nối lại
Khung Cast bổ sung logic kết nối lại để tự động xử lý việc kết nối lại trong nhiều trường hợp đặc biệt, chẳng hạn như:
- Khôi phục sau khi tạm thời mất kết nối Wi-Fi
- Khôi phục từ chế độ ngủ của thiết bị
- Khôi phục sau khi ứng dụng chạy ở chế độ nền
- Khôi phục nếu ứng dụng gặp sự cố
Cách hoạt động của các nút điều khiển nội dung nghe nhìn
Nếu một phiên Truyền được thiết lập bằng ứng dụng Trình thu nhận web hỗ trợ không gian tên nội dung nghe nhìn, thì khung sẽ tự động tạo một thực thể của GCKRemoteMediaClient; bạn có thể truy cập vào thực thể này dưới dạng thuộc tính remoteMediaClient của thực thể GCKCastSession.
Tất cả phương thức trên GCKRemoteMediaClient đưa ra yêu cầu cho Bộ thu web sẽ trả về một đối tượng GCKRequest có thể dùng để theo dõi yêu cầu đó. Bạn có thể chỉ định một
GCKRequestDelegate
cho đối tượng này để nhận thông báo về kết quả cuối cùng của thao tác.
Thực thể GCKRemoteMediaClient có thể được chia sẻ bởi nhiều phần của ứng dụng và một số thành phần nội bộ của khung như hộp thoại Truyền và các nút điều khiển nội dung nghe nhìn nhỏ cũng chia sẻ thực thể này. Để làm được điều đó, GCKRemoteMediaClient hỗ trợ việc đăng ký nhiều GCKRemoteMediaClientListener.
Đặt siêu dữ liệu nội dung nghe nhìn
Lớp GCKMediaMetadata đại diện cho thông tin về một mục nội dung nghe nhìn mà bạn muốn truyền. Ví dụ sau đây tạo một thực thể GCKMediaMetadata mới của một bộ phim và đặt tiêu đề, phụ đề, tên của xưởng phim và hai hình ảnh.
let metadata = GCKMediaMetadata() metadata.setString("Big Buck Bunny (2008)", forKey: kGCKMetadataKeyTitle) metadata.setString("Big Buck Bunny tells the story of a giant rabbit with a heart bigger than " + "himself. When one sunny day three rodents rudely harass him, something " + "snaps... and the rabbit ain't no bunny anymore! In the typical cartoon " + "tradition he prepares the nasty rodents a comical revenge.", forKey: kGCKMetadataKeySubtitle) metadata.addImage(GCKImage(url: URL(string: "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/images/BigBuckBunny.jpg")!, width: 480, height: 360))
GCKMediaMetadata *metadata = [[GCKMediaMetadata alloc] initWithMetadataType:GCKMediaMetadataTypeMovie]; [metadata setString:@"Big Buck Bunny (2008)" forKey:kGCKMetadataKeyTitle]; [metadata setString:@"Big Buck Bunny tells the story of a giant rabbit with a heart bigger than " "himself. When one sunny day three rodents rudely harass him, something " "snaps... and the rabbit ain't no bunny anymore! In the typical cartoon " "tradition he prepares the nasty rodents a comical revenge." forKey:kGCKMetadataKeySubtitle]; [metadata addImage:[[GCKImage alloc] initWithURL:[[NSURL alloc] initWithString:@"https://commondatastorage.googleapis.com/" "gtv-videos-bucket/sample/images/BigBuckBunny.jpg"] width:480 height:360]];
Xem phần Lựa chọn và lưu hình ảnh vào bộ nhớ đệm để biết cách sử dụng hình ảnh có siêu dữ liệu nội dung nghe nhìn.
Tải nội dung nghe nhìn
Để tải một mục nội dung nghe nhìn, hãy tạo một thực thể GCKMediaInformation bằng siêu dữ liệu của nội dung nghe nhìn. Sau đó, hãy lấy GCKCastSession hiện tại và sử dụng GCKRemoteMediaClient của phiên đó để tải nội dung nghe nhìn trên ứng dụng nhận. Sau đó, bạn có thể sử dụng GCKRemoteMediaClient để điều khiển ứng dụng trình phát nội dung nghe nhìn đang chạy trên thiết bị nhận, chẳng hạn như để phát, tạm dừng và dừng.
let url = URL.init(string: "https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4") guard let mediaURL = url else { print("invalid mediaURL") return } let mediaInfoBuilder = GCKMediaInformationBuilder.init(contentURL: mediaURL) mediaInfoBuilder.streamType = GCKMediaStreamType.none; mediaInfoBuilder.contentType = "video/mp4" mediaInfoBuilder.metadata = metadata; mediaInformation = mediaInfoBuilder.build() guard let mediaInfo = mediaInformation else { print("invalid mediaInformation") return } if let request = sessionManager.currentSession?.remoteMediaClient?.loadMedia(mediaInfo) { request.delegate = self }
GCKMediaInformationBuilder *mediaInfoBuilder = [[GCKMediaInformationBuilder alloc] initWithContentURL: [NSURL URLWithString:@"https://commondatastorage.googleapis.com/gtv-videos-bucket/sample/BigBuckBunny.mp4"]]; mediaInfoBuilder.streamType = GCKMediaStreamTypeNone; mediaInfoBuilder.contentType = @"video/mp4"; mediaInfoBuilder.metadata = metadata; self.mediaInformation = [mediaInfoBuilder build]; GCKRequest *request = [self.sessionManager.currentSession.remoteMediaClient loadMedia:self.mediaInformation]; if (request != nil) { request.delegate = self; }
Ngoài ra, hãy xem phần về cách sử dụng bản nhạc đa phương tiện.
Định dạng video 4K
Để xác định định dạng video của nội dung nghe nhìn, hãy sử dụng thuộc tính videoInfo của GCKMediaStatus để lấy thực thể hiện tại của GCKVideoInfo.
Thực thể này chứa loại định dạng TV HDR, chiều cao và chiều rộng tính bằng pixel. Các biến thể của định dạng 4K được chỉ định trong thuộc tính hdrType bằng các giá trị enum GCKVideoInfoHDRType.
Thêm bộ điều khiển nhỏ
Theo Danh sách kiểm tra thiết kế Cast, ứng dụng của người gửi phải cung cấp một chế độ điều khiển liên tục được gọi là bộ điều khiển thu nhỏ. Bộ điều khiển này sẽ xuất hiện khi người dùng rời khỏi trang nội dung hiện tại. Trình điều khiển nhỏ giúp bạn truy cập tức thì và nhắc nhở trực quan về phiên Truyền hiện tại.
Khung Cast cung cấp một thanh điều khiển,
GCKUIMiniMediaControlsViewController,
có thể được thêm vào các cảnh mà bạn muốn hiển thị trình điều khiển thu nhỏ.
Khi ứng dụng gửi đang phát một sự kiện phát trực tiếp video hoặc âm thanh, SDK sẽ tự động hiển thị nút phát/dừng thay cho nút phát/tạm dừng trong bộ điều khiển thu nhỏ.
Xem phần Tuỳ chỉnh giao diện người dùng của ứng dụng gửi trên iOS để biết cách ứng dụng gửi có thể định cấu hình giao diện của các tiện ích Truyền.
Có hai cách để thêm bộ điều khiển thu nhỏ vào ứng dụng của người gửi:
- Cho phép khung Truyền quản lý bố cục của bộ điều khiển thu nhỏ bằng cách gói bộ điều khiển khung hiển thị hiện có bằng bộ điều khiển khung hiển thị riêng.
- Tự quản lý bố cục của tiện ích bộ điều khiển thu nhỏ bằng cách thêm tiện ích đó vào bộ điều khiển khung hiển thị hiện có bằng cách cung cấp một khung hiển thị phụ trong bảng phân cảnh.
Gói bằng GCKUICastContainerViewController
Cách đầu tiên là sử dụng
GCKUICastContainerViewController
để gói một trình điều khiển khung hiển thị khác và thêm
GCKUIMiniMediaControlsViewController
ở dưới cùng. Cách này bị hạn chế ở chỗ bạn không thể tuỳ chỉnh ảnh động và không thể định cấu hình hành vi của trình điều khiển khung hiển thị vùng chứa.
Cách đầu tiên thường được thực hiện trong phương thức -[application:didFinishLaunchingWithOptions:] của trình uỷ nhiệm ứng dụng:
func applicationDidFinishLaunching(_ application: UIApplication) { ... // Wrap main view in the GCKUICastContainerViewController and display the mini controller. let appStoryboard = UIStoryboard(name: "Main", bundle: nil) let navigationController = appStoryboard.instantiateViewController(withIdentifier: "MainNavigation") let castContainerVC = GCKCastContext.sharedInstance().createCastContainerController(for: navigationController) castContainerVC.miniMediaControlsItemEnabled = true window = UIWindow(frame: UIScreen.main.bounds) window!.rootViewController = castContainerVC window!.makeKeyAndVisible() ... }
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { ... // Wrap main view in the GCKUICastContainerViewController and display the mini controller. UIStoryboard *appStoryboard = [UIStoryboard storyboardWithName:@"Main" bundle:nil]; UINavigationController *navigationController = [appStoryboard instantiateViewControllerWithIdentifier:@"MainNavigation"]; GCKUICastContainerViewController *castContainerVC = [[GCKCastContext sharedInstance] createCastContainerControllerForViewController:navigationController]; castContainerVC.miniMediaControlsItemEnabled = YES; self.window = [[UIWindow alloc] initWithFrame:UIScreen.mainScreen.bounds]; self.window.rootViewController = castContainerVC; [self.window makeKeyAndVisible]; ... }
var castControlBarsEnabled: Bool { set(enabled) { if let castContainerVC = self.window?.rootViewController as? GCKUICastContainerViewController { castContainerVC.miniMediaControlsItemEnabled = enabled } else { print("GCKUICastContainerViewController is not correctly configured") } } get { if let castContainerVC = self.window?.rootViewController as? GCKUICastContainerViewController { return castContainerVC.miniMediaControlsItemEnabled } else { print("GCKUICastContainerViewController is not correctly configured") return false } } }
AppDelegate.h
@interface AppDelegate : UIResponder <UIApplicationDelegate> @property (nonatomic, strong) UIWindow *window; @property (nonatomic, assign) BOOL castControlBarsEnabled; @end
AppDelegate.m
@implementation AppDelegate ... - (void)setCastControlBarsEnabled:(BOOL)notificationsEnabled { GCKUICastContainerViewController *castContainerVC; castContainerVC = (GCKUICastContainerViewController *)self.window.rootViewController; castContainerVC.miniMediaControlsItemEnabled = notificationsEnabled; } - (BOOL)castControlBarsEnabled { GCKUICastContainerViewController *castContainerVC; castContainerVC = (GCKUICastContainerViewController *)self.window.rootViewController; return castContainerVC.miniMediaControlsItemEnabled; } ... @end
Nhúng vào trình điều khiển khung hiển thị hiện có
Cách thứ hai là thêm trực tiếp bộ điều khiển thu nhỏ vào bộ điều khiển khung hiển thị hiện có bằng cách sử dụng createMiniMediaControlsViewController để tạo một thực thể GCKUIMiniMediaControlsViewController, sau đó thêm thực thể đó vào bộ điều khiển khung hiển thị vùng chứa dưới dạng khung hiển thị phụ.
Thiết lập trình điều khiển khung hiển thị trong thực thể đại diện của ứng dụng:
func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplicationLaunchOptionsKey: Any]?) -> Bool { ... GCKCastContext.sharedInstance().useDefaultExpandedMediaControls = true window?.clipsToBounds = true let rootContainerVC = (window?.rootViewController as? RootContainerViewController) rootContainerVC?.miniMediaControlsViewEnabled = true ... return true }
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { ... [GCKCastContext sharedInstance].useDefaultExpandedMediaControls = YES; self.window.clipsToBounds = YES; RootContainerViewController *rootContainerVC; rootContainerVC = (RootContainerViewController *)self.window.rootViewController; rootContainerVC.miniMediaControlsViewEnabled = YES; ... return YES; }
Trong trình kiểm soát khung hiển thị gốc, hãy tạo một thực thể GCKUIMiniMediaControlsViewController và thêm thực thể đó vào trình kiểm soát khung hiển thị vùng chứa dưới dạng khung hiển thị phụ:
let kCastControlBarsAnimationDuration: TimeInterval = 0.20 @objc(RootContainerViewController) class RootContainerViewController: UIViewController, GCKUIMiniMediaControlsViewControllerDelegate { @IBOutlet weak private var _miniMediaControlsContainerView: UIView! @IBOutlet weak private var _miniMediaControlsHeightConstraint: NSLayoutConstraint! private var miniMediaControlsViewController: GCKUIMiniMediaControlsViewController! var miniMediaControlsViewEnabled = false { didSet { if self.isViewLoaded { self.updateControlBarsVisibility() } } } var overriddenNavigationController: UINavigationController? override var navigationController: UINavigationController? { get { return overriddenNavigationController } set { overriddenNavigationController = newValue } } var miniMediaControlsItemEnabled = false override func viewDidLoad() { super.viewDidLoad() let castContext = GCKCastContext.sharedInstance() self.miniMediaControlsViewController = castContext.createMiniMediaControlsViewController() self.miniMediaControlsViewController.delegate = self self.updateControlBarsVisibility() self.installViewController(self.miniMediaControlsViewController, inContainerView: self._miniMediaControlsContainerView) } func updateControlBarsVisibility() { if self.miniMediaControlsViewEnabled && self.miniMediaControlsViewController.active { self._miniMediaControlsHeightConstraint.constant = self.miniMediaControlsViewController.minHeight self.view.bringSubview(toFront: self._miniMediaControlsContainerView) } else { self._miniMediaControlsHeightConstraint.constant = 0 } UIView.animate(withDuration: kCastControlBarsAnimationDuration, animations: {() -> Void in self.view.layoutIfNeeded() }) self.view.setNeedsLayout() } func installViewController(_ viewController: UIViewController?, inContainerView containerView: UIView) { if let viewController = viewController { self.addChildViewController(viewController) viewController.view.frame = containerView.bounds containerView.addSubview(viewController.view) viewController.didMove(toParentViewController: self) } } func uninstallViewController(_ viewController: UIViewController) { viewController.willMove(toParentViewController: nil) viewController.view.removeFromSuperview() viewController.removeFromParentViewController() } override func prepare(for segue: UIStoryboardSegue, sender: Any?) { if segue.identifier == "NavigationVCEmbedSegue" { self.navigationController = (segue.destination as? UINavigationController) } } ...
RootContainerViewController.h
static const NSTimeInterval kCastControlBarsAnimationDuration = 0.20; @interface RootContainerViewController () <GCKUIMiniMediaControlsViewControllerDelegate> { __weak IBOutlet UIView *_miniMediaControlsContainerView; __weak IBOutlet NSLayoutConstraint *_miniMediaControlsHeightConstraint; GCKUIMiniMediaControlsViewController *_miniMediaControlsViewController; } @property(nonatomic, weak, readwrite) UINavigationController *navigationController; @property(nonatomic, assign, readwrite) BOOL miniMediaControlsViewEnabled; @property(nonatomic, assign, readwrite) BOOL miniMediaControlsItemEnabled; @end
RootContainerViewController.m
@implementation RootContainerViewController - (void)viewDidLoad { [super viewDidLoad]; GCKCastContext *castContext = [GCKCastContext sharedInstance]; _miniMediaControlsViewController = [castContext createMiniMediaControlsViewController]; _miniMediaControlsViewController.delegate = self; [self updateControlBarsVisibility]; [self installViewController:_miniMediaControlsViewController inContainerView:_miniMediaControlsContainerView]; } - (void)setMiniMediaControlsViewEnabled:(BOOL)miniMediaControlsViewEnabled { _miniMediaControlsViewEnabled = miniMediaControlsViewEnabled; if (self.isViewLoaded) { [self updateControlBarsVisibility]; } } - (void)updateControlBarsVisibility { if (self.miniMediaControlsViewEnabled && _miniMediaControlsViewController.active) { _miniMediaControlsHeightConstraint.constant = _miniMediaControlsViewController.minHeight; [self.view bringSubviewToFront:_miniMediaControlsContainerView]; } else { _miniMediaControlsHeightConstraint.constant = 0; } [UIView animateWithDuration:kCastControlBarsAnimationDuration animations:^{ [self.view layoutIfNeeded]; }]; [self.view setNeedsLayout]; } - (void)installViewController:(UIViewController *)viewController inContainerView:(UIView *)containerView { if (viewController) { [self addChildViewController:viewController]; viewController.view.frame = containerView.bounds; [containerView addSubview:viewController.view]; [viewController didMoveToParentViewController:self]; } } - (void)uninstallViewController:(UIViewController *)viewController { [viewController willMoveToParentViewController:nil]; [viewController.view removeFromSuperview]; [viewController removeFromParentViewController]; } - (void)prepareForSegue:(UIStoryboardSegue *)segue sender:(id)sender { if ([segue.identifier isEqualToString:@"NavigationVCEmbedSegue"]) { self.navigationController = (UINavigationController *)segue.destinationViewController; } } ... @end
GCKUIMiniMediaControlsViewControllerDelegate cho bộ điều khiển chế độ xem lưu trữ biết thời điểm bộ điều khiển thu nhỏ sẽ hiển thị:
func miniMediaControlsViewController(_: GCKUIMiniMediaControlsViewController, shouldAppear _: Bool) { updateControlBarsVisibility() }
- (void)miniMediaControlsViewController: (GCKUIMiniMediaControlsViewController *)miniMediaControlsViewController shouldAppear:(BOOL)shouldAppear { [self updateControlBarsVisibility]; }
Thêm bộ điều khiển mở rộng
Danh sách kiểm tra thiết kế Google Cast yêu cầu ứng dụng của người gửi phải cung cấp một bộ điều khiển mở rộng cho nội dung nghe nhìn đang được truyền. Trình điều khiển mở rộng là phiên bản toàn màn hình của trình điều khiển thu nhỏ.
Bộ điều khiển mở rộng là một chế độ xem toàn màn hình, cho phép bạn kiểm soát hoàn toàn việc phát nội dung nghe nhìn từ xa. Chế độ xem này sẽ cho phép ứng dụng truyền quản lý mọi khía cạnh có thể quản lý của một phiên truyền, ngoại trừ việc điều khiển âm lượng của Trình thu web và vòng đời của phiên (kết nối/dừng truyền). Nó cũng cung cấp tất cả thông tin về trạng thái của phiên phát nội dung nghe nhìn (hình minh hoạ, tiêu đề, phụ đề, v.v.).
Chức năng của thành phần hiển thị này được triển khai bằng lớp GCKUIExpandedMediaControlsViewController.
Việc đầu tiên bạn phải làm là bật trình điều khiển mở rộng mặc định trong bối cảnh truyền. Sửa đổi thực thể đại diện của ứng dụng để bật trình điều khiển mở rộng mặc định:
func applicationDidFinishLaunching(_ application: UIApplication) { .. GCKCastContext.sharedInstance().useDefaultExpandedMediaControls = true ... }
- (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { ... [GCKCastContext sharedInstance].useDefaultExpandedMediaControls = YES; .. }
Thêm mã sau vào trình điều khiển khung hiển thị để tải trình điều khiển mở rộng khi người dùng bắt đầu truyền video:
func playSelectedItemRemotely() { GCKCastContext.sharedInstance().presentDefaultExpandedMediaControls() ... // Load your media sessionManager.currentSession?.remoteMediaClient?.loadMedia(mediaInformation) }
- (void)playSelectedItemRemotely { [[GCKCastContext sharedInstance] presentDefaultExpandedMediaControls]; ... // Load your media [self.sessionManager.currentSession.remoteMediaClient loadMedia:mediaInformation]; }
Bộ điều khiển mở rộng cũng sẽ tự động chạy khi người dùng nhấn vào bộ điều khiển thu nhỏ.
Khi ứng dụng gửi đang phát một sự kiện phát trực tiếp video hoặc âm thanh, SDK sẽ tự động hiển thị nút phát/dừng thay cho nút phát/tạm dừng trong bộ điều khiển mở rộng.
Xem phần Áp dụng kiểu tuỳ chỉnh cho ứng dụng iOS để biết cách ứng dụng gửi có thể định cấu hình giao diện của các tiện ích Truyền.
Điều chỉnh âm lượng
Khung Truyền tự động quản lý âm lượng cho ứng dụng của người gửi. Khung này tự động đồng bộ hoá với âm lượng của Bộ thu web cho các tiện ích giao diện người dùng được cung cấp. Để đồng bộ hoá thanh trượt do ứng dụng cung cấp, hãy sử dụng GCKUIDeviceVolumeController.
Điều khiển âm lượng bằng nút vật lý
Bạn có thể dùng các nút âm lượng vật lý trên thiết bị của người gửi để thay đổi âm lượng của phiên Truyền trên Trình nhận web bằng cách sử dụng cờ physicalVolumeButtonsWillControlDeviceVolume trên GCKCastOptions, được đặt trên GCKCastContext.
let criteria = GCKDiscoveryCriteria(applicationID: kReceiverAppID) let options = GCKCastOptions(discoveryCriteria: criteria) options.physicalVolumeButtonsWillControlDeviceVolume = true GCKCastContext.setSharedInstanceWith(options)
GCKDiscoveryCriteria *criteria = [[GCKDiscoveryCriteria alloc] initWithApplicationID:kReceiverAppID]; GCKCastOptions *options = [[GCKCastOptions alloc] initWithDiscoveryCriteria :criteria]; options.physicalVolumeButtonsWillControlDeviceVolume = YES; [GCKCastContext setSharedInstanceWithOptions:options];
Xử lý lỗi
Ứng dụng của người gửi cần phải xử lý tất cả các lệnh gọi lại lỗi và quyết định phản hồi phù hợp nhất cho từng giai đoạn của vòng đời Truyền. Ứng dụng có thể hiển thị hộp thoại lỗi cho người dùng hoặc có thể quyết định kết thúc phiên Truyền.
Xin lưu ý rằng một số lỗi, bao gồm cả
GCKErrorCode
GCKErrorCodeCancelled, là hành vi có chủ đích.
Đừng cố gắng thử lại một kết nối không thành công với GCKErrorCodeCancelled.
Nếu bạn làm vậy, hoạt động không mong muốn có thể xảy ra.
Ghi nhật ký
GCKLogger
là một singleton được khung sử dụng để ghi nhật ký. Sử dụng
GCKLoggerDelegate
để tuỳ chỉnh cách bạn xử lý thông điệp nhật ký.
Khi sử dụng GCKLogger, SDK sẽ tạo ra kết quả ghi nhật ký dưới dạng thông báo gỡ lỗi, lỗi và cảnh báo. Các thông điệp nhật ký này hỗ trợ việc gỡ lỗi và hữu ích cho việc khắc phục sự cố cũng như xác định vấn đề. Theo mặc định, kết quả nhật ký sẽ bị chặn, nhưng bằng cách chỉ định GCKLoggerDelegate, ứng dụng của người gửi có thể nhận các thông báo này từ SDK và ghi lại vào bảng điều khiển hệ thống.
@UIApplicationMain class AppDelegate: UIResponder, UIApplicationDelegate, GCKLoggerDelegate { let kReceiverAppID = kGCKDefaultMediaReceiverApplicationID let kDebugLoggingEnabled = true var window: UIWindow? func applicationDidFinishLaunching(_ application: UIApplication) { ... // Enable logger. GCKLogger.sharedInstance().delegate = self ... } // MARK: - GCKLoggerDelegate func logMessage(_ message: String, at level: GCKLoggerLevel, fromFunction function: String, location: String) { if (kDebugLoggingEnabled) { print(function + " - " + message) } } }
AppDelegate.h
@interface AppDelegate () <GCKLoggerDelegate> @end
AppDelegate.m
@implementation AppDelegate static NSString *const kReceiverAppID = @"AABBCCDD"; static const BOOL kDebugLoggingEnabled = YES; - (BOOL)application:(UIApplication *)application didFinishLaunchingWithOptions:(NSDictionary *)launchOptions { ... // Enable logger. [GCKLogger sharedInstance].delegate = self; ... return YES; } ... #pragma mark - GCKLoggerDelegate - (void)logMessage:(NSString *)message atLevel:(GCKLoggerLevel)level fromFunction:(NSString *)function location:(NSString *)location { if (kDebugLoggingEnabled) { NSLog(@"%@ - %@, %@", function, message, location); } } @end
Để bật cả thông báo gỡ lỗi và thông báo chi tiết, hãy thêm dòng này vào mã sau khi đặt trình uỷ quyền (như minh hoạ ở trên):
let filter = GCKLoggerFilter.init() filter.minimumLevel = GCKLoggerLevel.verbose GCKLogger.sharedInstance().filter = filter
GCKLoggerFilter *filter = [[GCKLoggerFilter alloc] init]; [filter setMinimumLevel:GCKLoggerLevelVerbose]; [GCKLogger sharedInstance].filter = filter;
Bạn cũng có thể lọc các thông điệp nhật ký do GCKLogger tạo ra.
Đặt cấp độ ghi nhật ký tối thiểu cho mỗi lớp, ví dụ:
let filter = GCKLoggerFilter.init() filter.setLoggingLevel(GCKLoggerLevel.verbose, forClasses: ["GCKUICastButton", "GCKUIImageCache", "NSMutableDictionary"]) GCKLogger.sharedInstance().filter = filter
GCKLoggerFilter *filter = [[GCKLoggerFilter alloc] init]; [filter setLoggingLevel:GCKLoggerLevelVerbose forClasses:@[@"GCKUICastButton", @"GCKUIImageCache", @"NSMutableDictionary" ]]; [GCKLogger sharedInstance].filter = filter;
Tên lớp có thể là tên cố định hoặc mẫu glob, ví dụ: GCKUI\* và GCK\*Session.