Amazon Sumerian使用者指南

Amazon Sumerian 使用者指南

Amazon Sumerian: 使用者指南Copyright © 2020 Amazon Web Services, Inc. and/or its affiliates. All rights reserved.

Amazon's trademarks and trade dress may not be used in connection with any product or service that is not Amazon's,in any manner that is likely to cause confusion among customers, or in any manner that disparages or discreditsAmazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may notbe affiliated with, connected to, or sponsored by Amazon.

Amazon Sumerian 使用者指南

Table of Contents什麼是 Amazon Sumerian？ ................................................................................................................. 1使用案例 ............................................................................................................................................ 2權限 .................................................................................................................................................. 3

Sumerian 的 IAM 受管政策 .......................................................................................................... 3場景權限 .................................................................................................................................... 3

入門 .................................................................................................................................................. 5事前準備 .................................................................................................................................... 5建立專案和場景 .......................................................................................................................... 5設定場景 .................................................................................................................................... 6設定和新增實體 .......................................................................................................................... 7新增行為 .................................................................................................................................. 10新增虛擬實境模式 ...................................................................................................................... 12發佈和檢視場景 ......................................................................................................................... 13清理 ........................................................................................................................................ 13後續步驟 .................................................................................................................................. 14

概念 ................................................................................................................................................ 15場景 ........................................................................................................................................ 15元件和實體 ............................................................................................................................... 15資產 ........................................................................................................................................ 15主機 ........................................................................................................................................ 15專案 ........................................................................................................................................ 16範本 ........................................................................................................................................ 16

儀表板 ............................................................................................................................................. 17專案 ........................................................................................................................................ 17場景 ........................................................................................................................................ 18資產套件 .................................................................................................................................. 19範本 ........................................................................................................................................ 20垃圾桶 ..................................................................................................................................... 20鎖定 ........................................................................................................................................ 21

編輯器 ............................................................................................................................................. 22畫布 ........................................................................................................................................ 23資產程式庫 ............................................................................................................................... 24資產面板 .................................................................................................................................. 25實體面板 .................................................................................................................................. 26Inspector Panel ........................................................................................................................ 26工具 ........................................................................................................................................ 27

文字編輯器 ....................................................................................................................... 28狀態機器編輯器 ................................................................................................................. 28時間軸 ............................................................................................................................. 29

鍵盤和滑鼠 ............................................................................................................................... 30發布 ........................................................................................................................................ 31

場景設定 .......................................................................................................................................... 33AWS 組態 ................................................................................................................................ 35快照 ........................................................................................................................................ 36Document ................................................................................................................................ 38環境 ........................................................................................................................................ 39後製效果 .................................................................................................................................. 40場景大小 .................................................................................................................................. 42場景統計資料 ............................................................................................................................ 43

實體 ................................................................................................................................................ 44管理實體 .................................................................................................................................. 44管理元件 .................................................................................................................................. 45轉型 ........................................................................................................................................ 46Geometry ................................................................................................................................. 46

iii

Amazon Sumerian 使用者指南

Material (材質) .......................................................................................................................... 47相機 ........................................................................................................................................ 48虛擬實境相機裝備 ...................................................................................................................... 48HMD 相機 ................................................................................................................................ 49虛擬實境控制器 ......................................................................................................................... 49Host ........................................................................................................................................ 49語音 ........................................................................................................................................ 50

狀態機器 .......................................................................................................................... 51指令碼 ............................................................................................................................. 52

對話 ........................................................................................................................................ 52狀態機器 .......................................................................................................................... 53指令碼 ............................................................................................................................. 55

2D 圖形 ................................................................................................................................... 55HTML ...................................................................................................................................... 55HTML 3D ................................................................................................................................. 56聲音 ........................................................................................................................................ 57低 ........................................................................................................................................... 57粒子系統 .................................................................................................................................. 57動畫 ........................................................................................................................................ 59碰撞器 ..................................................................................................................................... 59Rigid Body ............................................................................................................................... 61狀態機器 .................................................................................................................................. 62指令碼 ..................................................................................................................................... 62時間軸 ..................................................................................................................................... 64

資產 ................................................................................................................................................ 66Packs ...................................................................................................................................... 67範本 ........................................................................................................................................ 68虛擬實境工具 ............................................................................................................................ 69AR 工具 .................................................................................................................................. 69

Android Sample Project (Android 範例專案) .......................................................................... 70iOS 範例專案 ................................................................................................................... 70

主機 ........................................................................................................................................ 70模型 ........................................................................................................................................ 71Skybox .................................................................................................................................... 72媒體 ........................................................................................................................................ 74

狀態機器 .......................................................................................................................................... 75動畫 ........................................................................................................................................ 76音訊和相機 ............................................................................................................................... 76AWS 功能 ................................................................................................................................ 77鍵盤和滑鼠 ............................................................................................................................... 77效果與照明 ............................................................................................................................... 77材質和轉譯 ............................................................................................................................... 78物理和碰撞 ............................................................................................................................... 78邏輯和轉換 ............................................................................................................................... 79

指令碼編寫 ....................................................................................................................................... 80內建指令碼 ............................................................................................................................... 81內容物件 .................................................................................................................................. 81參數和引數 ............................................................................................................................... 82

參數格式 .......................................................................................................................... 82參數類型 .......................................................................................................................... 83

外部依賴關係 ............................................................................................................................ 84偵錯 ........................................................................................................................................ 85

故障診斷 .......................................................................................................................................... 86

iv

Amazon Sumerian 使用者指南

什麼是 Amazon Sumerian？Amazon Sumerian 為一組工具，用於在 web 上建立高品質虛擬實境 (VR) 體驗。有了 Sumerian，即可建構互動式 3D 場景而無須採取任何程式設計步驟、也可在瀏覽器中測試並發布為可立即供使用者使用的網站。

使用資產的 Sumerian 程式庫或者導入自己的程式庫。當您匯入 3D 模型時，Sumerian 將自動將轉換並最佳化模型。Sumerian 也有基本形狀、3D 模型、主機、紋理與指令碼的程式庫。

Note

第一次使用 3D、虛擬實境、動畫與編寫指令碼嗎？The Sumerian 網站提供各種體驗等級的多種實用教學。

Sumerian 3D 引擎提供程式庫進階使用 JavaScript 來編寫指令碼，即使不是程式設計師也能建立互動式虛擬實境！使用內建的狀態機器來為物件製作動畫並回應如點選與移動等使用者動作。

當您準備好與外界分享您的作品，可以直接以靜態網站形式發佈到 Amazon CloudFront，使用支援 WebVR的瀏覽器和耳機來檢視網站。

1

Amazon Sumerian 使用者指南

Amazon Sumerian 使用案例和要求Amazon Sumerian 的核心是以 web 為基礎的編輯器，可用來建構含動畫、指令碼互動和特殊效果的 3D 場景。編輯器會在 web 瀏覽器中執行，而且您的所有資料都會存放在 AWS。編輯器會將場景輸出至 AmazonCloudFront 做為靜態網站，您可以將其直接載入到任何與 WebVR 相容的瀏覽器和耳機，或是在您的網站上內嵌以供其他人存取。

Note

不知道如何編寫指令碼嗎？Sumerian 編輯器提供功能完整的狀態機器，無需編寫程式碼即可撰寫動畫指令碼和使用者視覺化互動。

WebVR 是一種開放規格，可讓您透過 web 建立和共用虛擬實境 (VR) 體驗。在多種桌上型電腦和行動作業系統上支援 web 應用程式之類的 WebVR 應用程式。這可讓您免於將應用程式連接至不同的程式設計語言和套件格式，以供所有使用者使用。Sumerian 提供您可以使用的工具和元件以將虛擬實境新增到您的場景 (p. 69)。

Sumerian 也可讓您建立擴增實境 (AR) 應用程式。AR 應用程式可以使用您手機的相機或與 AR 相容的耳機來在真實世界上添加圖形浮水印。Sumerian 提供範本和範例應用程式 (p. 69)以為 iOS 手機建立 ARKit 應用程式。

Sumerian 提供最佳化 3D 物件和場景範本的程式庫，您可以用這些來建構場景，而不需使用任何現有的資產。如果您有 3D 模型時，您可以將它們與他們的動畫和紋理從檔案系統拖曳到編輯器畫布來進行匯入。Sumerian 支援格式為 OBJ 和 FBX 的模型。

2

Amazon Sumerian 使用者指南Sumerian 的 IAM 受管政策

Amazon Sumerian 權限您可以使用 AWS Identity and Access Management (IAM) 以授予使用者 Sumerian 權限，並在您的帳戶中運算資源。IAM 在 API 層級控制對 AWS 的存取權限，以一致且安全地強制執行權限。

Sumerian 的 IAM 受管政策為了讓您輕鬆授予權限，IAM 支援每個服務的受管政策。當服務發佈新的 API 時，可使用新權限來更新這些受管政策。Sumerian 為使用者使用 Sumerian 編輯器所需的權限提供受管政策。

• AmazonSumerianFullAccess – 使用所有 Sumerian 功能的權限。

{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "sumerian:*" ], "Resource": "*" } ]}

新增受管政策連接到 IAM 使用者、群組或角色

1. 開啟 IAM 主控台。2. 開啟與您的執行個體描述檔、IAM 使用者或 IAM 群組關聯的角色。3. 在 Permissions(許可) 下，關聯受管政策。

您只需要存取至 Sumerians API。Sumerian 管理您建立在帳戶之外所有關聯至場景的儲存 (Amazon S3) 和內容交付 (Amazon CloudFront)。

場景權限若要在場景中使用 AWS 服務，場景也需要登入資料。您可以使用 Amazon Cognito Identity 建立一個身分集區，可讓場景透過權限存取角色以使用 AWS。建立一個將從指令碼存取，具有任何服務權限的角色，以及使用 AWS 服務元件的權限。

若要為 Sumerian 場景建立身分集區

1. 開啟 Amazon Cognito 主控台中的 Federated identities (聯合身分) 頁面。2. 選擇 Create new identity pool (建立新的身分集區)。3. 透過下列設定建立集區。

• Unauthenticated identities (未驗證的身分) – 已啟用4. 選擇 Edit identity pool (編輯身分集區) 以查看集區的詳細資訊。

3

Amazon Sumerian 使用者指南場景權限

5. 請記下 Identity pool ID (身分集區 ID) 以在日後使用。

當您建立身分集區，Amazon Cognito 會提示您建立兩個角色，驗證的角色，與未經驗證的角色。新增授權至未經驗證的角色。

若要為 Sumerian 場景新增權限到身分集區角色

1. 在 IAM 主控台中開啟 Roles (角色) 頁面。2. 選擇名為 Cognito_pool-nameUnauth_Role 的角色。3. 選擇 Attach policy (連接政策) 並為您的場景使用的服務新增政策。

• Speech component (語音元件) – AmazonPollyReadOnlyAccess 透過語音元件 (p. 50)授予場景使用 Amazon Polly 以將文字轉譯為音訊。

• AWS SDK for JavaScript – 新增授與存取權至您以 SDK for JavaScript 呼叫服務的政策。例如，AmazonS3ReadOnlyAccess。

在場景設定中的 AWS configuration (p. 35) (AWS 組態) 指派身分集區到您的場景。

4

Amazon Sumerian 使用者指南事前準備

Amazon Sumerian 入門。若要開始使用 Amazon Sumerian，透過在 Sumerian 程式庫中的資產來組成場景。您可以用不到一小時的時間建立含效果、動畫和支援虛擬實境 (VR) 耳機的場景。此教學課程也會顯示以語音元件進行指令碼的基本使用，其會使用 Amazon Polly 來將文字轉譯為音訊。

小節• 事前準備 (p. 5)• 建立專案和場景 (p. 5)• 設定場景 (p. 6)• 設定和新增實體 (p. 7)• 新增行為 (p. 10)• 新增虛擬實境模式 (p. 12)• 發佈和檢視場景 (p. 13)• 清理 (p. 13)• 後續步驟 (p. 14)

事前準備若要使用 Sumerian 編輯器，您需要在 IAM 使用者上使用 Sumerian API 的許可。此外，場景本身需要呼叫 Amazon Polly 的許可。您透過建立角色和 Amazon Cognito 身分集區來提供此許可。遵循 AmazonSumerian 權限 (p. 3) 中的指示來設定兩者。

您可以在最新版本的 Chrome 或 Firefox 中使用編輯器。要查看在虛擬實境中完成的場景，請使用最新版本的 Firefox。對於虛擬實境模式，您也需要相容的耳機。

支援的硬體

• Oculus Rift• HTC Vive

建立專案和場景建立專案和場景專案可以包含多個場景，以及您可以透過這些場景建立的資產套件和範本。

若要建立專案和場景

1. 開啟 Sumerian 儀表板。2. 選擇 Projects (專案)、New project (新專案)。3. 在專案名稱中輸入教教教教，然後選擇 Create (建立)。4. 請選擇 Create new scene (建立新場景)。

5

Amazon Sumerian 使用者指南設定場景

5. 在場景名稱中輸入 seesaw，然後選擇 Create (建立)。

設定場景skybox 是一種紋理或一組紋理，其會圍繞場景以提供背景映像。從 Sumerian Asset (資產) 程式庫新增skybox。

從 Sumerian 程式庫匯入 skybox。

1. 在螢幕頂端選擇 Import assets (匯入資產)。2.

選擇 Blue skysphere。如果您無法立即找到，按一下 skybox 圖示 來篩選清單。3. 選擇 Add (新增)。

此會將 skybox 資產套件新增到 Asset (資產) 面板。此套件包含 skybox 資產和 skybox 使用的 PNG 格式的紋理。將 skybox 新增到 Environment (環境) 下的場景設定中的場景。在該處新增一些霧和雪。

若要設定場景的環境

1. 在 Entities (實體) 面板中選擇根節點 (seesaw)，或按一下在畫布中的場景背景。顯示在右側螢幕上檢測器面板中的選項群組是場景設定。

2. 按一下 Environment (環境) 區段，以將其展開。展開其下的 Skybox、Fog & Ambient (煙霧和環境) 和Particles (粒子) 區段。

3. 從資產面板中按一下 Blue skysphere skybox 並將其拖曳至檢測器面板中的 Drop skybox (放置 skybox)欄位來將它連接到場景。

4. 選擇 Fog (煙霧) 來啟用並設定其參數：

• Fog near (煙霧靠近) – 5• Fog far (煙霧遠離) – 20

這會在離相機 5 個單位淡入煙霧和在 20 個單位或更遠處完全遮住所有東西。5. 選擇 Snow (雪) 來啟用並設定其參數：

• Velocity (速度) – 20• Rate (速率) – 30• Height (高度) – 100

6. 按一下畫面下方的播放按鈕，以查看雪片。調整雪片至您喜歡的速度和速率。在播放模式中對這些設定的變更會立即套用。

在本教學課程中稍後，您會設定場景來在播放時使用 Amazon Polly 將文字轉譯為音訊。若要這樣做，場景需要登入資料才能在 web 瀏覽器中使用 AWS SDK for JavaScript。為場景登入資料指派您在先決條件區段 (p. 5)中建立之身分集區的 ID 來提供場景登入資料。

若要設定 AWS SDK for JavaScript 登入資料

1. 在 Entities (實體) 面板選擇根節點。

6

Amazon Sumerian 使用者指南設定和新增實體

2. 在檢測器面板中展開 AWS configuration (AWS 組態) 區段。3. 輸入 Amazon Cognito 身分集區 ID。

設定和新增實體將一些地面新增到場景。

若要將下雪的田地新增到場景

1. 選擇 Create entity (建立實體)。2.

在 3D primitives (3D 基本值) 中，選擇四 。

會自動選取四。如果您選擇其他，您可以在畫布按一下或在實體面板按一下以再次選擇3. 四元件會出現在畫布右側上的檢測器面板中。展開最上方的區段並將實體名稱變更為 ground (地面)。

這些變更會立即反映在區段名稱和實體面板。4. 展開 Transform (轉換) 區段，然後輸入以下值：

• X 旋轉 – -90• X、Y 和 Z 比例 – 100• 靜態 – 已啟用

7

Amazon Sumerian 使用者指南設定和新增實體

5. 展開 Material (材料) 區段，並檢閱每個層的設定。您可以按一下擴散或反射顏色以選擇不同的顏色，或放置映像檔以新增紋理。

目前靠近相機的空間是非常暗。新增定向光源以為場景打光，像是太陽在其中照射。

若要新增定向光源

1. 選擇 Create entity (建立實體)。2. 在 Lights (光源) 底下，選擇 Directional (定向)。3. 展開 Transform (轉換) 區段，然後輸入以下值：

