com.github.twitch4j.helix.webhooks.topics.StreamsTopic Maven / Gradle / Ivy

Go to download
package com.github.twitch4j.helix.webhooks.topics;

import com.github.twitch4j.helix.domain.StreamList;
import lombok.Getter;
import lombok.NonNull;
import org.jetbrains.annotations.ApiStatus;

import java.util.TreeMap;

/**
 * Notifies when a stream changes; e.g., stream goes online or offline, the stream title changes, or the game changes.
 *
 * @deprecated Twitch decommissioned this API; please migrate to EventSub
 */
@Getter
@Deprecated
@ApiStatus.ScheduledForRemoval(inVersion = "2.0.0")
public class StreamsTopic extends TwitchWebhookTopic {

    public static final String PATH = "/streams";

    private static TreeMap mapParameters(String userId) {
        TreeMap parameterMap = new TreeMap<>();
        parameterMap.put("user_id", userId);
        return parameterMap;
    }

    /**
     * @return The user whose stream is monitored.
     */
    private String channelId;

    /**
     * Notifies when a stream changes; e.g., stream goes online or offline, the stream title changes, or the game changes.
     *
     * @param userId Specifies the user whose stream is monitored.
     * @deprecated Will be decommissioned after 2021-09-16 in favor of EventSub
     */
    @Deprecated
    public StreamsTopic(@NonNull String userId) {
        super(
            PATH,
            StreamList.class,
            mapParameters(userId)
        );
        this.channelId = userId;
    }

}