git.basschouten.com Git - openhab-addons.git/blob

   1 /**
   2  * Copyright (c) 2010-2023 Contributors to the openHAB project
   3  *
   4  * See the NOTICE file(s) distributed with this work for additional
   5  * information.
   6  *
   7  * This program and the accompanying materials are made available under the
   8  * terms of the Eclipse Public License 2.0 which is available at
   9  * http://www.eclipse.org/legal/epl-2.0
  10  *
  11  * SPDX-License-Identifier: EPL-2.0
  12  */
  13 package org.openhab.binding.yamahareceiver.internal.protocol;
  14
  15 import static java.util.stream.Collectors.toSet;
  16 import static org.openhab.binding.yamahareceiver.internal.YamahaReceiverBindingConstants.Inputs.*;
  17
  18 import java.io.IOException;
  19 import java.util.Set;
  20 import java.util.stream.Stream;
  21
  22 /**
  23  * The play controls protocol interface
  24  *
  25  * @author David Graeff - Initial contribution
  26  * @author Tomasz Maruszak - Spotify support, adding Server to supported preset inputs
  27  */
  28 public interface InputWithPlayControl extends IStateUpdatable {
  29     /**
  30      * List all inputs that are compatible with this kind of control
  31      */
  32     Set<String> SUPPORTED_INPUTS = Stream.of(INPUT_NET_RADIO, INPUT_NET_RADIO_LEGACY, INPUT_USB, INPUT_IPOD_USB,
  33             INPUT_IPOD, INPUT_DOCK, INPUT_PC, INPUT_NAPSTER, INPUT_PANDORA, INPUT_SIRIUS, INPUT_RHAPSODY,
  34             INPUT_BLUETOOTH, INPUT_SPOTIFY, INPUT_SERVER, INPUT_HD_RADIO).collect(toSet());
  35
  36     /**
  37      * Start the playback of the content which is usually selected by the means of the Navigation control class or
  38      * which has been stopped by stop().
  39      *
  40      * @throws Exception
  41      */
  42     void play() throws IOException, ReceivedMessageParseException;
  43
  44     /**
  45      * Stop the currently playing content. Use start() to start again.
  46      *
  47      * @throws Exception
  48      */
  49     void stop() throws IOException, ReceivedMessageParseException;
  50
  51     /**
  52      * Pause the currently playing content. This is not available for streaming content like on NET_RADIO.
  53      *
  54      * @throws Exception
  55      */
  56     void pause() throws IOException, ReceivedMessageParseException;
  57
  58     /**
  59      * Skip forward. This is not available for streaming content like on NET_RADIO.
  60      *
  61      * @throws Exception
  62      */
  63     void skipFF() throws IOException, ReceivedMessageParseException;
  64
  65     /**
  66      * Skip reverse. This is not available for streaming content like on NET_RADIO.
  67      *
  68      * @throws Exception
  69      */
  70     void skipREV() throws IOException, ReceivedMessageParseException;
  71
  72     /**
  73      * Next track. This is not available for streaming content like on NET_RADIO.
  74      *
  75      * @throws Exception
  76      */
  77     void nextTrack() throws IOException, ReceivedMessageParseException;
  78
  79     /**
  80      * Previous track. This is not available for streaming content like on NET_RADIO.
  81      *
  82      * @throws Exception
  83      */
  84     void previousTrack() throws IOException, ReceivedMessageParseException;
  85 }