• Y 轉換 – 10• X 旋轉 – -30• Y 旋轉 – -60• 靜態 – 已啟用

4. 展開 Light (光源) 區段並啟用 Shadows (陰影)。

新增空白實體來代表 seesaw 與支點和板條的形狀。

若要新增 seesaw

1. 選擇 Create entity (建立實體)。2. 在 Others (其他) 底下，選擇 Entity (實體)。3. 在檢測器面板中，將實體名稱變更為 seesaw。4. 選擇 Create entity (建立實體)，然後將圓柱體新增到場景。5. 將圓柱體重新命名教教，取消選取 Uniform scale (統一擴展)，並將 Z 擴展到 0.6。將擴散顏色設定為黃

色。6. 新增空白實體。將其重新命名為教教。此空白實體可做為到板條模型的父項目，以及將與板條一同移動的

相機和主機實體。7. 新增方塊實體。將其重新命名為教教教教。套用以下轉換並將擴散顏色設定為藍色：

• Y 轉換 – .5• Z 旋轉 – 12

8

Amazon Sumerian 使用者指南設定和新增實體

• X 比例 – 4.5• Y 比例 – 0.1• Z 比例 – 0.6• 靜態 – 已停用

接著從 Sumerian 程式庫匯入主機。主機是 Sumerian 提供的字元模型，內含內建動畫並支援語音。

若要新增主機

1. 選擇 Import assets (匯入資產)。2. 選擇 Cristine、Luke 或 Preston。接著選擇 Add (新增)。

3. 當資產套件完成載入時，將主機實體從 Asset (資產) 面板拖曳至畫布。4. 套用以下轉換：

• X 轉換 – 1.95• Y 轉換 – 0.97• Z 旋轉 – 12• Y 旋轉 – -90• X、Y 和 Z 比例 – 1.3• 靜態 – 已停用

最後，使用 Entities (實體) 面板來組織您在階層中建立的實體。拖曳實體到另一個實體，讓他們成為父項與子項。

9

Amazon Sumerian 使用者指南新增行為

新增行為您可以透過將指令碼或狀態機器元件附加到實體來對場景新增行為。

狀態機器可讓您以視覺化的方式新增行為，方法是選擇事件觸發的動作，並將這些動作組織成狀態。將狀態機器新增到板條實體，以將其及其子項變成動畫。

若要使用狀態機器製作板條的動畫。

1. 在實體面板中選擇 plank (板條)。2. 在檢測器面板中，按一下 Add component (新增元件)。然後選擇 State machine (狀態機器)。3. 按一下行為欄位旁的加號來建立新行為。將其命名為教教。4. State machine (狀態機器) 面板會與單一狀態一起顯示。將狀態命名為教教，然後選擇 Add action (新增動

作)。5. 在 Animate (動畫) 下，選擇 Tween rotate (Tween 輪換)。套用以下屬性：

• Z 旋轉 – -24• 相對 – 已停用• 時間 – 1000• 簡化類型 – Linear (線性)• 方向 – In (入內)

6. 再次選擇 Add action (新增動作)，然後新增 Wait (等待) 動作。套用以下屬性：

• 時間 – 2000• 隨機 – 0

7. 在 State machine (狀態機器) 面板中，選擇 Duplicate state (重複的狀態) 來製作 up (開啟) 的副本。按兩下新狀態以在檢測器面板中開啟。

8. 將狀態名稱變更為教教，然後將旋轉值從 -24 變更為 0。

10

Amazon Sumerian 使用者指南新增行為

9. 在 State machine (狀態機器) 面板中，每個狀態顯示兩個事件，一個發生在動畫結尾，另一個發生在等待動作結尾。按一下在 On wait end (啟動) 下的 On wait end (在等待端) 事件並拖曳直線到 down (關閉)狀態。然後在另一個方向執行相同動作。

10. 播放場景，以觀賞 seesaw 動畫。

將相機新增到另一端 seesaw 並使其成為預設相機。在播放期間，使用者將會保持在同一位置並查看周圍環境。內建的相機指令碼允許使用者在進入虛擬實境模式前使用滑鼠來進行尋找。

若要使用滑鼠查詢控制新增相機

1. 選擇 Create entity (建立實體)，然後將固定的相機新增到場景。將其重新命名為教教教，然後套用以下轉換：

• X 轉換 – -2.5• Y 轉換 – 1.2• Y 旋轉 – -90

2. 在實體面板中，將相機移動到 plank (板條) 實體，使其能與 seesaw 一起移動。3. 在相機的 Camera (相機) 元件中，套用下列屬性：

• 主要相機 – 已啟用• FOV – 35

4. 選擇 Add component (新增元件)，然後將指令碼元件新增到相機。5. 按一下指令碼欄位旁的加號，然後選擇 Mouse look control (滑鼠查詢控制)。此會新增滑鼠查詢內建指令

碼的執行個體。指令碼的所有執行個體共用同一個指令碼程式碼，但有不同的參數值。6. 若要阻止使用者尋找過低的值，將 Min ascent (最小堆疊) 參數變更為 -40。7. 播放場景，並確認相機的行為。按一下並拖曳滑鼠左鍵以查看場景。您可以在播放期間調整指令碼的參

數，以及查看他們是否會立即影響到控制。

11

Amazon Sumerian 使用者指南新增虛擬實境模式

主機隨附語音元件。若要使用該元件，您需要將 AWS 登入資料新增至場景，並將文字檔案新增到元件，並新增指令碼或狀態機器元件來觸發播放時的語音。

在此範例中，您將使用指令碼來執行狀態機器無法做到的事項 — 隨機選擇和播放檔案。如果您尚未為場景設定 AWS 登入資料，如先決條件 (p. 5)中所述，請先執行該部分。

若要在主機上設定語音

1. 在畫布或實體面板中選擇主機。2. 在 Speech (語音) 下，將一些文字檔案放置到語音欄位。您可以使用此存檔中的檔案：sonnets.zip。3. 選擇主機的聲音。請參閱 Amazon Polly 開發人員指南中的可用語音來尋找依地區排序的語音清單。4. 將指令碼元件新增至主機。5. 按一下指令碼欄位旁的加號，然後選擇 Custom (自訂)。6. 按一下指令碼執行個體參數中的編輯 (鉛筆圖示) 以在文字編輯器中開啟該指令碼。您也可以按 J 鍵以隨

時開啟文字編輯器。7. 按兩下 Documents (文件) 清單中指令碼名稱 (Script) 以將名稱變更為 RandomSpeech。8. 將預留位置 setup 函數取代為以下內容。

var setup = function(args, ctx) { sumerian.SystemBus.addListener('aws.sdkReady', () => { var speechComponent = ctx.entity.getComponent("speechComponent"); var speeches = speechComponent.speeches; var speech = speeches[Math.floor(Math.random() * speeches.length)]; speech.play(); }, true );};

此指令碼會等待 AWS SDK for JavaScript 載入和擷取登入資料。然後，它會取得對相同實體上語音元件的參考 (主機) 並取得所有附加語音的清單。它會從陣列中選擇一個語音並播放它。

9. 播放場景，以查看主機描述語音。10.

返回語音元件，然後按一下 會新增手勢標記。11. 再次播放場景，以查看主機使用手勢描述語音。

新增虛擬實境模式到目前為止，您只能在播放模式中使用標準相機。新增虛擬實境 (VR) 設備，以讓使用者使用虛擬實境耳機與頭追蹤檢視 3D 中的場景。Sumerian 會將虛擬實境模式所需的實體和指令碼配套包裹在名為 CoreVR 的資產套件中。

若要新增虛擬實境模式

1. 選擇 Import assets (匯入資產)，然後將 CoreVR 資產套件新增到場景。2. 當資產套件完成載入時，將 VRCameraRig 實體拖曳至畫布以將其新增至場景。3. 選擇 VRCameraRig 實體。4. 選擇 VRCameraRig 元件。5. 選擇 Current VR camera rig (目前的虛擬實境相機裝備) 選項以啟用此裝備。6. 取消選取 Start at current camera (以目前相機開始) 選項。這可讓您在相機裝備在場景中放置的位置使

用該裝備，而不在使用者進入虛擬實境模式時使用非虛擬實境相機的位置。7. 在實體面板中，將 VRCameraRig 實體移動到 plank (板條) 實體，使其能成為使用者相機的同級。

12

Amazon Sumerian 使用者指南發佈和檢視場景

8. 選擇 user (使用者) 相機。按一下 Transform (轉換) 區段中的齒輪圖示，然後選擇 Copy (複製) 以複製轉換值。

9. 選擇 VRCameraRig。按一下 Transform (轉換) 區段中的齒輪圖示，然後選擇 Paste (貼上) 以貼上來自使用者相機的轉換值。

10. 使用綠色轉換處理，以調整與板條相對的虛擬實境相機高度。

11. 播放場景，然後按一下虛擬實境耳機圖示，以進入虛擬實境模式。

發佈和檢視場景是時候與全世界共用場景。使用 Amazon CloudFront 發佈場景來主控其做為任何人都能查看的網站。

若要發佈和檢視場景

1. 選擇畫面左上角 Scene (場景) 功能表中的 Publish (發佈)。2. 選擇 Publish (發佈)。3. 當編輯器完成發佈場景時，選擇 View (檢視)。

清理您的發佈場景會是公有的和將保持線上直到您取消發佈。

13

Amazon Sumerian 使用者指南後續步驟

若要取消發佈場景

1. 選擇畫面左上角 Scene (場景) 功能表中的 Publish (發佈)。2. 選擇 Unpublish (取消發佈)。3. 選擇 Yes (是)。

您可以保持 Sumerian 場景和專案以用於其他教學課程或將其刪除。您可以隨時從垃圾桶功能表中恢復已刪除的項目。

若要刪除專案。

1. 開啟 Sumerian 儀表板。2. 選擇專案。3. 在 Project details (專案詳細資訊) 下，請選擇 Delete (刪除)。

如果您為此教學課程建立了身分集區且不打算再次使用該及區，請在 Amazon Cognito 主控台中將其刪除。

後續步驟在下一章進一步了解 Sumerian，Amazon Sumerian 概念 (p. 15)。

14

Amazon Sumerian 使用者指南場景

Amazon Sumerian 概念Amazon Sumerian 可讓您建立虛擬實境 (VR) 與擴增實境 (AR) 場景，以元件及實體組成，並組織為專案。讓我們一起來仔細檢閱用於 Sumerian 編輯器和本指南中的概念。

場景場景是一種 3D 空間，其中包含定義虛擬實境或 AR 環境的物件和行為。物件包含您自支援的檔案類型匯入的幾何、材料和聲音，以及您在場景內建立的物件，例如光線、相機與粒子效果。行為包含狀態機器行為、動畫、時間軸和指令碼。

當您準備好展示場景，可直接以可在瀏覽器中開啟的靜態網站形式匯出到 Amazon CloudFront。

如需詳細資訊，請參閱「場景 (p. 18)」。

元件和實體所有物件與行為為元件，結合後可建立實體。例如，當您匯入 3D 模型並加入場景時，編輯器會建立含有幾何元件的實體、材料元件、轉換元件和動畫元件。然後，您可以使用編輯器來新增嚴格的內文、碰撞器和其他元件到實體之中。

如需詳細資訊，請參閱「Amazon Sumerian 實體 (p. 44)」。

資產資產是影像、聲音、指令碼、模型和文件，可匯入至 Sumerian 以用於場景。您可以獨立管理場景中的資產，場景會在資產程式庫中使用這些資產。資產可能屬於使用者或專案。

如需詳細資訊，請參閱「資產套件 (p. 19)」。

主機主機是一種由 Sumerian 提供的資產，具有內建的動畫、語音和行為，可與使用者互動。

15

Amazon Sumerian 使用者指南專案

主機使用 Amazon Polly 來從文字來源向使用者說話。您可以使用主機來與使用者互動，並指引他們完成虛擬實境體驗。

如需詳細資訊，請參閱「Amazon Sumerian 主機元件 (p. 49)」。

專案專案是組織工具，用於管理場景、資產和範本。

如需詳細資訊，請參閱「專案 (p. 17)」。

範本範本可讓您儲存場景複本，做為其他場景時的起始點使用。範本屬於專案。Sumerian 提供多種範本，您可以從儀表板存取。

如需詳細資訊，請參閱「範本 (p. 20)」。

16

Amazon Sumerian 使用者指南專案

Amazon Sumerian 儀表板儀表板開啟 Amazon Sumerian 應用程式時會看到的第一個畫面。您可以在此管理您的專案、場景、資產套件與範本。

專案蒐集您從專案中匯出的場景與範本及資產套件。您可以在專案外部建立草稿專案，但是您必須有可匯出範本與資產的專案。

當您在編輯器中開啟場景時，場景將會鎖定以避免其他使用者修改。儀表板可管理鎖定，且若有其他使用者意外讓場景開啟時您可以奪取鎖定。

主題• 專案 (p. 17)• 場景 (p. 18)• 資產套件 (p. 19)• 範本 (p. 20)• 垃圾桶 (p. 20)• 鎖定 (p. 21)

專案專案會收集您正在工作的場景。您在每個區域最多可以建立 1,000 個專案。

建立專案

1. 開啟 Sumerian 儀表板。

17

Amazon Sumerian 使用者指南場景

2. 選擇 Projects (專案)。3. 選擇 New project (新專案)。4. 輸入專案名稱，然後選擇 Create (建立)。

一旦您有一個專案，您可以使用儀表板以進行複製或刪除。

若要管理專案

1. 開啟 Sumerian 儀表板。2. 選擇專案。3. 在 Project details (專案詳細資訊) 下，請使用以下其中一個選項。

• Thumbnail (縮圖) – 選擇 Browse (瀏覽) 以上傳縮圖。• Name (名稱) – 變更專案名稱。• Description (描述) – 變更專案描述。• Actions (動作) – 移動或複製專案。Delete (刪除) 該專案並傳送到 Trash (垃圾桶)。• Published URLs (已發佈的 URL 連結) – 選擇 View URL List (檢視 URL 清單)，來取得已在 Amazon

CloudFront 發佈的所有專案場景的連結。

場景場景是您在儀表板中且在 Sumerian 編輯器上處理的 3D 空間。Sumerian 提供多種範本，您可以使用這些範本做為起點。

場景可以是草稿，或專案的一部分。每個區域最多可以建立 10,000 個場景。

建立場景

1. 開啟 Sumerian 儀表板。2. 選擇建立場景的位置。

• Home (首頁) – 建立草稿場景。• Drafts (草稿) – 建立草稿場景。• Project (專案) – 建立在其中一個專案的場景。

3. 請選擇 Create scene (建立場景)。4. (選用) 選擇 template (p. 20) (範本)。5. 輸入場景名稱，然後選擇 Create (建立)。

當您建立場景時，它會在 Sumerian 編輯器 (p. 22)中開啟以供立即使用。一旦您有一個場景，您可以使用儀表板以進行複製或刪除。選擇左上角的 Sumerian 圖示以離開場景並返回儀表板。

18

Amazon Sumerian 使用者指南資產套件

若要管理場景

1. 開啟 Sumerian 儀表板。2. 在 Recent scenes (最近場景)、Drafts (草稿) 或專案下尋找場景。3. 按一下場景縮圖以進行選擇。

Note

如果您按一下場景名稱或按兩下縮圖，場景會在 Sumerian 編輯器中開啟。4. 在 Scene details (場景詳細資訊) 下，請使用以下其中一個選項。

• Thumbnail (縮圖) – 選擇 Browse (瀏覽) 以上傳縮圖。• Name (名稱) – 變更場景名稱。• Description (描述) – 變更場景描述。• Tags (標籤) – 將標籤新增到用於篩選條件的場景。• 動作

• Open (開啟) – 在 Sumerian 編輯器中開啟場景。• View published (查看發佈) – 開啟在 Amazon CloudFront 場景中託管的已發佈版本。• Move (移動) – 將場景移動至不同的專案。• Copy (複製) – 將場景複製至不同的專案。• Duplicate (重複) – 在同一個專案中建立場景複本。• Delete (刪除) – 將場景傳送到垃圾桶

場景的其他選項可在Sumerian 編輯器 (p. 33)中取得。

資產套件專案的 Assets (資產) 頁面會顯示從場景匯出的資產套件。

在儀表板中，您可以變更套件的名稱和描述以及將其複製或移動到另一個專案。

若要管理資產套件

1. 開啟 Sumerian 儀表板。2. 選擇專案。3. 選擇 Assets (資產)。4. 選擇資產套件。5. 在 Asset details (資產詳細資訊) 下，請使用以下其中一個選項。

