/* * Copyright 2018-2023 Amazon.com, Inc. or its affiliates. All Rights Reserved. * * Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance with * the License. A copy of the License is located at * * http://aws.amazon.com/apache2.0 * * or in the "license" file accompanying this file. This file is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR * CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions * and limitations under the License. */ package com.amazonaws.services.ivsrealtime; import javax.annotation.Generated; import com.amazonaws.services.ivsrealtime.model.*; /** * Interface for accessing ivsrealtime asynchronously. Each asynchronous method will return a Java Future object * representing the asynchronous operation; overloads which accept an {@code AsyncHandler} can be used to receive * notification when an asynchronous operation completes. *

* Note: Do not directly implement this interface, new methods are added to it regularly. Extend from * {@link com.amazonaws.services.ivsrealtime.AbstractAmazonIVSRealTimeAsync} instead. *

* Introduction *

* The Amazon Interactive Video Service (IVS) stage API is REST compatible, using a standard HTTP API and an AWS * EventBridge event stream for responses. JSON is used for both requests and responses, including errors. *

* Terminology: *

*
* The IVS stage API sometimes is referred to as the IVS RealTime API. *
*
*
* A participant token is an authorization token used to publish/subscribe to a stage. *
*
*
* A participant object represents participants (people) in the stage and contains information about them. When a * token is created, it includes a participant ID; when a participant uses that token to join a stage, the participant * is associated with that participant ID There is a 1:1 mapping between participant tokens and participants. *
*

* Resources *

* The following resources contain information about your IVS live stream (see Getting Started with Amazon IVS): *

*
* Stage — A stage is a virtual space where multiple participants can exchange audio and video in real time. *
*

* Tagging *

* A tag is a metadata label that you assign to an AWS resource. A tag comprises a key and a value, * both set by you. For example, you might set a tag as topic:nature to label a particular video category. * See Tagging AWS Resources for more * information, including restrictions that apply to tags and "Tag naming limits and requirements"; Amazon IVS stages * has no service-specific constraints beyond what is documented there. *

* Tags can help you identify and organize your AWS resources. For example, you can use the same tag for different * resources to indicate that they are related. You can also use tags to manage access (see Access Tags). *

* The Amazon IVS stage API has these tag-related endpoints: TagResource, UntagResource, and * ListTagsForResource. The following resource supports tagging: Stage. *

* At most 50 tags can be applied to a resource. *

* Stages Endpoints *

*
* CreateParticipantToken — Creates an additional token for a specified stage. This can be done after stage * creation or when tokens expire. *
*
*
* CreateStage — Creates a new stage (and optionally participant tokens). *
*
*
* DeleteStage — Shuts down and deletes the specified stage (disconnecting all participants). *
*
*
* DisconnectParticipant — Disconnects a specified participant and revokes the participant permanently from a * specified stage. *
*
*
* GetParticipant — Gets information about the specified participant token. *
*
*
* GetStage — Gets information for the specified stage. *
*
*
* GetStageSession — Gets information for the specified stage session. *
*
*
* ListParticipantEvents — Lists events for a specified participant that occurred during a specified stage * session. *
*
*
* ListParticipants — Lists all participants in a specified stage session. *
*
*
* ListStages — Gets summary information about all stages in your account, in the AWS region where the API * request is processed. *
*
*
* ListStageSessions — Gets all sessions for a specified stage. *
*
*
* UpdateStage — Updates a stage’s configuration. *
*

* Tags Endpoints *

*
* ListTagsForResource — Gets information about AWS tags for the specified ARN. *
*
*
* TagResource — Adds or updates tags for the AWS resource with the specified ARN. *
*
*
* UntagResource — Removes tags from the resource with the specified ARN. *
*

*/ @Generated("com.amazonaws:aws-java-sdk-code-generator") public interface AmazonIVSRealTimeAsync extends AmazonIVSRealTime { /** *

* Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire. * Tokens always are scoped to the stage for which they are created. *

* Encryption keys are owned by Amazon IVS and never used directly by your application. *

* * @param createParticipantTokenRequest * @return A Java Future containing the result of the CreateParticipantToken operation returned by the service. * @sample AmazonIVSRealTimeAsync.CreateParticipantToken * @see AWS API Documentation */ java.util.concurrent.Future createParticipantTokenAsync(CreateParticipantTokenRequest createParticipantTokenRequest); /** *

* Creates an additional token for a specified stage. This can be done after stage creation or when tokens expire. * Tokens always are scoped to the stage for which they are created. *

* Encryption keys are owned by Amazon IVS and never used directly by your application. *

* * @param createParticipantTokenRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateParticipantToken operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.CreateParticipantToken * @see AWS API Documentation */ java.util.concurrent.Future createParticipantTokenAsync(CreateParticipantTokenRequest createParticipantTokenRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Creates a new stage (and optionally participant tokens). *

* * @param createStageRequest * @return A Java Future containing the result of the CreateStage operation returned by the service. * @sample AmazonIVSRealTimeAsync.CreateStage * @see AWS API * Documentation */ java.util.concurrent.Future createStageAsync(CreateStageRequest createStageRequest); /** *

* Creates a new stage (and optionally participant tokens). *

* * @param createStageRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the CreateStage operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.CreateStage * @see AWS API * Documentation */ java.util.concurrent.Future createStageAsync(CreateStageRequest createStageRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Shuts down and deletes the specified stage (disconnecting all participants). *

* * @param deleteStageRequest * @return A Java Future containing the result of the DeleteStage operation returned by the service. * @sample AmazonIVSRealTimeAsync.DeleteStage * @see AWS API * Documentation */ java.util.concurrent.Future deleteStageAsync(DeleteStageRequest deleteStageRequest); /** *

* Shuts down and deletes the specified stage (disconnecting all participants). *

* * @param deleteStageRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DeleteStage operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.DeleteStage * @see AWS API * Documentation */ java.util.concurrent.Future deleteStageAsync(DeleteStageRequest deleteStageRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Disconnects a specified participant and revokes the participant permanently from a specified stage. *

* * @param disconnectParticipantRequest * @return A Java Future containing the result of the DisconnectParticipant operation returned by the service. * @sample AmazonIVSRealTimeAsync.DisconnectParticipant * @see AWS API Documentation */ java.util.concurrent.Future disconnectParticipantAsync(DisconnectParticipantRequest disconnectParticipantRequest); /** *

* Disconnects a specified participant and revokes the participant permanently from a specified stage. *

* * @param disconnectParticipantRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the DisconnectParticipant operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.DisconnectParticipant * @see AWS API Documentation */ java.util.concurrent.Future disconnectParticipantAsync(DisconnectParticipantRequest disconnectParticipantRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets information about the specified participant token. *

* * @param getParticipantRequest * @return A Java Future containing the result of the GetParticipant operation returned by the service. * @sample AmazonIVSRealTimeAsync.GetParticipant * @see AWS * API Documentation */ java.util.concurrent.Future getParticipantAsync(GetParticipantRequest getParticipantRequest); /** *

* Gets information about the specified participant token. *

* * @param getParticipantRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetParticipant operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.GetParticipant * @see AWS * API Documentation */ java.util.concurrent.Future getParticipantAsync(GetParticipantRequest getParticipantRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets information for the specified stage. *

* * @param getStageRequest * @return A Java Future containing the result of the GetStage operation returned by the service. * @sample AmazonIVSRealTimeAsync.GetStage * @see AWS API * Documentation */ java.util.concurrent.Future getStageAsync(GetStageRequest getStageRequest); /** *

* Gets information for the specified stage. *

* * @param getStageRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetStage operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.GetStage * @see AWS API * Documentation */ java.util.concurrent.Future getStageAsync(GetStageRequest getStageRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets information for the specified stage session. *

* * @param getStageSessionRequest * @return A Java Future containing the result of the GetStageSession operation returned by the service. * @sample AmazonIVSRealTimeAsync.GetStageSession * @see AWS * API Documentation */ java.util.concurrent.Future getStageSessionAsync(GetStageSessionRequest getStageSessionRequest); /** *

* Gets information for the specified stage session. *

* * @param getStageSessionRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the GetStageSession operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.GetStageSession * @see AWS * API Documentation */ java.util.concurrent.Future getStageSessionAsync(GetStageSessionRequest getStageSessionRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists events for a specified participant that occurred during a specified stage session. *

* * @param listParticipantEventsRequest * @return A Java Future containing the result of the ListParticipantEvents operation returned by the service. * @sample AmazonIVSRealTimeAsync.ListParticipantEvents * @see AWS API Documentation */ java.util.concurrent.Future listParticipantEventsAsync(ListParticipantEventsRequest listParticipantEventsRequest); /** *

* Lists events for a specified participant that occurred during a specified stage session. *

* * @param listParticipantEventsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListParticipantEvents operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.ListParticipantEvents * @see AWS API Documentation */ java.util.concurrent.Future listParticipantEventsAsync(ListParticipantEventsRequest listParticipantEventsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Lists all participants in a specified stage session. *

* * @param listParticipantsRequest * @return A Java Future containing the result of the ListParticipants operation returned by the service. * @sample AmazonIVSRealTimeAsync.ListParticipants * @see AWS * API Documentation */ java.util.concurrent.Future listParticipantsAsync(ListParticipantsRequest listParticipantsRequest); /** *

* Lists all participants in a specified stage session. *

* * @param listParticipantsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListParticipants operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.ListParticipants * @see AWS * API Documentation */ java.util.concurrent.Future listParticipantsAsync(ListParticipantsRequest listParticipantsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets all sessions for a specified stage. *

* * @param listStageSessionsRequest * @return A Java Future containing the result of the ListStageSessions operation returned by the service. * @sample AmazonIVSRealTimeAsync.ListStageSessions * @see AWS * API Documentation */ java.util.concurrent.Future listStageSessionsAsync(ListStageSessionsRequest listStageSessionsRequest); /** *

* Gets all sessions for a specified stage. *

* * @param listStageSessionsRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListStageSessions operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.ListStageSessions * @see AWS * API Documentation */ java.util.concurrent.Future listStageSessionsAsync(ListStageSessionsRequest listStageSessionsRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets summary information about all stages in your account, in the AWS region where the API request is processed. *

* * @param listStagesRequest * @return A Java Future containing the result of the ListStages operation returned by the service. * @sample AmazonIVSRealTimeAsync.ListStages * @see AWS API * Documentation */ java.util.concurrent.Future listStagesAsync(ListStagesRequest listStagesRequest); /** *

* Gets summary information about all stages in your account, in the AWS region where the API request is processed. *

* * @param listStagesRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListStages operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.ListStages * @see AWS API * Documentation */ java.util.concurrent.Future listStagesAsync(ListStagesRequest listStagesRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Gets information about AWS tags for the specified ARN. *

* * @param listTagsForResourceRequest * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonIVSRealTimeAsync.ListTagsForResource * @see AWS API Documentation */ java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest); /** *

* Gets information about AWS tags for the specified ARN. *

* * @param listTagsForResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the ListTagsForResource operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.ListTagsForResource * @see AWS API Documentation */ java.util.concurrent.Future listTagsForResourceAsync(ListTagsForResourceRequest listTagsForResourceRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Adds or updates tags for the AWS resource with the specified ARN. *

* * @param tagResourceRequest * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonIVSRealTimeAsync.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest); /** *

* Adds or updates tags for the AWS resource with the specified ARN. *

* * @param tagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the TagResource operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.TagResource * @see AWS API * Documentation */ java.util.concurrent.Future tagResourceAsync(TagResourceRequest tagResourceRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Removes tags from the resource with the specified ARN. *

* * @param untagResourceRequest * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonIVSRealTimeAsync.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest); /** *

* Removes tags from the resource with the specified ARN. *

* * @param untagResourceRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UntagResource operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.UntagResource * @see AWS API * Documentation */ java.util.concurrent.Future untagResourceAsync(UntagResourceRequest untagResourceRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); /** *

* Updates a stage’s configuration. *

* * @param updateStageRequest * @return A Java Future containing the result of the UpdateStage operation returned by the service. * @sample AmazonIVSRealTimeAsync.UpdateStage * @see AWS API * Documentation */ java.util.concurrent.Future updateStageAsync(UpdateStageRequest updateStageRequest); /** *

* Updates a stage’s configuration. *

* * @param updateStageRequest * @param asyncHandler * Asynchronous callback handler for events in the lifecycle of the request. Users can provide an * implementation of the callback methods in this interface to receive notification of successful or * unsuccessful completion of the operation. * @return A Java Future containing the result of the UpdateStage operation returned by the service. * @sample AmazonIVSRealTimeAsyncHandler.UpdateStage * @see AWS API * Documentation */ java.util.concurrent.Future updateStageAsync(UpdateStageRequest updateStageRequest, com.amazonaws.handlers.AsyncHandler asyncHandler); }