GCKCastOptions 類別
影響投放裝置偵測結果和投放工作階段行為的選項。
必須先設定可寫入的屬性，才能將此物件傳送至 GCKCastContext。
- 開始時間
- 3.0
繼承 NSObject、<NSclone> 和 <NSSecureCoding>。
以指定的探索條件建構新的 GCKCastOptions 物件。
- Parameters
-
| discoveryCriteria | The discovery criteria to apply to discovered Cast devices. Only those devices that satisfy the criteria will be made available to the application. |
- 開始時間
- 4.0
| - (instancetype) initWithReceiverApplicationID: |
|
(NSString *) |
applicationID |
|
以指定接收器應用程式 ID 建構新的 GCKCastOptions 物件。
- Parameters
-
| applicationID | The ID of the receiver application which must be supported by discovered Cast devices, and which will be launched when starting a new Cast session. |
- Deprecated:
- 使用 initWithDiscovery Conditions：
| - (instancetype) initWithSupportedNamespaces: |
|
(NSArray< NSString * > *) |
namespaces |
|
以指定的命名空間清單建構新的 GCKCastOptions 物件。
- Parameters
-
| namespaces | A list of namespaces which must be supported by the currently running receiver application on each discovered Cast device. |
- Deprecated:
- 使用 initWithDiscovery Conditions：
| - (BOOL) physicalVolumeButtonsWillControlDeviceVolume |
|
readwritenonatomicassign |
這個標記表示傳送者裝置的實體音量按鈕是否應控制工作階段的音量。
| - (BOOL) disableDiscoveryAutostart |
|
readwritenonatomicassign |
| - (BOOL) disableAnalyticsLogging |
|
readwritenonatomicassign |
這類標記可用於停用或啟用診斷資料的收集功能，以提高 Cast 裝置探索的穩定性。
預設值為 NO (已啟用)；也可將值設為 YES 以停用。
- 開始時間
- 4.0
| - (NSString*) sharedContainerIdentifier |
|
readwritenonatomiccopy |
由架構執行的背景 HTTP 下載內容使用的共用容器 ID。
- 開始時間
- 3.2
| - (BOOL) suspendSessionsWhenBackgrounded |
|
readwritenonatomicassign |
傳送者應用程式進入背景時，是否應暫停工作階段 (並在應用程式回到前景時繼續)。
此選項的預設值為 YES。如果應用程式可在背景無限期維持網路連線，建議您將其設為 NO。
- 開始時間
- 3.4
| - (BOOL) stopReceiverApplicationWhenEndingSession |
|
readwritenonatomicassign |
當使用者透過 [停止投放] 按鈕結束工作階段時，是否應終止接收端應用程式。
此選項的預設值為 NO。
- 開始時間
- 4.0
| - (BOOL) startDiscoveryAfterFirstTapOnCastButton |
|
readwritenonatomicassign |
是否只有在使用者首次輕觸 GCKUICastButton 後，才會開始探索投放裝置。
如果設為 YES，則會持續顯示 GCKUICastButton，直到使用者首次輕觸投放按鈕為止。第一次輕觸時，系統會顯示插頁式廣告，說明為何需要區域網路存取權限才能投放內容。使用者關閉插頁式廣告後，探索廣告就會開始。只有在裝置連上 Wi-Fi 網路時，投放按鈕才會再次顯示。如果沒有 Wi-Fi 網路連線，投放按鈕會隱藏。如果設為 NO，探索功能會以標記 disableDiscoveryAutoStart 為基礎。此標記只會在 iOS 14 以上版本使用，前提是標記 disableDiscoveryAutoStart 設為 NO。預設值為 YES。
- 開始時間
- 4.5.3
除非另有註明，否則本頁面中的內容是採用創用 CC 姓名標示 4.0 授權，程式碼範例則為阿帕契 2.0 授權。詳情請參閱《Google Developers 網站政策》。Java 是 Oracle 和/或其關聯企業的註冊商標。
上次更新時間：2023-12-02 (世界標準時間)。
[null,null,["上次更新時間：2023-12-02 (世界標準時間)。"],[[["GCKCastOptions manages the discovery of Cast devices and Cast session behavior, with writable properties needing configuration before use."],["It offers various options, including controlling session volume with device buttons, managing discovery timing, and handling session suspension and receiver application termination."],["Developers can specify discovery criteria, receiver application ID, and supported namespaces to refine the Cast device selection process."],["GCKCastOptions also allows customization of launch options, background downloads, and the behavior of the Cast button on iOS 14 and above."],["It's worth noting that some initialization methods using receiver application ID or supported namespaces are deprecated in favor of using discovery criteria for more flexibility."]]],["The GCKCastOptions class configures Cast device discovery and session behavior. Key actions include: constructing options with discovery criteria, receiver application ID, or namespaces; setting flags to control session volume with physical buttons, manage discovery autostart, enable/disable diagnostic data collection, and suspend sessions when backgrounded. It also specifies receiver launch options, shared container identifiers, terminating the receiver app on session end, and initiating device discovery on the first Cast button tap. These writable properties must be configured prior to use.\n"]]
