ภาพรวม
ตัวควบคุมสำหรับมุมมอง UI ที่ใช้เพื่อควบคุมหรือแสดงสถานะการเล่นสื่อในตัวรับ Cast
แอปพลิเคชันการโทรจะลงทะเบียนตัวควบคุม UI ที่เกี่ยวข้องกับสื่อกับตัวควบคุมโดยการตั้งค่าพร็อพเพอร์ตี้ที่เหมาะสม จากนั้นตัวควบคุมจะตอบสนองต่อเหตุการณ์การแตะบนตัวควบคุมโดยการออกคำสั่งสื่อที่เหมาะสมไปยังตัวรับ และอัปเดตตัวควบคุมตามข้อมูลสถานะและข้อมูลเมตาสื่อที่ได้รับจากตัวรับ ตัวควบคุมจะเปิดและปิดใช้ตัวควบคุม UI โดยอัตโนมัติตามความเหมาะสมกับเซสชันปัจจุบันและสถานะของมีเดียเพลเยอร์ นอกจากนี้ยังปิดใช้การควบคุมทั้งหมดในขณะที่คำขออยู่ระหว่างดำเนินการ
ดูโปรโตคอลการมอบสิทธิ์ได้ที่ GCKUIMediaControllerDelegate
- Since
- 3.0
รับค่า NSObject
สรุปวิธีการของอินสแตนซ์ | |
| (instancetype) | - init |
| เริ่มต้นอินสแตนซ์ เพิ่มเติม... | |
| (void) | - bindLabel:toMetadataKey: |
| เชื่อมโยง UILabel กับคีย์ข้อมูลเมตา เพิ่มเติม... | |
| (void) | - bindLabel:toMetadataKey:withFormatter: |
| เชื่อมโยง UILabel กับคีย์ข้อมูลเมตา เพิ่มเติม... | |
| (void) | - bindTextView:toMetadataKey: |
| เชื่อมโยง UITextView กับคีย์ข้อมูลเมตา เพิ่มเติม... | |
| (void) | - bindTextView:toMetadataKey:withFormatter: |
| เชื่อมโยง UITextView กับคีย์ข้อมูลเมตา เพิ่มเติม... | |
| (void) | - bindImageView:toImageHints: |
| เชื่อมโยง UIImageView กับอินสแตนซ์ GCKUIImageHints เพิ่มเติม... | |
| (void) | - unbindView: |
| ยกเลิกการเชื่อมโยงมุมมองที่ระบุ เพิ่มเติม... | |
| (void) | - unbindAllViews |
| ยกเลิกการเชื่อมโยงมุมมองที่เชื่อมโยงทั้งหมด เพิ่มเติม... | |
| (GCKMediaRepeatMode) | - cycleRepeatMode |
| เปลี่ยนโหมดเล่นซ้ำสำหรับคิวเป็นโหมดถัดไปในรอบเพิ่มเติม... | |
| (void) | - selectTracks |
| วิธีที่สะดวกในการแสดง UI การเลือกแทร็กสื่อ เพิ่มเติม... | |
สรุปพร็อพเพอร์ตี้ | |
| id< GCKUIMediaControllerDelegate > | delegate |
| ผู้รับมอบสิทธิ์ในการรับการแจ้งเตือนจาก GCKUIMediaController เพิ่มเติม... | |
| GCKSession * | session |
| เซสชันที่เชื่อมโยงกับตัวควบคุมนี้ เพิ่มเติม... | |
| BOOL | mediaLoaded |
| มีสื่อที่โหลด (หรือกำลังโหลด) อยู่ในเครื่องรับหรือไม่ เพิ่มเติม... | |
| BOOL | hasCurrentQueueItem |
| มีรายการปัจจุบันในคิวหรือไม่ เพิ่มเติม... | |
| BOOL | hasLoadingQueueItem |
| มีรายการที่กำลังโหลดล่วงหน้าในคิวหรือไม่ เพิ่มเติม... | |
| GCKMediaPlayerState | lastKnownPlayerState |
| สถานะมีเดียเพลเยอร์ที่ทราบล่าสุด เพิ่มเติม... | |
| NSTimeInterval | lastKnownStreamPosition |
| ตำแหน่งสตรีมสื่อที่ทราบล่าสุด เพิ่มเติม... | |
| UIButton * | playButton |
| ปุ่ม "เล่น" เพิ่มเติม... | |
| UIButton * | pauseButton |
| ปุ่ม "หยุดชั่วคราว" เพิ่มเติม... | |
| GCKUIButton * | playPauseToggleButton |
| ปุ่มเปิด/ปิด "เล่น/หยุดชั่วคราว" เพิ่มเติม... | |
| GCKUIPlayPauseToggleController * | playPauseToggleController |
| ตัวควบคุมการสลับ "เล่น/หยุดชั่วคราว" เพิ่มเติม... | |
| UIButton * | stopButton |
| ปุ่ม "หยุด" เพิ่มเติม... | |
| GCKUIButton * | forward30SecondsButton |
| ปุ่มสำหรับกรอไปข้างหน้า 30 วินาทีในรายการสื่อที่กำลังเล่นอยู่ เพิ่มเติม... | |
| GCKUIButton * | rewind30SecondsButton |
| ปุ่มสำหรับกรอกลับ 30 วินาทีในรายการสื่อที่กำลังเล่นอยู่ เพิ่มเติม... | |
| UIButton * | pauseQueueButton |
| ปุ่มสำหรับหยุดการเล่นคิวชั่วคราวเมื่อรายการปัจจุบันเล่นจบ เพิ่มเติม... | |
| UIButton * | nextButton |
| ปุ่ม "ถัดไป" เพิ่มเติม... | |
| UIButton * | previousButton |
| ปุ่ม "ก่อนหน้า" เพิ่มเติม... | |
| GCKUIButton * | repeatModeButton |
| ปุ่มสำหรับวนดูโหมดเล่นซ้ำในคิวที่มีให้ใช้งาน เพิ่มเติม... | |
| UISlider * | streamPositionSlider |
| แถบเลื่อนสำหรับแสดงและเปลี่ยนตำแหน่งสตรีมปัจจุบัน เพิ่มเติม... | |
| UIProgressView * | streamProgressView |
| มุมมองสำหรับแสดงความคืบหน้าของสตรีมปัจจุบัน เพิ่มเติม... | |
| UILabel * | streamPositionLabel |
| ป้ายกำกับสำหรับแสดงตำแหน่งสตรีมปัจจุบันเป็นนาทีและวินาที เพิ่มเติม... | |
| UILabel * | streamDurationLabel |
| ป้ายกำกับสำหรับแสดงระยะเวลาของสตรีมปัจจุบัน หน่วยเป็นนาทีและวินาที เพิ่มเติม... | |
| UILabel * | streamTimeRemainingLabel |
| ป้ายกำกับสำหรับแสดงเวลาที่เหลือในการสตรีม (ระยะเวลาลบด้วยตำแหน่ง) เป็นนาทีและวินาที เพิ่มเติม... | |
| GCKUIStreamPositionController * | streamPositionController |
| ตัวควบคุมตำแหน่งสตรีม เพิ่มเติม... | |
| BOOL | displayTimeRemainingAsNegativeValue |
| ไม่ว่าจะแสดงเวลาสตรีมที่เหลือเป็นค่าลบหรือไม่ เช่น "-1:23:45" เพิ่มเติม... | |
| UIButton * | tracksButton |
| ปุ่มสำหรับเลือกแทร็กเสียงและ/หรือคำบรรยายแทนเสียงหรือคำบรรยาย เพิ่มเติม... | |
| UILabel * | smartSubtitleLabel |
| ป้ายกำกับสำหรับแสดงคำบรรยายแทนเสียงของสื่อที่โหลดอยู่ในปัจจุบัน เพิ่มเติม... | |
| UIActivityIndicatorView * | mediaLoadingIndicator |
| มุมมองตัวบ่งชี้กิจกรรมสำหรับระบุว่าสื่ออยู่ในสถานะกำลังโหลด เพิ่มเติม... | |
รายละเอียดวิธีการ
| - (instancetype) init |
เริ่มต้นอินสแตนซ์
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
เชื่อมโยง UILabel กับคีย์ข้อมูลเมตา
มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง
ดูรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้าได้ที่ GCKMediaMetadata
- Parameters
-
label The UILabel that will display the value. key The metadata key.
| - (void) bindLabel: | (UILabel *) | label | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
เชื่อมโยง UILabel กับคีย์ข้อมูลเมตา
มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง
ดูรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้าได้ที่ GCKMediaMetadata
- Parameters
-
label The UILabel that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
เชื่อมโยง UITextView กับคีย์ข้อมูลเมตา
มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง
ดูรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้าได้ที่ GCKMediaMetadata
- Parameters
-
textView The UITextView that will display the value. key The metadata key.
| - (void) bindTextView: | (UITextView *) | textView | |
| toMetadataKey: | (NSString *) | key | |
| withFormatter: | (GCKUIValueFormatter) | formatter | |
เชื่อมโยง UITextView กับคีย์ข้อมูลเมตา
มุมมองจะแสดงค่าปัจจุบันของช่องข้อมูลเมตาที่เกี่ยวข้อง
ดูรายการคีย์ข้อมูลเมตาที่กำหนดไว้ล่วงหน้าได้ที่ GCKMediaMetadata
- Parameters
-
textView The UITextView that will display the value. key The metadata key. formatter A block that will produce the desired string representation of the value.
| - (void) bindImageView: | (UIImageView *) | imageView | |
| toImageHints: | (GCKUIImageHints *) | imageHints | |
เชื่อมโยง UIImageView กับอินสแตนซ์ GCKUIImageHints
ระบบจะใช้ UIImagePicker ที่ติดตั้งอยู่ในปัจจุบันเพื่อเลือกรูปภาพจากข้อมูลเมตาสำหรับมุมมอง
- Parameters
-
imageView The UIImageView that will display the selected image. imageHints The image hints.
| - (void) unbindView: | (UIView *) | view |
ยกเลิกการเชื่อมโยงมุมมองที่ระบุ
- Parameters
-
view The view to unbind.
| - (void) unbindAllViews |
ยกเลิกการเชื่อมโยงมุมมองที่เชื่อมโยงทั้งหมด
| - (GCKMediaRepeatMode) cycleRepeatMode |
เปลี่ยนโหมดการเล่นซ้ำสำหรับคิวเป็นโหมดถัดไปในรอบ
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
- การคืนสินค้า
- โหมดเล่นซ้ำใหม่
| - (void) selectTracks |
วิธีที่สะดวกในการแสดง UI การเลือกแทร็กสื่อ
รายละเอียดพร็อพเพอร์ตี้
|
readwritenonatomicweak |
ผู้รับมอบสิทธิ์ในการรับการแจ้งเตือนจาก GCKUIMediaController
|
readnonatomicstrong |
เซสชันที่เชื่อมโยงกับตัวควบคุมนี้
|
readnonatomicassign |
มีสื่อที่โหลด (หรือกำลังโหลด) อยู่ในเครื่องรับหรือไม่
หากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ ไอคอนนี้จะเป็น NO
|
readnonatomicassign |
มีรายการปัจจุบันในคิวหรือไม่
|
readnonatomicassign |
มีรายการที่กำลังโหลดล่วงหน้าในคิวหรือไม่
|
readnonatomicassign |
สถานะมีเดียเพลเยอร์ที่ทราบล่าสุด
หากไม่มีเซสชันแคสต์ที่ใช้งานอยู่ สถานะนี้จะเป็นสถานะของเพลเยอร์ก่อนที่เซสชันล่าสุดจะสิ้นสุดลง หากไม่มีเซสชันก่อนหน้า ค่านี้จะเป็น GCKMediaPlayerStateUnknown
|
readnonatomicassign |
ตำแหน่งสตรีมสื่อที่ทราบล่าสุด
หากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ นี่จะเป็นตำแหน่งสตรีมของสื่อก่อนที่เซสชันล่าสุดจะสิ้นสุดลง หากไม่มีเซสชันก่อนหน้า ค่านี้จะเป็น kGCKInvalidTimeInterval
|
readwritenonatomicweak |
ปุ่ม "เล่น"
เมื่อแตะปุ่ม ระบบจะเริ่มหรือกลับมาเล่นต่อในตัวรับสัญญาณสำหรับสื่อที่โหลดอยู่ในปัจจุบัน ปุ่มนี้จะปิดใช้หากกำลังเล่นอยู่ หรือหากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชัน Cast ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
ปุ่ม "หยุดชั่วคราว"
เมื่อแตะปุ่มนี้ ระบบจะหยุดเล่นสื่อที่โหลดอยู่ในปัจจุบันบนตัวรับสัญญาณชั่วคราว ปุ่มนี้จะปิดใช้หากสื่อที่โหลดอยู่ในปัจจุบันไม่รองรับการหยุดชั่วคราว หรือหากการเล่นไม่ได้ดำเนินการอยู่ หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชัน Cast ที่ใช้งานอยู่ในปัจจุบัน
|
readwritenonatomicweak |
ปุ่มเปิด/ปิด "เล่น/หยุดชั่วคราว"
ผู้โทรควรกำหนดไอคอนที่เหมาะสมสำหรับสถานะ GCKUIControlStatePlay และ GCKUIControlStatePause ของปุ่ม ซึ่งได้แก่ ไอคอน "หยุดชั่วคราว" สำหรับสถานะเล่น และไอคอน "เล่น" สำหรับสถานะหยุดชั่วคราว สถานะของปุ่มจะได้รับการอัปเดตโดยอัตโนมัติเพื่อให้สอดคล้องกับสถานะการเล่นปัจจุบันบนเครื่องรับ เมื่อแตะปุ่มนี้ ระบบจะหยุดเล่นสื่อที่โหลดอยู่ในปัจจุบันชั่วคราวหรือกลับมาเล่นต่อบนตัวรับ ปุ่มนี้จะปิดใช้หากสื่อที่โหลดอยู่ในปัจจุบันไม่รองรับการหยุดชั่วคราว หรือหากการเล่นไม่ได้กำลังดำเนินการหรือหยุดชั่วคราว หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชัน Cast ที่ใช้งานอยู่ในปัจจุบัน
|
readwritenonatomicstrong |
ตัวควบคุมการสลับ "เล่น/หยุดชั่วคราว"
ใช้แทน UI สลับเล่น/หยุดชั่วคราวที่กำหนดเองซึ่งแอปพลิเคชันจัดหาให้ ดูรายละเอียดได้ที่ GCKUIPlayPauseToggleController
- Since
- 3.4
|
readwritenonatomicweak |
ปุ่ม "หยุด"
เมื่อแตะปุ่มนี้ ระบบจะหยุดเล่นสื่อที่โหลดอยู่ในปัจจุบันบนตัวรับ ปุ่มนี้จะปิดใช้หากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
ปุ่มสำหรับกรอไปข้างหน้า 30 วินาทีในรายการสื่อที่กำลังเล่นอยู่
ปุ่มนี้จะปิดใช้หากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
ปุ่มสำหรับกรอกลับ 30 วินาทีในรายการสื่อที่กำลังเล่นอยู่
ปุ่มนี้จะปิดใช้หากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
ปุ่มสำหรับหยุดการเล่นคิวชั่วคราวเมื่อรายการปัจจุบันเล่นจบ
|
readwritenonatomicweak |
ปุ่ม "ถัดไป"
เมื่อแตะปุ่มนี้ การเล่นจะย้ายไปยังรายการสื่อถัดไปในคิว ปุ่มจะปิดใช้หากไม่รองรับการดำเนินการ หรือหากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
ปุ่ม "ก่อนหน้า"
เมื่อแตะปุ่มนี้ การเล่นจะย้ายไปยังรายการสื่อก่อนหน้าในคิว ปุ่มจะปิดใช้หากไม่รองรับการดำเนินการ หรือหากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
ปุ่มสำหรับวนดูโหมดเล่นซ้ำในคิวที่มีให้ใช้งาน
(ดู GCKMediaRepeatMode) ผู้เรียกควรตั้งค่าไอคอนที่เหมาะสมสำหรับสถานะ UIControlStateNormal (ปิดการทำซ้ำ), GCKUIControlStateRepeatSingle, GCKUIControlStateRepeatAll และ GCKUIControlStateShuffle ของปุ่ม สถานะของปุ่มจะอัปเดตโดยอัตโนมัติเพื่อแสดงโหมดเล่นซ้ำในคิวปัจจุบันบนเครื่องรับ การแตะปุ่มจะสลับไปยังโหมดเล่นซ้ำถัดไปตามลำดับต่อไปนี้
GCKMediaRepeatModeOff → GCKMediaRepeatModeAll → GCKMediaRepeatModeSingle → GCKMediaRepeatModeAllAndShuffle
ปุ่มนี้จะปิดใช้หากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในขณะนี้
|
readwritenonatomicweak |
แถบเลื่อนสำหรับแสดงและเปลี่ยนตำแหน่งสตรีมปัจจุบัน
เมื่อผู้ใช้เปลี่ยนค่าของแถบเลื่อน ระบบจะอัปเดตตำแหน่งสตรีมของสื่อที่โหลดอยู่ในปัจจุบันบนตัวรับ ขณะที่เล่นสื่อบนตัวรับ ค่าของแถบเลื่อนจะได้รับการอัปเดตแบบเรียลไทม์เพื่อให้สอดคล้องกับตำแหน่งสตรีมปัจจุบัน แถบเลื่อนจะปิดใช้หากสื่อที่โหลดอยู่ในปัจจุบันไม่รองรับการกรอ หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชัน Cast ที่ใช้งานอยู่ในปัจจุบัน
|
readwritenonatomicweak |
มุมมองสำหรับแสดงความคืบหน้าของสตรีมปัจจุบัน
ขณะที่การเล่นสื่อกำลังดำเนินการบนเครื่องรับ ระบบจะอัปเดตค่าของมุมมองแบบเรียลไทม์เพื่อให้สอดคล้องกับตำแหน่งสตรีมปัจจุบัน ระบบจะปิดใช้มุมมองหากสื่อที่โหลดอยู่ในปัจจุบันเป็นไลฟ์สด หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชัน Cast ที่ใช้งานอยู่ในปัจจุบัน
|
readwritenonatomicweak |
ป้ายกำกับสำหรับแสดงตำแหน่งสตรีมปัจจุบันเป็นนาทีและวินาที
หากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในปัจจุบัน ป้ายกำกับจะแสดงรูปแบบ "--:--" ที่แปลเป็นภาษาท้องถิ่น
|
readwritenonatomicweak |
ป้ายกำกับสำหรับแสดงระยะเวลาของสตรีมปัจจุบัน หน่วยเป็นนาทีและวินาที
หากสื่อที่โหลดอยู่ในปัจจุบันไม่มีระยะเวลา (เช่น เป็นไลฟ์สด) หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในปัจจุบัน ป้ายกำกับจะแสดงรูปแบบ "--:--" ที่แปลเป็นภาษาท้องถิ่น
|
readwritenonatomicweak |
ป้ายกำกับสำหรับแสดงเวลาที่เหลือในการสตรีม (ระยะเวลาลบด้วยตำแหน่ง) เป็นนาทีและวินาที
หากสื่อที่โหลดอยู่ในปัจจุบันไม่มีระยะเวลา (เช่น เป็นไลฟ์สด) หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชันการแคสต์ที่ใช้งานอยู่ในปัจจุบัน ป้ายกำกับจะแสดงรูปแบบ "--:--" ที่แปลเป็นภาษาท้องถิ่น
|
readwritenonatomicstrong |
ตัวควบคุมตำแหน่งสตรีม
ใช้แทนตำแหน่งสตรีมที่กำหนดเองและ UI การกรอที่แอปพลิเคชันจัดหาให้ ดูรายละเอียดได้ที่ GCKUIStreamPositionController
- Since
- 3.4
|
readwritenonatomicassign |
ไม่ว่าจะแสดงเวลาสตรีมที่เหลือเป็นค่าลบหรือไม่ เช่น "-1:23:45"
โดยค่าเริ่มต้น พร็อพเพอร์ตี้นี้จะตั้งค่าเป็น YES
|
readwritenonatomicweak |
ปุ่มสำหรับเลือกแทร็กเสียงและ/หรือคำบรรยายแทนเสียงหรือคำบรรยาย
เมื่อแตะปุ่ม ระบบจะแสดง UI การเลือกแทร็กสื่อต่อผู้ใช้ ปุ่มจะปิดใช้หากสื่อที่โหลดอยู่ในปัจจุบันไม่มีแทร็กสื่อที่เลือกได้ หรือหากไม่มีสื่อที่โหลดอยู่ในปัจจุบัน หรือหากไม่มีเซสชัน Cast ที่ใช้งานอยู่ในปัจจุบัน
|
readwritenonatomicweak |
ป้ายกำกับสำหรับแสดงคำบรรยายแทนเสียงของสื่อที่โหลดอยู่ในปัจจุบัน
หากไม่มีการตั้งค่าฟิลด์คำบรรยายแทนเสียงอย่างชัดเจนในข้อมูลเมตา ค่ายเพลงจะแสดงฟิลด์ข้อมูลเมตาที่เหมาะสมที่สุดตามประเภทสื่อ เช่น ชื่อสตูดิโอสำหรับภาพยนตร์ หรือชื่อศิลปินสำหรับแทร็กเพลง
|
readwritenonatomicweak |
มุมมองตัวบ่งชี้กิจกรรมสำหรับระบุว่าสื่ออยู่ในสถานะกำลังโหลด