• Thumbnail (縮圖) – 選擇 Browse (瀏覽) 以上傳縮圖。• Name (名稱) – 變更資產套件名稱。• Description (描述) – 變更資產套件描述。• Tags (標籤) – 將標籤新增到用於篩選條件的資產套件。• 動作

• Move (移動) – 將資產套件移動至不同的專案。• Copy (複製) – 將資產套件複製至不同的專案。• Delete (刪除) – 將資產套件傳送到垃圾桶

資產套件的其他選項可在Sumerian 編輯器 (p. 67)中取得。

19

Amazon Sumerian 使用者指南範本

範本範本是從專案匯出的場景，做為其他場景的起始點使用。除了範由 Sumerian 提供的範本外，儀表板還可讓您管理您自場景匯出的範本。

您可以使用儀表板從範本建立場景，或在場景間移動或複製範本。Sumerian 也提供範本程式庫。

若要從範本建立場景

1. 開啟 Sumerian 儀表板。2. 請選擇 Create new scene (建立新場景)。3. 選擇其中一個 Sumerian Templates (Sumerian 範本)，或選擇 My templates (我的範本) 來從其中一個專

案使用範本。4. 輸入您的場景名稱，然後選擇 Create (建立)。

從 Sumerian 編輯器中的場景設定區塊 (p. 33)來從場景中建立範本。然後，您可以從儀表板上場景專案頁面中的 Templates (範本) 區塊複製範本到其他專案。

若要管理範本

1. 開啟 Sumerian 儀表板。2. 選擇專案。3. 選擇 Templates (範本)。4. 選擇一個範本。5. 在 Template details (範本詳細資訊) 下，請使用以下其中一個選項。

• Thumbnail (縮圖) – 選擇 Browse (瀏覽) 以上傳縮圖。• Name (名稱) – 變更範本名稱。• Description (描述) – 變更範本描述。• Tags (標籤) – 將標籤新增到用於篩選條件的範本。• 動作

• Move (移動) – 將範本移動至不同的專案。• Copy (複製) – 將範本複製至不同的專案。• Delete (刪除) – 將範本傳送到 Trash (垃圾桶)

垃圾桶當您刪除場景、專案、範本或資產套件，Amazon Sumerian 將其移到垃圾桶。垃圾桶的項目會無限期保留，且您可隨時恢復它們。

您可以使用垃圾桶功能表來恢復已刪除的項目或將其永久刪除。

20

Amazon Sumerian 使用者指南鎖定

若要恢復已刪除的項目

1. 開啟 Sumerian 儀表板。2. 選擇 Trash (垃圾桶)。3. 選擇某個項目，然後選擇 Restore (恢復)。

復原項目將會傳回到原始專案。

為了避免支付已刪除項目的儲存成本，請將它們永久刪除。

若要永久刪除項目

1. 開啟 Sumerian 儀表板。2. 選擇 Trash (垃圾桶)。3. 選擇某個項目，然後選擇 Delete (刪除)。

或

選擇 Empty trash (清空垃圾桶)。4. 選擇 Delete (刪除)。

鎖定Amazon Sumerian 編輯器使用鎖定來控制場景的修改。當您開啟場景，編輯器會在場景上建立鎖定並定期重新整理它。如果您嘗試在鎖定啟用時使用其他瀏覽器打開場景，則會看到錯誤。

如果您確定沒有其他人正在場景工作，或創建一個場景的複本並對其進行處理，您可以強制 Sumerian 放棄鎖定。

21

Amazon Sumerian 使用者指南

Amazon Sumerian 編輯器Sumerian 編輯器提供的界面，讓您輕鬆地在網際網路上匯入資產、建置和發佈場景。

當您在 Sumerian 編輯器中載入場景時，您可以查看螢幕上方的功能表列、實體面板、資產面板、畫布和檢測器面板。此功能表列提供的功能表可供您在場景間導覽，存取工具和進行發佈。

上方列

• Sumerian 標誌 – 離開至儀表板。• Scene (場景) – 建立新場景、發佈場景，或開啟最近的場景。• Tools (工具) – 存取文字編輯器、行為編輯器和時間軸編輯器。• Create entity (建立實體) – 將形狀、光源、相機或空白實體新增至場景。• Import assets (匯入資產) – 開啟資產程式庫。• Help (協助) – 查看捷徑清單或提交意見回饋。• Username (使用者名稱) – 登出。

位於畫面下方的狀態列顯示有關儲存、匯入和轉譯操作的更新。

狀態列

• 進度列 – 顯示有關目前活動的資訊 (例如模型上傳)。• Path (途徑) – 目前使用者、專案和場景。

22

Amazon Sumerian 使用者指南畫布

下列主題說明在編輯器每個區域的功能表選項。

面板和功能表• Amazon Sumerian 編輯器畫布 (p. 23)• 在 Amazon Sumerian 編輯器中從資產程式庫匯入資產 (p. 24)• 在 Amazon Sumerian 編輯器中使用資產面板 (p. 25)• 在 Amazon Sumerian 編輯器中使用實體面板 (p. 26)• 在 Amazon Sumerian 編輯器中使用檢測器面板 (p. 26)• 在 Amazon Sumerian 編輯器中使用工具 (p. 27)• Amazon Sumerian 編輯器鍵盤和滑鼠控制 (p. 30)• 在 Amazon Sumerian 編輯器中發佈場景 (p. 31)

Amazon Sumerian 編輯器畫布WebGL 渲染的檢視區位於 Sumerian 編輯器的中央。在此處您可以瀏覽、檢查並預覽場景中的內容。

畫布上方的功能表列有相機、播放與渲染選項。許多按鈕都有相應的 keyboard commands (p. 30) (鍵盤指令)

畫布功能表

• – 隱藏或顯示側邊面板。

• – 變更轉換控制點至平移模式。

• – 變更轉換控制點至旋轉模式。

• – 變更轉換控制點至縮放模式。

• – 在相對位置與絕對位置間切換。

•

– 在畫布中預覽渲染的場景。•

– 選擇畫布的渲染模式。•

– 顯示或隱藏 skybox (p. 72) 紋理。•

– 顯示或隱藏格線。•

– 顯示或隱藏後期效果。•

– 以預設相機檢視場景。•

– 以選擇的實體填入畫布。

23

Amazon Sumerian 使用者指南資產程式庫

• – 以所有場景中的實體填入畫布。

• – 以畫布填滿畫面。

在 Amazon Sumerian 編輯器中從資產程式庫匯入資產

您可以使用 Sumerian 編輯器的資產程式庫自 Sumerian 程式庫、您的本機機器或自您從場景匯出的資產套件 (p. 67)匯入資產。

若要匯入資產

1. 在 Sumerian 編輯器中開啟場景。2. 選擇 Import assets (匯入資產)。3. 選擇一個資產類型 (p. 66)來根據類型篩選可用的資產。4. 選擇一個資產套件，然後選擇 Add (新增) 來新增到場景的資產。

5. 編輯器完成匯入資產套件後，請從資產面板 (p. 25)拖曳套件中包含的實體到畫布上以新增到場景中。

24

Amazon Sumerian 使用者指南資產面板

在 Amazon Sumerian 編輯器中使用資產面板資產面板顯示所有屬於場景的資產。資產為實體或實體元件的可攜式版本。您可以從在編輯器中建立的外部檔案或實體來建立資產。

若要建立資產，請從機器抓取檔案或自實體面板抓取實體放入資產面板。根據檔案類型，您可以將檔案分割成多個資產。

如需更多詳細資訊，請參閱 Amazon Sumerian 資產 (p. 66)。

25

Amazon Sumerian 使用者指南實體面板

在 Amazon Sumerian 編輯器中使用實體面板實體面板顯示在階層中場景的實體，從場景本身開始。實體可以是場景或其他實體的子項。當您在實體面板選擇場景，檢測器面板 (p. 26)將顯示場景的設定。當您選擇實體，檢測器面板將顯示實體的元件。

依據實體或與其他實體的邏輯關係組織實體。實體的位置、輪換及擴展皆與其父項相對。當您移動父項，子項也會跟著移動。若要變更實體的父項，請將其拖曳到實體面板的新父項。

實體面板控制

•– 摺疊實體以在實體面板中隱藏子項。

• – 隱藏或顯示在畫布上的實體。

• – 複製實體。

• – 刪除一項實體。

• – 還原或重做變更。

在 Amazon Sumerian 編輯器中使用檢測器面板使用檢測器面板來管理場景設定、實體和資產。當您在 Sumerian 編輯器中選取任何這些元素，您會在以元素命名的部分中獲得以下屬性。

26

Amazon Sumerian 使用者指南工具

一般屬性

• Thumbnail (縮圖) – 元素的縮圖影像。拖曳影像到縮圖欄位上或將滑鼠暫停在上面。然後選擇 Takescreenshot (擷取螢幕畫面) 以儲存目前畫布檢視的影像。

• Name (名稱) – 元素的名稱。• ID (唯讀) – 元素的唯一識別符。• Type (類型 [唯讀]) – 元素類型：場景、實體或 資產類型 (p. 66)。• Description (描述) – 元素的描述。• Tags (標籤) – 您可用於指令碼的僅金鑰中繼資料。您可以使用內容物件 (p. 81)讀取標籤或搜尋有特定

標籤的實體。• Custom attributes (自訂屬性) – 您可用於指令碼的金鑰值中繼資料。您可以使用內容物件 (p. 81)來讀取

屬性。

當您選擇在實體面板 (p. 44)中的場景，或按一下畫布中的場景背景，檢測器面板會顯示套用至整個場景的設定的數個額外部分。這些包括環境設定、後續處理效果、和 AWS 開發套件登入資料。如需詳細資訊，請參閱「??? (p. 33)」。

當您在實體面板中選擇一實體，或在畫布上按一下實體，檢測器面板會顯示實體上的每個元件部分。最少，每個實體有轉換元件，決定其位置、旋轉和大小。透過將資產放到以其類型為基礎的其他組件場景中創建的實體。您可透過 Add component (新增元件) 來新增元件到檢測器面板中的任何實體。如需詳細資訊，請參閱「??? (p. 44)」。

當您在資產面板 (p. 25)選擇一個資產，檢測器面板僅會顯示適用於場景中每個資產執行個體的組件部分。例如，指令碼資產只有程式碼，但實體上的指令碼元件可以有自訂該指令碼執行個體的參數。不過，一個材質資產擁有所有的材質元件 (p. 47)屬性。修改任何這些屬性都會變更場景中材質的每個執行個體。

在 Amazon Sumerian 編輯器中使用工具Sumerian 編輯器有三種工具面板以使用複雜的資產和元件：

• text (文字) 編輯器提供可編寫指令碼、JSON 文件和語音檔案的介面。• timeline (時間軸) 編輯器可在關鍵影格之間製作動畫實體。• 此 state machine (狀態機器) 編輯器可讓您以視覺化的方式建構並連接狀態機器行為和動作。

27

Amazon Sumerian 使用者指南文字編輯器

文字編輯器文字編輯器可讓您檢視和修改場景中的所有文字資產，包括指令碼、JSON 文件和語音檔案。

若要使用文字編輯器，選擇 Tools (工具)、Text Editor (文字編輯器)。或者按下 J 鍵。

Documents (文件) 面板列出了您場景中的文字資產。請按下一個，以在索引標籤中開啟。若要重新命名資產，將其反白並按一下鉛筆圖示。

當您開啟一個指令碼，External Resources (外部資源) 面板便會顯示。您可以使用此面板從您的程式碼依據的網際網路匯入程式庫。如需詳細資訊，請參閱「外部依賴關係 (p. 84)」。

狀態機器編輯器狀態機器編輯器提供視覺化呈現，連接到狀態機器元件 (p. 62)的動作和行為。

28

Amazon Sumerian 使用者指南時間軸

若要使用狀態機器編輯器，按一下資產面板中行為旁邊，或在狀態機器元件上的鉛筆圖示。

每個行為的狀態機器編輯器都會顯示一個方塊。每個方塊中都有一個堆疊的動作，依執行順序排列。當動作轉換到另一個行為，將出現一個箭頭連接動作到目標行為。按下一個動作並拖曳游標到行為，以在兩者間建立轉換。

如需更多詳細資訊，請參閱 Amazon Sumerian State Machines (p. 75)。

時間軸使用時間軸以隨時間移動、旋轉或變更實體規模。您可以設定這些屬性的開始和結束值，並新增關鍵影格，以控制過程中的動畫速度或方向。時間軸也可以發出自訂事件，您可以從狀態機器或指令碼來使用它們。

29

Amazon Sumerian 使用者指南鍵盤和滑鼠

如需更多詳細資訊，請參閱 Amazon Sumerian 時間軸元件 (p. 64)。

Amazon Sumerian 編輯器鍵盤和滑鼠控制Sumerian 新增到每個場景的預設相機，支援滑鼠控制平移、縮放和圍繞相機的錨點旋轉。若要移動相機，請按住滑鼠按鈕，同時移動滑鼠。如果您只有一個滑鼠按鈕，您可以使用按鍵與滑鼠按鈕的組合來執行相同的動作。

相機移動

• 放大或縮小 – 滑鼠滾輪向上或向下捲動• 平移 – 滑鼠滾輪按鈕，或 Shift+ 滑鼠左鍵• 環繞 – 滑鼠右鍵，或 Alt+ 滑鼠左鍵

Sumerian 編輯器提供大多數畫布功能表按鈕 (p. 23)的對應按鍵。使用下方列按鍵以切換預設相機檢視，以及 F 鍵以單一實體填入畫布。空白鍵可隱藏側邊面板，讓畫布全螢幕顯示。

相機

• Frame entity (框架實體) – F

30

Amazon Sumerian 使用者指南發布

• Frame all (框住所有) – Shift+F• 底部和頂部檢視 – V• 後方和前方檢視 – C• 左右兩側檢視 – X• 編輯器相機檢視 – Z• 顯示和隱藏側邊列 – Space

在編輯器或 Entities (實體) 面板按一下以選取實體。在已選擇的實體，使用下列命令來加速編輯。

Editing (編輯)

• Delete entity (刪除實體) – Backspace 或 Delete• Duplicate entity (複製實體) – Ctrl+D• Translate handles (平移控制點) – W• Rotation handles (旋轉控制點) – E• Scale handles (比例控制點) – R• 在全域和相對轉換之間切換 – G• Undo (復原) – Ctrl+Z• Redo (重做) – Ctrl+Shift+Z

使用下列命令以開啟文字編輯器、時間軸編輯器與發佈功能表。

工具

• Text editor (文字編輯器) – J• Timeline (時間軸) – T• Publish (發佈) – Ctrl+Shift+P

時間軸開啟時，使用下列命令來調整關鍵影格和播放頭。

時間軸

• 向左移動關鍵影格 – Left (快速)、Ctrl+Left(緩慢)• 向右移動關鍵影格 – Right (快速)，Ctrl+Right(緩慢)• 向左移動讀取頭 – Shift+Left(快速)，Ctrl+Shift+Left(緩慢)• 向右移動讀取頭 – Shift+Right(快速)，Ctrl+Shift+Right(緩慢)• 向左調整關鍵影格 – Ctrl+Alt+1• 向中央調整關鍵影格 – Ctrl+Alt+2• 向右調整關鍵影格 – Ctrl+Alt+3• 移動關鍵影格至開頭 – Home• 移動關鍵影格至結尾 – End

在 Amazon Sumerian 編輯器中發佈場景發佈您的 Sumerian 場景來與網際網路上的使用者分享。當您發佈場景時，Sumerian 將使用您的場景來建立一個靜態網站並託管於 Amazon CloudFront。您可以直接連結使用者到景觀，或內嵌在網站的框架中。

31

Amazon Sumerian 使用者指南發布

若要發佈場景

1. 在 Sumerian 編輯器中開啟您的場景。2. 選擇 Scene (場景)，然後選擇 Publish (發佈)。3. 設定發佈設定。

• Custom CSS (自訂 CSS) – 指定 style 標籤的內容來新增到產生的網頁中。• Custom JavaScript (自訂 JavaScript) – 指定 script 標籤的內容來新增到產生的網頁中。

4. 選擇 Publish (發佈)。

在幾秒後，您的場景便會上線。您可以按一下 View (檢視) 來開啟。

32

Amazon Sumerian 使用者指南

Amazon Sumerian 場景設定除了儀表板中的可用選項外 (p. 18)，Sumerian 編輯器包含許多設定場景的選項。在檢測器面板中，您可以設定 AWS SDK for JavaScript 的登入資料、調整畫布大小與網格、以及設定全域設定，例如霧、背景影像以及後製處理效果。

若要設定場景

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中修改場景設定。

