설명서AnalyticsMedia Analytics 안내서

개요 overview

Last update: Wed Jan 11 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

작성 대상:

  • User
  • Admin
  • Developer

다음은 모든 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 구현

  1. 미디어 재생 중 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 드롭된 프레임 수 예

  2. getQoSObject() 메서드가 업데이트된 최신 QoS 정보를 반환하는지 확인합니다.

  3. 재생 시 비트율이 변경되면 미디어 하트비트 인스턴스에서 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