ApsaraVideo Live：StartLiveMPUTask - 建立混流轉推任務（新）

單個應用 ID 預設支援單路轉推任務上限為 200 個，混流轉碼轉推任務上限為 40。如果您需要提升配額，請提交工單。

混流任務生命週期

啟動

• 主播首次開播，可以調用 StartLiveMPUTask 啟動旁路。

  • 若無使用者入會，會返回 channel 不存在錯誤。

  • 使用者開始推流時才會輸出旁路流。若單路任務使用者未推流，則旁路流無法播放。

  • 混流任務需保證至少有一個使用者有推流，旁路流才可播放。未推流的使用者對應的布局畫面會展示黑屏。

• 客戶商務服務器建議記錄旁路任務狀態、任務類型、任務參數。

  • 任務狀態：啟動、停止。

  • 任務類型：單路、混流。

  • 任務參數：即最新的入參，例如：調用 UpdateLiveMPUTask 成功後，記錄最新任務參數。

• 在連麥或者 PK 情境下，此時任務已經被更新為混流。若當前主播異常退出重新入會後，客戶商務服務器可以根據儲存的最新的任務類型和任務參數，直接調用 StartLiveMPUTask 啟動混流任務。

  • 如果啟動前任務未被系統自動清理，則直接啟動成功。

  • 如果任務還未被系統自動清理，則會返回任務已存在錯誤碼。

結束

• 主播離會，需要主動調用 StopLiveMPUTask 停止旁路任務。

• 若任務所指定的所有使用者均已離會但未主動調用 StopLiveMPUTask，系統會在 2 分鐘後對旁路任務進行停止。

QPS 限制

本介面的單使用者 QPS 限制為 500 次/秒。超過限制，API 呼叫會被限流，這可能會影響您的業務，請合理調用。

布局和音量 SEI

以直播連麥情境為例：

如果只是單主播，觀眾端接收的 SEI 資訊裡 stream 集合只有一個成員資訊；如果是主播正在連麥或者 PK，觀眾端接收的 SEI 資訊裡 stream 集合會有多個成員資訊。 例如，當主播 111 單主播推流時，觀眾端收到的 SEI 框架格式如下：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696105170} 當主播 111 和觀眾 222 進行連麥時，觀眾端收到的 SEI 框架格式如下：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","paneid":0,"zorder":1,"x":0,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":1,"vad":119},{"uid":"222","paneid":1,"zorder":1,"x":0.5018382,"y":0.25,"w":0.5,"h":0.5,"type":0,"status":1,"muted":0,"vol":60,"vad":123}],"ver":"1.0.0.20220915","ts":1697696106230} 判斷 stream 數組的個數可以知道當前直播布局是否發生切換，stream 數組的個數為 1 時，則是單主播推流；stream 數組的個數大於 1，則主播在連麥或 PK 中。通過成員的布局資訊，知道每個成員在混流布局中的具體位置。

透傳 SEI

• 自訂 SEI，通過 StartLiveMPUTask 命令啟動混流轉推任務，在 PassThrough 參數中，指定 PayloadContent 內容；也可以在 UpdateLiveMPUTask 命令更新混流轉推任務時，在 PassThrough 參數中，指定 PayloadContent 內容。

• 自訂 SEI 可以周期性發送，通過 PassThrough 參數中的 Interval 來設定周期，單位為 ms；

• 自訂 SEI 也可以跟隨主要畫面格發送，通過 PassThrough 參數中的 FollowIdr 來設定。

  • 既可以按照 Interval 來周期性發送，也可以將 SEI 跟隨主要畫面格來發送，如 Interval:1000，FollowIdr: 1 表示每隔 1000ms 發送一次自訂 SEI，並且在發送主要畫面格時攜帶自訂 SEI。

  • 當不攜帶 Interval 以及不攜帶 FollowIdr 時，表示該自訂 SEI 只在調用時發送一次。

例如，當主播 111 單主播推流時，調用 UpdateLiveMPUTask 命令下發周期性 SEI，PassThrough 參數中的 Interval 設定為 1000，FollowIdr 設定為 0，PayloadContent 設定為"hello world"，那麼每隔 1000ms 將發送一次自訂 SEI，觀眾端收到的 SEI 框架格式如下：
{"canvas":{"w":1920,"h":1080,"bgnd":0},"stream":[{"uid":"111","paneid":-1,"zorder":0,"x":0,"y":0,"w":0,"h":0,"type":0,"status":1,"muted":0,"vol":0,"vad":0}],"ver":"1.0.0.20220915","ts":1697696109876,"udd":"hello world"}

跨頻道多使用者混流

若您需要將跨多個頻道中的多個主播進行混流布局並轉推到直播服務時，您需要將發起跨頻道通話的主播的 UserID、ChannelID，以及對端的 UserID 作為入參建立混流任務。樣本如下： 在直播 PK 情境中，頻道 channelA 的主播 userA，通過用戶端介面發起了和頻道 channelB 主播 userB 的跨頻道 PK，並將兩個主播的混流畫面輸出給頻道 channelA 的麥下觀眾觀看。則，此時建立混流任務時關於頻道和使用者參數的指定示範如下：

• ChannelID： 指定為 channelA

• UserInfos->UserId ：分別指定 userA 和 userB