Twitch Clips: Add title and duration parameters (#395)

* Twitch Clips: Add title and duration parameters

* fix: remove unneeded csharp props

* fix: friendly type names for user-facing input dialogs

---------

Co-authored-by: Whipstickgostop <8366326+Whipstickgostop@users.noreply.github.com>

Author: brofar

streamerbot/3.api/1.sub-actions/twitch/channel/create-clip.md

@@ -1,6 +1,14 @@
 ---
 title: Create Clip
-description: Create a 30-second Twitch Clip
+description: Create a Twitch Clip
+parameters:
+  - name: Clip Title
+    type: Text
+    description: If blank, will match the stream title at the time of creation.
+  - name: Duration
+    type: Number
+    default: 30
+    description: Clip duration in seconds (min. 5, max 60).
 variables:
   - name: createClipSuccess
     type: bool
@@ -21,11 +29,3 @@ variables:
 csharpMethods:
   - CreateClip
 ---
-
-::warning
-**Twitch API restrictions**
-- The generated clip will always be 30 seconds in length
-- The clip title will match your stream title at the time of creation
-
-  To make your own changes to the clip duration and/or title, you can manually edit the clip later.
-::

streamerbot/3.api/3.csharp/3.methods/twitch/clips/create-clip.md

@@ -1,16 +1,21 @@
 ---
 name: CreateClip
 title: CreateClip
-description: Create a 30 second Twitch Clip
+description: Create a Twitch Clip
+parameters:
+  - name: title
+    description: If `null`, will match the stream title at the time of creation.
+  - name: duration
+    description: Clip duration in seconds (min. 5, max 60).
 example: |
   using System;
   using Twitch.Common.Models.Api; //Needed for ClipData Type
   public class CPHInline
   {
       public bool Execute()
       {
-          //Create Clip
-          ClipData clip = CPH.CreateClip();
+          //Create a 25 second clip titled "Example Title"
+          ClipData clip = CPH.CreateClip("Example Title", 25);
 
           //Access created clip data
           //Get clip creator name
@@ -24,12 +29,3 @@ example: |
       }
   }
 ---
-
-::warning
-**Twitch API restrictions**
-
-- The generated clip will always be 30 seconds in length
-- The clip title will match your stream title at the time of creation
-
-  To make your own changes to the clip duration and/or title, you can manually edit the clip later.
-::