kz / lifx-php

     * @param float $peak (Optional) Defines where in a period the target color is at its maximum. Defaults to `0.5`. Minimum `0.0`, maximum `1.0`.

     * @return \Psr\Http\Message\StreamInterface

     */

    public function breatheLights(

        $selector = 'all',

        $color = 'purple',

        $from_color = null,

        $period = 1.0,

        $cycles = 1.0,

        $persist = false,

        $power_on = true,

        $peak = 0.5

    ) {

        $request = new Request('POST', 'lights/' . $selector . '/effects/breathe');

        $response = $this->sendRequest($request,[

            'query' => [

                'color' => $color,

                'from_color' => $from_color,

                'period' => $period,

                'cycles' => $cycles,

                'persist' => $persist,

                'power_on' => $power_on,

                'peak' => $peak,

            ]

        ]);

        return $response->getBody();

    }

    /**

     * Performs a pulse effect by quickly flashing between the given colors.

     * @param float $duty_cycle (Optional) Ratio of the period where color is active. Defaults to `0.5`. Minimum `0.0`, maximum `1.0`.

     * @return \Psr\Http\Message\StreamInterface

     */

    public function pulseLights(

        $selector = 'all',

        $color = 'purple',

        $from_color = null,

        $period = 1.0,

        $cycles = 1.0,

        $persist = false,

        $power_on = true,

        $duty_cycle = 0.5

    ) {

        $request = new Request('POST', 'lights/' . $selector . '/effects/pulse');

        $response = $this->sendRequest($request,[

            'query' => [

                'selector' => $selector,

                'color' => $color,

                'from_color' => $from_color,

                'period' => $period,

                'cycles' => $cycles,

                'persist' => $persist,

                'power_on' => $power_on,

                'duty_cycle' => $duty_cycle,

            ]

        ]);

        return $response->getBody();

    }

}