• Details (詳細資訊) – 更新場景的名稱與描述。• Tags (標籤) – 新增中繼資料標籤到場景。• Custom attributes (自訂屬性) – 新增中繼資料金鑰-值組到場景。

您可以將場景複本儲存為 template (範本)，做為建立其他場景時的起始點使用。如果您的場景儲存到專案，範本也會儲存到相同的專案。否則，您必須選擇專案來保留範本。

若要建立範本

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

33

Amazon Sumerian 使用者指南

3. 在檢測器面板中展開場景部分。4. 選擇 Save scene as template (另存場景為範本)。5. 如果場景是草稿，請選擇範本的專案。

您可以在儀表板中的場景之間複製或移動範本 (p. 20)。您可以再次從相同來源場景建立範本或者從範本建立的場景來更新範本當您儲存範本時，可選擇建立新範本或更新現有範本。

選擇場景名稱來收合場景設定區塊。

小節• 為您的 Amazon Sumerian 場景設定 AWS 登入資料 (p. 35)• 建立 Your Amazon Sumerian 場景的快照 (p. 36)• 為您的 Amazon Sumerian 場景設定畫布 (p. 38)• 為您的 Amazon Sumerian 場景設定環境設定 (p. 39)• 為您的 Amazon Sumerian 場景設定後製效果 (p. 40)• 計算您的 Amazon Sumerian 場景大小 (p. 42)

34

Amazon Sumerian 使用者指南AWS 組態

• 檢視您的 Amazon Sumerian 場景效能資訊 (p. 43)

為您的 Amazon Sumerian 場景設定 AWS 登入資料The AWS configuration (AWS 組態) 區塊可讓您設定登入資料與 AWS SDK for JavaScript 搭配使用。您可以設定 Amazon Cognito 身分集區 ID，Sumerian 會使用此 ID 在載入場景時擷取登入資料。身分集區必須有未經驗證且有權限的角色來使用您的指令碼存取的 AWS API。

Note

若您沒有身分集區，請依照 Amazon Sumerian 權限 (p. 3) 下的說明新增一個。

若要設定 AWS SDK for JavaScript 登入資料

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中展開 AWS configuration (AWS 組態) 區段。4. 輸入 Amazon Cognito 身分集區 ID。

若要使用登入資料，請在初始化 SDK for JavaScript 客戶端前建立偵測 aws.sdkReady 的指令碼。以下範例列出瀏覽器主控台中名為 mybucket 的 Amazon S3 儲存貯體。若要測試其功能，請建立指令碼 (p. 80)、附加到實體並播放場景。

Example S3listobjects 指令碼

'use strict';

35

Amazon Sumerian 使用者指南快照

var setup = function(args, ctx) { sumerian.SystemBus.addListener('aws.sdkReady', () => { let s3 = new AWS.S3(); s3.listObjects({Bucket: "mybucket"}, function(err, data) { if (err) { console.log('ERROR', err, data); } else { console.log('DATA', data); } } ); }, true );};

建立 Your Amazon Sumerian 場景的快照您可以使用快照面板來建立場景複本，之後可用於還原場景。建立快照以在嘗試新功能或進行場景的全面變更前設定還原點。

若要建立快照

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中展開 Snapshots (快照) 部分。

36

Amazon Sumerian 使用者指南快照

4. 輸入描述。5. 選擇 Create (建立)。

若要還原或刪除快照

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中展開 Snapshots (快照) 部分。4. 選擇一個快照。5. 選擇 Restore (還原) 或 Delete (刪除)。

37

Amazon Sumerian 使用者指南Document

為您的 Amazon Sumerian 場景設定畫布您可以使用文件面板來設定 WebGL 畫布和網格顏色的大小。這些設定只適用在編輯器中的場景上操作時，並適用於已發佈的場景。

若要使用文件設定來設定畫布

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中展開 Document (文件) 部分。

4. 您可以從以下選項中選擇：

• Grid (網格) – 更改網格顏色。• Stretch (延展) – 延展畫布以符合容器大小。• Aspect ratio (長寬比) – 延展畫布以符合容器大小，但是維持長寬比。• Resolution (解析度) – 設定畫布的固定大小。

38

Amazon Sumerian 使用者指南環境

為您的 Amazon Sumerian 場景設定環境設定使用環境設定來設定您的場景的背景影像、周圍光源和天氣。

若要設定環境設定

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中展開 Environment (環境) 部分。

4. 進行下列設定：

• Background (背景) – 設定場景的背景色以及不透明度。

為了讓背景呈現透明，請將 Opacity (不透明度) 設為 0。如果您新增 skybox，對背景設定沒有任何影響。

• Skybox – 使用影像做為場景背景。您可以從資產面板放入現有 skybox，或者選擇加號圖示來建立新的 skybox (p. 72)。

• Ambient (環境) – 新增環境光線來打亮場景中的所有物件。環境光線不會影響 skybox。

39

Amazon Sumerian 使用者指南後製效果

• Fog (霧) – 新增霧到場景。霧會以 Fog near (近霧) 單位開始遮蔽場景中的物件不被相機照到，而 Fogfar (遠霧) 單位則會讓霧變為完全不透明。

• Particles (粒子) – 新增會動、如雪般的粒子到場景的背景。

屬性• Velocity (頂端) – 粒子落下的速度。• Rate (出現率) – 每秒顯示的粒子數。• Height (高度) – 粒子將顯示的高度，相對於相機高度。

為您的 Amazon Sumerian 場景設定後製效果在檢測器面板的後製效果區塊中，您可以新增轉譯效果，例如去鋸齒與動態模糊。後製效果與虛擬實境模式不相容。

若要新增後製效果

1. 在 Sumerian 編輯器中開啟場景。2. 在 Entities (實體) 面板選擇根節點。

3. 在檢測器面板中展開 Post effects (後製效果) 部分。

4. 選擇 Add effects (新增效果)。5. 選擇一或多個效果，然後選擇 Add (新增)。

40

Amazon Sumerian 使用者指南後製效果

6. 調整檢測器面板中各種效果的設定。7.

按一下後製效果圖示 用於切換開與關。

後製效果屬性

• Antialias (去鋸齒) – 新增以 FXAA 為基礎的去鋸齒功能來消除鋸齒邊緣。• Span (平移) – 平滑效果的區域。

• Bloom (打光) – 讓明亮背景色覆蓋前景物件邊緣。• Opacity (不透明度) – 套用的打光量。• Size (大小) – 發光區域大小。• Gain (增益) – 加入亮度的量。• Intensity (強度) – 對比量。

• Bleach (漂白) – 根據亮度調整輸入色彩。• Opacity (不透明度) – 效果的混合倍數。

• Blur (模糊) – 模糊整個場景，呈現失焦感。• Amount (混合量) – 導致模糊的混合量。• Size (大小) – 模糊區域大小。

• Contrast (對比) – 調整亮度、對比與飽和度。• Brightness (亮度) – 移除或新增亮度。• Contrast (對比) – 調整對比。• Saturation (飽和度) – 調整色彩飽和度。

• Dot (點) – 加入黑白格子效果。• Angle (角度) – 格子角度。• Scale (比例) – 格子厚度。• SizeX – 傾斜 X 軸上的格子。• SizeY – 傾斜 Y 軸上的格子。

• Edge detect (邊緣偵測) – 新增以高斯分布差異為基礎的邊緣偵測。• Gauss Sigma – 兩個高斯核心的基礎。• Threshold (閾值) – 邊緣偵測公差值。• Background % (背景 %) – 背景與邊緣顏色之間的混合量。• Edge Color (邊緣顏色) – 邊緣顏色。• Background Color (背景顏色) – 背景顏色。

• Film grain (底片顆粒) – 加入噪點與解析度線條。• Noise (噪點) – 噪點量。• Line Intensity (線條強度) – 線條銳利度。• Line Count (線條數量) – 線條數量。

• Hatch (孵化) – 以黑白轉譯場景，黑色區域採用格子效果。• Width (寬度) – 格子線條的寬度。• Spread (延伸) – 格子線條之間的距離。

• HSB (色調、飽和度與亮度) – 調整場景顏色。• Hue (色調) – 調整色調。• Saturation (飽和度) – 調整色彩飽和度。• Brightness (亮度) – 調整影像亮度。

• Levels (等級) – 套用 gamma 修正到影像。• Gamma – 調整 gamma 等級。

41

Amazon Sumerian 使用者指南場景大小

• Min input (最小輸入) 與 Max input (最大輸入) – gamma 輸入範圍。• Min output (最小輸出) 與 Max output (最大輸出) – gamma 輸出範圍。

• Motion Blur (動態模糊) – 套用模糊效果到從前一個轉譯影格中移動的物件。如果相機移動，整個影像會變得模糊。• Amount (量) – 混合量。• Scale (比例) – 在目前影格上以不同比例覆蓋前一個影格來建立縮放或飛行效果。

• Noise (噪點) – 加入訊號噪點到影像中。• Noise (噪點) – 訊號噪點量。

• Overlay (覆蓋) – 在影像上覆蓋紋理。• Texture (紋理) – 紋理資產。• Blend mode (混合模式) – 混合覆蓋層與背景的方法。• Amount (量) – 混合量。

• Radial (放射狀) – 新增放射狀模糊到影像。• Offset (位移) – 模糊位移。• Multiplier (倍數) – 模糊倍數。

• RGB shift (RGB 位移) – 將影像分割為紅色、綠色與藍色層，圖層間帶有位移。• Amount (量) – 圖層間的距離。• Angle (角度) – 圖層間的弧度角度。

• Sepia – 新增 Sepia 顏色過濾器。• Amount (量) – 效果強度。

• Tint (色調) – 套用顏色過濾器到影像。• Color (顏色) – 顏色色調。• Amount (量) – 效果強度。

• Vignette – 在影像邊緣加入深色漸層。• Offset (位移) – 漸層大小。• Darkness (深度) – 漸層強度。

計算您的 Amazon Sumerian 場景大小Scene Size (場景大小) 區塊可計算您的場景使用了多少資料。您可以從 JSON、網格資料與二進位程式碼看到 KB 位元數。

顯示的數字將反映未經壓縮的場景大小。當場景自 Amazon CloudFront 提供時，內容將被壓縮。若要查看壓縮的大小，請開啟您的場景並使用瀏覽器開發人員工具的網路標籤來尋找已傳輸的數據量。

42

Amazon Sumerian 使用者指南場景統計資料

檢視您的 Amazon Sumerian 場景效能資訊Scene stats (場景統計資料) 區塊可提供部分關於目前場景的效能統計資料。

統計資料

• FPS – 每秒轉譯的影格量。• Draw calls (繪製呼叫) – 每影格執行的繪製呼叫量。• Entities (實體) – 可見實體的數量。• Lights (光線) – 轉譯的光線量。• Shadow casters (陰影發散體) – 轉譯的陰影發散體數量。• Shaders (著色器) – 轉譯的著色器數量。• Texture size (紋理大小) – 目前在 GPU 中的紋理大小。• Triangles (三角形) – 轉譯的三角形數量。

為提升效能，請嘗試減少繪製呼叫、光線和著色器的數量。

43

Amazon Sumerian 使用者指南管理實體

Amazon Sumerian 實體實體是一種 Sumerian 中的容器，可用來收集並組織場景中的資產。例如，當您新增 3D 模型到場景時，編輯器會將其分割到網格、紋理和動畫資產，並將它們以對應的 Sumerian 幾何、材質、和動畫元件指派給實體。您的場景最多可包含至 1,000 實體。

實體可以為相機、光源或其他實體的容器。Entities panel (p. 26) (實體面板) 組織實體到階層。您可以使用它在父子關係中來連接實體至另一個實體。

元件是實體可設定的部分，在播放期間判斷它的外觀和行為。若要讓燈光模型照明場景，請新增光源元件。若要在播放、新增實體機器、時間軸或指令碼元件時移動或變更實體。

若要建立實體並新增元件

1. 在 Sumerian 編輯器中開啟場景。2. 選擇 Create entity (建立實體)。3. 選擇形狀或內建物件。對於空白實體，選擇 Entity (實體)。4. 在實體面板中選擇 new entity (新實體)。5. 在檢測器面板中，展開 Details (詳細資訊) 部分。在欄位輸入文字來變更實體名稱、描述、標籤和屬性。6. 若要將實體置入場景，請使用在畫布上的 X、Y 和 Z 軸控制點。或者展開 Transform (轉換) 部分然後輸

入絕對座標。7. 選擇 plus (加上) 圖示，然後選擇元件類型以新增元件至實體。

管理實體使用實體面板以在階層中組織您場景的實體。當您將一個實體附加為另一個實體的子實體，它便會連接至父實體。也就是說，當您移動父實體時、子實體也會移動，而當您設定子實體位置時，它也會與父實體的位置關聯。

若要管理實體

1. 在 Sumerian 編輯器中開啟場景。2. 在實體面板中選擇一個 entity (實體)。

44

Amazon Sumerian 使用者指南管理元件

3. 拖曳實體到另一個實體，使其成為該實體的子實體。4. 使用實體名稱旁的圖示，來管理該實體。使用實體旁的眼睛圖示來隱藏它。

• – 隱藏實體。

• – 複製實體。

• – 刪除實體。

管理元件元件屬性可用來調整設定或附加資產。所有實體都包含轉型元件，您可以用來將實體圍繞場景移動。根據您建立的實體類型，也會自動包含其他元件。

預設元件

• 2D shapes (2D 圖形) – 轉換 2d 圖形• 3D shapes (3D 圖形) – 轉換、幾何、材質• Cameras (相機) – 轉換、相機、指令碼• HTML 3D – 轉換、HTML 3D• Lights (光源) – 轉換、光源• Particles (粒子) – 轉換、粒子• Timeline (時間軸) – 轉換、時間軸

若要管理元件

1. 在 Sumerian 編輯器中開啟場景。2. 在實體面板中選擇一個 entity (實體)。3. 在檢測器面板中，選擇元件的名稱來擴展或收合其屬性。請參閱下方主題的每個元件可用屬性詳細資

訊。4. 按一下齒輪圖示，然後使用以下選項：

• Reset (重設) – 重設元件屬性的預設值。• Toggle panel (切換面板) – 顯示或隱藏元件屬性。• Remove (移除) – 刪除元件。• Copy (複製) – 複製 (一些) 元件的組態。• Paste (貼上) – 貼上您從不同實體複製的相同元件貼上 (一些) 元件組態。

有些元件也有會被父元件影響的特殊屬性。例如，碰撞器的行為會根據連接到相同實體或父實體上的剛性物體類型而變更。

下列主題描述了每種組件的參數和用法。

基本元件

• Amazon Sumerian 轉換元件 (p. 46)

45

Amazon Sumerian 使用者指南轉型

• Amazon Sumerian 幾何元件 (p. 46)• Amazon Sumerian 材質元件 (p. 47)• Amazon Sumerian 相機元件 (p. 48)• Amazon Sumerian 虛擬實境相機裝備元件 (p. 48)• Amazon Sumerian HMD 相機元件 (p. 49)• Amazon Sumerian 虛擬實境控制器元件 (p. 49)• Amazon Sumerian 主機元件 (p. 49)• Amazon Sumerian 語音元件 (p. 50)• Amazon Sumerian 對話元件 (p. 52)

內容和效果

• Amazon Sumerian 2D 圖形元件 (p. 55)• Amazon Sumerian HTML 元件 (p. 55)• Amazon Sumerian HTML 3D 元件 (p. 56)• Amazon Sumerian 聲音元件 (p. 57)• Amazon Sumerian 光線元件 (p. 57)• Amazon Sumerian Particle System Component (粒子系統元件) (p. 57)

動畫和物理

• Amazon Sumerian 動畫元件 (p. 59)• Amazon Sumerian 碰撞器元件 (p. 59)• Amazon Sumerian 剛性物體元件 (p. 61)• Amazon Sumerian State Machine 元件 (p. 62)• Amazon Sumerian 指令碼元件 (p. 62)• Amazon Sumerian 時間軸元件 (p. 64)

Amazon Sumerian 轉換元件轉換元件包含了本機轉換的元件 – 轉譯、旋轉和擴展。轉換與其父系相對。

屬性

• Translation (轉譯) – 相對於其父系物件的物件位置。• Rotation (旋轉) – 物件的旋轉度數。• Scale (擴展) – 物件的大小。• Uniform scale (統一擴展) – 當規模在任何軸上修改時所維持的比例。• Static (靜態) – 根據播放期間不移動物件的轉譯進行最佳化。

Amazon Sumerian 幾何元件幾何元件包含了在實體上的可渲染網格或原始物件。當您從 Create entity (建立實體) 功能表匯入 3D 模型或建立一個原始物件時，一律會得到一個幾何元件。

