Tencent Cloud

Recent Pages

TRTCKaraoke(Android)

最終更新日:2024-07-19 15:32:54

TRTCKaraokeRoomは、Tencent CloudのTRTCおよびIMサービスを基に組み合わせたコンポーネントで、以下の機能をサポートしています。
管理者が作成した新しいKaraokeルームが配信を開始すると、リスナーはKaraokeルームに入室して聴取/インタラクションを行います。
管理者は、楽曲の順序を管理し、マイク・オンのキャスターをキックアウトすることもできます。
管理者はまた、座席をクローズすることができ、その他のリスナーはマイク・オンを申請することができなくなります。
リスナーはマイク・オンを申請して、マイク・オンのキャスターになり、マイク・オン後は楽曲の選択や歌唱ができるようになります。また、いつでもマイク・オフにして、通常のリスナーになることも可能です。
ギフトや各種のテキストメッセージ、カスタムメッセージの送信をサポートします。カスタムメッセージを弾幕、「いいね」などを実装するために使用することができます。
説明：
TUIKitシリーズコンポーネントはTencent CloudのTRTCとIMという2つの基本的なPaaSサービスを同時に使用し、TRTCをアクティブにした後、IMサービスを同期的にアクティブにすることができます。IMサービスの課金ルールの詳細については、Instant Messagingの料金説明をご参照ください。TRTCをアクティブにすると、デフォルトでは、100DAUまでサポートするIM SDK体験版もアクティブになります。
TRTCKaraokeRoomはオープンソースのClassであり、Tencent Cloudの2つのクローズドソースのSDKに依存しています。具体的な実装プロセスについては、Karaoke (Android)をご参照ください。
TRTC SDK：TRTC SDKを低遅延のボイスチャットコンポーネントとして使用しています。
IM SDK：IM SDKのAVChatroomを使用してチャットルーム機能を実装します。同時にIMの属性インターフェースによって、マイクリストなどのルーム情報を保存し、招待シグナリングはマイク・オン/ピックのリクエストに用いることができます。
TRTCKaraokeRoom API概要
SDK基本関数
API
説明
sharedInstance
シングルトンオブジェクトを取得します。
destroySharedInstance
シングルトンオブジェクトを廃棄します。
setDelegate
イベントコールバックを設定します。
setDelegateHandler
イベントのコールバックが配置されているスレッドを設定します。
login
ログイン。
logout
ログアウト。
setSelfProfile
個人情報を修正します。
ルーム関連インターフェース関数
API
説明
createRoom
ルームの作成（管理者が呼び出し）。ルームが存在しない場合は、システムが新しいルームを自動的に作成します。
destroyRoom
ルームの破棄（管理者が呼び出し）。
enterRoom
入室（リスナーが呼び出し）。
exitRoom
退室（リスナーが呼び出し）。
getRoomInfoList
ルームリストの詳細情報を取得します。
getUserInfoList
指定されたuserIdのユーザー情報を取得します。 nullの場合は、ルーム内全員の情報を取得します。
音楽再生インターフェース
API
説明
startPlayMusic
音楽の再生を開始します。
stopPlayMusic
音楽の再生を停止します。
pausePlayMusic
音楽の再生を一時停止します。
resumePlayMusic
音楽の再生を再開します。
マイク管理インターフェース
API
説明
enterSeat
ユーザーが発言者になる（リスナー側/管理者ともに呼び出し可）。
leaveSeat
ユーザーが視聴者になる（キャスターが呼び出し）。
pickSeat
視聴者が発言できるように招待（管理者が呼び出し）。
kickSeat
キックアウトしてマイク・オフ（管理者が呼び出し）。
muteSeat
任意のマイクのミュート/ミュート解除（管理者が呼び出し）。
closeSeat
任意のマイクのクローズ/解除（管理者が呼び出し）。
ローカルのオーディオ操作インターフェース
API
説明
startMicrophone
マイクの集音開始。
stopMicrophone
マイクの集音停止。
setAudioQuality
音質の設定。
muteLocalAudio
ローカルオーディオミュートの開始/停止。
setSpeaker
スピーカーの起動設定。
setAudioCaptureVolume
マイクの集音音量設定。
setAudioPlayoutVolume
再生音量の設定。
setVoiceEarMonitorEnable
インイヤーモニタリングのオン/オフ。
リモートユーザー音声操作インターフェース
API
説明
muteRemoteAudio
指定メンバーをミュート/ミュート解除。
muteAllRemoteAudio
全メンバーをミュート/ミュート解除。
BGMサウンドエフェクト関連インターフェース
API
説明
getAudioEffectManager
BGMサウンドエフェクト管理オブジェクトTXAudioEffectManagerを取得します。
メッセージ送信関連インターフェース
API
説明
sendRoomTextMsg
ルーム内でのテキストメッセージのブロードキャスト。通常、弾幕によるチャットに使用します。
sendRoomCustomMsg
カスタマイズしたテキストメッセージを送信します。
招待シグナリング関連インターフェース
API
説明
sendInvitation
ユーザーに招待を送信。
acceptInvitation
招待の同意。
rejectInvitation
招待の辞退。
cancelInvitation
招待の取り消し。
TRTCKaraokeRoomDelegate API概要
一般的なイベントコールバック
API
説明
onError
エラーのコールバック。
onWarning
警告のコールバック。
onDebugLog
Logコールバック。
ルームイベントのコールバック
API
説明
onRoomDestroy
ルームが廃棄された時のコールバック。
onRoomInfoChange
Karaoke情報変更のコールバック。
onUserVolumeUpdate
ユーザー通話音量のコールバック。
マイク変更コールバック
API
説明
onSeatListChange
全量のマイクリストの変更。
onAnchorEnterSeat
発言者のメンバーがいます（ユーザーが発言者になります/管理者が視聴者を発言できるように招待）。
onAnchorLeaveSeat
視聴者のメンバーがいます（ユーザーが視聴者になる/管理者がキックアウトしてマイク・オフ）。
onSeatMute
管理者のマイクミュート。
onUserMicrophoneMute
ユーザーのマイクがミュートされているかどうか。
onSeatClose
管理者のマイククローズ。
リスナーの入退室イベントのコールバック
API
説明
onAudienceEnter
リスナー入室通知の受信。
onAudienceExit
リスナー退室通知の受信。
メッセージイベントのコールバック
API
説明
onRecvRoomTextMsg
テキストメッセージを受信します。
onRecvRoomCustomMsg
カスタムメッセージを受信します。
シグナリングイベントのコールバック
API
説明
onReceiveNewInvitation
新規招待リクエストの受信。
onInviteeAccepted
被招待者が招待に同意。
onInviteeRejected
被招待者が招待を拒否。
onInvitationCancelled
招待者が招待を取り消し。
楽曲イベントコールバック
API
説明
onMusicProgressUpdate
楽曲再生進捗度のコールバック。
onMusicPrepareToPlay
音楽再生準備のコールバック。
onMusicCompletePlaying
音楽再生完了のコールバック。
SDK基本関数
sharedInstance
TRTCKaraokeRoomシングルトンオブジェクトを取得します。
 public static synchronized TRTCKaraokeRoom sharedInstance(Context context);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
