伺服器端效能查詢

伺服器上的良好轉譯效能對於穩定畫面播放速率和良好的使用者體驗至關重要。 請務必仔細監視伺服器上的效能特性，並視需要優化。 您可以透過專用 API 函式來查詢效能資料。

對於轉譯效能影響最大的是模型輸入資料。 您可以調整輸入資料，如設定模型轉換 中所述 。

用戶端應用程式效能也可能是瓶頸。 如需用戶端效能的深入分析，建議採用 performance trace 。

用戶端/伺服器時間軸

在詳細討論各種延遲值之前，請務必先查看時間軸上的用戶端與伺服器之間的同步點：

此圖顯示如何：

• 姿勢 估計 值是由用戶端以常數 60-Hz 畫面播放速率啟動（每 16.6 毫秒）
• 然後，伺服器會根據姿勢開始轉譯
• 伺服器會傳回編碼的視訊影像
• 用戶端會解碼映射、在映射上執行一些 CPU 和 GPU 工作，然後顯示影像

框架統計資料查詢

畫面格統計資料會提供最後一個畫面的一些高階資訊，例如延遲。 結構中 FrameStatistics 提供的資料會測量在用戶端，因此 API 是同步呼叫：

void QueryFrameData(RenderingSession session)
{
    FrameStatistics frameStatistics;
    if (session.GraphicsBinding.GetLastFrameStatistics(out frameStatistics) == Result.Success)
    {
        // do something with the result
    }
}

void QueryFrameData(ApiHandle<RenderingSession> session)
{
    FrameStatistics frameStatistics;
    if (session->GetGraphicsBinding()->GetLastFrameStatistics(&frameStatistics) == Result::Success)
    {
        // do something with the result
    }
}

擷取 FrameStatistics 的物件會保存下列成員：

所有延遲值的總和通常大於 60 Hz 的可用幀時間。 這沒問題，因為多個畫面會平行執行，而且新的畫面要求會以所需的畫面播放速率啟動，如下圖所示。 不過，如果延遲變得太大，它會影響後期重現 的品質 ，而且可能會危害整體體驗。

VideoFramesReceived、 VideoFrameReusedCount 和 VideoFramesDiscarded 可用來測量網路和伺服器效能。 低 VideoFramesReceived 值和高 VideoFrameReusedCount 值的組合可能表示網路壅塞或伺服器效能不佳。 高 VideoFramesDiscarded 值也表示網路壅塞。

最後， TimeSinceLastPresent ， VideoFrameMinDelta 和 VideoFrameMaxDelta 提供傳入視訊畫面和本機簡報呼叫變異數的概念。 高變異數表示不穩定的畫面播放速率。

上述值都沒有清楚指出純網路延遲（圖例中的紅色箭號），因為伺服器忙碌轉譯的確切時間必須從往返值 LatencyPoseToReceive 減去。 整體延遲的伺服器端部分是用戶端無法使用的資訊。 不過，下一段說明此值如何透過伺服器的額外輸入來近似，並透過 NetworkLatency 值公開。

效能評定查詢

效能評定查詢 提供有關伺服器上 CPU 和 GPU 工作負載的更深入資訊。 由於資料是從伺服器要求，因此查詢效能快照集會遵循一般非同步模式：

async void QueryPerformanceAssessment(RenderingSession session)
{
    try
    {
        PerformanceAssessment result = await session.Connection.QueryServerPerformanceAssessmentAsync();
        // do something with result...
    }
    catch (RRException ex)
    {
    }
}

void QueryPerformanceAssessment(ApiHandle<RenderingSession> session)
{
    session->Connection()->QueryServerPerformanceAssessmentAsync([](Status status, PerformanceAssessment result) {
        if (status == Status::OK)
        {
            // do something with result...
        }
    });
}

FrameStatistics與 物件相反， PerformanceAssessment 物件包含伺服器端資訊：

為了協助您評估這些值，每個部分都會隨附品質分類，例如 Great、 Good 、 Mediocre 或 Bad 。 此評定計量提供伺服器健康情況的粗略指示，但不應該被視為絕對。 例如，假設您看到 GPU 時間的「平庸」分數。 它被認為是平庸的，因為它接近整體框架時間預算的限制。 不過，在您的案例中，這可能是一個很好的值，因為您要轉譯複雜的模型。

統計資料偵錯輸出

類別是 C# 類別 ServiceStatistics ，包裝在框架統計資料和效能評估查詢周圍，並提供方便的功能，以匯總值或預先建置的字串的形式傳回統計資料。 下列程式碼是顯示用戶端應用程式中伺服器端統計資料的最簡單方式。

ServiceStatistics _stats = null;

void OnConnect()
{
    _stats = new ServiceStatistics();
}

void OnDisconnect()
{
    _stats = null;
}

void Update()
{
    if (_stats != null)
    {
        // update once a frame to retrieve new information and build average values
        _stats.Update(Service.CurrentActiveSession);

        // retrieve a string with relevant stats information
        InfoLabel.text = _stats.GetStatsString();
    }
}

上述程式碼會以下列文字填入文字標籤：

API 會 GetStatsString 格式化所有值的字串，但也可以從 ServiceStatistics 實例以程式設計方式查詢每個單一值。

也會有成員的變體，其會隨著時間匯總值。 請參閱尾碼 *Avg 為 、 *Max 或 *Total 的成員。 成員 FramesUsedForAverage 會指出此匯總已使用多少框架。

API 文件

• C# 轉譯連線。QueryServerPerformanceAssessmentAsync（）
• C++ 轉譯連線ion：：QueryServerPerformanceAssessmentAsync（）

下一步

• 建立效能追蹤
• 設定模型轉換