ภาพรวม
ตัวควบคุมสําหรับมุมมอง UI ที่ใช้เพื่อควบคุมหรือแสดงสถานะการเล่นสื่อบนตัวรับการแคสต์
แอปพลิเคชันการโทรจะลงทะเบียนตัวควบคุม 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
ระบบจะใช้ UIImageInserter ที่ติดตั้งอยู่ในปัจจุบันเพื่อเลือกรูปภาพจากข้อมูลเมตาสําหรับข้อมูลพร็อพเพอร์ตี้
- 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 |
ปุ่ม "เล่น"
เมื่อแตะปุ่ม การเล่นสื่อที่โหลดในปัจจุบันจะเริ่มต้นหรือเล่นต่อบนตัวรับ ปุ่มจะถูกปิดใช้งานหากกําลังเล่นอยู่หรือไม่มีการโหลดสื่อในปัจจุบัน หรือไม่มีเซสชันการแคสต์ทํางานอยู่
|
readwritenonatomicweak |
ปุ่ม "หยุดชั่วคราว"
เมื่อแตะปุ่ม การเล่นสื่อที่โหลดในปัจจุบันจะหยุดชั่วคราวในผู้รับ ปุ่มจะถูกปิดใช้งานหากสื่อที่โหลดอยู่ในปัจจุบันไม่รองรับการหยุดชั่วคราว หรือหากการเล่นไม่ได้อยู่ระหว่างดําเนินการ หรือไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ทํางานอยู่
|
readwritenonatomicweak |
ปุ่มเปิด/ปิด "เล่น/หยุดชั่วคราว"
ผู้โทรควรตั้งค่าไอคอนที่เหมาะสมสําหรับสถานะ GCKUIControlStatePlay และ GCKUIControlStatePause ของปุ่ม ซึ่งก็คือไอคอน "หยุดชั่วคราว" สําหรับสถานะการเล่นและไอคอน "เล่น" สําหรับสถานะหยุดชั่วคราว สถานะของปุ่มจะอัปเดตโดยอัตโนมัติเพื่อแสดงสถานะการเล่นปัจจุบันบนตัวรับ เมื่อแตะปุ่ม การเล่นสื่อที่โหลดในปัจจุบันจะหยุดชั่วคราวหรือเล่นต่อบนผู้รับ ปุ่มจะถูกปิดใช้งานหากสื่อที่โหลดอยู่ในปัจจุบันไม่รองรับการหยุดชั่วคราว หรือหากการเล่นไม่ได้อยู่ระหว่างดําเนินการหรือหยุดชั่วคราว หรือไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ทํางานอยู่
|
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 |
แถบเลื่อนสําหรับแสดงและเปลี่ยนตําแหน่งสตรีมปัจจุบัน
เมื่อมีการเปลี่ยนแปลงค่าแถบเลื่อนของผู้ใช้ ตําแหน่งสตรีมของสื่อที่โหลดในปัจจุบันจะอัปเดตบนตัวรับ ขณะที่กําลังเล่นสื่อบนตัวรับ ค่าของแถบเลื่อนจะได้รับการอัปเดตแบบเรียลไทม์เพื่อแสดงตําแหน่งสตรีมปัจจุบัน แถบเลื่อนจะถูกปิดใช้งานหากสื่อที่โหลดอยู่ในปัจจุบันไม่รองรับการกรอ หรือไม่มีการโหลดสื่อใดๆ ในปัจจุบัน หรือไม่มีเซสชันการแคสต์เปิดใช้งานอยู่
|
readwritenonatomicweak |
มุมมองสําหรับแสดงความคืบหน้าของสตรีมปัจจุบัน
ขณะเล่นสื่อในระหว่างตัวรับ ค่าของการดูจะได้รับการอัปเดตแบบเรียลไทม์เพื่อแสดงตําแหน่งปัจจุบันของสตรีม ระบบจะปิดใช้มุมมองหากสื่อที่โหลดอยู่ในปัจจุบันเป็นสตรีมแบบสด หรือไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือไม่มีเซสชันการแคสต์ทํางานอยู่
|
readwritenonatomicweak |
ป้ายกํากับสําหรับแสดงตําแหน่งสตรีมปัจจุบันในหน่วยนาทีและวินาที
หากไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ทํางานอยู่ ป้ายกํากับจะแสดงรูปแบบ "--:--" ที่แปลแล้ว
|
readwritenonatomicweak |
ป้ายกํากับสําหรับแสดงระยะเวลาสตรีมปัจจุบันเป็นนาทีและวินาที
หากสื่อที่โหลดอยู่ในปัจจุบันไม่มีระยะเวลา (เช่น กรณีที่เป็นสตรีมแบบสด) หรือไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ทํางานอยู่ ป้ายกํากับจะแสดงรูปแบบ "--:--" ที่แปลแล้ว
|
readwritenonatomicweak |
ป้ายกํากับสําหรับแสดงเวลาสตรีมที่เหลือ (ระยะเวลาลบตําแหน่ง) ในหน่วยนาทีและวินาที
หากสื่อที่โหลดอยู่ในปัจจุบันไม่มีระยะเวลา (เช่น กรณีที่เป็นสตรีมแบบสด) หรือไม่มีสื่อที่โหลดอยู่ในขณะนี้ หรือหากไม่มีเซสชันการแคสต์ที่ทํางานอยู่ ป้ายกํากับจะแสดงรูปแบบ "--:--" ที่แปลแล้ว
|
readwritenonatomicstrong |
ตัวควบคุมที่เก็บสตรีม
ใช้เป็นสแตนด์บายสําหรับตําแหน่งสตรีมที่แอปพลิเคชันมีให้ และ/หรือ UI ที่กําหนดเอง ดูรายละเอียดได้ที่ GCKUIStreamPositionController
- Since
- 3.4
|
readwritenonatomicassign |
เวลาของสตรีมที่เหลืออยู่จะแสดงเป็นค่าลบ เช่น "-1:23:45"
พร็อพเพอร์ตี้นี้ตั้งไว้เป็น YES โดยค่าเริ่มต้น
|
readwritenonatomicweak |
ปุ่มสําหรับเลือกแทร็กเสียงและ/หรือคําบรรยาย
เมื่อแตะปุ่มนี้ สื่อติดตาม UI การเลือกจะปรากฏให้ผู้ใช้เห็น ระบบจะปิดใช้ปุ่มดังกล่าวหากสื่อที่โหลดอยู่ในปัจจุบันไม่มีแทร็กสื่อที่เลือกได้ หรือไม่มีสื่อที่โหลดอยู่ในขณะนี้หรือหากไม่มีเซสชันการแคสต์ในปัจจุบัน
|
readwritenonatomicweak |
ป้ายกํากับสําหรับแสดงคําบรรยายสําหรับสื่อที่โหลดในปัจจุบัน
หากไม่ได้ตั้งค่าช่องคําบรรยายไว้ในข้อมูลเมตาอย่างชัดเจน ป้ายกํากับจะแสดงช่องข้อมูลเมตาที่เหมาะสมที่สุดตามประเภทสื่อ เช่น ชื่อสตูดิโอสําหรับภาพยนตร์ หรือชื่อศิลปินสําหรับแทร็กเพลง
|
readwritenonatomicweak |
มุมมองตัวบ่งชี้กิจกรรมเพื่อระบุว่าสื่ออยู่ในสถานะการโหลด