자막 세그먼트 가져오기 요청을 맞춤설정하는 함수입니다. Shaka Player는 지원되지 않습니다.
enableSmoothLiveRefresh
boolean
원활한 실시간 스트리밍을 위해 매니페스트 새로고침 로직을 사용 설정하는 플래그입니다.
enableUITextDisplayer
boolean
Shaka Player의 DOM 기반 텍스트 렌더기인 shaka.text.UITextDisplayer를 사용 설정하는 플래그입니다.
UITextDisplayer를 생성하는 데 사용되는 videoContainer는 기본적으로 Cast 동영상 요소의 상위 요소로 설정됩니다. 이 텍스트 디스플레이어를 사용하면 특히 이전 세대의 Cast 기기에서 텍스트 트랙과 오디오/동영상 트랙 간에 동기화 문제가 발생할 수 있습니다. 수신기 애플리케이션에서 맞춤 UI를 사용해야 하는 경우 videoContainer가 화면 크기에 따라 제대로 정렬되지 않을 수 있습니다.
ignoreTtmlPositionInfo
boolean
TTML 위치 지정 정보를 무시할지 여부를 나타내는 플래그입니다.
initialBandwidth
(숫자 또는 정의되지 않음)
초당 비트 단위의 초기 대역폭입니다.
licenseCustomData
(문자열 또는 정의되지 않음)
커스텀 라이선스 데이터 Shaka Player는 지원되지 않습니다.
licenseHandler
(function(non-null Uint8Array, non-null cast.framework.NetworkResponseInfo)는 (null이 아닌 Uint8Array 또는 null이 아닌 Uint8Array를 포함하는 null이 아닌 Promise) 또는 정의되지 않음을 반환합니다.
라이선스 데이터를 처리하는 핸들러입니다. 핸들러는 라이선스 데이터를 전달하고 수정된 라이선스 데이터를 반환합니다.
(function(non-null Uint8Array, non-null cast.framework.NetworkResponseInfo)는 (null이 아닌 Uint8Array 또는 null이 아닌 Uint8Array를 포함하는 null이 아닌 Promise) 또는 정의되지 않음을 반환합니다.
세그먼트 데이터를 처리하는 핸들러입니다. 핸들러에 세그먼트 데이터가 전달되고 수정된 세그먼트 데이터가 반환됩니다.
미디어 세그먼트를 가져오기 위해 요청 정보를 맞춤설정하는 함수입니다. 핸들러에는 수정할 네트워크 요청 정보가 전달됩니다. SDK는 수정된 네트워크 요청 정보를 처리하여 세그먼트 요청을 시작합니다. 비동기 핸들러는 Shaka Player에서만 지원됩니다.
segmentRequestRetryLimit
(숫자 또는 정의되지 않음)
세그먼트의 네트워크 요청을 재시도할 최대 횟수입니다.
기본값은 3입니다.
shakaConfig
(null이 아닌 객체 또는 정의되지 않음)
이 객체는 CAF의 기본 Shaka 구성과 병합됩니다 (이 객체에 설정된 옵션이 우선 적용됨). 재생 문제가 발생할 수 있으므로 개발자는 Shaka 구성에 값을 적용할 때 주의해야 합니다.
이 객체에서 허용되는 옵션에 관한 자세한 내용은 shaka.util.PlayerConfiguration을 참고하세요.
[null,null,["최종 업데이트: 2025-07-25(UTC)"],[[["\u003cp\u003e\u003ccode\u003ePlaybackConfig\u003c/code\u003e is a class for customizing playback behavior in the Cast framework.\u003c/p\u003e\n"],["\u003cp\u003eIt provides properties to control buffering, license acquisition, manifest handling, and protection systems.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can use handlers to modify network requests for captions, licenses, manifests, and segments.\u003c/p\u003e\n"],["\u003cp\u003eShaka Player specific configurations can be applied through the \u003ccode\u003eshakaConfig\u003c/code\u003e property.\u003c/p\u003e\n"],["\u003cp\u003ePlayback settings like \u003ccode\u003eautoPauseDuration\u003c/code\u003e, \u003ccode\u003einitialBandwidth\u003c/code\u003e, and \u003ccode\u003eprotectionSystem\u003c/code\u003e can be configured using \u003ccode\u003ePlaybackConfig\u003c/code\u003e.\u003c/p\u003e\n"]]],["The `PlaybackConfig` class customizes playback behavior, offering properties to manage buffering, captions, and manifest handling. Key actions include setting `autoPauseDuration` and `autoResumeDuration` for buffering control, and defining `captionsRequestHandler`, `licenseHandler`, `manifestHandler`, and `segmentHandler` to modify data. `licenseUrl`, and `protectionSystem` configure content decryption. Request handlers, such as `licenseRequestHandler`, `manifestRequestHandler`, and `segmentRequestHandler`, allow for customizing network requests. `shakaConfig` enables merging with Shaka Player settings. Other key properties are enableSmoothLiveRefresh, enableUITextDisplayer and ignoreTtmlPositionInfo.\n"],null,["# Class: PlaybackConfig\n\ncast.[framework](/cast/docs/reference/web_receiver/cast.framework).PlaybackConfig\n=================================================================================\n\nclass static\n\nConfiguration to customize playback behavior.\n\nConstructor\n-----------\n\n### PlaybackConfig\n\nnew\nPlaybackConfig()\n\nProperties\n----------\n\n### autoPauseDuration\n\n(number or undefined)\n\nDuration of buffered media in seconds to start buffering. Not supported\nby Shaka Player.\n\n### autoResumeDuration\n\n(number or undefined)\n\nDuration of buffered media in seconds to start/resume playback after\nauto-paused due to buffering.\n\n### autoResumeNumberOfSegments\n\n(number or undefined)\n\nMinimum number of buffered segments to start/resume playback. For DASH\ncontent use autoResumeDuration instead.\n\n### captionsRequestHandler\n\n(function(non-null [cast.framework.NetworkRequestInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkRequestInfo)) or undefined)\n\nA function to customize request to get a caption segment. Not supported\nby Shaka Player.\n\n### enableSmoothLiveRefresh\n\nboolean\n\nA flag to enable manifest refresh logic for Smooth Live streaming.\n\n### enableUITextDisplayer\n\nboolean\n\nA flag to enable Shaka Player's DOM-based text renderer,\n[shaka.text.UITextDisplayer](https://shaka-player-demo.appspot.com/docs/api/shaka.text.UITextDisplayer.html).\nThe videoContainer used to construct the UITextDisplayer defaults to the\nparent of the Cast video element. Use of this text displayer may incur\nsynchronization issues between the text track and audio/video track(s),\nespecially on older generation Cast devices. The videoContainer may not\nbe properly aligned relative to the screen size, should custom UI be used\nin the receiver application.\n\n### ignoreTtmlPositionInfo\n\nboolean\n\nA flag whether to ignore TTML positioning information.\n\n### initialBandwidth\n\n(number or undefined)\n\nInitial bandwidth in bits in per second.\n\n### licenseCustomData\n\n(string or undefined)\n\nCustom license data. Not supported by Shaka Player.\n\n### licenseHandler\n\n(function(non-null Uint8Array, non-null [cast.framework.NetworkResponseInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkResponseInfo)) returns (non-null Promise containing non-null Uint8Array or non-null Uint8Array) or undefined)\n\nHandler to process license data. The handler is passed the license data,\nand returns the modified license data.\n\n### licenseRequestHandler\n\n(function(non-null [cast.framework.NetworkRequestInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkRequestInfo)) or undefined)\n\nA function to customize an outgoing request to get a license. The handler\nis passed network request information to be modified. The SDK processes\nthe modified network request information to initiate the license request.\nAsynchronous handlers are only supported on Shaka Player.\n\n### licenseUrl\n\n(string or undefined)\n\nUrl for acquiring the license.\n\n### manifestHandler\n\n(function(string, non-null [cast.framework.NetworkResponseInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkResponseInfo)) returns (non-null Promise containing string or string) or undefined)\n\nHandler to process manifest data. The handler is passed the manifest, and\nreturns the modified manifest.\n\n### manifestRequestHandler\n\n(function(non-null [cast.framework.NetworkRequestInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkRequestInfo)) or undefined)\n\nA function to customize request to get a manifest. The handler\nis passed network request information to be modified. The SDK processes\nthe modified network request information to initiate the manifest\nrequest. Asynchronous handlers are only supported on Shaka Player.\n\n### protectionSystem\n\n[cast.framework.ContentProtection](/cast/docs/reference/web_receiver/cast.framework#.ContentProtection)\n\nPreferred protection system to use for decrypting content.\n\n### segmentHandler\n\n(function(non-null Uint8Array, non-null [cast.framework.NetworkResponseInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkResponseInfo)) returns (non-null Promise containing non-null Uint8Array or non-null Uint8Array) or undefined)\n\nHandler to process segment data. The handler is passed the segment data,\nand returns the modified segment data.\n\n### segmentRequestHandler\n\n(function(non-null [cast.framework.NetworkRequestInfo](/cast/docs/reference/web_receiver/cast.framework.NetworkRequestInfo)) or undefined)\n\nA function to customize request information to get a media segment. The\nhandler is passed network request information to be modified. The SDK\nprocesses the modified network request information to initiate the\nsegment request. Asynchronous handlers are only supported on Shaka\nPlayer.\n\n### segmentRequestRetryLimit\n\n(number or undefined)\n\nMaximum number of times to retry a network request for a segment.\nDefaults to 3.\n\n### shakaConfig\n\n(non-null Object or undefined)\n\nThis object is merged with CAF's default Shaka configurations (with\noptions set in this object taking precedence). Developers should use\ncaution when applying values to the Shaka configuration as it could\nresult in playback issues.\nFor allowed options in this object, see\n[shaka.util.PlayerConfiguration](https://shaka-player-demo.appspot.com/docs/api/shaka.extern.html#.PlayerConfiguration)\nfor more information."]]