46

Amazon Sumerian 使用者指南Material (材質)

與材質元件一起，您可以渲染該實體。如果您還沒有材質元件，則看不見該幾何體。

對不同種類的網格與原始物件，面板看起來會有所不同，但一般而言它們都有這些設定：

屬性

• 投射陰影• 接受陰影• 維度與/或樣本數 (僅適用原始物件)

Amazon Sumerian 材質元件當您新增 3D 模型到環境中時，至少有兩個元件。幾何元件 (p. 46)定義模型形狀。材質元件定義其紋理與轉譯屬性。

屬性

• Diffuse color (漫反射顏色) – 表面的基底顏色。• Color (顏色) – 基底漫反射顏色。• Texture (紋理) – 來自紋理的漫反射顏色。

• Normal (正常) – 凸對應類型。正常貼圖為您用以新增表面細節到模型的紋理特殊種類，例如凸面、曲線與刮痕。這些細節可抓取光線，彷彿由實際的幾何呈現。

您可以透過 Texture (紋理) 輸入來設定正常貼圖，而您可以設定 Strength (強度) 值來修改其強度。• Specular (反射) – 反射效果，基本上為場景中光源的直接反射。這些通常會顯示物件表面的明亮打光或亮

度 (雖然反射打光可能難以察覺或者也會呈現漫反射)。

您可以設定基底反射度 Color (顏色)，使用 Texture (紋理) 並設定 shininess (亮度) 值。• Emissive (發光) – 物體的自我照明顏色。您可以使用 Color (顏色) 輸入及/或使用 Texture (紋理) 來設定發

光顏色。• Ambient (環境) – 在陰影中的物體顏色。此顏色是在環境光線照明時物件反射的顏色，而非直接光線。

• Color (顏色) 基底環境顏色。• Texture (紋理) 定義網格上暴露於環境光線或避開環境光線的區域之環境貼圖。

• Opacity (不透明度) – 以透明度混合來使用。您可以使用 Strength (強度) 來輸入介於 0 到 1 之間的值，其中 0.0 代表完全透明而 1.0 代表完全不透明。• Threshold (閾值) – 用於表示當表面完全透明時，且可從轉譯中捨棄。• Dual transparency (雙重透明度) – 轉譯材料表面的正面與背面。

• Reflectivity (反射性) – 材質的反射性設定。• Texture (紋理) – 反射性紋理。• Environment (環境) – 您在反射中看到的環境貼圖。如果未選取，將使用目前的 skybox。• Amount (量) – 要使用的反射量。• Fresnel (菲涅耳透鏡) – 非零的菲涅耳透鏡值將產生較少反射，根據正常方向而定。

• Refractivity (折射度) – 折射輸入。需要模擬表面折射索引的紋理或值。對於玻璃與水等物體來說非常有用，可折射穿越這些物體的光線。用於折射的紋理環境。• Amount (量) – 折射與目前顏色混合的量。• Refraction (折射) – 與折射相關的折射索引比例。

• Blending (混合) – 用於材質的混合模式。• NoBlending

47

Amazon Sumerian 使用者指南相機

• TransparencyBlending• CustomBlending• AdditiveBlending• SubtractiveBlending• MultiplyBlending

• Culling (剔除) – 是否要在三角層級上剔除，以及要剔除那些表面 (反面、正面、兩者)。• Depth (深度) – 是否要啟用深度測試或者深度編寫，以及要使用哪些 RenderQueue 值。• Shading (著色)

• Flat (平面) – 為網格開啟平面著色。• Wireframe (線框邊界) – 在線框邊界模式中轉譯網格。• Wrap factor (包裝元素) – 光線包裝元素。• Wrap amount (包裝量) – 光線包裝量。

Note

您可以共用實體之間的材質資產。如果共用材料資產，變更一個實體的外觀也會變更共用材質的實體外觀。

Amazon Sumerian 相機元件相機元件新增相機到實體。在 Amazon Sumerian 編輯器中，您可以使用它來定義 3D 檢視區。

屬性

• Main camera (主要相機) – 在場景開始時使用此相機。若您有多個相機，可以在編輯與播放模式下在相機之間切換。

• Follow editor camera (跟隨編輯器相機) – 以編輯器相機來設定相機位置。在編輯和播放模式之間切換時，此選項很有用。

• Projection (投影) – 控制相機在 2D 畫布上投影 3D 世界的方式。• Field of view (FOV) (檢視欄位 (FOV)) – 設定相機從左至右平移的角度。• Clipping planes (剪裁平面) – 設定物件繪製位置與相機的距離。

Amazon Sumerian 虛擬實境相機裝備元件虛擬實境相機裝備元件會設定虛擬實境 (VR) 耳機和控制器，以用於在播放時的虛擬實境模式。當使用者具有支援的耳機，他們可按一下虛擬實境按鈕來切換主要相機 (p. 48)及代表虛擬實境耳機頭掛載顯示 (HMD)相機 (p. 49)。

支援的硬體

• Oculus Rift• HTC Vive

針對 HMD 相機和每個虛擬實境控制器，將虛擬實境相機裝備元件附加至具子實體的實體。CoreVR 資產套件 (p. 69)在 Sumerian 程式庫中包含的裝備實體，內含適用於每個受支援耳機的 HMD 相機和控制器。

48

Amazon Sumerian 使用者指南HMD 相機

屬性

• Load gamepads (載入遊戲器) – 取消選取以停用控制器。• Start at current camera (以目前相機開始) – 取消選取以從其轉換位置使用相機，而不是當使用者進入虛擬

實境模式交換虛擬實境裝備的主要相機。• Current VR camera rig (目前的虛擬實境相機裝備) – 選擇在虛擬實境模式使用此裝備。

Amazon Sumerian HMD 相機元件HMD 相機元件代表在虛擬實境相機裝備中的頭戴式顯示器 (HMD)。當您將含 HMD 相機元件的實體連接至虛擬實境相機裝備，使用者可以使用虛擬實境耳機來檢視虛擬實境模式中的場景。

此元件沒有任何可設定的屬性。如需詳細資訊，請參閱「Amazon Sumerian 虛擬實境相機裝備元件 (p. 48)」。

Amazon Sumerian 虛擬實境控制器元件虛擬實境控制器元件代表在虛擬實境相機裝備中的單一虛擬實境 (VR) 控制器。當使用者透過連接的控制器進入虛擬實境模式時，虛擬實境控制器元件會在 3D 空間中追蹤其位置。

如需詳細資訊，請參閱「Amazon Sumerian 虛擬實境相機裝備元件 (p. 48)」。

屬性

• ID – 此實體代表的控制器類型。

Amazon Sumerian 主機元件主機是一種由 Sumerian 提供的資產，具有內建的動畫、語音和行為，可與使用者互動。從資產程式庫 (p. 24)將主機新增到您的場景。

當您將主機新增到場景，它包含 Host (主機) 元件，可用來設定主機的行為，以及 speech (語音) 元件 (p. 50)，可用來設定主機的語音和指令碼。

49

Amazon Sumerian 使用者指南語音

屬性

• Point of interest (感興趣的點) – 設定來 Look at entity (看看實體) 以訓練主機的目光在播放時保持在相機、物件或其他實體。

• Target entity (目標實體) – 將實體放置在這裡，以將它設定為主機感興趣的點。• Lip sync (唇同步) – 在播放語音時播放唇同步動畫。• Gestures (手勢) – 在播放語音時播放手勢動畫。• Gesture hold time (手勢保存時間) – 設定要播放手勢動畫的秒數。• Minimum gesture period (最低手勢期間) – 設定手勢完成後另一個手勢發生前的秒數。

Amazon Sumerian 語音元件語音元件指定文字至一個實體並以 Amazon Polly 播放。您會透過狀態機器或指令碼，將文字指定到實體，並從 Amazon Polly 播放音訊輸出。場景在執行時間呼叫 Amazon Polly 來產生音訊。

若要在播放時使用 Amazon Polly，場景需要來自 Amazon Cognito Identity. 的 AWS 登入資料。為您的場景建立一個身分集區 (p. 3)並在場景設定中的 AWS 組態 (p. 35)下設定它。

50

Amazon Sumerian 使用者指南狀態機器

屬性

• Voice (語音) – Amazon Polly 語音。• Volume (磁碟區的) – 已轉譯音訊的磁碟區。•

Speech files (語音檔案) – 將文字檔案放至此處，以將其新增至元件。Click 使用手勢以標記語音檔案。

若要在播放時觸發語音，請在相同實體上使用狀態機器或指令碼元件。

狀態機器要播放語音，請使用語音元件新增狀態機器 (p. 62)至實體。以 AWS SDK ready (支援 AWS 開發套件) 新增狀態並開始語音動作。

51

Amazon Sumerian 使用者指南指令碼

指令碼若要播放語音，請從上下文物件中取得語音元件的參考。元件有包含語音附加到元件中的 speeches 陣列。在語音上呼叫 play。

Sumerian 會在您播放語音時呼叫 Amazon Polly，因此您必須使用 aws.sdkReady 接聽程式來確保場景的AWS 登入資料在呼叫前載入。

Example 指令碼 – 播放隨機語音

'use strict';var setup = function(args, ctx) {sumerian.SystemBus.addListener('aws.sdkReady', () => { var speechComponent = ctx.entity.getComponent("speechComponent"); var speeches = speechComponent.speeches; var speech = speeches[Math.floor(Math.random() * speeches.length)]; speech.play(); }, true);};

Amazon Sumerian 對話元件對話元件指派 Amazon Lex 聊天機器人到實體。您可以使用此元件來啟用主機 (p. 49)或其他實體以具有與使用者對話以及蒐集資訊的能力。

若要在播放時使用 Amazon Lex，場景需要來自 Amazon Cognito Identity 的 AWS 登入資料。為您的場景建立一個身分集區 (p. 3)並在場景設定中的 AWS 組態 (p. 35)下設定它。

52

Amazon Sumerian 使用者指南狀態機器

屬性

• Name (名稱) – Amazon Lex 機器人的名稱。• Alias (別名) – 發佈機器人時選擇的別名。

若要在播放時觸發對話，請在相同實體上使用狀態機器或指令碼元件。

狀態機器若要使用 Amazon Lex 機器人，請新增狀態機器 (p. 62)到含有對話與語音 (p. 50)元件的實體。使用動作來擷取音訊或文字、傳送到 Amazon Lex 進行處理、播放遊戲並等待額外的輸入。

Example 文字輸入狀態

• 教教教 – AWS SDK ready (支援 AWS 開發套件) 等待 AWS SDK for JavaScript 從 Amazon Cognito 身分集區擷取登入資料。

• 教教教教 – Get HTML text (取得 HTML 文字) 動作，擷取 HTML 元件中 input 元素的內容。• Entity (實體) – 含有 input 元素的 HTML 元素。• HTML element selector (HTML 元素選擇工具) – input 元素的 ID。例如，教myTagId。

• Send to bot (教教教教教教) – Send text input to dialogue bot(傳送文字輸入到對話機器人) 可從之前的狀態傳送文字到您的 Amazon Lex 機器人並傳遞回應到下一個狀態。

傳換 On response ready (在回應備妥時) 到 Play response、以及 On processing error (在處理錯誤時)到 Collect text。

• Play response (播放回應) – Start speech (開始語音) 播放來自 Amazon Lex 的回應。轉換為 Collecttext。• Use Lex response (使用 Lex 回應) – 已啟用。

53

Amazon Sumerian 使用者指南狀態機器

Example 音訊輸入狀態

• 教教教 – AWS SDK ready (支援 AWS 開發套件) 等待 AWS SDK for JavaScript 從 Amazon Cognito 身分集區擷取登入資料。

• 教教 (1) – Key down (按下按鍵) 等待使用者按下按鍵。• 教教 (2) – Start microphone recording (開始麥克風錄製) 錄製音訊與 Key up (放開按鍵) 等待使用者放開按

鍵。• 教教 (3) – Stop microphone recording (停止麥克風錄製) 完成音訊錄製並傳遞到下一個狀態。• 教教教教教教 – Send audio input to dialogue bot (傳送音訊輸入到對話機器人) 從之前的狀態傳送音訊到

Amazon Lex 機器人。• 教教教教 – Start speech (開始語音) 從之前的狀態播放音訊回應。轉換為 Wait (等待)。

54

Amazon Sumerian 使用者指南指令碼

指令碼您可以使用指令碼來更新實體對話元件的組態，以回應使用者輸入。以下範例新增接聽程式到兩個按鈕，以變更按下按鈕時的作用中機器人。

Example 指令碼 – 變更作用中機器人

'use strict';

function setup(args, ctx) { ctx.entityData.changeBot = function(event){ var name = event.target.getAttribute("botname"); var alias = event.target.getAttribute("botalias"); console.log("Changing bot to " + name); ctx.entity.dialogueComponent.updateConfig({name: name, alias: alias}); }; document.getElementById("bot1button").addEventListener('click', ctx.entityData.changeBot); document.getElementById("bot2button").addEventListener('click', ctx.entityData.changeBot);}

同一個場景中的 HTML 元件會建立指令碼參考的按鈕。

Example HTML – 對話指令碼的按鈕

<button id="bot1button" botname="OrderFlowers" botalias="latest" type="button">Order Flowers</button><button id="bot2button" botname="BookTrip" botalias="latest" type="button">Book Trip</button>

Amazon Sumerian 2D 圖形元件2D 的影像或影片。

屬性

• Tint (色調) – 顏色色調。• Emissiveness (放射性) – 影像的放射性。• Opacity (不透明度) – 影像的不透明度。• Reflection (反射) – 影像的反射度。

Amazon Sumerian HTML 元件HTML 元件新增 2D HTML 文件 (div) 到場景，並可讓您在文字編輯器中編輯其內容。您可以將使用實體轉換來定位文件，或使用 CSS 來定義與檢視區相對的位置。

屬性

• Move with transform (以轉換移動) – 使用相同實體的轉換元件，將 HTML 文件放在場景內。文件一律是相同的大小並面向相機，但可以相對於相機移動。取消選取以使用樣式屬性，相對於檢視區放置 HTML 內容。

55

Amazon Sumerian 使用者指南HTML 3D

• Pixel perfect (完美符合像素) – 使用實體轉換來放置時，將 HTML 視窗貼齊最靠近的像素位置。• Attributes (屬性) – 新增 HTML 屬性到 div. 例如，您可以新增樣式屬性來將 HTML 內容放置到畫面上。

選擇 Open in editor (在編輯器中開啟) 按鈕以在文字編輯器中開啟 HTML 文件。

Amazon Sumerian HTML 3D 元件HTML 3D 元件會將 3D DOM 元素新增到實體，並讓您輕鬆地將它與 WebGL 混合。3D DOM 元素的表現方式就像在 3D 空間的四元素，您可以在文字編輯器中編輯其內容。

屬性

• Width (寬度) – 像素數量，其應該符合 X 軸上的 3D quad。

HTML 3D 元件背後的技巧，如下所示。WebGL 畫布會放在 DOM 元素前，其是使用 CSS3D 進行轉換。在WebGL 場景中，有組成畫布的 Quad，因此，可以透過它來看到畫布後方的 DOM 元素。WebGL 和 CSS3D轉換的同步處理已由 Sumerian 引擎在內部完成。

最明顯限制是您無法在 HTML 中使用透明度。因為 3D DOM 元素後沒有任何項目，您會在其後方看到空的背景。

若要嵌入 iframe，只需使用以下 HTML 做為 HTML 3D 元件 (僅替換 URL)。

<iframe src="https://en.wikipedia.org/wiki/WebGL" width="100%" height="100%"></iframe>

嵌入 YouTube 影片

56

Amazon Sumerian 使用者指南聲音

移至 YouTube 影片，請按一下 Share (共用)，然後 Embed (嵌入)，並複製程式碼。將它貼到您的 HTML3D 元件。

<iframe width="100%" height="100%" src="https://www.youtube.com/embed/qpQFfMofc1I" frameborder="0" allowfullscreen></iframe>

Amazon Sumerian 聲音元件聲音元件將數個聲音資產新增到實體。聲音不會自動播放，但是您可以使用指令碼或狀態機器來播放。

屬性

• Master volume (主控音量) – 元件中所有聲音的音量。

Amazon Sumerian 光線元件光源元件將為實體新增光源。

屬性

• 類型• Point (點) – 從空間中的一點朝所有方向發出光線，例如火焰。• Directional (定向) – 在整個場景發出平均光線，例如太陽。• Spot (投射) – 以圓錐發出光線，例如聚光燈。

