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 iOS bằng cách sử dụng SDK Người gửi iOS.
Thiết bị di động hoặc máy tính xách tay là người gửi điều khiển quá trình phát và thiết bị Google Cast là trình thu hiển thị nội dung trên TV.
Khung trình gửi tham chiếu đến tệp nhị phân của thư viện lớp Cast và các tài nguyên liên kết có trong thời gian chạy trên trình gửi. Ứng dụng người gửi hoặc Ứng dụng truyền đề cập đến một ứng dụng cũng chạy trên người gửi. Ứng dụng Web receiver là ứng dụng HTML chạy trên Web receiver.
Khung của 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 của người gửi về các sự kiện và để chuyển đổi giữa các trạng thái khác nhau 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 ứng dụng iOS của người gửi:
- Khung Cast khởi động
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 danh sách các thiết bị Truyền đã phát hiện.
- Khi người dùng chọn một thiết bị Truyền, khung sẽ cố chạy ứng dụng Trình thu nhận web trên thiết bị truyền.
- Khung này sẽ gọi các lệnh gọi lại trong ứng dụng 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 một kênh liên lạc giữa người gửi và ứng dụng Trình nhận trên web.
- Khung này sử dụng kênh giao tiếp để tải và điều khiển quá trình phát nội dung nghe nhìn trên Web receiver.
- Khung sẽ đồng bộ hoá trạng thái phát nội dung nghe nhìn giữa người gửi và Trình nhận trên web: khi người dùng thực hiện thao tác trên giao diện người dùng của người gửi, khung sẽ chuyển các yêu cầu điều khiển nội dung nghe nhìn đó đến Trình nhận web và khi Trình nhận trên 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 Web receiver.
Để khắc phục sự cố đối với người gửi, bạn cần bật tính năng ghi nhật ký.
Để biết danh sách đầy đủ tất cả các lớp, phương thức và sự kiện trong khung Google Cast dành cho iOS, hãy xem Tài liệu tham khảo về API Google Cast dành cho iOS. Các phần sau đây trình bày các bước để tích hợp tính năng Truyền vào ứng dụng iOS.
Phương thức gọi từ luồng chính
Khởi chạy ngữ cảnh Truyền
Khung Cast có một đối tượng singleton toàn cầu, GCKCastContext, điều phối tất cả hoạt động của khung. Đối tượng này phải được khởi chạy sớm trong vòng đời của ứng dụng, thường là trong phương thức -[application:didFinishLaunchingWithOptions:] của thực thể uỷ quyền ứng dụng để quá trình 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 động 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, dùng để lọc kết quả khám phá và chạy ứng dụng Web receiver khi phiên Truyền bắt đầu.
Phương thức -[application:didFinishLaunchingWithOptions:] cũng là phương thức phù hợp để thiết lập uỷ quyền ghi nhật ký để nhận thông báo ghi 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 dành cho iOS cung cấp các tiện ích sau đây tuân thủ Danh sách kiểm tra thiết kế truyền:
Lớp phủ giới thiệu: Lớp
GCKCastContextcó một phương thứcpresentCastInstructionsViewControllerOnceWithCastButton, có thể dùng để làm nổi bật nút Truyền vào lần đầu tiên có Web receiver. Ứ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 dành cho thiết bị gửi iOS phiên bản 4.6.0, nút truyền sẽ luôn hiển thị khi thiết bị gửi được kết nối với Wi-Fi. Vào 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 lần đầu, 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 vào mạng cục bộ cho 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ẽ hiển thị, trong đó 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ị được 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 phòng thu 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 khi không có thiết bị nào, một màn hình sẽ xuất hiện để cho người dùng biết 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 bộ điều khiển mở rộng để sang một màn hình khác trong ứng dụng gửi, bộ điều khiển thu nhỏ sẽ hiển thị ở 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 về nội dung nghe nhìn hoặc bộ điều khiển thu nhỏ, thì tay điều khiển mở rộng sẽ khởi chạy. Bộ điều khiển mở rộng sẽ hiển thị siêu dữ liệu nội dung nghe nhìn 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 một thành phần nút Truyền dưới dạng một lớp con UIButton. Bạn có thể thêm phần tử này vào thanh tiêu đề của ứng dụng bằng cách gói trong một 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, thao tác nhấn vào nút này sẽ mở hộp thoại Truyền do khung cung cấp.
Bạn cũng có thể thêm GCKUICastButton trực tiếp vào bảng phân cảnh.
Định cấu hình chế độ khám phá thiết bị
Trong khung này, quá trình khám phá thiết bị sẽ diễn ra tự động. Bạn không cần bắt đầu hoặc dừng quá 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.
Hoạt động khám phá trong khung này do lớp GCKDiscoveryManager quản lý. Đâ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 từ vựng theo tên thân thiện với 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, một cách hoạt động kết hợp các bước kết nối với một thiết bị, 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 một kênh điều khiển nội dung nghe nhìn. Vui lòng xem Hướng dẫn về vòng đời của ứng dụng Web receiver để biết thêm thông tin về các phiên truyền và vòng đời của Trình nhận web.
Phiên hoạt động do lớp GCKSessionManager (một thuộc tính của GCKCastContext) quản lý.
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 đại diện cho các phiên có thiết bị Truyền. Bạn có thể truy cập phiên Truyền đang hoạt động (nếu có) dưới dạng thuộc tính currentCastSession của GCKSessionManager.
Bạn có thể dùng giao diện GCKSessionManagerListener để theo dõi các sự kiện trong phiên, chẳng hạn như tạo phiên, tạm ngưng, tiếp tục và chấm dứt. Khung này sẽ 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 ở chế độ 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ẽ tự động được tạo và thu nhỏ 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 cá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 thực hiện quy trình đặ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 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 sự kiện phát trực tiếp
Việc giữ nguyên trạng thái phiên là cơ sở của quá trình chuyển sự kiệ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 ngừ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 đến). Mọi thiết bị truyền 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 luồng.
Để tải thiết bị đích mới trong quá trình chuyển luồng, hãy sử dụng thuộc tính GCKCastSession#device trong quá trình gọi lại [sessionManager:didResumeCastSession:].
Hãy xem bài viết Chuyển luồng trên Web receiver để 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 khó phát hiện, chẳng hạn như:
- Khôi phục sau khi mất Wi-Fi tạm thời
- Khôi phục từ chế độ ngủ của thiết bị
- Khôi phục sau khi chạy ứng dụng ở chế độ nền
- Khôi phục nếu ứng dụng gặp sự cố
Cách hoạt động của tính năng điều khiển nội dung nghe nhìn
Nếu phiên Truyền được thiết lập bằng một ứng dụng Bộ thu web hỗ trợ không gian tên nội dung nghe nhìn, thì một thực thể của GCKRemoteMediaClient sẽ được khung tạo tự động; phiên đó có thể được truy cập dưới dạng thuộc tính remoteMediaClient của thực thể GCKCastSession.
Tất cả các phương thức trên GCKRemoteMediaClient gửi yêu cầu đến Trình nhận web sẽ trả về đối tượng GCKRequest có thể dùng để theo dõi yêu cầu đó. Bạn có thể gán 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.
Theo dự kiến, thực thể của GCKRemoteMediaClient có thể được chia sẻ giữa nhiều phần của ứng dụng và thực tế, một số thành phần nội bộ của khung này, chẳng hạn như hộp thoại Truyền và các tuỳ chọn điều khiển nội dung nghe nhìn nhỏ sẽ chia sẻ phiên bản này. Do đó, GCKRemoteMediaClient sẽ hỗ trợ đăng ký nhiều GCKRemoteMediaClientListener.
Thiết lập siêu dữ liệu đa phương tiện
Lớp GCKMediaMetadata biểu thị thông tin về mục nội dung đa phương tiện mà bạn muốn truyền. Ví dụ sau đây sẽ tạo một thực thể GCKMediaMetadata mới của một bộ phim và đặt tiêu đề, phụ đề, tên phòng thu 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 vào bộ nhớ đệm hình ảnh để biết cách sử dụng hình ảnh cùng với 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 cách sử dụng siêu dữ liệu của nội dung nghe nhìn đó. Sau đó, lấy GCKCastSession hiện tại và dùng GCKRemoteMediaClient để tải nội dung nghe nhìn trên ứng dụng nhận. Sau đó, bạn có thể dùng GCKRemoteMediaClient để điều khiển một ứng dụng trình phát nội dung nghe nhìn chạy trên receiver, 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 sử dụng các bản nhạc đa phương tiện.
Định dạng video 4K
Để xác định định dạng video có chứa nội dung nghe nhìn của bạ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.
Phiên bản này chứa loại định dạng TV HDR cũng như chiều cao và chiều rộng tính bằng pixel. Biến thể của định dạng 4K được biểu thị trong thuộc tính hdrType bằng các giá trị enum GCKVideoInfoHDRType.
Thêm tay điều khiển mini
Theo Danh sách kiểm tra thiết kế cho Cast, ứng dụng gửi phải cung cấp chế độ điều khiển liên tục (được gọi là bộ điều khiển 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. Bộ điều khiển thu nhỏ cho phép truy cập tức thì và hiển thị lời nhắc cho phiên Truyền hiện tại.
Khung Truyền 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 trình điều khiển thu nhỏ.
Khi ứng dụng gửi của bạn đang phát một video hoặc âm thanh trực tiếp, SDK sẽ tự động hiển thị nút phát/dừng thay cho nút phát/tạm dừng trong tay điều khiển nhỏ.
Xem Tuỳ chỉnh giao diện người 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 mini 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 trình điều khiển nhỏ bằng cách gói trình điều khiển chế độ xem hiện có với trình điều khiển chế độ xem riêng.
- Tự quản lý bố cục của tiện ích trình điều khiển nhỏ bằng cách thêm tiện ích đó vào trình đ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 bộ điều khiển chế độ xem khác và thêm GCKUIMiniMediaControlsViewController ở dưới cùng. Phương pháp này bị giới hạn ở 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 bộ điều khiển khung hiển thị vùng chứa.
Cách đầu tiên này thường được thực hiện trong phương thức
-[application:didFinishLaunchingWithOptions:] của uỷ quyền ứ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 bộ điều khiển chế độ xem hiện có
Cách thứ hai là thêm trực tiếp bộ điều khiển mini vào trình điều khiển khung hiển thị hiện có bằng cách dùng createMiniMediaControlsViewController để tạo thực thể GCKUIMiniMediaControlsViewController rồi thêm thực thể đó vào bộ điều khiển khung hiển thị vùng chứa dưới dạng một khung hiển thị phụ.
Thiết lập bộ điều khiển chế độ xem trong tính năng uỷ quyền ứ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 bộ điều khiển khung hiển thị gốc, hãy tạo một thực thể GCKUIMiniMediaControlsViewController rồi thêm thực thể đó vào bộ điều khiển chế độ xem vùng chứa dưới dạng một chế độ xem 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 sẽ thông báo cho bộ điều khiển khung hiển thị của máy chủ lưu trữ thời điểm hiển thị tay điều khiển thu nhỏ:
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ế của Google Cast yêu cầu một ứng dụng gửi yêu cầu cung cấp bộ điều khiển mở rộng cho nội dung nghe nhìn đang được truyền. Tay điều khiển mở rộng là phiên bản toàn màn hình của tay điều khiển mini.
Bộ điều khiển mở rộng là chế độ xem toàn màn hình cho phép toàn quyền kiểm soát việc phát nội dung nghe nhìn từ xa. Khung hiển thị 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 phiên truyền, ngoại trừ tính năng kiểm soát âm lượng của Bộ thu web và vòng đời phiên (kết nối/dừng truyền). Tệp này cũng cung cấp tất cả thông tin trạng thái về phiên phát nội dung đa phương tiện (hình minh hoạ, tiêu đề, phụ đề, v.v.).
Chức năng của khung hiển thị này được lớp GCKUIExpandedMediaControlsViewController triển khai.
Điều đầu tiên bạn phải làm là bật bộ điều khiển mở rộng mặc định trong ngữ cảnh truyền. Sửa đổi tính năng uỷ quyền ứng dụng để bật bộ đ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 chế độ xem để tải bộ đ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 tay điều khiển thu nhỏ.
Khi ứng dụng gửi của bạn đang phát video hoặc âm thanh trực tiếp, 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 Áp dụng kiểu tuỳ chỉnh cho ứng dụng iOS của bạn để 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.
Chỉnh âm lượng
Khung Cast tự động quản lý âm lượng cho ứng dụng gửi. Khung này tự động đồng bộ hoá với âm lượng của Trình thu nhận 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.
Kiểm soát â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ị gửi để thay đổi âm lượng của phiên Truyền trên Web receiver 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
Điều quan trọng là các ứng dụng gửi 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 tốt nhất cho từng giai đoạn trong vòng đời của tính năng Truyền. Ứng dụng có thể cho người dùng thấy hộp thoại lỗi hoặc có thể quyết định kết thúc phiên Truyền.
Ghi nhật ký
GCKLogger là một singleton được khung 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. Những thông điệp nhật ký này hỗ trợ việc gỡ lỗi và rất hữu ích trong việc khắc phục sự cố cũng như xác định sự cố. Theo mặc định, đầu ra nhật ký sẽ bị chặn, nhưng khi gán một GCKLoggerDelegate, ứng dụng gửi có thể nhận những thông báo này từ SDK và ghi chúng 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ũng như bật các thông báo gỡ lỗi và chi tiết, hãy thêm dòng này vào mã sau khi đặt phương thức uỷ quyền (hiển thị trước đó):
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 hình cầu, ví dụ: GCKUI\* và GCK\*Session.