개요 overview
다음은 모든 2.x SDK에 구현과 관련된 지침입니다.
IMPORTANT
SDK의 1.x 버전을 구현하는 경우 SDK 다운로드에서 1.x 개발자 안내서를 다운로드할 수 있습니다.
체감 품질 추적에 QoS(서비스 품질) 및 오류 추적이 포함됩니다. 둘 다 선택적 옵션이며 코어 미디어 추적 구현에 필요하지 않습니다. 미디어 플레이어 API를 사용하여 QoS 및 오류 추적과 관련된 변수를 식별할 수 있습니다. 다음은 경험 추적 품질의 핵심 요소입니다.
플레이어 이벤트 player-events
QoS 지표 변경 사항이 있을 경우:
재생에 대해 QoS 개체 인스턴스를 생성하거나 업데이트하십시오. QoS API 참조
모든 비트율 변경 이벤트
호출 trackEvent(Media.Heartbeat.Event.BitrateChange);
QOS 구현
-
미디어 재생 중 QOS 지표가 변경되는 시점을 식별하고 QoS 정보를 사용하여
MediaObject
를 작성하고 새 QoS 정보를 업데이트합니다.QoSObject 변수:
note tip TIP 다음 변수는 QoS를 추적하려는 경우에만 필요합니다. table 0-row-3 1-row-3 2-row-3 3-row-3 4-row-3 3-align-center 7-align-center 11-align-center 15-align-center 19-align-center 변수 설명 필수 여부 bitrate
현재 비트율 예 startupTime
시작 시간 예 fps
FPS 값 예 droppedFrames
드롭된 프레임 수 예 -
getQoSObject()
메서드가 업데이트된 최신 QoS 정보를 반환하는지 확인합니다. -
재생 시 비트율이 변경되면 미디어 하트비트 인스턴스에서
BitrateChange
를 호출합니다.note important IMPORTANT 비트율 변경 시마다 QoS 개체를 업데이트하고 비트율 변경 이벤트를 호출합니다. 이렇게 하면 가장 정확한 QoS 데이터가 제공됩니다.
다음 샘플 코드는 HTML5 미디어 플레이어에 JavaScript 2.x SDK를 사용합니다. 이 코드는 코어 미디어 재생 코드와 함께 사용해야 합니다.
var mediaDelegate = new MediaHeartbeatDelegate();
...
// This is called periodically by MediaHeartbeat instance
mediaDelegate.prototype.getQoSObject = function() {
return this.qosInfo;
};
if (e.type == "qos_update") {
var qosInfo = MediaHeartbeat.createQoSObject(<BITRATE>,<STARTUP_TIME>,<FPS>,<DROPPED_FRAMES>);
mediaDelegate.qosInfo = qosInfo;
};
if (e.type == "bitrate_change") {
this.mediaHeartbeat.trackEvent(MediaHeartbeat.Event.BitrateChange, qosObject);
};
recommendation-more-help
c8eee520-cef5-4f8c-a38a-d4952cfae4eb