context
Context
Androidコンテキスト。内部ではApplicationContextに変換してシステムAPIの呼び出しに使用します
destroySharedInstance
TRTCKaraokeRoomシングルトンオブジェクトを破棄します。
説明：
インスタンスの破棄後は、外部にキャッシュされたTRTCKaraokeRoomインスタンスの再使用ができません。改めてsharedInstanceを呼び出し、インスタンスを新規取得してください。
public static void destroySharedInstance();
setDelegate
TRTCKaraokeRoomイベントコールバック。 TRTCKaraokeRoomDelegate を介してTRTCKaraokeLiveRoomの各種ステータス通知を受け取ることができます。
public abstract void setDelegate(TRTCKaraokeRoomDelegate delegate);
説明：
setDelegateはTRTCKaraokeRoomのプロキシコールバックです。   
setDelegateHandler
イベントコールバックが配置されているスレッドを設定します。
public abstract void setDelegateHandler(Handler handler);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
handler
Handler
TRTCKaraokeRoomの各種ステータス通知は、指定したhandlerスレッドに発信されます。
login
ログイン。
public abstract void login(int sdkAppId,
 String userId, String userSig,
TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
sdkAppId
int
TRTCコンソール> 【アプリケーション管理】>アプリケーション情報の中でSDKAppIDを確認できます。
userId
String
現在のユーザーID。文字列タイプであり、英語のアルファベット（a-zとA-Z）、数字（0-9）、ハイフン（-）とアンダーライン（_）のみ使用できます。
userSig
String
Tencent Cloudによって設計されたセキュリティ保護署名。取得方法については、 UserSigの計算、使用方法をご参照ください。
callback
ActionCallback
ログインのコールバック。成功時にcodeは0になります。
logout
ログアウト。
public abstract void logout(TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
callback
ActionCallback
ログアウトのコールバック。成功時にcodeは0になります。
setSelfProfile
個人情報の修正。
public abstract void setSelfProfile(String userName, String avatarURL, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userName
String
ニックネーム。
avatarURL
String
プロフィール画像のアドレス。
callback
ActionCallback
個人情報設定のコールバック。成功時にcodeは0になります。
ルーム関連インターフェース関数
createRoom
ルームの作成（管理者が呼び出し）：
public abstract void createRoom(int roomId, TRTCKaraokeRoomDef.RoomParam roomParam, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです。
パラメータ
タイプ
意味
roomI
int
ルームIDは、ご自身でアサインし、一元管理してください。複数のroomIDを、一つのKaraokeルームリストにまとめることができます。Tencent Cloudでは現在、Karaokeルームリストの管理サービスを行っていませんので、ご自身でKaraokeルームリストを管理してください。
roomParam
TRTCCreateRoomParam
ルーム情報です。ルーム名、マイク情報、カバー情報など、ルームを説明するために用いる情報に使用します。マイク管理が必要な場合は、ルームのマイク数を記入してください。
callback
ActionCallback
ルームの新規作成結果のコールバック。成功時にcodeは0になります。
管理者が配信を開始する際の通常の呼び出しプロセスは次のとおりです： 
1. 管理者は、createRoomを呼び出して新しいKaraokeルームを作成します。この時、ルームID、マイク・オンにすることの管理者の確認の要否、ルームタイプなどルームの属性情報を渡します。
2. 管理者は、ルーム作成に成功した後、enterSeatを呼び出して参加します。
3. 管理者は、コンポーネントのonSeatListChangeマイクリスト変更イベント通知を受信します。この時、マイクリストの変更をUI上で更新することができます。
4. 管理者は、マイクリストのメンバーが参加したonAnchorEnterSeatというイベント通知も受信します。この時、マイク集音は自動的に開始されます。
destroyRoom
ルームの破棄（管理者が呼び出し）。管理者は、ルーム作成後、この関数を呼び出してルームを破棄します。
public abstract void destroyRoom(TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
callback
ActionCallback
ルームの廃棄結果のコールバック。成功時にcodeは0になります。
enterRoom
入室（リスナーが呼び出し）。
public abstract void enterRoom(int roomId, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
roomId
int
ルームID。
callback
ActionCallback
入室結果のコールバック。成功時にcodeは0になります。
リスナーが入室し聴取する際の通常の呼び出しプロセスは次のとおりです： 
1. リスナーがサーバーから取得する最新のKaraokeルームリストには、多くのKaraokeルームのroomIdおよびルーム情報が含まれる場合があります。
2. リスナーは1つのKaraokeルームを選択し、enterRoomを呼び出してルームナンバーを渡すと、そのルームに参加できます。
3. 入室後、コンポーネントのonRoomInfoChangeルーム属性変更イベント通知を受信します。この時、ルーム属性を記録し、それに応じた修正を行うことができます。例：UIに表示するルーム名、マイク・オンの際の管理者への同意リクエストの要否の記録など。
4. 入室後は、コンポーネントのonSeatListChangeマイクリスト変更イベント通知を受信します。この時、マイクリストの変更をUI上に更新することができます。
5. 入室後に、マイクリストにキャスターが参加したonAnchorEnterSeatのイベント通知も受信します。
exitRoom
ルームから退出します。
public abstract void exitRoom(TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
callback
ActionCallback
退室結果のコールバック。成功時にcodeは0になります。
getRoomInfoList
ルームリストの詳細情報を取得します。このうち、ルーム名、ルームカバーは、管理者がcreateRoom()作成時にroomInfoによって設定したものになります。
説明：
ルームリストおよびルーム情報をご自身で管理する場合は、この関数は無視できます。
public abstract void getRoomInfoList(List<Integer> roomIdList, TRTCKaraokeRoomCallback.RoomInfoCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
roomIdList
List<Integer>
ルームナンバーリスト。
callback
RoomInfoCallback
ルーム詳細情報のコールバック。
getUserInfoList
指定されたuserIdのユーザー情報を取得します。
public abstract void getUserInfoList(List<String> userIdList, TRTCKaraokeRoomCallback.UserListCallback userlistcallback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userIdList
List<String>
取得すべきユーザーIDリスト。nullの場合は、ルーム内全員の情報を取得します。
userlistcallback
UserListCallback
ユーザーの詳細情報のコールバック。
音楽再生インターフェース
startPlayMusic
音楽を再生します（マイク・オン後に呼び出し）。
説明：
音楽を再生すると、onMusicPrepareToPlayというイベント通知を受信します。
音楽の再生中、ルーム内の全メンバーは、onMusicProgressUpdateというイベント通知を継続して受け取ります。
音楽の再生が完了すると、onMusicCompletePlayingというイベント通知を受信します。
public abstract void startPlayMusic(int musicID, String originalUrl, String accompanyUrl);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
musicID
int
音楽のID。
originalUrl
String
原曲の絶対パス。
accompanyUrl
String
伴奏の絶対パス。
このインターフェースを呼び出すと、最後に再生されていた楽曲が停止します。
stopPlayMusic
音楽の再生を停止します（音楽を再生するときに呼び出します）。
説明：
再生が停止すると、onMusicCompletePlayingというイベント通知を受信します。
public abstract void stopPlayMusic();
pausePlayMusic
音楽の再生を一時停止します（音楽を再生するときに呼び出します）。
説明：
onMusicProgressUpdateというイベント通知が一時停止されます
onMusicCompletePlayingというイベント通知を受信しません。
public abstract void pausePlayMusic();
resumePlayMusic
一時停止した音楽を再開します（一時停止後に呼び出します）。
説明：
onMusicPrepareToPlayというイベント通知を受信しません。
public abstract void resumePlayMusic();
マイク管理インターフェース
enterSeat
ユーザーが発言者になります（リスナー側/管理者ともに呼び出し可）。
説明：
マイク・オンの成功後、ルーム内の全メンバーは、onSeatListChangeおよびonAnchorEnterSeatというイベント通知を受信します。
public abstract void enterSeat(int seatIndex, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
seatIndex
int
マイク・オンの必要があるマイク番号。
callback
ActionCallback
操作コールバック。
このインターフェースを呼び出すと、直ちにマイクリストが変更されます。リスナーによるマイク・オンの申請に管理者の同意が必要となるケースの場合は、まずsendInvitationを呼び出してから管理者に申請し、onInvitationAcceptを受信するとこの関数を呼び出せるようになります。
leaveSeat
ユーザーが視聴者になります（キャスターが呼び出し）。
説明：
マイク・オフの成功後、ルーム内の全メンバーは、onSeatListChangeおよびonAnchorLeaveSeatというイベント通知を受信します。
public abstract void leaveSeat(TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
callback
ActionCallback
操作コールバック。
pickSeat
視聴者が発言できるように招待（管理者が呼び出し）。
説明：
管理者が視聴者を発言できるように招待すると、ルーム内の全メンバーは、onSeatListChangeとonAnchorEnterSeatというイベント通知を受信します。
public abstract void pickSeat(int seatIndex, String userId, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
seatIndex
int
視聴者が発言できるように招待する必要があるマイク番号。
userId
String
ユーザーID。
callback
ActionCallback
操作コールバック。
このインターフェースを呼び出すと、すぐにマイクリストが修正されます。管理者がリスナーの同意がなければマイク・オンできないケースの場合は、まずsendInvitationを呼び出してからリスナーに申請し、onInvitationAcceptを受信すると、この関数をコールできるようになります。
kickSeat
キックアウトしてマイク・オフ（管理者が呼び出し）。
説明：
管理者がキックアウトしてマイク・オフにすると、ルーム内の全メンバーは、onSeatListChangeおよびonAnchorLeaveSeatというイベント通知を受信します。
public abstract void kickSeat(int seatIndex, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
seatIndex
int
キックアウトしてマイク・オフの必要があるマイク番号。
callback
ActionCallback
操作コールバック。
このインターフェースを呼び出すと、すぐにマイクリストが修正されます。
muteSeat
任意のマイクのミュート/ミュート解除（管理者が呼び出し）。
説明：
任意のマイクをミュート/ミュート解除します。ルーム内の全メンバーがonSeatListChangeおよびonSeatMuteというイベント通知を受信します。
public abstract void muteSeat(int seatIndex, boolean isMute, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
seatIndex
int
操作の必要があるマイク番号。
isMute
boolean
true：該当するマイクをミュートします；false：該当するマイクをミュート解除します。
callback
ActionCallback
操作コールバック。
このインターフェースを呼び出すと、直ちにマイクリストが変更されます。seatIndexの座席に該当するキャスターは、muteAudioを自動的に呼び出してミュート/ミュート解除にします。
closeSeat
任意のマイクのクローズ/解除（管理者が呼び出し）。
説明：
管理者は、該当するマイクをクローズ/解除し、ルーム内の全メンバーはonSeatListChangeおよびonSeatCloseというイベント通知を受信します。
public abstract void closeSeat(int seatIndex, boolean isClose, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
seatIndex
int
操作の必要があるマイク番号。
isClose
boolean
true：該当するマイクをクローズします； false：該当するマイクをクローズ解除します。
callback
ActionCallback
操作コールバック。
このインターフェースを呼び出すと、すぐにマイクリストが修正されます。該当するseatIndexの座席上のキャスターはクローズされ、自動的にマイク・オフになります。
ローカル音声操作のインターフェース
startMicrophone
マイクの集音開始。
public abstract void startMicrophone();
stopMicrophone
マイクの集音停止。
public abstract void stopMicrophone();
setAudioQuality
音質の設定。
public abstract void setAudioQuality(int quality);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
quality
int
音声品質。詳細は TRTC SDKをご参照ください。
muteLocalAudio
ローカルの音声のミュート/ミュート取り消し。
public abstract void muteLocalAudio(boolean mute);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
mute
boolean
ミュート/ミュート取り消し。詳細は TRTC SDKをご参照ください。
setSpeaker
スピーカーの起動設定。
public abstract void setSpeaker(boolean useSpeaker);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
useSpeaker
boolean
true：スピーカー、false：ヘッドホン。
setAudioCaptureVolume
マイクの集音音量設定。
public abstract void setAudioCaptureVolume(int volume);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
volume
int
集音音量、0 - 100、 デフォルト100。
setAudioPlayoutVolume
再生音量の設定。
public abstract void setAudioPlayoutVolume(int volume);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
volume
int
再生音量、0 - 100、 デフォルト100。
muteRemoteAudio
指定メンバーのミュート/ミュート解除。
public abstract void muteRemoteAudio(String userId, boolean mute);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userId
String
指定ユーザーID。
mute
boolean
true：ミュート起動；false：ミュート停止。
muteAllRemoteAudio
全メンバーのミュート/ミュート解除。
public abstract void muteAllRemoteAudio(boolean mute);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
mute
boolean
true：ミュート起動；false：ミュート停止。
setVoiceEarMonitorEnable
インイヤーモニタリングのオン/オフ。
public abstract void setVoiceEarMonitorEnable(boolean enable);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
enable
boolean
true：インイヤーモニタリングをオン。false：インイヤーモニタリングをオフ。
BGMサウンドエフェクト関連インターフェース関数
getAudioEffectManager
BGMサウンドエフェクト管理オブジェクト TXAudioEffectManagerを取得します。
public abstract TXAudioEffectManager getAudioEffectManager();
メッセージ送信関連インターフェース関数
sendRoomTextMsg
ルーム内でテキストメッセージをブロードキャストします。通常、弾幕によるチャットに使用します。
public abstract void sendRoomTextMsg(String message, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
message
String
テキストメッセージ。
callback
ActionCallback
送信結果のコールバック。
sendRoomCustomMsg
カスタマイズしたテキストメッセージを送信します。
public abstract void sendRoomCustomMsg(String cmd, String message, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
cmd
String
コマンドワードです。開発者がカスタマイズするものであり、主にさまざまなメッセージタイプを区別するために使用されます。
message
String
テキストメッセージ。
callback
ActionCallback
送信結果のコールバック。
招待シグナリング関連インターフェース
sendInvitation
ユーザーに招待を送信。
public abstract String sendInvitation(String cmd, String userId, String content, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
cmd
String
業務カスタマイズコマンド。
userId
String
招待ユーザーID。
content
String
招待コンテンツ。
callback
ActionCallback
送信結果のコールバック。
戻り値：
戻り値
タイプ
意味
inviteId
String
今回の招待IDの識別に使用。
acceptInvitation
招待の同意。
public abstract void acceptInvitation(String id, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
callback
ActionCallback
送信結果のコールバック。
rejectInvitation
招待の拒否。
public abstract void rejectInvitation(String id, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
callback
ActionCallback
送信結果のコールバック。
cancelInvitation
招待の取り消し。
public abstract void cancelInvitation(String id, TRTCKaraokeRoomCallback.ActionCallback callback);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
callback
ActionCallback
送信結果のコールバック。
TRTCKaraokeRoomDelegateイベントコールバック
一般的なイベントコールバック
onError
エラーのコールバック。
説明：
SDKリカバリー不能なエラーは必ず監視し、状況に応じてユーザーに適切なインターフェースプロンプトを表示します。
void onError(int code, String message);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
code
int
エラーコード。
message
String
エラーメッセージ。
onWarning
警告のコールバック。
void onWarning(int code, String message);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
code
int
エラーコード。
message
String
警告メッセージ。
onDebugLog
Logコールバック。
void onDebugLog(String message);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
message
String
ログ情報。
ルームイベントのコールバック
onRoomDestroy
ルーム破棄のコールバック。管理者がルームを解散するとき、ルーム内の全ユーザーはこの通知を受信します。
void onRoomDestroy(String roomId);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
roomId
String
ルームID。
onRoomInfoChange
入室に成功後、このインターフェースをコールバックします。roomInfoの情報は、管理者がルームを作成するときに渡されます。
void onRoomInfoChange(TRTCKaraokeRoomDef.RoomInfo roomInfo);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
roomInfo
RoomInfo
ルーム情報。
onUserMicrophoneMute
ユーザーのマイクがミュートになっているかどうかについて、ユーザーがmuteLocalAudioを呼び出すと、ルームの他のユーザーがこの通知を受信します。
void onUserMicrophoneMute(String userId, boolean mute);
﻿
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userId
String
ユーザーID。
mute
boolean
音量の大きさ。値：0～100。
onUserVolumeUpdate
音量レベルリマインダを有効にすると、各メンバーの音量を通知します。
void onUserVolumeUpdate(List<TRTCCloudDef.TRTCVolumeInfo> userVolumes, int totalVolume);
﻿
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userVolumes
List
ユーザーリスト。
totalVolume
int
音量の大きさ。値：0～100。
マイクコールバック
onSeatListChange
全量のマイクリストの変更です。全てのマイクリストを含みます。
void onSeatListChange(List<SeatInfo> seatInfoList);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
seatInfoList
List<SeatInfo>
全量のマイクリスト。
onAnchorEnterSeat
発言者のメンバーがいます（ユーザーが発言者になる/管理者が視聴者を発言できるように招待）。
void onAnchorEnterSeat(int index, TRTCKaraokeRoomDef.UserInfo user);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
index
int
メンバーがマイク・オンのマイク。
user
UserInfo
マイク・オンのユーザーの詳細情報。
onAnchorLeaveSeat
視聴者のメンバーがいます（ユーザーが視聴者になる/管理者がキックアウトしてマイク・オフ）。
void onAnchorLeaveSeat(int index, TRTCKaraokeRoomDef.UserInfo user);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
index
int
マイク・オフのマイク。
user
UserInfo
マイク・オフのユーザーの詳細情報。
onSeatMute
管理者のマイクミュート。
void onSeatMute(int index, boolean isMute);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
index
int
操作するマイク。
isMute
boolean
true：マイクミュート； false：ミュート解除。
onSeatClose
管理者のマイククローズ。
void onSeatClose(int index, boolean isClose);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
index
int
操作するマイク。
isClose
boolean
true：マイクのクローズ； false：マイクのクローズ解除。
リスナーの入退室イベントのコールバック
onAudienceEnter
リスナー入室通知の受信。
void onAudienceEnter(TRTCKaraokeRoomDef.UserInfo userInfo);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userInfo
UserInfo
入室したリスナーの情報。
onAudienceExit
リスナー退室通知の受信。
void onAudienceExit(TRTCKaraokeRoomDef.UserInfo userInfo);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
userInfo
UserInfo
退室したリスナーの情報。
メッセージイベントのコールバック
onRecvRoomTextMsg
テキストメッセージを受信します。
void onRecvRoomTextMsg(String message, TRTCKaraokeRoomDef.UserInfo userInfo);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
message
String
テキストメッセージ。
userInfo
UserInfo
送信者のユーザー情報。
onRecvRoomCustomMsg
カスタムメッセージを受信します。
void onRecvRoomCustomMsg(String cmd, String message, TRTCKaraokeRoomDef.UserInfo userInfo);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
command
String
コマンドワードです。開発者がカスタマイズするもので、主にさまざまなメッセージタイプを区別するために使用されます。
message
String
テキストメッセージ。
userInfo
UserInfo
送信者のユーザー情報。
招待シグナリングイベントのコールバック
onReceiveNewInvitation
新規招待リクエストの受信。
void onReceiveNewInvitation(String id, String inviter, String cmd, String content);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
inviter
String
招待者のユーザーID。
cmd
String
開発者がカスタマイズする業務指定のコマンドワードです。
content
String
業務指定のコンテンツ。
onInviteeAccepted
被招待者が招待に同意。
void onInviteeAccepted(String id, String invitee);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
invitee
String
被招待者のユーザーID。
onInviteeRejected
被招待者による招待の拒否。
void onInviteeRejected(String id, String invitee);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
invitee
String
被招待者のユーザーID。
onInvitationCancelled
招待者が招待を取り消し。
void onInvitationCancelled(String id, String inviter);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
id
String
招待ID。
inviter
String
招待者のユーザーID。
音楽再生ステータスコールバック
onMusicPrepareToPlay
音楽再生準備のコールバック
void onMusicPrepareToPlay(int musicID);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
musicID
int
再生時に渡されたmusicID。
onMusicProgressUpdate
楽曲再生進捗度のコールバック
void onMusicProgressUpdate(int musicID, long progress, long total);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
musicID
int
再生時に渡されたmusicID。
progress
long
現在の再生時間。単位： ms。
total
long
合計時間。単位： ms。
onMusicCompletePlaying
音楽再生完了のコールバック
void onMusicCompletePlaying(int musicID);
パラメータは下表に示すとおりです：
パラメータ
タイプ
意味
musicID
int
再生時に渡されたmusicID。

お問い合わせ

カスタマーサービスをご提供できるため、ぜひお気軽にお問い合わせくださいませ。

テクニカルサポート

さらにサポートが必要な場合は、サポートチケットを送信して弊社サポートチームにお問い合わせください。24時間365日のサポートをご提供します。

電話サポート（24 時間365日対応）

API	説明
sharedInstance	シングルトンオブジェクトを取得します。
destroySharedInstance	シングルトンオブジェクトを廃棄します。
setDelegate	イベントコールバックを設定します。
setDelegateHandler	イベントのコールバックが配置されているスレッドを設定します。
login	ログイン。
logout	ログアウト。
setSelfProfile	個人情報を修正します。

API	説明
createRoom	ルームの作成（管理者が呼び出し）。ルームが存在しない場合は、システムが新しいルームを自動的に作成します。
destroyRoom	ルームの破棄（管理者が呼び出し）。
enterRoom	入室（リスナーが呼び出し）。
exitRoom	退室（リスナーが呼び出し）。
getRoomInfoList	ルームリストの詳細情報を取得します。
getUserInfoList	指定されたuserIdのユーザー情報を取得します。 nullの場合は、ルーム内全員の情報を取得します。

API	説明
startPlayMusic	音楽の再生を開始します。
stopPlayMusic	音楽の再生を停止します。
pausePlayMusic	音楽の再生を一時停止します。
resumePlayMusic	音楽の再生を再開します。

API	説明
enterSeat	ユーザーが発言者になる（リスナー側/管理者ともに呼び出し可）。
leaveSeat	ユーザーが視聴者になる（キャスターが呼び出し）。
pickSeat	視聴者が発言できるように招待（管理者が呼び出し）。
kickSeat	キックアウトしてマイク・オフ（管理者が呼び出し）。
muteSeat	任意のマイクのミュート/ミュート解除（管理者が呼び出し）。
closeSeat	任意のマイクのクローズ/解除（管理者が呼び出し）。

API	説明
startMicrophone	マイクの集音開始。
stopMicrophone	マイクの集音停止。
setAudioQuality	音質の設定。
muteLocalAudio	ローカルオーディオミュートの開始/停止。
setSpeaker	スピーカーの起動設定。
setAudioCaptureVolume	マイクの集音音量設定。
setAudioPlayoutVolume	再生音量の設定。
setVoiceEarMonitorEnable	インイヤーモニタリングのオン/オフ。

API	説明
muteRemoteAudio	指定メンバーをミュート/ミュート解除。
muteAllRemoteAudio	全メンバーをミュート/ミュート解除。

API	説明
getAudioEffectManager	BGMサウンドエフェクト管理オブジェクトTXAudioEffectManagerを取得します。

API	説明
sendRoomTextMsg	ルーム内でのテキストメッセージのブロードキャスト。通常、弾幕によるチャットに使用します。
sendRoomCustomMsg	カスタマイズしたテキストメッセージを送信します。

API	説明
sendInvitation	ユーザーに招待を送信。
acceptInvitation	招待の同意。
rejectInvitation	招待の辞退。
cancelInvitation	招待の取り消し。

API	説明
onError	エラーのコールバック。
onWarning	警告のコールバック。
onDebugLog	Logコールバック。

API	説明
onRoomDestroy	ルームが廃棄された時のコールバック。
onRoomInfoChange	Karaoke情報変更のコールバック。
onUserVolumeUpdate	ユーザー通話音量のコールバック。

API	説明
onSeatListChange	全量のマイクリストの変更。
onAnchorEnterSeat	発言者のメンバーがいます（ユーザーが発言者になります/管理者が視聴者を発言できるように招待）。
onAnchorLeaveSeat	視聴者のメンバーがいます（ユーザーが視聴者になる/管理者がキックアウトしてマイク・オフ）。
onSeatMute	管理者のマイクミュート。
onUserMicrophoneMute	ユーザーのマイクがミュートされているかどうか。
onSeatClose	管理者のマイククローズ。

API	説明
onAudienceEnter	リスナー入室通知の受信。
onAudienceExit	リスナー退室通知の受信。

API	説明
onRecvRoomTextMsg	テキストメッセージを受信します。
onRecvRoomCustomMsg	カスタムメッセージを受信します。

API	説明
onReceiveNewInvitation	新規招待リクエストの受信。
onInviteeAccepted	被招待者が招待に同意。
onInviteeRejected	被招待者が招待を拒否。
onInvitationCancelled	招待者が招待を取り消し。

API	説明
onMusicProgressUpdate	楽曲再生進捗度のコールバック。
onMusicPrepareToPlay	音楽再生準備のコールバック。
onMusicCompletePlaying	音楽再生完了のコールバック。

パラメータ	タイプ	意味
context	Context	Androidコンテキスト。内部ではApplicationContextに変換してシステムAPIの呼び出しに使用します

戻り値	タイプ	意味
inviteId	String	今回の招待IDの識別に使用。

tencent cloud

サインアップ

ログイン

Recent Pages

TRTCKaraoke(Android)

TRTCKaraokeRoom API概要

SDK基本関数

ルーム関連インターフェース関数

音楽再生インターフェース

マイク管理インターフェース

ローカルのオーディオ操作インターフェース

リモートユーザー音声操作インターフェース

BGMサウンドエフェクト関連インターフェース

メッセージ送信関連インターフェース

招待シグナリング関連インターフェース

TRTCKaraokeRoomDelegate API概要

一般的なイベントコールバック

ルームイベントのコールバック

マイク変更コールバック

リスナーの入退室イベントのコールバック

メッセージイベントのコールバック

シグナリングイベントのコールバック

楽曲イベントコールバック

SDK基本関数

sharedInstance

destroySharedInstance

setDelegate

setDelegateHandler

login

logout

setSelfProfile

ルーム関連インターフェース関数

createRoom

destroyRoom

enterRoom

exitRoom

getRoomInfoList

getUserInfoList

音楽再生インターフェース

startPlayMusic

stopPlayMusic

pausePlayMusic

resumePlayMusic

マイク管理インターフェース

enterSeat

leaveSeat

pickSeat

kickSeat

muteSeat

closeSeat

ローカル音声操作のインターフェース

startMicrophone

stopMicrophone

setAudioQuality

muteLocalAudio

setSpeaker

setAudioCaptureVolume

setAudioPlayoutVolume

muteRemoteAudio

muteAllRemoteAudio

setVoiceEarMonitorEnable

BGMサウンドエフェクト関連インターフェース関数

getAudioEffectManager

メッセージ送信関連インターフェース関数

sendRoomTextMsg

sendRoomCustomMsg

招待シグナリング関連インターフェース

sendInvitation

acceptInvitation

rejectInvitation

cancelInvitation

TRTCKaraokeRoomDelegateイベントコールバック

一般的なイベントコールバック

onError

onWarning

onDebugLog

ルームイベントのコールバック

onRoomDestroy

onRoomInfoChange

onUserMicrophoneMute