Gravio Showcase

日本語が喋る方はこちら

This repository is where we collect and showcase both official and community Gravio snippets. You can find example Actions and Triggers here, as well as usage notes on each item.

For example, if you want to see how to use a specific component, say, the SendHttpRequest component, you can search for actions with that component here.

Each Action comes annotated with the following notable fields:

Field	Description	Values
Components	List of components this Action uses	{list of any valid component}
Payload	Whether this Action demonstrates usage of the cv.Payload object	{true,false}
Pre-Mappings	Whether this Action demonstrates usage of any pre-mappings fields	{true,false}
Post-Mappings	Whether this Action demonstrates usage of any post-mappings fields	{true,false}
Component Property	Whether this Action demonstrates usage of any cp. fields	{true,false}
Component Value	Whether this Action demonstrates usage of any cv. fields	{true,false}
Action Property	Whether this Action demonstrates usage of any ap. variables	{true,false}
Action Value	Whether this Action demonstrates usage of any av. variables	{true,false}
Trigger Property	Whether this Action demonstrates usage of any tp. fields	{true,false}
Trigger Value	Whether this Action demonstrates usage of any tv. fields	{true,false}
Formula	Whether this Action demonstrates usage of any formula functions	{list of any valid function}
Hardware	Whether this Action relies on other Gravio hardware, such as the Gravio Light	{list of any other Gravio hardware}

Repo Notes

Structure of this Repo

This repo is separated primarily into branches for Gravio 5, Gravio 4 and Gravio 3. We know that not everyone will upgrade at the same speed, so we keep older Actions around for those scenarios.

Within each main branch, the branch splits between Community and Official folders. If you only want officially created sample Actions, go with the Official path. If you want to see what our community has to offer, check out the Community path.

This repo will be updated with more branches if and when backwards-incompatible versions are released.

Version Compatability

Some versions of Gravio are not backwards compatable. For example. 3.8 Actions are not compatable with 4.1 Actions. If we release a major update to Gravio and don't include a new folder here, it can be assumed that the Actions are compatable and may be used freely. If we do include a new folder, then you should assume they are not compatable and should use the folder closest to the version you use that doesn't go over.

Contributing

Submitting an Action or Trigger for the Showcase

If you'd like to submit something for us to include in the Showcase, please submit a pull request with your added .acs or .gac files in the appropriate location, and include an edit to the relevent README.md file that contains the full annotations for your submission.

If you do not have a GitHub account or cannot make a pull request, please ping any of the people in the Gravio Slack Channel with (Asteria) in their name and we'll get it added. If we're all offline, ping us anyway.

Submission Location

Community should be under the respective versions in the Community folder.

Naming Scheme

We try to use a Snake Case scheme for the filenames of Actions and their folders for increased readability E.g., Set_Gravio_Light_To_Green.acs, or Send_Url_To_Slack.acs. Only ascii filesnames are accepted.

Licence

Material made available here is freely licensed for use by anyone under the MIT licence. Any community submissions are subject to this licence. Unless otherwise specified in the exceptions.txt file, neither Asteria Corporation, community submitters, nor users of the submissions retain any ownership of the submitted material.

Other contributions

We welcome pull requests for other things like documentation updates or typos as well.