Repository files navigation

We are building an Alexa Skill live on-stream atCodebase Alpha on Twitch. The skill, calledDevStreams, is the voice interface for theDevStreams community website that is being developed on theDevChatter Twitch stream by Brendan Enrick and contributors. A fork of that repo can be found in this Github. Integration has been achieved through the introduction of a GraphQL endpoint into the DevStreams solution (also developed on-stream at Codebase Alpha). TheEssenbee.Alexa code uses this endpoint to query DevStreams and thus provide users with the information about live coding streams that they have requested.

The primary reusable component created in this project is theEssenbee.Alexa.Lib NuGet package. Please see below for installation and usage instructions.

The main phase of development for this code is encompassed by Episodes 4 - 11 of Codebase Alpha. The videos for these episodes are archived on YouTubehere.

Install theEssenbee.Alexa.Lib NET Standard 2.0 library into your own ASP.NET Core (2.2+) Web App or Web API via Nuget with the command:

dotnet add package Essenbee.Alexa.Lib

The library contains the following features at this stage:

• Middleware and methods to satisfy Amazon's security requirements for Skills, seehere
• AlexaRequest andAlexaResponse classes for speech, cards and dialogs, but not yet for AudioPlayer requests at this time
• A fluentResponseBuilder that makes creating responses easy
• A strongly-typed HTTP client (AlexaClient) that you can use to access Device Settings or User Address details (with the user's permission)

Further features will be added over time, with the intent being to provide library support for all of the features that Alexa skills can exploit. However, that takes time, especially doing the work live on Twitch, so please check back here often to see what is new.

Install the latest NuGet package into your project. In theStartup.cs class, add the following code to theConfigure method:

app.UseWhen(context => context.Request.Path.StartsWithSegments("/api/alexa"), (appBuilder) =>{    appBuilder.UseAlexaRequestValidation();});

To use the strongly-typed HTTP client, add this line to yourConfigureServices method:

services.AddHttpClient<IAlexaClient, AlexaClient>();

Make sure that you store your Alexa Skill Application ID (securely) in yourConfiguration. In the example code, it is held inConfiguration["SkillId"]. This is needed for theAlexaRequestShouldProcessRequest()` static method call shown below. It is this method that, alongside the custom Middleware, ensures that your Skill staisfies Amazon's security requirements.

Create anAlexaController using the example below as a starting point:

[ApiController][Produces("application/json")]public class AlexaController : ControllerBase{    private IConfiguration _config;    private ILogger<AlexaController> _logger;    private readonly IAlexaClient _client;    public AlexaController(IConfiguration config, ILogger<AlexaController> logger, IAlexaClient client)    {        _config = config;        _logger = logger;        _client = client;    }    [HttpPost]    [ProducesResponseType(200, Type = typeof(AlexaResponse))]    [ProducesResponseType(400)]    [Route("api/alexa/your-endpoint")]    public async Task<ActionResult<AlexaResponse>> MySkill ([FromBody] AlexaRequest alexaRequest )    {        if (!AlexaRequest.ShouldProcessRequest(_config["SkillId"], alexaRequest))        {            _logger.LogError("Bad Request - application id did not match or timestamp tolerance exceeded!");            return BadRequest();        }                // Your skill's code here    }        }

You use theResponseBuilder like this:

var response = new ResponseBuilder()                .Say("To use this skill, ask me about the schedule of your favourite stream.")                .Build();

var response = new ResponseBuilder()                .Say("Codebase Alpha is streaming now")                .WriteSimpleCard("Streaming Now!", "Codebase Alpha")                .Build();

var ssml = @"<speak>Welcome to my skill</speak>";var response = new ResponseBuilder()                .SayWithSsml(ssml)                .Build();

var response = new ResponseBuilder()                .Ask("Try asking me who is streaming now",                     "You can ask me who is streaming now")                .Build();

var response = new ResponseBuilder()                .DelegateDialog()                .Build();

If you have any questions, suggestions or bug reports relating to theEssenbee.Alexa.Lib library, head over to my Discordhere. Why not join me for some live coding on Twitch? We work on a variety of projects, not just Alexa skills.