本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
遷移至 Amazon Chime SDK 訊息命名空間
Amazon Chime SDK Messaging 命名空間是 APIs 的專用位置,可建立和管理 Amazon Chime SDK 訊息資源。您可以使用 命名空間來處理任何可用 AWS 區域中的 Amazon Chime SDK 訊息 API 端點。如果您才剛開始使用 Amazon Chime SDK,請使用此命名空間。如需區域的詳細資訊,請參閱本指南Amazon Chime SDK 的可用 AWS 區域中的 。
使用 Amazon Chime 命名空間的現有應用程式應計劃遷移至專用命名空間。
遷移原因
基於下列原因,建議您遷移至 Amazon Chime SDK Messaging 命名空間:
- API 端點的選擇
-
Amazon Chime SDK Messaging 命名空間是唯一可在任何區域中使用 API 端點的 API 命名空間。如果您想要使用美國東部 (維吉尼亞北部) 以外的 API 端點,您必須使用 Amazon Chime SDK Messaging 命名空間。
如需 Amazon Chime SDK 訊息如何使用 AWS 區域的詳細資訊,請參閱本指南中的可用區域。
- 更新和新的訊息 APIs
-
我們只在 Amazon Chime SDK 訊息命名空間中新增或更新訊息 APIs。
遷移之前
遷移之前,請注意命名空間之間的差異。下表列出並說明它們。
| Amazon Chime SDK Messaging 命名空間 | Amazon Chime 命名空間 | |
|---|---|---|
| AWS SDK 命名空間 | ChimeSDKMessaging | Chime |
| 區域 | 多個 | 僅限美國東部 (維吉尼亞北部) |
| API | 僅限用於傳訊APIs | Amazon Chime 訊息和其他部分的 APIs |
| 流程 | 可用性 | 無 |
| 彈性頻道 | 可用性 | 無 |
命名空間之間的差異
下列各節說明 Amazon Chime和 Amazon Chime SDK Messaging命名空間之間的差異。
AWS SDK 命名空間
Amazon Chime SDK 命名空間使用Chime正式名稱。Amazon Chime SDK Messaging 命名空間使用ChimeSDKMessaging正式名稱。名稱的精確格式因平台而異。
例如,如果您使用 Node.js 中的 AWS SDK 來建立訊息,您可以使用一行程式碼來定址命名空間。
const chimeMessaging = AWS.Chime();
若要遷移至 Amazon Chime Messaging SDK,請使用新的命名空間和端點區域更新此行程式碼。
const chimeMessaging = AWS.ChimeSDKMessaging({ region: "Europe (Frankfurt)" });
區域
Amazon Chime 命名空間只能處理US East (N. Virginia)區域中的 API 端點。Amazon Chime SDK 訊息命名空間可以在任何可用區域中處理 Amazon Chime SDK 訊息 API 端點。如需最新訊息區域的清單,請參閱本指南Amazon Chime SDK 的可用 AWS 區域中的 。
端點
Amazon Chime SDK Messaging 命名空間使用與 Amazon Chime 命名空間不同的 API 端點。
只有用來建立傳訊資源的端點才能修改它。這表示透過 中的端點建立的訊息資源Europe (Frankfurt)只能透過 修改Europe (Frankfurt)。這表示透過歐洲 (法蘭克福) 端點建立的頻道只能透過歐洲 (法蘭克福) 進行修改。這也表示您無法將透過Chime命名空間建立的頻道定址為美國東部 (維吉尼亞北部) 的ChimeSDKMessaging命名空間。如需目前端點的詳細資訊,請參閱本指南API 映射中的 。
服務主體
Amazon Chime SDK Messaging 命名空間使用新的服務主體:messaging.chime.amazonaws.com。如果您有授予服務存取權的 SQS、SNS 或其他 IAM 存取政策,則需要更新這些政策,以授予新服務主體存取權。
API
Amazon Chime SDK Messaging 命名空間僅包含用於建立和管理訊息資源,以及用於傳送和接收訊息的 APIs。Amazon Chime 命名空間包含 Amazon Chime 服務其他部分的 APIs 以及簡訊。
頻道流程
頻道流程可讓開發人員在傳輸中的訊息上執行商業邏輯,再交付給訊息頻道的成員。例如,您可以建立流程,在訊息傳遞前從訊息中移除敏感資料,例如政府 ID 號碼、電話號碼或褻瀆資料。這有助於實作公司通訊政策或其他通訊指導方針。
您也可以使用頻道流程來執行函數,例如在將結果傳回給參與者之前彙總輪詢的回應,或透過 SMS 傳送訊息。
頻道流程僅適用於 ChimeSDKMessaging 命名空間。如需有關它們的詳細資訊,請參閱本指南使用頻道流程來處理 Amazon Chime SDK 訊息中的 。
彈性頻道
彈性管道支援大規模聊天體驗,最多 100 萬聊天使用者會在定義的子頻道數量之間自動平衡。彈性頻道只能在ChimeSDKMessaging端點中使用。如需彈性頻道的詳細資訊,請參閱本指南使用彈性管道在 Amazon Chime SDK 會議上主持即時事件中的 。
其他 APIs
訊息命名空間有不斷增長的 APIs 清單,而Chime命名空間沒有這些 API。如果您開始使用 Amazon Chime SDK,請使用簡訊命名空間來存取所有最新功能。如需目前 APIs的詳細資訊,請參閱《Amazon Chime SDK API 參考》中的 Amazon Chime SDK 訊息。