• Color (顏色) – 光線顏色。• Intensity (強度的強度) – 光線強度 (通常介於 0 和 1)。• Specular (反射) – 反射光線強度 (通常介於 0 和 1)。• Range (範圍 [點和投射]) –• Cone angle (圓錐角度 [點狀]) – 圓錐在光源處的角度，以度為單位。• Penumbra (半影 [點狀]) – 圓錐邊緣的光源強度。• Projection (投影 [定向和點狀]) – 上傳紋理以套用到光源。• Shadows (陰影 [定向和點狀]) – 投射來自光照物件的陰影。

Amazon Sumerian Particle System Component (粒子系統元件)

粒子系統元件可透過在場景中產生並製作大量小型 2D 影像動畫來模擬流暢的實體，例如液體、雲朵和火焰。

屬性

• General (一般) – 為粒子發射器的基本行為。• Auto play (自動播放) – 會在場景開始時開始產生動畫。• Loop (迴路) – 重複動畫迴圈。• Duration (持續時間) – 動畫持續時間 (以秒為單位)。• Prewarm – 可在播放前先載入效果。

57

Amazon Sumerian 使用者指南粒子系統

• Max particles (最大粒子數) – 限制可見粒子的數量。• Gravity (重力) – 套用到粒子的重力向量。• Seed (種子) – 隨機種子。使用值來進行實驗以尋找您要的結果，或設定為 -1，以每次取得不同效果。• Local space simulation (本機空間模擬) – 設定為 true，以在父實體邊界內模擬粒子系統，而非整個場

景。• Emitter shape (發送器) – 發射器的形狀和大小。專屬每個形狀的其他設定。

Box (立方體)

• Random direction (隨機方向) – 依隨機方向產生每個粒子。• Box extents – 發射器的長、寬與高。

Sphere (球體)

• Radius (半徑) – 發射器的大小。• Emit from shell (從 shell 發射) – 從發射器邊緣外產生粒子。• Random direction (隨機方向) – 依隨機方向產生每個粒子。

Cone (圓錐)

• Random direction (隨機方向) – 依隨機方向產生每個粒子。• Emit from (發射自) – 從圓錐的窄端 (Base)，圓錐母線 (Volume) 或圓錐邊緣 (Volumeedge) 來發射粒

子。• Cone radius (圓錐半徑) – 圓錐窄端的半徑。• Cone angle (圓錐角度) – 圓錐反光面的角度。• Cone length (圓錐長度) – 圓錐面長度。

• Over duration properties (持續時間屬性) – 套用於每個動畫迴圈的微調值。每個值可保持不變，或可在持續時間中以線性或隨機進行。• Emission rate (發射速率) – 每秒發出的粒子數。• Start speed (開始速率) – 粒子速度。• Start size (開始大小) – 粒子大小。• Start color (開始顏色) – 粒子顏色。• Start life time (開始生命週期) – 每個粒子消失前的秒數。• Start angle (開始角度) – 粒子角度。

• Over lifetime properties (整體生命週期屬性) – 套用於粒子發射器整個生命週期的微調值。每個值可保持不變，或可在生命週期中以線性或隨機進行。• Color (顏色) – 粒子顏色。持續時間顏色複合物。• Size (大小) – 粒子大小。持續時間大小複合物。• Rotation speed (旋轉速度) – 每秒粒子旋轉度數。• Local velocity (局部速度) – 每秒局部空間速度單位。• World velocity (world 速度) – 每秒 world 空間速度單位。

• Texture (紋理) – 每個粒子的紋理。使用提供的紋理或選擇 custom (自訂) 以上傳紋理。• Texture animation (紋理動畫)

• Texture tiles (紋理並排數目) – sprite 表單中以 X 和 Y 方向並排的數目。• Cycles (循環) – 生命週期期間紋理需完成的動畫循環次數。• Frame over lifetime (生命週期影格數) – 在動畫中指定何時應顯示哪一個影格的曲線。0 是第一個影格，

而 1 則是最後一個。從 0 開始並以 1 結束的線性曲線，並貫穿動畫中的所有框架。• Rendering (渲染) – 自訂渲染行為。

• Billboard – 粒子一律面對相機。• Render queue (渲染佇列) – 粒子網格的渲染佇列。

58

Amazon Sumerian 使用者指南動畫

• Render queue offset (渲染佇列位移) – 新增至渲染佇列的位移。• Blending (混色) – 混色類型 (無、加色、減色、色彩增值，或透明)。• Depth write (深度寫入) – 寫入至深度緩衝。• Depth test (深度測試) – 深度緩衝測試。• Sorting mode (排序模式) – 粒子描繪順序 (無或相機距離)。若要進行透明混色，建議使用相機距離排

序。• Opacity threshold (不透明度閾值) – 碎片捨棄時的較低 alpha 閾值。

Amazon Sumerian 動畫元件動畫元件控制已匯入的 3D 網格之動畫。其中包含動畫狀態和轉換的清單。

當您將模型匯入到編輯器時，可以獲得幾何元件和動畫元件。

動畫 State (狀態) 包含關於動畫的資訊，例如應循環的次數、應執行的速度以及是否有任何轉換。如果沒有動畫狀態的轉場，將使用底部的預設轉場。

如果您想要在動畫狀態中切換，但想要讓切換更為順暢，請新增 Transition (轉場)。

轉場

• Fade (淡入/淡出) – 在指定時間內從一個動畫狀態混合至另一個狀態，從轉場開始時的本機時間 0 開始播放目標剪輯。最適合用於兩個剪輯有類似動作時。

• SyncFade – 在指定時間內從一個動畫狀態混合至另一個狀態，同步目標狀態為初始狀態的開始時間。最適合用於兩個剪輯有類似動作時。

• Frozen (凍結) – 兩個狀態的轉場，在目前位置凍結開始狀態並隨時間以目標狀態來混合。目標狀態會與正常情況相同在混合時間內向前移動。

Amazon Sumerian 碰撞器元件碰撞器元件新增碰撞器幾何至實體。若與嚴格的內文元件搭配使用，您就能建立一個動態且衝突的實體。如果碰撞器沒有任何嚴格的內文元件，將會在物理運算環境中成為靜態碰撞幾何。我們將此情況稱為靜態碰撞器。

如果實體帶有碰撞器或任何父實體有動態的嚴格內文元件，實體將會轉換為動態碰撞器。如果實體帶有碰撞器或任何父實體有運動的嚴格內文元件，實體將會轉換為運動碰撞器。

碰撞器形狀會以綠色線框來渲染。

屬性

• Shape (形狀) – 碰撞器的形狀。• Box (立方體)• Sphere (球體)• 平面• 無限平面

• Trigger (觸發) –

如果碰撞器並非觸發，它會在碰撞時發出這些事件：• sumerian.physics.beginContact• sumerian.physics.duringContact

59

Amazon Sumerian 使用者指南碰撞器

• sumerian.physics.endContact

如果碰撞器是觸發，將不會與其他物理物件碰撞。不過，它會在物理物件進入其中時發出事件。可用的事件為：• sumerian.physics.triggerEnter• sumerian.physics.triggerStay• sumerian.physics.triggerLeave

• Friction (摩擦) – 0 代表沒有摩擦。用於碰撞中的最終摩擦 (與補償) 值將使用乘法運算。例如，摩擦值為0.5 的球面與擦值為 0.5 的平面碰撞時，將會獲得 0.25 的摩擦值。

• Restitution (補償) – 碰撞器應反彈的值。0 為無反彈而 1 為最高反彈。如果您將補償設為大於 1 的數字，將隨每次反彈獲得越來越多的能量。

• Half extents (半長度) – 碰撞器在 X、Y 與 Z 軸上的半長度。

60

Amazon Sumerian 使用者指南Rigid Body

Amazon Sumerian 剛性物體元件剛性物體元件會新增物理屬性，例如質量和速度到實體。該元件將會模擬元件物理性質，並據此設定實體的位置與方向。

屬性

• Mass (質量) – 實體的質量。• Kinematic (運動) – 使剛性物體進行非隨機的運動。動態物體受例如重力等外部力量影響。運動主體不會依

碰撞而落下或做出反應。• Velocity (速度) – 物體最初線性速度。• Angular velocity (角速度) – 物體最初角速度。• Linear drag (線性拖曳) – 物體線性移動的阻力、介於 0 和 1 之間。• Angular drag (角度拖曳) – 物體角度移動的阻力、介於 0 和 1 之間。

如果您新增碰撞器元件到實體，該碰撞器會用於剛性物體衝突，其質心會與剛性物體在相同位置。

將單一碰撞器元件和剛性物體元件新增在相同的實體有些受限。碰撞器將一律為實體的中心，且您無法移動它。解決方案為在階層中將其置於剛性物體元件下的實體上。這可讓您將移動碰撞器或使用多個碰撞器。

因此，如果您想製作一張由六個碰撞器 (四條腿+椅背+座位) 組成的椅子，您首先應創建一個帶有剛性物體的根實體。然後，您以方塊碰撞器元件建立六個實體，並將它們置為根實體的子實體。擴展並正確放置它們，就可開始使用。

61

Amazon Sumerian 使用者指南狀態機器

Amazon Sumerian State Machine 元件狀態機器元件會新增 Sumerian 狀態機器至實體。您可以使用狀態機器來建立具備動畫、物理、特殊效果的動態和互動場景。狀態機器專屬於實體，所以場景中可以有多個狀態機器，針對不同的事件而觸發。

狀態機器有一或多個行為，將場景邏輯分組為狀態、動作和轉換。如需詳細資訊，請參閱「AmazonSumerian State Machines (p. 75)」。

Amazon Sumerian 指令碼元件您可以將指令碼新增至任何實體。指令碼元件可以包含多個指令碼。指令碼以從上到下的順序執行，而您可以在指令碼元件屬性中調整順序。

若要支援重複使用，需新增指令碼的執行個體到指令碼元件，而非指令碼本身。執行個體包含指令碼狀態與參數，可讓您根據提供的陳述式來以不同行為新增多個相同指令碼的執行個體。

屬性

• Enabled (已啟用) – 清除核取方塊以停用指令碼。

62

Amazon Sumerian 使用者指南指令碼

• Instance of (執行個體) – 清單中的每個指令碼執行個體都參考其使用的指令碼。選擇一個指令碼來前往指令碼自己的面板。

• Parameters (參數) – 任何在指令碼的 parameters 陣列 (p. 82)定義的參數將顯示於此。調整值來自訂此指令碼執行個體的行為。

若要建構您的參數，可以將參數存放在一個 JSON 檔案中。在指令碼內部定義參數來開始。然後，新增JSON 檔案並從指令碼設定中參考。

Example 使用 JSON 參數的指令碼

