2018-07-08 01:41:21 +02:00
package org.telegram.telegrambots.meta.api.methods.send ;
2016-01-14 01:14:53 +01:00
2016-11-17 02:41:12 +01:00
import com.fasterxml.jackson.core.type.TypeReference ;
2018-07-08 01:41:21 +02:00
import org.telegram.telegrambots.meta.api.methods.PartialBotApiMethod ;
2018-07-27 00:27:26 +02:00
import org.telegram.telegrambots.meta.api.objects.InputFile ;
2018-07-08 01:41:21 +02:00
import org.telegram.telegrambots.meta.api.objects.Message ;
import org.telegram.telegrambots.meta.api.objects.replykeyboard.ApiResponse ;
import org.telegram.telegrambots.meta.api.objects.replykeyboard.ReplyKeyboard ;
import org.telegram.telegrambots.meta.exceptions.TelegramApiRequestException ;
import org.telegram.telegrambots.meta.exceptions.TelegramApiValidationException ;
2016-01-14 01:14:53 +01:00
2016-06-03 19:22:02 +02:00
import java.io.File ;
2016-11-17 02:41:12 +01:00
import java.io.IOException ;
2016-06-04 06:15:55 +02:00
import java.io.InputStream ;
2016-08-07 05:47:23 +02:00
import java.util.Objects ;
2016-06-03 19:22:02 +02:00
2016-01-14 01:14:53 +01:00
/ * *
* @author Ruben Bermudez
* @version 1 . 0
2018-02-14 20:36:22 +01:00
* Use this method to send audio files , Use this method to send audio files , if you want
2016-04-11 02:53:53 +02:00
* Telegram clients to display them in the music player . Your audio must be in an . mp3 format . On
* success , the sent Message is returned . Bots can currently send audio files of up to 50 MB in
* size , this limit may be changed in the future .
2016-02-27 03:17:06 +01:00
* @note For sending voice notes , use sendVoice method instead .
2016-01-14 01:14:53 +01:00
* /
2016-11-17 02:41:12 +01:00
public class SendAudio extends PartialBotApiMethod < Message > {
2016-01-14 01:14:53 +01:00
public static final String PATH = " sendaudio " ;
2016-04-11 02:53:53 +02:00
public static final String DURATION_FIELD = " duration " ;
2016-01-14 01:14:53 +01:00
public static final String CHATID_FIELD = " chat_id " ;
public static final String AUDIO_FIELD = " audio " ;
public static final String REPLYTOMESSAGEID_FIELD = " reply_to_message_id " ;
2016-02-27 03:17:06 +01:00
public static final String DISABLENOTIFICATION_FIELD = " disable_notification " ;
2016-04-02 18:54:00 +02:00
public static final String REPLYMARKUP_FIELD = " reply_markup " ;
public static final String PERFOMER_FIELD = " performer " ;
public static final String TITLE_FIELD = " title " ;
2016-09-24 22:37:25 +02:00
public static final String CAPTION_FIELD = " caption " ;
2018-02-14 20:36:22 +01:00
public static final String PARSEMODE_FIELD = " parse_mode " ;
2018-07-27 00:27:26 +02:00
public static final String THUMB_FIELD = " thumb " ;
2016-04-11 02:53:53 +02:00
2016-04-02 18:54:00 +02:00
private Integer duration ; ///< Integer Duration of the audio in seconds as defined by sender
private String chatId ; ///< Unique identifier for the chat to send the message to (or Username fro channels)
2018-07-27 00:27:26 +02:00
private InputFile audio ; ///< Audio file to send. file_id as String to resend an audio that is already on the Telegram servers or Url to upload it
2016-06-20 20:50:03 +02:00
private Integer replyToMessageId ; ///< Optional. If the message is a reply, ID of the original message
2017-03-27 00:49:08 +02:00
private Boolean disableNotification ; ///< Optional. Sends the message silently. Users will receive a notification with no sound.
2016-06-20 20:50:03 +02:00
private ReplyKeyboard replyMarkup ; ///< Optional. JSON-serialized object for a custom reply keyboard
2016-01-14 01:14:53 +01:00
private String performer ; ///< Optional. Performer of sent audio
private String title ; ///< Optional. Title of sent audio
2016-09-24 22:37:25 +02:00
private String caption ; ///< Optional. Audio caption (may also be used when resending documents by file_id), 0-200 characters
2018-02-14 20:36:22 +01:00
private String parseMode ; ///< Send Markdown or HTML, if you want Telegram apps to show bold, italic, fixed-width text or inline URLs in the media caption.
2018-07-27 00:27:26 +02:00
/ * *
* Thumbnail of the file sent . The thumbnail should be in JPEG format and less than 200 kB in size .
* A thumbnail ‘ s width and height should not exceed 90 .
* Ignored if the file is not uploaded using multipart / form - data .
* Thumbnails can ’ t be reused and can be only uploaded as a new file , so you can pass
* “ attach : //<file_attach_name>” if the thumbnail was uploaded using multipart/form-data under <file_attach_name>.
* /
private InputFile thumb ;
2016-01-14 01:14:53 +01:00
public SendAudio ( ) {
super ( ) ;
}
2016-04-11 02:53:53 +02:00
public Integer getDuration ( ) {
return this . duration ;
}
2016-03-15 22:58:43 +01:00
2016-04-12 21:25:54 +02:00
public SendAudio setDuration ( Integer duration ) {
2016-04-02 18:54:00 +02:00
this . duration = duration ;
2016-04-12 21:25:54 +02:00
return this ;
2016-04-02 18:54:00 +02:00
}
2016-01-14 01:14:53 +01:00
public String getChatId ( ) {
return chatId ;
}
2016-04-12 21:25:54 +02:00
public SendAudio setChatId ( String chatId ) {
2016-01-14 01:14:53 +01:00
this . chatId = chatId ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
2016-11-17 02:41:12 +01:00
public SendAudio setChatId ( Long chatId ) {
Objects . requireNonNull ( chatId ) ;
this . chatId = chatId . toString ( ) ;
return this ;
}
2018-07-27 00:27:26 +02:00
public InputFile getAudio ( ) {
2016-01-14 01:14:53 +01:00
return audio ;
}
2016-01-24 03:20:54 +01:00
/ * *
* Use this method to set the audio to an audio existing in Telegram system
*
2016-04-11 02:53:53 +02:00
* @param audio File_id of the audio to send
2016-01-24 03:20:54 +01:00
* @note The file_id must have already been received or sent by your bot
* /
2016-04-12 21:25:54 +02:00
public SendAudio setAudio ( String audio ) {
2018-07-27 00:27:26 +02:00
this . audio = new InputFile ( audio ) ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
2016-01-24 03:20:54 +01:00
/ * *
* Use this method to set the audio to a new file
2016-04-11 02:53:53 +02:00
*
2016-06-03 19:22:02 +02:00
* @param file New audio file
2016-01-24 03:20:54 +01:00
* /
2018-07-27 00:27:26 +02:00
public SendAudio setAudio ( File file ) {
Objects . requireNonNull ( file , " file cannot be null! " ) ;
this . audio = new InputFile ( file , file . getName ( ) ) ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
2018-07-27 00:27:26 +02:00
public SendAudio setAudio ( String audioName , InputStream inputStream ) {
2016-08-07 05:47:23 +02:00
Objects . requireNonNull ( audioName , " audioName cannot be null! " ) ;
Objects . requireNonNull ( inputStream , " inputStream cannot be null! " ) ;
2018-07-27 00:27:26 +02:00
this . audio = new InputFile ( inputStream , audioName ) ;
return this ;
}
public SendAudio setAudio ( InputFile audio ) {
Objects . requireNonNull ( audio , " audio cannot be null! " ) ;
this . audio = audio ;
2016-06-04 06:15:55 +02:00
return this ;
}
2016-06-20 20:50:03 +02:00
public Integer getReplyToMessageId ( ) {
return replyToMessageId ;
2016-01-14 01:14:53 +01:00
}
2016-06-20 20:50:03 +02:00
public SendAudio setReplyToMessageId ( Integer replyToMessageId ) {
this . replyToMessageId = replyToMessageId ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
2016-06-20 20:50:03 +02:00
public ReplyKeyboard getReplyMarkup ( ) {
return replyMarkup ;
2016-01-14 01:14:53 +01:00
}
2016-06-20 20:50:03 +02:00
public SendAudio setReplyMarkup ( ReplyKeyboard replyMarkup ) {
this . replyMarkup = replyMarkup ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
public String getPerformer ( ) {
return performer ;
}
2016-04-12 21:25:54 +02:00
public SendAudio setPerformer ( String performer ) {
2016-01-14 01:14:53 +01:00
this . performer = performer ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
public String getTitle ( ) {
return title ;
}
2016-04-12 21:25:54 +02:00
public SendAudio setTitle ( String title ) {
2016-01-14 01:14:53 +01:00
this . title = title ;
2016-04-12 21:25:54 +02:00
return this ;
2016-01-14 01:14:53 +01:00
}
2016-02-27 03:17:06 +01:00
public Boolean getDisableNotification ( ) {
return disableNotification ;
}
2016-04-12 22:26:59 +02:00
public SendAudio enableNotification ( ) {
2016-02-27 03:17:06 +01:00
this . disableNotification = false ;
2016-04-12 22:26:59 +02:00
return this ;
2016-02-27 03:17:06 +01:00
}
2016-04-12 22:26:59 +02:00
public SendAudio disableNotification ( ) {
2016-02-27 03:17:06 +01:00
this . disableNotification = true ;
2016-04-12 22:26:59 +02:00
return this ;
2016-02-27 03:17:06 +01:00
}
2016-09-24 22:37:25 +02:00
public String getCaption ( ) {
return caption ;
}
public SendAudio setCaption ( String caption ) {
this . caption = caption ;
return this ;
}
2018-02-14 20:36:22 +01:00
public String getParseMode ( ) {
return parseMode ;
}
public SendAudio setParseMode ( String parseMode ) {
this . parseMode = parseMode ;
return this ;
}
2018-07-27 00:27:26 +02:00
public InputFile getThumb ( ) {
return thumb ;
}
public SendAudio setThumb ( InputFile thumb ) {
this . thumb = thumb ;
return this ;
}
2016-11-17 02:41:12 +01:00
@Override
public Message deserializeResponse ( String answer ) throws TelegramApiRequestException {
try {
ApiResponse < Message > result = OBJECT_MAPPER . readValue ( answer ,
new TypeReference < ApiResponse < Message > > ( ) { } ) ;
if ( result . getOk ( ) ) {
return result . getResult ( ) ;
} else {
throw new TelegramApiRequestException ( " Error sending audio " , result ) ;
}
} catch ( IOException e ) {
throw new TelegramApiRequestException ( " Unable to deserialize response " , e ) ;
}
}
@Override
public void validate ( ) throws TelegramApiValidationException {
if ( chatId = = null ) {
throw new TelegramApiValidationException ( " ChatId parameter can't be empty " , this ) ;
}
2018-07-27 00:27:26 +02:00
if ( audio = = null ) {
throw new TelegramApiValidationException ( " Audio parameter can't be empty " , this ) ;
}
audio . validate ( ) ;
if ( thumb ! = null ) {
thumb . validate ( ) ;
2016-11-17 02:41:12 +01:00
}
if ( replyMarkup ! = null ) {
replyMarkup . validate ( ) ;
}
}
2016-03-08 20:17:07 +01:00
@Override
public String toString ( ) {
return " SendAudio{ " +
2016-09-24 22:37:25 +02:00
" duration= " + duration +
" , chatId=' " + chatId + '\'' +
2018-07-27 00:27:26 +02:00
" , audio= " + audio +
2016-06-20 20:50:03 +02:00
" , replyToMessageId= " + replyToMessageId +
2016-09-24 22:37:25 +02:00
" , disableNotification= " + disableNotification +
2016-06-20 20:50:03 +02:00
" , replyMarkup= " + replyMarkup +
2016-03-08 20:17:07 +01:00
" , performer=' " + performer + '\'' +
" , title=' " + title + '\'' +
2018-02-14 20:36:22 +01:00
" , caption=' " + caption + '\'' +
" , parseMode=' " + parseMode + '\'' +
2018-07-27 00:27:26 +02:00
" , thumb= " + thumb +
2016-03-08 20:17:07 +01:00
'}' ;
}
2016-01-14 01:14:53 +01:00
}