Alexa.NET.Gadgets 1.1.2

A simple package built to work with the Alexa Gadgets API, using Alexa.NET as the core

There is a newer version of this package available.
See the version list below for details.
Install-Package Alexa.NET.Gadgets -Version 1.1.2
dotnet add package Alexa.NET.Gadgets --version 1.1.2
<PackageReference Include="Alexa.NET.Gadgets" Version="1.1.2" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Alexa.NET.Gadgets --version 1.1.2
The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Alexa.NET.Gadgets

A simple skill built to work with the Alexa Gadgets API, using Alexa.NET as the core

Game Controller Support

Set all attached buttons to the same color

A good one to show the user active buttons during roll call

using Alexa.NET.Gadgets.GadgetController
...
response.GadgetColor("0000FF",10000)

which is the same as

var setLight = new SetLightDirective
{
    Parameters =
        SetLightParameter.Create(
            SetLightAnimation.CreateSingle(
				AnimationSegment.Create("0000FF", 10000)))
};

response.Response.Directives.Add(setLight);

Set light color of a specific gadget

using Alexa.NET.Gadgets.GadgetController
...
response.GadgetColor("0000FF", new[] { "gadgetid1"}, 10000);

which is the same as

var setLight = new SetLightDirective
{
    TargetGadgets = new List<string>{"gadgetid1"},
    Parameters =
        SetLightParameter.Create(
            SetLightAnimation.CreateSingle(
				AnimationSegment.Create("0000FF", 10000)))
};

response.Response.Directives.Add(setLight);

Set light with more explicit settings

var setLight = new SetLightDirective
{
    TargetGadgets = new List<string> { "gadgetId1", "gadgetId2" },
    Parameters = new SetLightParameter
    {
        TriggerEvent = TriggerEvent.Down,
        TriggerEventTimeMilliseconds = 200,
        Animations = new List<SetLightAnimation> {
            new SetLightAnimation {
                Repeat = 1,
                TargetLights = new List<int> { 1 },
                Sequence = new List<AnimationSegment>
                        {
                            new AnimationSegment
                            {
                                Blend=false,
                                DurationMilliseconds = 3000,
                                Color="0000FF"
                            }
                        }
            }
        }
    }
};
skillResponse.Response.Directives.Add(setLight);

Game Engine Support

Add support for GameEngine requests - please this in constructor/startup

new GadgetRequestHandler().AddToRequestConverter();

Roll Call - Ask User to identify buttons

Adds a directive to the response that looks for buttons to be pressed, and assigns them to the list passed in on a first come first served basis (Good to use in combination with a general GadgetColor from GameController to show the user which buttons they can pick from)

using Alexa.NET.Gadgets.GameEngine
...
response.AddRollCall("first", "second");

This is equivalent to:

  • A StartInputHandler Directive
  • Proxy added for each name passed in
  • A timed out event
  • A "rollcall complete" event
  • A "rollcall complete" recogniser
    • A pattern for each name to be pressed down, once, in order.

Roll Call - Find gadgets used in roll call

When an InputHandlerEventRequest is identified, this will check to see if it was a rollcall event, and then map the matched events to the gadget ids in the order passed in.

Assuming the previous AddRollCall method was used, this would return a dictionary mapping first -> firstGadgetId, second -> secondGadgetId

using Alexa.NET.Gadgets.GameEngine
...
switch(skillRequest.Request)
{
    case InputHandlerEventRequest inputHandler:
      inputHandler.TryRollCallResult(out Dictionary<string,string> mapping, "first","second");
}

Alexa.NET.Gadgets

A simple skill built to work with the Alexa Gadgets API, using Alexa.NET as the core

Game Controller Support

Set all attached buttons to the same color

A good one to show the user active buttons during roll call

using Alexa.NET.Gadgets.GadgetController
...
response.GadgetColor("0000FF",10000)

which is the same as

var setLight = new SetLightDirective
{
    Parameters =
        SetLightParameter.Create(
            SetLightAnimation.CreateSingle(
				AnimationSegment.Create("0000FF", 10000)))
};

response.Response.Directives.Add(setLight);

Set light color of a specific gadget

using Alexa.NET.Gadgets.GadgetController
...
response.GadgetColor("0000FF", new[] { "gadgetid1"}, 10000);

which is the same as

var setLight = new SetLightDirective
{
    TargetGadgets = new List<string>{"gadgetid1"},
    Parameters =
        SetLightParameter.Create(
            SetLightAnimation.CreateSingle(
				AnimationSegment.Create("0000FF", 10000)))
};

response.Response.Directives.Add(setLight);

Set light with more explicit settings

var setLight = new SetLightDirective
{
    TargetGadgets = new List<string> { "gadgetId1", "gadgetId2" },
    Parameters = new SetLightParameter
    {
        TriggerEvent = TriggerEvent.Down,
        TriggerEventTimeMilliseconds = 200,
        Animations = new List<SetLightAnimation> {
            new SetLightAnimation {
                Repeat = 1,
                TargetLights = new List<int> { 1 },
                Sequence = new List<AnimationSegment>
                        {
                            new AnimationSegment
                            {
                                Blend=false,
                                DurationMilliseconds = 3000,
                                Color="0000FF"
                            }
                        }
            }
        }
    }
};
skillResponse.Response.Directives.Add(setLight);

Game Engine Support

Add support for GameEngine requests - please this in constructor/startup

new GadgetRequestHandler().AddToRequestConverter();

Roll Call - Ask User to identify buttons

Adds a directive to the response that looks for buttons to be pressed, and assigns them to the list passed in on a first come first served basis (Good to use in combination with a general GadgetColor from GameController to show the user which buttons they can pick from)

using Alexa.NET.Gadgets.GameEngine
...
response.AddRollCall("first", "second");

This is equivalent to:

  • A StartInputHandler Directive
  • Proxy added for each name passed in
  • A timed out event
  • A "rollcall complete" event
  • A "rollcall complete" recogniser
    • A pattern for each name to be pressed down, once, in order.

Roll Call - Find gadgets used in roll call

When an InputHandlerEventRequest is identified, this will check to see if it was a rollcall event, and then map the matched events to the gadget ids in the order passed in.

Assuming the previous AddRollCall method was used, this would return a dictionary mapping first -> firstGadgetId, second -> secondGadgetId

using Alexa.NET.Gadgets.GameEngine
...
switch(skillRequest.Request)
{
    case InputHandlerEventRequest inputHandler:
      inputHandler.TryRollCallResult(out Dictionary<string,string> mapping, "first","second");
}

Release Notes

Update readme, improve GadgetController extensions add GameExtensions to both request and response objects

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version History

Version Downloads Last updated
1.6.0 465 1/16/2020
1.5.1 103 12/21/2019
1.5.0 162 8/20/2019
1.4.0 162 8/10/2019
1.3.5 496 4/25/2018
1.3.1 378 4/24/2018
1.2.3 363 4/11/2018
1.2.2 342 4/10/2018
1.2.1 525 4/8/2018
1.1.13 488 4/8/2018
1.1.9 486 4/7/2018
1.1.2 430 4/5/2018
1.0.2 359 4/4/2018
1.0.1 341 4/4/2018
0.1.20-pre 357 3/26/2018
0.1.15-pre 386 1/4/2018
0.1.12-pre 379 12/29/2017
0.1.11-pre 421 12/27/2017
0.1.9-pre 443 12/27/2017
0.1.8-pre 381 12/26/2017
Show less