• Install .Net Core 2.1

• Sign up for AWS account

• Install AWS CLI

• See Latest Release Notes for Sumerian Browser Compatibility

• Must use AWS region us-east-1

• Setup - LambdaSharp Tool (aka lash)

  • Upgrade lash

    dotnet tool uninstall -g LambdaSharp.Tool
    dotnet tool install -g LambdaSharp.Tool --version 0.7.0-rc7
    lash --version
    

    OR

  • Install lash

    dotnet tool install -g LambdaSharp.Tool --version 0.7.0-rc7
    lash --version
    

• Initialize a LambdaSharp environment

   lash init --quick-start
  

• Clone GoFish repository

   git clone git@github.com:LambdaSharp/SumerianGoFish.git
   cd SumerianGoFish
  

• Create resources for the game

   lash deploy Game
  

This will create:

• Lambda Function with Game Logic
• DynamoDB table to store game state
• S3 Bucket to store card images
• Cognito Identity Pool to connect Sumerian with AWS Services

Copy values for use later in this challenge.

In the AWS Console, navigate to CloudFormation:

(1) Cognito Pool Id

• Search Sumerian-GoFish, click on the result, then click on the Resources section.
• Search for SumerianCognitoIdentityPool
• Find and copy the Physical Id for SumerianCognitoIdentityPool

(2) GoFishGame Database

• While still in the Resources, search GoFishSessions
• Find and copy the Physical Id for GoFishSessions

(3) GoFish Lambda Arn

• Click on the Outputs section
• Copy the Lambda function ARN for the Key GoFish

Create a service role for the lex bot:

aws iam create-service-linked-role --aws-service-name lex.amazonaws.com

NOTE: If you get a message that the role already exists or has been taken, skip this step

Alternative Version: This step can also be performed via the AWS Console:

• Navigate to Amazon IAM service:
• From the left navigation, click the Roles section
• Find role AWSServiceRoleForLexBots -- if it exists, skip the next step of creating the role
• Click the Create Role button
• Choose Lex; then Lex Bots at the bottom of the page
• Continue Next: Tags
• Continue Next: Review
• Create Role

In a text editor:

• open Lex/GoFishBot.json.
• Find/replace PASTE_LAMBDA_ARN_HERE with the (3) GoFish Lambda Arn copied earlier.
• Zip the GoFishBot.json, name it GoFishBot.zip

  IMPORTANT: IT MUST BE THE ONLY FILE AND NOT IN A DIRECTORY

In your terminal run the following command from the root of the project:

aws lex-models start-import --resource-type BOT --merge-strategy FAIL_ON_CONFLICT --payload fileb://Lex/GoFishBot.zip

In the AWS Console, navigate to Amazon Lex service:

• Edit the GoFishBot
• Build and Publish. For the alias, enter anything you'd like (i.e. Prod, Latest, etc).
• Copy values for later:
  • (4) LexBot Name Name of the LexBot (GoFishBot)
  • (5) LexBot Alias Alias entered when publishing the Lex Bot
• Try Test Chatbot by speaking or typing new game.

You could try playing GoFish with the Lex Bot but we have no idea what the game state is.

In the AWS Console, navigate to Sumerian -- make sure you are in the us-east-1 region.

• Under the heading Create scene from template choose the empty scene, name it GoFish Challenge
• On the left side, Entities, there should only be GoFish Challenge and under it, Default Camera; if there's something else, delete it.
• Click the Import Assets link in the top center of the page
• On the right there's a window that says Import from Disk, choose the Sumerian/GoFishSumerian.zip file

Delete the default camera:

• On the left side, Entities, click Fixed Camera
• On right side, click Camera, make it the Main Camera
• On the left side, Entities, delete the Default Camera

Add the Cogitno Pool Id to the Sumerian scene:

• On the left side Entities, click on GoFish Challenge
• On the right side, click on Aws Configuration
• Paste the (1) Cognito Pool Id copied from earlier into the Cognito Pool Id field

Add a host to the scene

• Use the Import Assets and search for host. Choose a host.
• In the bottom left in the Assets section, find the name of the host with a hexagon next to it; click and drag it onto the scene

NOTE: If you don't see your host, it's just very small. We'll fix it in the next steps.

Configure the host.

• On the left side Entities, click on the host name
• On the right side, click Transform and change the XYZ for the scale to 10, 10, 10

• On the right side, click the host name

• Add a Custom Attributes value for databaseName with (2) GoFishGame Database

  NOTE: Be sure to use the NAME of the database and not the ARN

• On the right side, click Speech
• Add the speech file GameIntro from the Assets

• On the right side, click Host
• Change the point of interest to be the Fixed Camera entity

• Add a component Script
• Add the script file GameScripts from the Assets

• Add a component Dialogue
• Paste the (4) LexBot Name and (5) LexBot Alias of your Lex Bot in the fields

• Add a component State Machine
• Add the behavior GoFishChatBot from the Assets

Play the scene. To start, press the space bar and say new game.

NOTE: Don't forget to click the scene after starting. Also, it may take a few seconds for the host to respond the first time as the lambda function has a cold start.

In the AWS Console, navigate to Sumerian and open this project.

• On the top left side Entities, click the host Grace Polo
• On the right side click Scripts, then click the GameScripts edit pencil icon
• Add the card name with the image

In the AWS Console, navigate to Sumerian and open this project.

• On the top left side Entities, click the host Grace Polo
• On the right side click State Machine, then click the GoFishChatBot edit pencil icon
• In the state machine, Add a state between the Start and Wait for Input that will tell the user what to do when they enter the scene.
  • Add state; name it Introduction
  • Add an action in the Introduction state for Start Speech; use the GameIntro speech text

NOTE: You can change the GameIntro speech. Use Amazon Polly to test your SSML!

In a text editor:

• Edit the WhichCardToAskFor method in file Game/GoFish/AskForCard.cs

It currently asks only for a martini.

Maybe it could ask for cards in it's hand?

But then the player will know which cards the host has.

What can you do?

To re-deploy the function run lash deploy Game

We barely touched the tip of the iceberg of what's possible in Amazon Sumerian.

Try adding something else to the scene!

• Add some flair to the Game Over messaging.
• Add Captions to the Game using the Turning Amazon Lex Responses into Text tutorial as a guide.
• You already have an assets bucket from this challenge... try to Stream video from S3.
• For the Introduction state, gestures are pretty easy to implement. Use the Using a Host and Speech Components tutorial.
• Add an easter egg, Flying a Drone around the screen with your keyboard.

Or try a different Amazon Sumerian tutorial or Amazon Sumerian Article. Some are quick and definitely fun to implement!