varsetup=function(args,ctx){ console.log(args.myJsonParameter);// Prints the parsed JSON data};

var parameters=[{ key:'myJsonParameter', type:'json'}];

若要建立具有 JSON 參數的指令碼

1. 建立空白實體 (p. 44)。2. 選擇 Add component (新增元件)，然後選擇 Script (指令碼)。3. 選擇 Add script (新增指令碼)，然後選擇 Custom (自訂)。

4. 選擇 Edit script (編輯指令碼)。

5. 將預設 parameters 宣告取代為以下內容。

var parameters=[{ key:'myJsonParameter', type:'json'}];

6. 回到指令碼設定。設定自動更新以包含 JSON 參數。7. 將 JSON 檔案放入參數欄位。

63

Amazon Sumerian 使用者指南時間軸

Amazon Sumerian 時間軸元件使用時間軸以隨時間移動、旋轉或變更實體規模。您可以設定這些屬性的開始和結束值，並新增關鍵影格，以控制過程中的動畫速度或方向。時間軸也可以發出自訂事件，您可以從狀態機器或指令碼來使用它們。

若要建立時間軸，請選擇 Create entity (建立實體)、Timeline (時間軸)。您也可以新增時間軸元件到現有的實體，但請勿將其新增至您想要製作動畫的實體。時間軸僅可控制除連接之實體外的其他實體。

64

Amazon Sumerian 使用者指南時間軸

屬性

• Duration (持續時間) – 時間軸長度，以秒為單位。• Loop (循環) – 可重複循環時間軸動畫。• Auto start (自動開始) – 若要使用狀態機器或指令碼來觸發時間軸，請停用此選項以避免時間軸自動在播放

模式中開始。

若要開啟時間軸編輯器，請在時間軸元件中選擇 Toggle timeline (切換時間軸) 或從 Tools (工具) 功能表中選擇 Timeline (時間軸)。

若要新增實體到時間軸，請將物件從實體面板拖曳到時間軸編輯器。編輯器中的每個管道皆控制轉換的一項屬性，例如 X 轉譯或 Z 比例。按一下屬性旁的時鐘圖示來啟用管道並新增第一個關鍵影格。

選擇時間並變更屬性的值來新增更多關鍵影格到管道中。在播放時，實體會在每個關鍵影格的轉換值之間製作動畫。在預設情況下，變更屬性值會自動建立關鍵影格。您可以按下 Drop entity here (在此放入實體) 方塊旁的鑰匙圖示來停用此功能。

新增 Event channels (事件管道) 到時間軸在系統匯流排上發出自訂事件。管道名稱為 Sumerian 在事件管道上每個關鍵影格的事件名稱。使用 SystemBus.addListener 來從指令碼中使用此事件，或者使用 Listenaction (偵測動作) 從狀態機器 (p. 62)使用此事件。

65

Amazon Sumerian 使用者指南

Amazon Sumerian 資產在 Sumerian 中的資產面板蒐集場景中的可共享資產。當您新增資產到場景時，Sumerian 會自動新增到資產面板中的預設套件。您建立的實體不會自動新增，但是您可以從實體面板拖曳到資產面板中來建立實體資產。

資產類型

•Entity (實體) – 一個 Sumerian 實體 (p. 44)。如果您匯入檔案或資產套件，從資產面板將實體放入畫

布上以新增至場景中。•

Mesh (網格) – 來自 3D 模型的多邊形網格。•

Skeleton (骨架) – 來自 3D 模型的骨架與動畫。•

Material (材質) – 自 3D 模型產生的各個可轉譯圖層的含紋理材質元件 (p. 47)。•

Sound (聲音) – 搭配聲音元件 (p. 57)使用的音訊檔案。•

Script (指令碼) – 可在 指令碼元件 (p. 57)上執行個體化的 JavaScript 指令碼。•

Speech (語音) – 搭配語音元件 (p. 50)使用的文字檔案。•

JSON – 可在指令碼元件 (p. 57)上做為參數輸入的 JSON 檔案。•

Skybox – 可新增到場景的環境設定 (p. 39)中的場景背景之紋理集合。•

Behavior (行為) – 可新增到狀態機器元件 (p. 62)的動作集合。•

Texture (紋理) –可新增到材質元件 (p. 47)、2D 圖形元件 (p. 55)或者 skybox 圖層的影像檔案。

若要新增資產到場景，您可以直接從桌面拖曳資產到畫布。根據檔案類型，編輯器會在實體面板中建立一個實體，以及一或多個資產。例如，當您新增 JPG 影像到場景時，場景、材質資產、以及紋理資產將會得到一個影像實體。

若要將資產新增到場景

1. 在 Sumerian 編輯器中開啟場景。2. 將檔案從桌面檔案瀏覽器拖曳到畫布。

或

按一下預設套件旁的加號圖示來建立空白資產。若要查看圖示，請選取套件名稱。

66

Amazon Sumerian 使用者指南Packs

3. 在資產面板中選擇資產並使用檢測器面板中的選項來修改。

Amazon Sumerian 資產套件您可透過建立套件在場景之間組織您的資產並分享。在資產面板中建立一個套件並將資產移動或複製到其中。

套件支援以下動作：

• – 在套件中建立新的資產。

• – 匯出套件至資產程式庫。

• – 刪除未在場景中使用的套件中的任何資產。

• – 刪除資產套件。

匯出套件並將其新增到您選擇的專案中。如果您還沒有專案，可在儀表板建立一個 (p. 17)。然後，您可以使用儀表板以複製或移動套件 (p. 19)到其他場景或專案。匯出的套件不會關聯至場景套件或其資產。

若要新增資產到套件並匯出

1. 在 Sumerian 編輯器中開啟場景。2. 在 Assets (資產) 下，選擇 Create pack (建立套件)。3. 選擇套件並修改名稱、描述、標籤，並在檢測器面板中自訂屬性。4. 將資產從預設套件拖曳到自定套件中。

或

透過選擇它然後按一下複製圖示來複製該項目。將該複製拖曳到自訂套件。5.

選取自訂套件，然後按一下資產程式庫圖示 ，或在檢測器面板選擇 Add to asset library (新增到資產程式庫)。

67

Amazon Sumerian 使用者指南範本

6. 為資產套件選擇一個資產類型 (p. 66)。7. 選擇 Add to asset library (新增到資產程式庫)。8. 選擇一個專案，然後選擇 Select (選取)。

Amazon Sumerian 場景範本Sumerian 提供場景範本，您可以使用這些範本做為場景的起點。

Sumerian 場景範本

• Augmented reality (擴增實境) – 使用配套範例應用程式來建立擴增實境 (AR) 場景的範本。如需詳細資訊，請參閱「Amazon Sumerian Augmented Reality Tools (擴增實境工具) (p. 69)」。

• Default lighting (預設光源) – 含 skysphere 以及三個方向光源的空白場景。此範本會用在介面教學課程中。

• Speech & gestures (語音和手勢) – 具有 Sumerian 主機 (p. 70)的場景，設定為搭配狀態機器使用語音。

在儀表板 (p. 17)中選擇任何這些範本來建立草稿場景。

68

Amazon Sumerian 使用者指南虛擬實境工具

Amazon Sumerian Virtual Reality Tools (虛擬實境工具)

Sumerian 提供的虛擬實境 (VR) 相關的資產套件，讓您輕鬆在場景中啟用虛擬實境。資產套件包含虛擬實境相機，可讓使用者進入虛擬實境模式，以及可與環境互動的虛擬實境控制器。

支援的硬體

• Oculus Rift• HTC Vive

若要啟用場景中的虛擬實境

1. 在 Sumerian 編輯器中開啟場景。2. 選擇 Import assets (匯入資產)。3. 選擇 CoreVR (核心虛擬實境)，然後選擇 Add (新增)。4. 當資產套件完成載入時，將 VRCameraRig 實體拖曳至畫布以將其新增至場景。5. 選擇 VRCameraRig 實體。6. 選擇 VRCameraRig 元件。7. 選擇 Current VR camera rig (目前的虛擬實境相機裝備) 選項以啟用此裝備。

當使用者使用耳機和連接的控制器進入虛擬實境模式，HMD 相機 (p. 49)會在 3D 空間中追蹤耳機以及虛擬實境控制器 (p. 49)。VR camera rig (p. 48) (虛擬實境相機裝備) 管理其他實體並在場景中啟用虛擬實境模式按鈕。

只有連接的類型控制器才會在場景中轉譯，因此您可以連接所有包含的實體以支援這些類型。您也可以用您自己的替換包含的控制器型號。

請參閱虛擬實境入門以取得使用這些資產的教學。

Amazon Sumerian Augmented Reality Tools (擴增實境工具)

Sumerian 提供了範本、資產和範例專案，可供您開發適用於 iOS 和 Android 裝置的擴增實況 (AR) 應用程式。

Augmented Reality (擴增實境) 場景範本僅在儀表板 (p. 17)中提供。您可使用它做為擴增實境場景的起點。

該場景包含下列資源：

69

Amazon Sumerian 使用者指南Android Sample Project (Android 範例專案)

• AR Camera (AR 相機) – 為主要相機，擁有可將其對應至裝置相機的指令碼。• AR Camera Control (相機控制) – 為使用 Sumerian 引擎 AR System (AR 系統) 的指令碼，以存取裝置的

擴增實境 API。您可以在文字編輯器中檢視此指令碼。• ARAnchor – 是 AR 應用程式用來將場景中的物件錨定至真實世界的空白實體。

您可以從此範本中透過新增模型建構一個 AR 場景，並讓它們成為 ARAnchor 實體的子項。發佈該場景，然後使用範例 AR 套件專案以建置使用它的應用程式。

範例• Android Sample Project (Android 範例專案) (p. 70)• iOS 範例專案 (p. 70)

Android Sample Project (Android 範例專案)範例專案 amazon-sumerian-arcore-starter-app，是一個擁有 ARCore 應用程式，能載入以 AR 範本建立的場景的 Android Studio 專案。以您發布的場景 URL 取代 檢視控制器中的場景 URL，建置應用程式，然後在相容的 Android 裝置上執行，以觀看其實際運作。

請參閱 使用 Sumerian 與 ARCore 進行擴增實境教學，以探索如何使用這些資產。

iOS 範例專案範例專案 amazon-sumerian-arkit-starter-app，是一個擁有 Swift 應用程式，能載入以 AR 範本建立的場景的XCode 專案。以您發布的場景 URL 取代 檢視控制器中的場景 URL，建置應用程式，然後在相容的 iOS 裝置上執行，以觀看其實際運作。

請參閱 使用 Sumerian 與 ARKit 進行擴增實境教學，以探索如何使用這些資產。

Amazon Sumerian 主機主機是一種由 Sumerian 提供的資產，具有內建的動畫、語音和行為，可與使用者互動。使用主機來讓使用者參與對談和傳達資訊。

將主機新增到您的場景

1. 在 Sumerian 編輯器中開啟場景。2. 選擇 Import assets (匯入資產)。3. 選擇下列其中一個主機：

70

Amazon Sumerian 使用者指南模型

• Cristine• Preston• Luke

4. 選擇 Add (新增)。5. 從資產面板拖曳主機實體到畫布上。

所有主機的網格、材料、動畫和指令碼是捆綁在單一實體，內含三個可設定的元件：

• Transform (p. 46) (轉換) – 相對於場景或其父實體的主機位置。• Host (p. 49) (主機) – 動畫和行為設定。• Speech (p. 50) (語音) – 文字轉語音功能與 Amazon Polly。

主機的模型和動畫遭到鎖定。您不能修改或擴展。

模型在資產面板上放入模型檔案來匯入。當您匯入模型時，Sumerian 會將模型轉換為其中包含模型的網格、骨架、材料和紋理的資產套件。網格將在匯入時自動三角化。這個過程可能需要一些時間，將視模型大小和格式而定。

您可以使用以下格式來匯入大小最高為 50 MB 的模型。

檔案格式

• FilmBox – .fbx

www.autodesk.com/products/fbx/overview• Wavefront OBJ – .obj

en.wikipedia.org/wiki/Wavefront_.obj_file

模型匯入後，從資產套件將模型實體放入畫布。這會根據匯入的檔案來以階層新增一個或多個實體到場景中。至少實體需有轉換、幾何和材料元件。如果您匯入包含骨架和動畫的模型，也會獲得動畫元件。骨架和多邊形網格連接到幾何元件，而紋理則附加到材料元件。

71

Amazon Sumerian 使用者指南Skybox

為最佳化模型匯入過程，請刪除物件歷程記錄並凍結模型工具中的轉換來移除不需要的資料。如果可以，請避免使用幾何轉換。如果您的模型有動畫，請封裝到模型和避免使用限制。

Sumerian 引擎支援下列模型功能。

模型功能

• 頂點顏色 – 支援每個頂點顏色或每個臉部頂點顏色。

當網格資料包含頂點顏色時，可在漫反射管道下的網格材料面上使用滑桿。您可以使用滑桿來混合設定的漫反射貼圖或顏色以及頂點顏色。

• UV 貼圖 – 如果有兩個貼圖可用，可以使用第二個，例如光線貼圖或環境遮蔽貼圖。

在編輯器中，您可以在材料面板中的環境管道上套用這些紋理。• 切線 – 如果未提供切線資料，將會在轉換時產生。• 正常 – 如果未提供正常資料，瞬間移動標準將在轉換時產生。• 骨架動畫 – 支援透過骨架網格變形製作的動畫。您可以在一個檔案中提供數個動畫。

著色器限制• 每個頂點的重量上限為 4。若提供更多，值最低的頂點將會移除。• 讓聯合計數保持於低位可支援更加廣泛的硬體組合。

若您已使用骨架動畫將模型轉換到編輯器中，且在之後新增更多動畫到模型工具中，可新增這些新動畫到編輯器中現有的模型。

在動畫面板的動畫狀態放置區上放入檔案來執行此操作。此操作會像平常一樣上傳檔案，但是在轉換期間只會匯出動畫資料。基本骨架架構必須相同，此步驟才能執行。如果您變更架構，必須透過一般程序重新匯入模型。

• 內嵌紋理 (FBX) – 在匯出 FBX 二進位格式時，可在結果檔案中嵌入紋理。

Skyboxskybox 是您套用於場景背景的紋理，以顯示天空、空間或包圍結構。Skybox 可以是單一紋理包裝在球面上，或六個紋理包裝在一個立方體上。在場景的環境設定 (p. 39)中將 skybox 新增到您的場景。

若要建立 skybox

1. 在 Sumerian 編輯器中開啟場景。2. 按一下預設套件旁邊的加號圖示。若要查看圖示，請選取套件名稱。

3. 選擇 Skybox。

72

Amazon Sumerian 使用者指南Skybox

4. 選擇 skybox 的形狀。

Skybox 形狀

• Box (箱型) – 貼圖到立方體的六個方形影像 (立方體貼圖)。• Sphere (球體) – 單一矩形影像貼至球體 (等距離長方圓柱投影)。

5. 將紋理資產或影像檔案放至 skybox 的每個部分。

6. 在 Entities (實體) 面板選擇根節點。

7. 選擇 Environment (環境)。8. 從資產面板將 skybox 資產置於 Skybox 欄位。

73

Amazon Sumerian 使用者指南媒體

媒體您可以匯入媒體檔案到 Sumerian 以用作紋理、音訊或文字物件。Sumerian 支援以下檔案格式。

紋理高達 10 MB

• CRN• DDS• JPG、JPEG• PNG• SVG• TGA• MP4• OGV• WEBM

音訊最多至 10 MB

• OGG• MP3• WAVE、WAV

文字最大至 1 MB

• JS• JSON

只要每個檔案大小在解壓縮時符合其類型的要求，您可以將多個資產檔案合併為 ZIP 封存檔，大小最多 200MB。

74

Amazon Sumerian 使用者指南

Amazon Sumerian State MachinesAmazon Sumerian 行為是有限狀態機器，您可以將它們附加到實體上的狀態機器元件 (p. 62)。行為是狀態的集合，會根據使用者互動、時機或其他事件在各狀態間轉換。

行為中的每個狀態由一或多個包含 Sumerian 所定義一些邏輯的動作組成。作用中狀態上的動作可以執行一些作業，例如回應使用者按一下行為所連接的實體、執行指令碼，或記錄音訊並將它傳送到 Amazon Lex 聊天機器人。動作完成後，可以觸發同一個狀態上的其他動作，或是轉換到另一個狀態。

Sumerian 提供許多動作，分為以下類別。

狀態機器動作• Amazon Sumerian State Machine 動畫動作 (p. 76)• Amazon Sumerian State Machine 音訊和相機動作 (p. 76)• Amazon Sumerian State Machine AWS 功能動作 (p. 77)• Amazon Sumerian State Machine 鍵盤和滑鼠動作 (p. 77)• Amazon Sumerian State Machine 效果和照明動作 (p. 77)• Amazon Sumerian State Machine 材質和轉譯動作 (p. 78)

75

Amazon Sumerian 使用者指南動畫

• Amazon Sumerian State Machine 物理和碰撞動作 (p. 78)• Amazon Sumerian State Machine 邏輯和轉換動作 (p. 79)

Amazon Sumerian State Machine 動畫動作您可以使用狀態機器動作來將實體製成動畫和轉換實體。

動畫動作

• Copy joint transform (複製聯合轉換) – 從其他實體複製聯合轉換，並將其套用到這個實體。此實體必須是內含動畫元件的子實體。

• Face current camera (面對目前的相機) – 轉換實體以面對作用中相機。• Look at (看著) – 轉換實體以面對空間中的一個點。• Move (移動) – 移動實體。• Pause animation (暫停動畫) – 暫停骨架動畫。• Play emote (播放表情) – 播放主機表情。• Resume animation (恢復動畫) – 繼續播放骨架動畫。• Rotate (輪換) – 使用設定的角度 (度數) 輪換實體。• Scale (擴展) – 擴展實體。• Set animation (設定動畫) – 轉移到選取的動畫。• Set animation offset (設定動畫位移) – 變更動畫剪輯位移。• Set animation time scale (設定動畫時間範圍) – 變更目前動畫的時間範圍。• Shake (抖動) – 抖動實體和選擇性地執行轉換。• Set point of interest target (設定興趣點目標) – 變更主機的目標實體。• Tween look at (Tween 查看) – 將實體輪換轉換到面向設定的位置。• Tween move (Tween 移動) – 轉移到設定位置。• Tween rotate (Tween 輪換) – 轉移到設定輪換 (以角度為單位)。• Tween scale (Tween 比例) – 轉移到設定規模。

Amazon Sumerian State Machine 音訊和相機動作您可使用狀態機器動作來控制音訊設定和場景相機。

音訊和相機動作

• Dolly zoom (手推車) – 執行手推車縮放。• Mute (靜音) – 靜音全域所有聲音。• Pause sound (暫停音效) – 暫停聲音。• Play sound (播放聲音) – 偵測在實體上的挑選事件並開啟新的瀏覽器視窗。• Sound fade in (音效淡入) – 淡化音效。• Sound fade out (音效淡出) – 音效淡出並停止。• Start microphone recording (開始麥克風錄製) – 開始從麥克風輸入錄製音訊。• Stop microphone recording (停止麥克風錄製) – 停止從麥克風輸入錄製音訊。• Stop sound (停止音效) – 停止音效。• Switch camera (切換相機) – 切換至不同的相機。• Toggle mute (切換靜音) – 將所有語音切換為全域靜音。

76

Amazon Sumerian 使用者指南AWS 功能

• Unmute (取消靜音) – 取消靜音全域所有語音。

Amazon Sumerian State Machine AWS 功能動作您可使用狀態機器動作來控制 AWS 整合功能。

AWS 功能動作

• AWS SDK ready (支援 AWS 開發套件) – 在使用呼叫 AWS 服務的功能之前，先等候 取得憑證。如需詳細資訊，請參閱「為您的 Amazon Sumerian 場景設定 AWS 登入資料 (p. 35)」。

• Change speech volume (變更語音音量) – 變更實體語音元件 (p. 50)的音量。• Send audio input to dialogue bot (傳送音訊輸入到對話機器人) – 傳送錄製的音訊至指派給實體對話元

件 (p. 52)的 Amazon Lex 聊天機器人。• Send text input to dialogue bot (傳送文字輸入到對話機器人) – 傳送文字輸入至指派給實體對話元件的

Amazon Lex 聊天機器人。• Start speech (開始語音) 和 Stop speech (停止語音) – 播放或停 語音元件 (p. 50)。

Amazon Sumerian State Machine 鍵盤和滑鼠動作您可以使用狀態機器動作，來回應鍵盤、滑鼠和觸控事件。

鍵盤和滑鼠動作

• Arrow keys (方向鍵) – 按下方向鍵時轉換為其他狀態。• Choose/tap on entity (選擇/點選實體) – 選擇實體。• Hover enter (暫留輸入) – 根據實體是否在內部使用者定義的方塊磁碟區來執行轉移。透過設定兩個點來

(也就是在連線時，形成穿過方塊磁碟區的對角) 定義的磁碟區。• Hover exit (暫留離開) – 根據實體是否在內部使用者定義的方塊磁碟區來執行轉移。透過設定兩個點來 (也

就是在連線時，形成穿過方塊磁碟區的對角) 定義的磁碟區。• Key down (減少按鍵) – 偵測按下按鍵，執行轉換。• Key pressed (按下鍵) – 偵測按鍵事件，執行轉換。透過轉移邊界運作。• Key up (增加按鍵) – 偵測放開按鍵，執行轉換。• Mouse down (減少滑鼠) – 偵測滑鼠按鈕和執行轉換。• Mouse move (滑鼠移動) – 偵測滑鼠移動和執行轉換。• Mouse pressed (按下滑鼠) – 偵測滑鼠按鈕事件和執行轉換。透過轉移邊界運作。• Mouse up (增加滑鼠) – 偵測滑鼠按鈕釋放和執行轉換。• Pick (挑選) – 偵測實體上的挑選事件和執行轉換。• Pick and exit (選擇和結束) – 偵測在實體上的挑選事件並開啟新的瀏覽器視窗。• WASD keys (WASD 鍵) – 按下 WASD 鍵時轉換為其他狀態。

Amazon Sumerian State Machine 效果和照明動作您可使用狀態機器動作來修改場景照明或新增特殊效果。

效果與照明動作

• Add light (新增光源) – 將點光源新增到實體。

77

Amazon Sumerian 使用者指南材質和轉譯

• Fire FX (火災 FX) – 進行實體發出火災。若要消滅火災、使用 Remove particles (移除碎片) 動作。

• Pause particle system (暫停粒子系統) – 暫停粒子系統。• Remove light (移除光源) – 將連接到實體的光源移除。• Remove particles (移除碎片) – 移除任何連接到實體的粒子發送器• Set light properties (設定光源屬性) – 修改光源元件的屬性。• Smoke FX (煙霧 FX) – 讓實體發出煙霧。若要取消煙霧排放器，使用 Remove particles (移除碎片) 動作。

• Start particle system (開始粒子系統) 和 Stop particle system (停止粒子系統) – 開始或停止粒子發送器。• Toggle post effects (切換後製效果) – 全域啟用或停用後製效果。• Tween light (Tween 燈) – 在兩個光源顏色之間轉換。

Amazon Sumerian State Machine 材質和轉譯動作您可以使用狀態機器動作來修改實體紋理和可見性。

材質和轉譯動作

• Hide (隱藏) 和 Show (顯示) – 隱藏或顯示實體及其子實體。• Set material color (設定材料顏色) – 變更材料顏色。• Set render target (設定轉譯目標) – 轉譯相機在目前的實體紋理所看到的項目。• Sprite animation (Sprite 動畫) – 開始 Sprite 動畫。• Tween material color (Tween 材料顏色) – Tween 材料顏色。• Tween material opacity (Tween 材料不透明度) – Tween 材料不透明度。• Tween texture offset (Tween 紋理位移) – 順利變更實體紋理位移。

Amazon Sumerian State Machine 物理和碰撞動作您可使用狀態機器動作來套用物理和碰撞檢查。

物理和碰撞動作

• Apply force (套用強制) – 將強制套用到附加的嚴格內文。• Apply impulse (套用脈衝) – 將脈衝套用到附加的嚴格內文。• Apply torque (套用扭力) – 將扭力套用到附加的嚴格內文。• Camera distance (相機距離) – 根據與主要相機或位置的距離執行轉移。

78

Amazon Sumerian 使用者指南邏輯和轉換

• In box (方塊中) – 根據實體是否在內部使用者定義的方塊磁碟區來執行轉移。透過設定兩個點來 (也就是在連線時，形成穿過方塊磁碟區的對角) 定義的磁碟區。

• Set rigid body angular velocity (設定嚴格內文角速度) – 變更嚴格內文的角速度。• Set rigid body position (設定嚴格內文位置) – 變更嚴格內文的位置。• Set rigid body rotation (設定嚴格內文輪換) – 變更嚴格內文的輪換。• Set rigid body velocity (設定嚴格內文速度) – 變更嚴格內文的速度。• Trigger enter (觸發輸入) – 當觸發磁碟區輸入的轉換。• Trigger leave (觸發保留) – 當碰撞器離開觸發磁碟區時的轉換。

Amazon Sumerian State Machine 邏輯和轉換動作您可使用狀態機器動作來執行指令碼 (p. 80)、回應事件，以及新增轉換至狀態。

邏輯和轉換動作

• Compare counter (比較計數器) 和 Compare 2 counters (比較 2 個計數器) – 比較計數器與一組值，或是比較兩個計數器的值。

• DOM listen (DOM 偵測) – 在一或多個元素上的 DOM 事件接聽程式新增 (由查詢選擇器所指定)，以及對指定事件執行轉換。

• Emit message (發出訊息) – 發出訊息至匯流排上的管道 (ping)。您可以使用 Listen (偵測) 動作或透過使用SystemBus.addListener(channel, callback) 函數的指令碼來偵測訊息。

• Execute script (執行指令碼) – 執行指令碼 (p. 80)和轉換為成功或失敗。在進入和退出狀態時，使用指令碼中的 enter 和 exit 函數來執行程式碼。若要觸發轉換，請呼叫內容物件 (p. 81)上的ctx.transitions.success() 或 ctx.transitions.failure()。

• Execute script condition (執行指令碼條件) – 評估表達式和對 true 或 false 結果的轉換。• Execute script expression (執行指令碼表達式) – 執行陳述式。• Get HTML text (取得 HTML 文字) 和 Set HTML text (設定 HTML 文字) – 讀取或變更 HTML 項目的內容。• In view (檢視中) – 根據實體是否處於相機的 frustum 來執行轉移。• Increment counter (增量計數器) – 以值來增量計數器。• Listen (聆聽) – 在頻道上在接收系統匯流排訊息時執行轉換。• Log message (日誌訊息) – 列印瀏覽器偵錯主控台的訊息。• Pause timeline (暫停時間軸) – 暫停時間軸。• Random transition (隨機轉換) – 執行隨機轉換。• Set counter (設定計數器) – 將計數器變更為值。• Set timelime time (設定時間軸) – 跳到時間軸上的點。• Start timeline (開始時間軸) 和 Stop timeline (停止時間軸) – 開始或停止時間軸。• Toggle full screen (切換全螢幕) – 將全螢幕切換為開啟/關閉。請注意，在大多數瀏覽器中此功能必須透過

使用者手勢來啟動。例如，按一下或觸控。• Transition (轉換) – 轉移到不同的狀態。• Transition on next frame (轉移到下一個畫面) – 轉移到下個畫面的選取狀態。• Wait (等待) – 執行指定的一段時間後的轉換。您可以設定隨機時間。這會將 0 和設定隨機時間之間的時間

新贈至指定等待時間。

79

Amazon Sumerian 使用者指南

指令碼編寫新增指令碼到您的場景以根據使用者輸入或事件來更新場景。您可以使用指令碼來存取 DOM、使用Sumerian 引擎與程式庫來建立和修改實體，或使用 AWS SDK for JavaScript 來存取 AWS 服務和資源。

Note

Sumerian 引擎程式庫的參考文件可於 Sumerian 網站取得。

若要建立空白指令碼

1. 在 Sumerian 編輯器中開啟場景。2. 按一下預設套件旁的加號圖示來建立空白資產，然後按一下 Script (指令碼)。選取套件名稱以查看圖

示。

3. 按下 j 來開啟文字編輯器。4. 在文件下選擇新指令碼。使用指令碼名稱旁的鉛筆圖示來變更它的名稱。

指令碼範本包含 7 種方法和參數 (p. 82)陣列。方法對應到場景的生命週期事件並在下列時間由引擎呼叫。

• setup – 當場景播放開始時。• fixedUpdate – 在每個物理更新上。• update – 在每個轉譯影格上。• lateUpdate – 在場景中呼叫所有 update 方法後。• enter – 在狀態機器指令碼動作 (p. 79)上，當狀態輸入時。• exit – 在狀態機器指令碼動作上，當狀態存在時。• cleanup – 當場景播放停止時。

主題• 內建指令碼 (p. 81)• 內容物件 (p. 81)• 參數和引數 (p. 82)• 外部依賴關係 (p. 84)• 偵錯 (p. 85)

80

Amazon Sumerian 使用者指南內建指令碼

內建指令碼編輯器還具有多種內建的指令碼，可提供標準功能，如相機、鍵盤和滑鼠控制。

相機指令碼

• Orbit camera control (環繞相機控制) – 可讓使用者透過按住滑鼠鍵並移動滑鼠來環繞場景。• Orbit and pan control (環繞與平移控制) – 可讓使用者以一個滑鼠按鈕環繞場景並用另一個按鈕平移相機。• Fly control (空拍控制) – 可讓使用者透過鍵盤縮放與平移。• Axis-aligned camera control (齊軸相機控制) – 移動相機到 X 或 Z 軸上的固定距離。• Pan camera control (平移相機控制) – 可讓使用者透過按住滑鼠鍵並移動滑鼠來平移相機。• Mouse look control (滑鼠查看控制) – 可讓使用者透過按住滑鼠鍵並移動滑鼠來四處查看。• WASD control (WASD 控制) – 可讓使用者透過鍵盤在 XZ 平面上到處移動。

物件指令碼

• Button (按鈕) – 可讓使用者按一下物件來開啟 URL。• Pick and rotate (選取與旋轉) – 讓使用者抓取物件並操控其方向。• Lens flare (鏡片反光) – 會在使用者注視物件時產生鏡片反光。

內容物件您可以使用內容物件 ctx 在指令碼存在時間內存放您的指令碼資料。將在 setup() 並清除 cleanup() 時建立上下文，並傳遞至所有指令碼函數中。它具有下列屬性：

屬性

• entity (Entity) – 指令碼連接的實體。• entityData (Object) – 在實體上的所有指令碼之間分享的資料物件。• activeCameraEntity (Entity) – 目前使用中的相機實體。• domElement (HTMLCanvasElement) – WebGL 帆布元素。• playTime (number) – 場景開始後經過的時間。• transitions(Object) – 用於發出狀態機器 (p. 75)上 Execute script (執行指令碼) 動作成功或失敗訊號

的轉換函數。• viewportHeight (number) – 畫布的高度。• viewportWidth (number) – 畫布的寬度。• world (World) – world 物件。• worldData (Object) – 在 world 中的所有指令碼之間共用的資料物件。

ctx 上的部分屬性將由指令碼共用。entityData 將由實體上所有指令碼共用且 worldData 由所有指令碼共用。所有實體最初皆為空內容，而且可用來存放任何類型的資料

例如，如果我們要定義稱為加速的屬性，可以提供三種層級：

// Only accessible to the script that defined the propertyctx.acceleration=9.82; // Accessible to all scripts on the entityctx.entityData.acceleration=9.82;

81

Amazon Sumerian 使用者指南參數和引數

// Accessible to all scriptsctx.worldData.acceleration=9.82;

內建內容屬性還包含一些便利功能。例如，world 物件可讓您根據標籤來搜尋實體。您可以使用帶有ctx.world.by.tag 的特定標籤來取得所有實體：

var entities = ctx.world.by.tag('myTag');

參數和引數參數可讓您建立指令碼，透過將欄位新增到編輯器中的指令碼屬性來自定指令碼。例如，下列指令碼定義名為 Velocity 的參數，取用 3 個號碼 (vec3 參數 (p. 83))。

var setup = function(args, ctx){ console.log(args.velocity);}; var parameters = [ { name : "Velocity", key : "velocity", type : "vec3", default : [1,0,0] }];

在設定階段，指令碼會從 args 物件讀取參數值，並將參數值列印到主控台。

當您新增上述指令碼的執行個體到實體時，編輯器將顯示一個 Velocity (速度) 欄位，接受三個值並反映預設值。

參數格式參數為含有下列必填與選填欄位的物件。

必要欄位

• key [string] – 一個獨特金鑰，用於存放與擷取 args 物件中的參數值。

82

Amazon Sumerian 使用者指南參數類型

• type [string] – 參數類型 (p. 83)。• default – 預設值或參數值。

選填欄位

• name [string] – 顯示於指令碼執行個體上的參數欄位的標籤。如果您不指定名稱，將使用 key 來產生標籤。

• control [string enum] – 控制類型。• slider – 滑桿控制。• color – 顏色轉輪。• select – 下拉式選單，列出 options 欄位中的值。• jointSelector – 下拉式清單，列出指令碼父實體上動畫元件的連接點。

• description [string] – 當您以滑鼠滑過參數時顯示的描述。• options [array] – select 控制的可能值陣列。• min 與 max [number] – int 或 float 參數的最小與最大值。• decimal [number] – float 參數的有效位數數字。• step [number] – float 值相等的累加值。• precision [number] – float 值的有效位數數字。• exponential [boolean] – 設為 true 來以對數方式在 slider 控制上分布值。

參數類型類型屬性須設定為其中一個預先定義的字串，每個字串對應至一個參數類型。

• int – 整數數字變數 (例如 1)。• float – 數字變數 (例如 3.14)。• string – 字串 (例如 “HelloGoo”)。• boolean – 布林值 (true 或 false)。• vec2、vec3、vec4 – 一系列的 2、3、或 4 個號碼。• texture、sound、entity、camera、animation、json – 指定類型的資產 (p. 66)。

所有動作中的類型，包含範例指令碼：

var parameters = [ {type: 'int', key: 'int', 'default': 1, description: 'Integer input'}, {type: 'float', key: 'float', 'default': 0.1, description: 'Float input'}, {type: 'string', key: 'string', 'default': 'Hello!', description: 'String input'}, {type: 'boolean', key: 'boolean', 'default': true, description: 'Checkbox'}, {type: 'vec2', key: 'vec2', 'default': [0, 0], description: 'Vector2 input'}, {type: 'vec3', key: 'vec3', 'default': [0, 0, 0], description: 'Vector3 input'}, {type: 'vec4', key: 'vec4', 'default': [0, 0, 0, 0], description: 'Vector4 input'}, {type: 'texture', key: 'texture', description: 'Texture asset drop area'}, {type: 'sound', key: 'sound', description: 'Sound asset drop area'}, {type: 'entity', key: 'entity', description: 'Entity drop area'}, {type: 'camera', key: 'camera', description: 'Camera drop down'}, {type: 'animation', key: 'animation', description: 'Animation state from the Animation component on the same entity'}, {type: 'json', key: 'json', description: 'JSON asset drop area'}, {type: 'float', control: 'slider', key: 'floatSlider', 'default': 10.1, min: 5, max: 15, exponential: false, decimal: 1, description: 'Float slider input'}, {type: 'int', control: 'slider', key: 'intSlider', 'default': 10, min: 5, max: 15, exponential: false, description: 'Integer slider input'},

83

Amazon Sumerian 使用者指南外部依賴關係

{type: 'vec3', control: 'color', key: 'vec3Color', 'default': [1, 0, 0], description: 'RGB color input'}, {type: 'vec4', control: 'color', key: 'vec4Color', 'default': [1, 0, 0, 1], description: 'RGBA color input'}, {type: 'string', control: 'select', key: 'select', 'default': 'a', options: ['a', 'b', 'c'], description: 'Dropdown/select'}, {type: 'int', control: 'jointSelector', key: 'jointSelector', description: 'Joint select from the animation component on a parent entity'}];

外部依賴關係若您的指令碼使用來自 web 的外部 JavaScript 程式庫到指令碼中，請在文字編輯器的 External resources(外部資源) 部分中宣告。

若要宣告外部依賴關係

1. 在 Sumerian 編輯器中開啟場景。2. 按下 J 來開啟文字編輯器。3. 在 Documents (文件) 清單中選擇指令碼資產。4. 在 External resources (外部資源) 下，輸入以 // 為開頭的 URL (通訊協定除外)。5. 按一下加號圖示來將程式庫新增到清單。

只要您將程式庫加入此清單，編輯器就會載入程式庫。若要重新載入程式庫，請選擇 Refresh resources (重新整理資源)。在您的已發佈場景中，將在載入階段載入並執行所有的依賴關係。

84

Amazon Sumerian 使用者指南偵錯

偵錯若要在 Sumerian 編輯器中對指令碼偵錯，請在您的瀏覽器中使用內建的工具。在 Google Chrome 中，在Mac 上按下 ALT-CMD-J 或在 Windows 按 F12 來開啟開發人員工具。

開啟在 Devtools 頂端的來源面板。在左側可看到所有載入於瀏覽器中的指令碼。如果您的場景中有指令碼，就會在下方的 sumerian-custom-scripts 中列出。請選擇您的指令碼來檢視。

開始對指令碼進行偵測最簡單的方法是新增 debugger; 陳述式到編輯器中的自訂指令碼。如果您已開啟Devtools 且已執行此陳述式，Devtools 將自動移至陳述式所在的檔案和列。

85

Amazon Sumerian 使用者指南

疑難排解使用 Amazon Sumerian 場景的問題

本主題列出您在使用 Sumerian 編輯器和播放器時可能會遇到的常見錯誤和問題。如果您發現未列在此處的問題，您可以使用此頁面上的 Feedback (意見回饋) 按鈕來回報。

問題：(Chrome) 播放期間音訊未在 Sumerian 編輯器中播放。

設定下列旗標以允許音訊在編輯器中播放。

• 自動播放政策：不需要使用者手勢。 – #autoplay-policy

若要存取 Chrome 旗標，請在搜尋列中輸入 chrome://flags。

問題：(Chrome) 無法進入虛擬實境模式。

您可能需要設定下列旗標以在 Chrome 中使用虛擬實境模式。

• WebVR – #enable-webvr• Gamepad Extensions (遊戲器延伸模組) – #enable-gamepad-extensions• Override software rendering list (覆寫軟體轉譯清單) – #override-software-rendering-list

若要存取 Chrome 旗標，請在搜尋列中輸入 chrome://flags。

問題：瀏覽器使用錯誤的 GPU 來進行硬體加速。

如果您有多個顯示卡，您可能需要設定系統來使用適當的 GPU 用於瀏覽器應用程式。例如，NVIDIA 控制面板有一個名為 target GPU (目標 GPU) 的選項，您可以為每個應用程式進行設定。

86