LightScript

0.2.9

Functions/KeyLight/Set-KeyLight.ps1

function Set-KeyLight {
    <#
    .Synopsis
        Sets Elgato Key Lighting
    .Description
        Changes Elgato Key Lighting
    .Example
        Set-KeyLight -Brightness .5
    .LINK
        Get-KeyLight
    #>
    [CmdletBinding(SupportsShouldProcess)]
    param(
        # One or more IP Addresses of Elgato Key Lighting devices.
        [Parameter(ValueFromPipelineByPropertyName)]
        [Alias('KeyLightIPAddress')]
        [IPAddress[]]
        $IPAddress,

        # Sets the brightness of all lights in a fixture
        # When passed with -Hue and -Saturation, sets the color
        # When passed with no other parameters, adjusts the absolute brightness
        [Parameter(ValueFromPipelineByPropertyName)]
        [Alias('Luminance')]
        [ValidateRange(0, 1)]
        [float]
        $Brightness,

        # If set, will turn the light on.
        [Parameter(ValueFromPipelineByPropertyName)]
        [switch]
        $On,

        # If set, will turn the light on.
        [Parameter(ValueFromPipelineByPropertyName)]
        [switch]
        $Off,

        # The color temperature as a Mired value.
        [Parameter(ValueFromPipelineByPropertyName)]
        [ComponentModel.DefaultBindingProperty('ct')]
        [ValidateRange(143, 334)]
        [Alias('CT', 'TemperatureMired')]
        [int]
        $ColorTemperature
    )

    begin {
        $PSDefaultParameterValues = @{
            "Invoke-RestMethod:ContentType" = "application/json"
        }
        if (-not $script:KeyLightCache) {
            $script:KeyLightCache = @{}
        }
        if ($home) {
            $lightScriptRoot = Join-Path $home -ChildPath LightScript
        }
    }

    process {
        $paramCopy = @{} + $PSBoundParameters
        #region Default to All Devices
        if (-not $IPAddress) {
            # If no -IPAddress was passed
            if ($home -and -not $script:KeyLightCache.Count) {
                # Read all .keylight.clixml files beneath your LightScript directory.
                Get-ChildItem -Path $lightScriptRoot -ErrorAction SilentlyContinue -Filter *.keylight.clixml -Force |
                Import-Clixml |
                ForEach-Object {
                    if (-not $_) { return }
                    $KeyLightConnection = $_                        
                    $script:KeyLightCache["$($KeyLightConnection.IPAddress)"] = $KeyLightConnection
                }

                $IPAddress = $script:KeyLightCache.Keys # The keys of the device cache become the -IPAddress.
            }
            elseif ($script:KeyLightCache.Count) {
                $IPAddress = $script:KeyLightCache.Keys # The keys of the device cache become the -IPAddress.
            }
            if (-not $IPAddress) {
                # If we still have no -IPAddress
                return # return.
            }
        }
        #endregion Default to All Devices
        
        
        # Reference to API: https://github.com/adamesch/elgato-key-light-api/tree/master/resources/lights
        foreach ($ip in $ipAddress) {
            $refreshDevice = $false
            $invokeSplat = @{Uri = "http://$($ip):9123/elgato/lights"; Method = 'Put' }
            $restOutputs = @(
                if ($paramCopy.ContainsKey("Brightness")) {
                    $realBrightness = [Math]::Ceiling($Brightness * 100)
                    $invokeSplat.Body = (
                        @{
                            "lights" = @(
                                @{
                                    Brightness = [int]$realBrightness
                                }
                            )
                        } | ConvertTo-Json -Compress)
                    if ($whatIfPreference) {
                        $invokeSplat
                    }
                    elseif ($psCmdlet.ShouldProcess("$($invokeSplat.Body)")) {
                        Invoke-RestMethod @invokeSplat
                    }                    
                    $refreshDevice = $true
                }

                if ($paramCopy.ContainsKey("ColorTemperature")) {
                    $invokeSplat.Body = (
                        @{
                            "lights" = @(
                                @{
                                    temperature = $ColorTemperature
                                }
                            )
                        } | ConvertTo-Json -Compress)                    
                    if ($whatIfPreference) {
                        $invokeSplat
                    }
                    elseif ($psCmdlet.ShouldProcess("$($invokeSplat.Body)")) {
                        Invoke-RestMethod @invokeSplat
                    }
                }

                if ($On -and -not $Off) {
                    $invokeSplat.Body = (
                        @{
                            "lights" = @(
                                @{
                                    on = 1
                                }
                            )
                        } | ConvertTo-Json -Compress)
                    if ($whatIfPreference) {
                        $invokeSplat
                    }
                    elseif ($psCmdlet.ShouldProcess("$($invokeSplat.Body)")) {
                        Invoke-RestMethod @invokeSplat
                    }
                }

                if ($off) {
                    $invokeSplat.Body = (@{
                            "lights" = @(
                                @{
                                    on = 0
                                }
                            )
                        } | ConvertTo-Json -Compress)
                    if ($whatIfPreference) {
                        $invokeSplat
                    }
                    elseif ($psCmdlet.ShouldProcess("$($invokeSplat.Body)")) {
                        Invoke-RestMethod @invokeSplat
                    }
                }
            )

            if ($restOutputs -and $whatIfPreference) {
                $restOutputs
            }

            if ($refreshDevice -and -not ($restOutputs | Where-Object error_code -gt 0) -and -not $whatIfPreference) {
                Connect-Elgato -IPAddress $IP
            }
        }
    }
}