

# IVS 伺服器端合成 \$1 即時串流
<a name="server-side-composition"></a>

伺服器端合成使用 IVS 伺服器來混合所有階段參與者的音訊和視訊，然後將此混合視訊傳送至 IVS 頻道 (例如觸及更多觀眾) 或 S3 儲存貯體。伺服器端合成會透過舞台主區域中的 IVS 控制平面操作調用。

使用伺服器端合成廣播或錄製階段會提供許多好處，可以讓使用者獲得高效可靠的雲端型影片工作流程，使其成為一個吸引人的選擇。

**Topics**
+ [IVS 伺服器端合成概觀](ssc-overview.md)
+ [開始使用 IVS 伺服器端合成](ssc-getting-started.md)
+ [自訂參與者排序](ssc-getting-started-custom-participant-ordering.md)
+ [在 IVS 伺服器端合成中啟用螢幕共用](ssc-getting-started-screen-share.md)
+ [已知問題和解決方法](ssc-known-issues.md)

# IVS 伺服器端合成概觀
<a name="ssc-overview"></a>

下圖說明伺服器端合成的運作方式：

![\[使用伺服器端合成廣播階段。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_Intro_Composite_Recording.png)


## 優勢
<a name="ssc-benefits"></a>

與用戶端合成相比，伺服器端合成具有以下優點：
+ **減少用戶端負載**：透過伺服器端合成，處理和合併音訊與視訊來源的負擔會從個別用戶端裝置轉移到伺服器本身。伺服器端合成可消除用戶端裝置使用其 CPU 和網路資源來合成檢視並將其傳輸到 IVS 的需求。這表示觀眾可以觀看廣播，而其裝置無需處理資源密集型任務，這可以改善電池壽命和更流暢的觀看體驗。
+ **一致的品質**：伺服器端合成可讓您精確控制最終串流的品質、解析度和位元速率。這可確保所有觀眾獲得一致的觀看體驗，無論其個別裝置的功能為何。
+ **彈性**：透過將合成程序集中在伺服器上，廣播會變得更加穩定。即使發布者裝置遇到技術限制或波動，伺服器也可以適應並為所有觀眾成員提供更流暢的串流。
+ **頻寬效率**：由於伺服器會處理合成，因此階段發布者不必花費額外頻寬將視訊廣播到 IVS。

若要將階段廣播到 IVS 頻道，您可以執行用戶端合成；請參閱《IVS 低延遲串流使用者指南》**中的[在 IVS 串流上啟用多位主持人](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/multiple-hosts.html)。

## 合成生命週期
<a name="ssc-composition-endpoint"></a>

參閱下方圖表，以了解合成的狀態轉換。

![\[伺服器端合成資源的生命週期。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_Composition_Lifecycle.png)


合成的生命週期大致如下：

1. 當使用者呼叫 StartComposition 操作時，會建立合成資源。

1. 一旦 IVS 成功啟動合成，就會傳送「IVS 合成狀態變更 (工作階段啟動)」EventBridge 事件。如需有關事件的詳細資訊，請參閱[搭配 IVS 即時串流使用 EventBridge](eventbridge.md)。

1. 只要合成處於作用中狀態，可能會發生以下情況：
   + 使用者停止合成：如果呼叫 StopComposition 操作，IVS 會起始正常關閉合成，並傳送「目的地結束」事件，然後傳送「工作階段結束」事件。
   + 合成執行自動關閉：如果已刪除 IVS 階段或 60 秒內沒有參與者主動發布到 IVS 階段，則合成會自動完成，並傳送 EventBridge 事件。
   + 目的地失敗：如果目的地意外失敗 (例如，IVS 頻道遭到刪除)，目的地會轉換為 `RECONNECTING` 狀態，並傳送「目的地重新連線」事件。如果無法復原，IVS 會將目的地轉換為 `FAILED` 狀態，並傳送「目的地失敗」事件。如果合成中至少有一個目的地處於作用中狀態，IVS 會保持作用中狀態。

1. 只要合成處於 `STOPPED` 或 `FAILED` 狀態，會在五分鐘後自動清理。(之後無法再被 ListCompositions 或 GetComposition 擷取。)

## IVS API
<a name="ssc-api"></a>

伺服器端合成使用下列關鍵 API 元素：
+ *EncoderConfiguration* 物件允許您自訂要生成的影片格式 (高度、寬度、位元速率和其他串流參數)。您可以在每次呼叫 StartComposition 操作時重複使用 EncoderConfiguration。
+ *Composition* 操作會追蹤影片合成，並輸出至 IVS 頻道。
+ *StorageConfiguration* 會追蹤記錄合成的 S3 儲存貯體。

若要使用伺服器端合成，您需要建立一個 EncoderConfiguration 並在呼叫 StartComposition 操作時連接。在此範例中，SquareVideo EncoderConfiguration 用於兩種合成：

![\[伺服器端合成使用兩個關鍵 API 元素。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_IVS_API_Composite_Recording.png)


如需完整資訊，請參閱 [IVS Real-Time Streaming API Reference](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/Welcome.html)。

## 版面配置
<a name="ssc-api-layouts"></a>

StartComposition 操作提供兩種版面配置選項：網格和 PiP (子母畫面)。

### 網格版面配置
<a name="ssc-api-layouts-grid"></a>

網格版面配置會將舞台參與者安排在大小相同的網格單元中。此版面配置提供數個可自訂屬性：
+ `videoAspectRatio` 用於設定參與者顯示模式，以控制視訊動態磚的長寬比。
+ `videoFillMode` 用於定義影片內容如何適應參與者動態磚。
+ `gridGap` 用於指定參與者動態磚之間的間距 (以像素為單位)。
+ `omitStoppedVideo` 用於允許將已停止的影片串流從合成中排除。
+ `featuredParticipantAttribute` 用於識別精選插槽。設定此屬性後，精選參與者會顯示在主畫面上較大的插槽中，其他參與者顯示在其下方。
+ `participantOrderAttribute` 會根據參與者權杖中的屬性值啟用自訂參與者排序。指定此屬性時，參與者會依其屬性值按數字排序，而缺少該屬性的參與者則回復為到達時間排序。此屬性提供選用的確定性定位，並允許基於角色的版面配置。

如需有關網格版面配置的詳細資訊 (包括所有欄位的有效值和預設值)，請參閱 [GridConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_GridConfiguration.html) 資料類型。

![\[伺服器端合成網格版面配置\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_Grid_Layout.png)


### 子母畫面 (PiP) 版面配置
<a name="ssc-api-layouts-pip"></a>

PiP 版面配置可在重疊視窗中顯示參與者，重疊視窗的大小、位置和行為都是可設定的。關鍵屬性包括：
+ `pipParticipantAttribute` 用於指定 PiP 視窗的參與者。
+ `pipPosition` 用於決定 PiP 視窗的邊角位置。
+ `pipWidth` 和 `pipHeight` 用於設定 PiP 視窗的寬度和高度。
+ `pipOffset` 用於設定 PiP 視窗相對最近邊緣的偏移位置 (以像素為單位)。
+ `pipBehavior` 用於定義所有其他參與者都離開後的 PiP 行為。

與網格版面配置一樣，PiP 版面配置支援 `featuredParticipantAttribute`、`omitStoppedVideo`、`videoFillMode`、`gridGap` 和 `participantOrderAttribute` 以供進一步自訂合成。`participantOrderAttribute` 可啟用自訂參與者排序，無論是為 PiP 視窗選取參與者，還是根據參與者權杖中的屬性值對網格參與者進行定位。

如需有關 PiP 版面配置的詳細資訊 (包括所有欄位的有效值和預設值)，請參閱 [PipConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_PipConfiguration.html) 資料類型。

![\[伺服器端合成子母畫面 (PiP) 版面配置\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_PiP_Layout.png)


**注意**：階段發布者在伺服器端合成上所支援的最大解析度為 1080p。如果發布者傳送的視訊高於 1080p，則發布者會轉譯為純音訊參與者。

**重要事項**：確保應用程式不依賴目前版面配置的特定功能，例如動態磚的大小和位置。*您可以隨時對版面配置進行視覺化改善*。

# 開始使用 IVS 伺服器端合成
<a name="ssc-getting-started"></a>

本文件將帶您了解開始使用 IVS 伺服器端合成的相關步驟。

## 必要條件
<a name="ssc-getting-started-prerequisites"></a>

若要使用伺服器端合成，您必須具有包含作用中發布者的階段，並使用 IVS 頻道和/或 S3 儲存貯體作為合成目的地。

若要建立 S3 儲存貯體，請參閱 S3 文件：[如何建立儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-bucket.html)。S3 儲存貯體必須在與 IVS 舞台相同的 AWS 區域中建立。

**重要**：如果您使用現有的 S3 儲存貯體：
+ **物件擁有權**設定必須是**強制執行的儲存貯體擁有者**，或是**偏好的儲存貯體擁有者**。
+ **預設類型**設定必須是**使用 Amazon S3 受管金鑰進行伺服器端加密 (SSE-S3)**。

如需詳細資訊，請參閱 S3 文件：[controlling ownership of objects](https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html) 和 [protecting data with encryption](https://docs.aws.amazon.com/AmazonS3/latest/userguide/UsingEncryption.html)。

## API 說明
<a name="ssc-getting-started-api-instructions"></a>

下面，我們描述了一種可能的工作流程，該工作流程使用 EventBridge 事件啟動合成，該合成會在參與者發布時將階段廣播到 IVS 頻道。您也可以根據自己的應用程式邏輯啟動和停止合成。請參閱[複合錄製](rt-composite-recording.md)中的另一個範例，其中展示了如何使用伺服器端合成將階段直接錄製到 S3 儲存貯體。

1. 建立一個 IVS 頻道。請參閱[開始使用 Amazon IVS 低延遲串流功能](https://docs.aws.amazon.com//ivs/latest/LowLatencyUserGuide/getting-started.html)。

1. 為每個發布者建立 IVS 階段和參與者權杖。

1. 建立一個 [EncoderConfiguration](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_EncoderConfiguration.html)。

1. 加入並發布到階段。(請參閱 [Web](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/web-publish-subscribe.html) 版、[Android](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/android-publish-subscribe.html) 版和 [iOS](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/ios-publish-subscribe.html) 版即時串流廣播 SDK 指南中的「發布與訂閱」章節。)

1. 收到「參與者已發布」EventBridge 事件後，請使用所需的版面配置組態呼叫 [StartComposition](https://docs.aws.amazon.com//ivs/latest/RealTimeAPIReference/API_StartComposition.html)。

1. 等待幾秒鐘，然後在頻道播放中查看複合檢視。

![\[當參與者發布時，使用 EventBridge 事件啟動合成的伺服器端合成工作流程。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_Workflow.png)


**注意**：在階段上的發布者參與者閒置 60 秒後，合成會執行自動關閉。此時，合成會終止並轉換為 `STOPPED` 狀態。合成會在保持 `STOPPED` 狀態幾分鐘後自動刪除。

## CLI 說明
<a name="ssc-getting-started-cli"></a>

使用 AWS CLI 是進階選項，需要您先在機器上下載並設定 CLI。如需詳細資訊，請參閱《[AWS 命令列界面使用者指南](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-welcome.html)》。

您目前可以使用 CLI 來建立和管理資源。合成操作位於 `ivs-realtime` 命名空間下。

### 建立 EncoderConfiguration 資源
<a name="ssc-getting-started-cli-create-encoderconfiguration"></a>

EncoderConfiguration 是一個物件，允許您自訂生成影片的格式 (高度、寬度、位元速率和其他串流參數)。您可以在每次呼叫合成操作時重複使用 EncoderConfiguration，如下一個步驟所述。

下列命令會建立 EncoderConfiguration 資源，可設定伺服器端視訊合成參數，例如視訊位元速率、影格率和解析度：

```
aws ivs-realtime create-encoder-configuration --name "MyEncoderConfig" --video "bitrate=2500000,height=720,width=1280,framerate=30"
```

回應為：

```
{
"encoderConfiguration": {
  "arn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/9W59OBY2M8s4",
  "name": "MyEncoderConfig",
  "tags": {},
  "video": {
	 "bitrate": 2500000,
	 "framerate": 30,
	 "height": 720,
	 "width": 1280
    }
  }
}
```

### 啟動合成
<a name="ssc-getting-started-cli-start-mediapublish"></a>

使用上述回應中提供的 EncoderConfiguration ARN 建立您的合成資源：

**網格版面配置範例**

```
aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/9W59OBY2M8s4"}}]' --layout '{"grid":{"participantOrderAttribute":"order","featuredParticipantAttribute":"isFeatured","videoFillMode":"COVER","gridGap":0}}'
```

**PiP 版面配置範例**

```
aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO"}}]' --layout '{"pip":{"participantOrderAttribute":"priority","pipParticipantAttribute":"isPip","pipOffset":10,"pipPosition":"TOP_RIGHT"}}'
```

**注意**：您可以使用[此工具](https://composition.ivsdemos.com/)，根據版面配置選擇更輕鬆地產生 `--layout` 組態。

回應將顯示合成建立時即處於 `STARTING` 狀態。只要合成開始發布合成，狀態就會轉換為 `ACTIVE`。(您可以透過呼叫 ListCompositions 或 GetComposition 操作來查看狀態。)

只要合成處於 `ACTIVE` 狀態，IVS 階段的複合檢視就可以在 IVS 頻道上出現，使用 ListCompositions：

```
aws ivs-realtime list-compositions
```

回應為：

```
{
"compositions": [
  {
	 "arn": "arn:aws:ivs:us-east-1:927810967299:composition/YVoaXkKdEdRP",
	 "destinations": [
		{
		   "id": "bD9rRoN91fHU",
		   "startTime": "2023-09-21T15:38:39+00:00",
		   "state": "ACTIVE"
		}
	 ],
	 "stageArn": "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik",
	 "startTime": "2023-09-21T15:38:37+00:00",
	 "state": "ACTIVE",
	 "tags": {}
    }
  ]
}
```

**注意**：您必須讓發布者參與者主動發布至階段，才能讓合成保持作用中狀態。如需詳細資訊，請參閱 [Web](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/web-publish-subscribe.html) 版、[Android](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/android-publish-subscribe.html) 版和 [iOS](https://docs.aws.amazon.com//ivs/latest/RealTimeUserGuide/ios-publish-subscribe.html) 版即時串流廣播 SDK 指南中的「發布與訂閱」章節。您必須為每個參與者建立不同的階段權杖。

# 自訂參與者排序
<a name="ssc-getting-started-custom-participant-ordering"></a>

自訂參與者排序可讓您根據參與者權杖中的自訂屬性值，控制網格和 PiP 版面配置中的參與者位置，包括確定重點參與者的位置以及為 PiP 視窗選取參與者。這可提供確定性的參與者定位，並啟用基於角色的版面配置。

## 自訂排序的運作方式
<a name="ssc-getting-started-custom-participant-ordering-how-custom-ordering-works"></a>

在版面配置組態中指定 `participantOrderAttribute` 時，參與者會根據下列規則排序：
+ 權杖中具有指定排序屬性的參與者會優先定位，並依其屬性值按數字排序。
+ 未具備排序屬性的參與者會回復為到達時間排序，並排在已排序的參與者之後。
+ 當多個參與者的排序值相同時，會依其加入階段的到達時間進行次排序。
+ 排序採用數字排序（非詞典編纂順序排序），因此「10」會排在「9」之後（而非「1」之後）。
+ 支援負值。負值會排在正值之前。
+ 非數字值（例如「abc」、「1.5」）會被視為無效，這些參與者會回復為到達時間排序。

**重要：**參與者排序（無論基於到達時間或自訂規則）會在合成開始後生效。對於在合成開始前加入階段的參與者，不保證其排序正確。

## 建立具有排序屬性的權杖
<a name="ssc-getting-started-custom-participant-ordering-creating-tokens-with-ordering-attributes"></a>

若要使用自訂參與者排序，請在建立參與者權杖時於權杖中包含排序屬性：

```
aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=1

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3
```

您可以將 custom-participant-order 屬性與用於為重點位置和 PiP 視窗選取參與者的屬性結合使用：

```
aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=2,isFeatured=true

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=3,isFeatured=true

aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes order=4,isPip=true
```

## 範例使用案例
<a name="ssc-getting-started-custom-participant-ordering-example-use-cases"></a>

範例使用案例包括：
+ 一致的定位 – 當參與者使用相同權杖重新連線時，會維持其位置。
+ 基於角色的定位 – 例如，您可以指定 order=1 的教師和 order=2 的學生。
+ 基於優先級的版面配置 – 順序值較低的 VIP 參與者會優先顯示。
+ 動態版面配置 – 對於複雜的案例，您可以將自訂排序與 `featuredParticipantAttribute` 和 `pipParticipantAttribute` 結合使用。
+ 跨舞台互動 – 將參與者複寫用於不同舞台的實況主互動的 VS 模式競賽等案例時，您可以覆寫排序屬性，以控制目的地舞台合成中的位置。

**注意：**對於參與者複寫使用案例，您可以在開始複寫時視需要覆寫參與者屬性 (包括順序屬性)，以在目的地舞台中實現所需的配置。

## 回溯相容性
<a name="ssc-getting-started-custom-participant-ordering-backward-compatibility"></a>

自訂參與者排序是一項選用功能，可完全回溯相容。沒有 `participantOrderAttribute` 的現有合成會將維持不變，繼續使用到達時間排序。當 `participantOrderAttribute` 設為空字串時，系統會完全忽略自訂排序，回復為預設行為。

# 在 IVS 伺服器端合成中啟用螢幕共用
<a name="ssc-getting-started-screen-share"></a>

若要使用固定螢幕共用版面配置，請按照以下步驟操作。

## 建立 EncoderConfiguration 資源
<a name="ssc-getting-started-screen-share-create-encoderconfiguration"></a>

下列命令會建立 EncoderConfiguration 資源，可設定伺服器端合成參數 (視訊位元速率、影格率和解析度)。

```
aws ivs-realtime create-encoder-configuration --name "test-ssc-with-screen-share" --video={bitrate=2000000,framerate=30,height=720,width=1280}
```

建立具有 `screen-share` 屬性的階段參與者權杖。由於我們將 `screen-share` 指定為 `featured` 插槽的名稱，因此我們需要建立一個階段權狀，並將 `screen-share` 屬性設定為 `true`：

```
aws ivs-realtime create-participant-token --stage-arn "arn:aws:ivs:us-east-1:123456789012:stage/u9OiE29bT7Xp" --attributes screen-share=true
```

回應為：

```
{
   "participantToken": {
      "attributes": {
         "screen-share": "true"
      },
      "expirationTime": "2023-08-04T05:26:11+00:00",
      "participantId": "E813MFklPWLF",
      "token": "eyJhbGciOiJLTVMiLCJ0eXAiOiJKV1QifQ.eyJleHAiOjE2OTExMjY3NzEsImlhdCI6MTY5MTA4MzU3MSwianRpIjoiRTgxM01Ga2xQV0xGIiwicmVzb3VyY2UiOiJhcm46YXdzOml2czp1cy1lYXN0LTE6OTI3ODEwOTY3Mjk5OnN0YWdlL3U5T2lFMjliVDdYcCIsInRvcGljIjoidTlPaUUyOWJUN1hwIiwiZXZlbnRzX3VybCI6IndzczovL3VzLWVhc3QtMS5ldmVudHMubGl2ZS12aWRlby5uZXQiLCJ3aGlwX3VybCI6Imh0dHBzOi8vYjJlYTVjMmZmMzU1Lmdsb2JhbC53aGlwLmxpdmUtdmlkZW8ubmV0IiwiYXR0cmlidXRlcyI6eyJzY3JlZW4tc2hhcmUiOiJ0cnVlIn0sImNhcGFiaWxpdGllcyI6eyJhbGxvd19wdWJsaXNoIjp0cnVlLCJhbGxvd19zdWJzY3JpYmUiOnRydWV9LCJ2ZXJzaW9uIjoiMC4zIn0.MGUCMFvMzv35O4yVzM9tIWZl7n3mmFQhleqsRSBx_G2qT2YUDlWSNg6H1vL7sAWQMeydSAIxAIvdfqt3Fh1MLiyelc9NnTjI5hL3YPKqDX6J3NDH1fksh8_5y1jztoPDy4yVA5OmtA"
   }
}
```

## 啟動合成
<a name="ssc-getting-started-screen-share-start-mediapublish"></a>

若要使用螢幕共用功能啟動合成，我們使用以下命令：

```
aws ivs-realtime start-composition --stage-arn "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik" --destinations  '[{"channel": {"channelArn": "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r", "encoderConfigurationArn": "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO"}}]' --layout '{"grid":{"featuredParticipantAttribute":"screen-share"}}'
```

回應為：

```
{
"composition" : {
"arn" : "arn:aws:ivs:us-east-1:927810967299:composition/B19tQcXRgtoz",
"destinations" : [ {
 "configuration" : {
	"channel" : {
	   "channelArn" : "arn:aws:ivs:us-east-1:927810967299:channel/DOlMW4dfMR8r",
	   "encoderConfigurationArn" : "arn:aws:ivs:us-east-1:927810967299:encoder-configuration/DEkQHWPVaOwO"
	},
	"name" : ""
 },
 "id" : "SGmgBXTULuXv",
 "state" : "STARTING"
} ],
"layout" : {
 "grid" : {
	"featuredParticipantAttribute" : "screen-share",
	"gridGap": 2,
	"omitStoppedVideo": false,
	"videoAspectRatio": "VIDEO"
 }
},
"stageArn" : "arn:aws:ivs:us-east-1:927810967299:stage/8faHz1SQp0ik",
"startTime" : "2023-09-27T21:32:38Z",
"state" : "STARTING",
"tags" : { }
}
}
```

當階段參與者 `E813MFklPWLF` 加入階段時，該參與者的視訊將顯示在精選插槽中，其餘階段發布者將會在插槽下方轉譯：

![\[使用螢幕共用功能啟動合成。\]](http://docs.aws.amazon.com/zh_tw/ivs/latest/RealTimeUserGuide/images/ssc_StartComposition.png)


## 停止合成
<a name="ssc-getting-started-screen-share-stop-mediapublish"></a>

若要在任何時間點停止合成，請呼叫 StopComposition 操作：

```
aws ivs-realtime stop-composition --arn arn:aws:ivs:us-east-1:927810967299:composition/B19tQcXRgtoz
```

# 已知問題和解決方法
<a name="ssc-known-issues"></a>

本節列出在使用 IVS 伺服器端合成時可能遇到的已知問題，並建議潛在的解決方法。
+ 某些合成可能會在靜音時段之後顯示短暫的音訊停頓。

  **解決方法**：無