

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 多應用程式串流群組概觀
<a name="multi-apps"></a>

*多應用程式串流群組*是連結至多個應用程式的串流群組。這可讓您在單一串流群組中使用相同的一組運算資源來串流多個應用程式。

多應用程式串流群組的常見使用案例是發行遊戲的不同版本。例如，假設您已建立串流群組，並將預設應用程式設定為遊戲的原始版本。然後，假設您建立包含遊戲其他版本的其他應用程式，並將其連結至串流群組。由於這些應用程式與相同的串流群組相關聯，因此您只需管理一組運算資源或串流容量，即可串流所有這些遊戲。這表示無論最終使用者串流是哪個應用程式，應用程式都會從此串流群組配置的相同集合，在運算資源上執行。

 以下是其他可能的實際範例：
+ 遊戲串流平台，可為客戶提供不同的串流層。
+ 正在測試遊戲多個版本的品質保證團隊。
+ 將單一串流群組用於多個應用程式，以簡化串流容量管理。
+ 啟用一組從相同串流容量集區串流的應用程式。

## 限制和要求
<a name="multi-apps-limitations"></a>

您只能將應用程式與具有相容執行期環境和串流類別的串流群組建立關聯。如需詳細資訊，請參閱 [串流類別](configuration-options.md#configuration-options-stream-classes)。

下列關聯限制適用於應用程式和串流群組。這些限制會在服務中針對所有客戶修正。


| 名稱 | 預設 | 可調整 | Description | 
| --- | --- | --- | --- | 
| 串流群組中的應用程式 | 250 | 否 | 可與串流群組相關聯的 Amazon GameLift Streams 應用程式數目上限。 | 
| 每個應用程式的串流群組關聯 | 100 | 否 | Amazon GameLift Streams 應用程式可關聯的串流群組數量上限。 | 

## 關於預設應用程式
<a name="multi-apps-about-linking"></a>

每個串流群組都有一個*預設應用程式*，其最初是您新增至串流群組的第一個應用程式。預設應用程式會自動預先在所有永遠啟用的運算資源上快取，這可協助縮短串流新創公司期間的應用程式載入時間。Amazon GameLift Streams 服務還可以在其最佳化過程中快取其他連結的應用程式。

預設應用程式和其他連結應用程式的特性：
+ 預設應用程式會預先快取 （在預先配置的運算資源上，例如永遠在線的容量），以協助縮短串流啟動期間的應用程式載入時間。
+ 預設應用程式可以變更。請注意，當您切換串流群組中的預設應用程式時，在所有位置預先快取新的預設應用程式最多可能需要幾個小時。
+ 至少需要一個連結的應用程式，才能從串流群組開始串流。第一個連結的應用程式會自動設為預設應用程式。
+ 如果您取消連結串流群組的預設應用程式，如果有的話，Amazon GameLift Streams 會自動從剩餘的相關聯應用程式中選擇新的預設應用程式。
+ 相同的應用程式可以是多個串流群組的預設應用程式。
+ 串流群組已過 180 天之前，連結的應用程式集都是可變的。在實際情況下，這表示您可以連結和取消連結應用程式，直到串流群組已過 180 天為止。之後，您只能在串流群組的剩餘生命週期內從串流群組取消連結應用程式。

## 變更預設應用程式
<a name="multi-apps-change-default"></a>

當您將第一個應用程式連結到串流群組時，它會自動成為預設應用程式，並接收預先快取的好處。您可以隨時變更預設應用程式，將這些優點提供給不同的應用程式。

**注意**  
當您切換串流群組中的預設應用程式時，在所有位置預先快取新的預設應用程式最多可能需要幾個小時。

------
#### [ Console ]

**使用 Amazon GameLift Streams 主控台變更預設應用程式**

1. 登入 AWS 管理主控台 並開啟 [Amazon GameLift Streams 主控台](https://console.aws.amazon.com/gameliftstreams/)。

1. 在導覽列中，選擇**串流群組**以檢視現有串流群組的清單。

1. 選取串流群組以檢視其詳細資訊。

1. 在**連結應用程式中**，選取您要設為預設值的應用程式。

1. 選擇**設為預設值**。

------
#### [ CLI ]

**必要條件**

 您必須 AWS CLI 使用使用者登入資料和您選擇的 來設定 AWS 區域。如需設定說明，請參閱 [下載 AWS CLI](setting-up.md#setting-up-prereqs)。

**使用 變更預設應用程式 AWS CLI**

在您的 AWS CLI 中使用 [UpdateStreamGroup](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_UpdateStreamGroup.html) 命令，為您的內容自訂 。您要設為預設的應用程式必須已與串流群組建立關聯。

```
aws gameliftstreams update-stream-group \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --default-application-identifier a-9ZY8X7Wv6
```

where
+ `identifier`:

  串流群組，其具有您要設為預設值的應用程式。

  此值可以是可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。

  ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`

  ID 範例： `sg-1AB2C3De4`
+ `default-application-identifier`:

  您想要在此串流群組中設為預設值的應用程式。

  此值是可唯一識別應用程式資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。

  ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`

  ID 範例： `a-9ZY8X7Wv6`

------

## 連結應用程式
<a name="multi-apps-link"></a>

當您連結或關聯應用程式至串流群組時，串流群組將能夠串流應用程式。如果它是串流群組中的第一個應用程式，它會自動成為*預設應用程式*。您可以在串流群組達到 180 天之前，將其他應用程式連結至串流群組並進行取消連結。之後，您只能在群組的剩餘生命週期內從串流群組取消連結應用程式。

**重要**  
 您無法將應用程式連結至超過 180 天的串流群組。若要將不同的應用程式與串流群組建立關聯，您必須先重新建立它。如需如何重新建立串流群組的說明，請參閱 [串流群組維護](stream-groups.md#stream-groups-maintenance)。

 連結應用程式之前，請確定串流群組處於**作用中**狀態。

------
#### [ Console ]

**使用 Amazon GameLift Streams 主控台進行連結**

1. 登入 AWS 管理主控台 並開啟 [Amazon GameLift Streams 主控台](https://console.aws.amazon.com/gameliftstreams/)。

1. 在導覽列中，選擇**串流群組**以檢視現有串流群組的清單。

1. 選取串流群組以檢視其詳細資訊。

1.  在**連結應用程式中**，選擇**連結應用程式**。

1.  選取您要連結的應用程式。確認您的選擇，然後選擇**連結應用程式**。

------
#### [ CLI ]

**必要條件**

 您必須 AWS CLI 使用使用者登入資料和您選擇的 來設定 AWS 區域。如需設定說明，請參閱 [下載 AWS CLI](setting-up.md#setting-up-prereqs)。

**使用 連結應用程式 （多個） AWS CLI**

 AWS CLI 在您的 中使用 [AssociateApplications](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_AssociateApplications.html) 命令，為您的內容自訂 。

```
aws gameliftstreams associate-applications \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --application-identifiers a-9ZY8X7Wv6 a-1Z78C7Wv6
```

where
+ `identifier`:

  要與這些應用程式連結的串流群組。

  此值可以是可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。

  ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`

  ID 範例： `sg-1AB2C3De4`
+ `application-identifiers`:

  您要與此串流群組連結的一組應用程式。

  此值是可唯一識別應用程式資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。

  ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`

  ID 範例： `a-9ZY8X7Wv6`

------

## 取消連結應用程式
<a name="multi-apps-unlink"></a>

 當您取消連結或取消應用程式與串流群組的關聯時，就無法再使用該串流群組配置的運算資源來串流此應用程式。任何進行中的串流都會繼續，直到終止為止，這有助於避免中斷最終使用者的串流。Amazon GameLift Streams 不會使用此串流群組啟動新的串流。取消連結動作不會影響串流群組的串流容量。

 如果您取消連結串流群組的預設應用程式，如果有的話，Amazon GameLift Streams 會自動從剩餘的相關聯應用程式中選擇新的預設應用程式。

------
#### [ Console ]

**使用 Amazon GameLift Streams 主控台取消連結**

1. 登入 AWS 管理主控台 並開啟 [Amazon GameLift Streams 主控台](https://console.aws.amazon.com/gameliftstreams/)。

1. 在導覽列中，選擇**串流群組**以檢視現有串流群組的清單。

1. 選取串流群組以檢視其詳細資訊。

1.  在**連結應用程式中**，選取您要取消連結的應用程式 (s)。選擇**取消連結應用程式**。

1.  在**取消連結應用程式**對話方塊中，確認取消連結動作，然後選擇**取消連結**。

------
#### [ CLI ]

**必要條件**

 您必須 AWS CLI 使用使用者登入資料和您選擇的 來設定 AWS 區域。如需設定說明，請參閱 [下載 AWS CLI](setting-up.md#setting-up-prereqs)。

**使用 ( ) 取消連結應用程式 AWS CLI**

 在您的 AWS CLI 中使用 [DisassociateApplications](https://docs.aws.amazon.com/gameliftstreams/latest/apireference/API_DisassociateApplications.html) 命令，為您的內容自訂 。

```
aws gameliftstreams disassociate-applications \
    --identifier arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4 \
    --application-identifiers a-9ZY8X7Wv6 a-1Z78C7Wv6
```

where
+ `identifier`:

  要從中取消這些應用程式連結的串流群組。

  此值可以是可唯一識別串流群組資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。

  ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:streamgroup/sg-1AB2C3De4`

  ID 範例： `sg-1AB2C3De4`
+ `application-identifiers`:

  您要從此串流群組取消連結的一組應用程式。

  此值是可唯一識別應用程式資源的 [Amazon Resource Name (ARN)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html) 或 ID。

  ARN 範例： `arn:aws:gameliftstreams:us-west-2:111122223333:application/a-9ZY8X7Wv6`

  ID 範例： `a-9ZY8X7Wv6`

------