tencent cloud

フィードバック

Android

最終更新日:2022-11-21 16:34:34

    ここではTUICallKitのユーザーインターフェースをカスタマイズする方法についてご説明します。インターフェース微調整自身でのUI実装という2つのソリューションをご用意しています。

    方法1:インターフェース微調整ソリューション

    ご提供するUIソースコードを直接変更することで、TUICallKitのユーザーインターフェースを調整します。TUICallKitのインターフェースソースコードはGithubAndroid/tuicallkitフォルダにあります。

    アイコンの置き換え

    res\drawable-xxhdpiフォルダ内のアイコンを直接置き換え、App全体のアイコンの色やスタイルに統一性を持たせることができます。置き換える際にアイコンファイルの名前を変更しないようにしてください。

    img

    着信音の置き換え

    res\rawフォルダ内の3つのオーディオファイルを置き換えることで、着信音の置き換えができます。

    ファイル名 用途
    phone_dialing.mp3 呼び出し開始時の音声
    phone_hangup.mp3 通話終了の音声
    phone_ringing.mp3 呼び出し応答時の音声

    テキストの置き換え

    values-zhおよびvalues-en内のstrings.xmlファイルを変更することで、ビデオ通話画面内の文字列の内容を変更できます。

    方法2:自身でのUI実装ソリューション

    TUICallKitの通話機能全体はTUICallEngineというUIレスコンポーネントをベースにして実装されています。tuicallkitフォルダを削除し、TUICallEngineを完全にベースにしてご自身のUIを実装することが可能です。

    TUICallEngine

    TUICallEngine APIは通話コンポーネント全体の基盤インターフェースです。主に1対1オーディオビデオ通話およびグループ内通話の開始、応答、拒否、終了、デバイス操作などの重要なインターフェースを提供します。

    API 説明
    createInstance TUICallEngineインスタンスの作成(シングルトンモード)
    destroyInstance TUICallEngineインスタンスの破棄(シングルトンモード)
    init オーディオビデオ通話基本機能の認証完了
    addObserver イベントコールバックの追加
    removeObserver コールバックインターフェースの削除
    call 1v1通話の開始
    groupCall グループ通話の開始
    accept 通話応答
    reject 通話拒否
    hangup 通話終了
    ignore 通話を無視
    inviteUser グループ通話中に他の人を招待
    joinInGroupCall 現在のグループ通話に自主的に参加
    switchCallMediaType 通話メディアタイプの切り替え。ビデオ通話からオーディオ通話への切り替えなど
    startRemoteView リモートユーザービデオストリームのサブスクリプション開始
    stopRemoteView リモートユーザービデオストリームのサブスクリプション停止
    openCamera カメラの起動
    closeCamera カメラの終了
    switchCamera フロント/リアカメラの切り替え
    openMicrophone マイクをオンにする
    closeMicrophone マイクをオフにする
    selectAudioPlaybackDevice オーディオ再生デバイスの選択(ヘッドホン/スピーカー)
    setSelfInfo ユーザーのニックネーム、プロフィール画像の設定
    enableMultiDeviceAbility TUICallEngineのマルチデバイスログインモードのオン/オフ (プレミアム版パッケージのみサポート)

    TUICallObserver

    TUICallObserverはTUICallEngineに対応するコールバックイベントクラスです。このコールバックによって、関心のあるコールバックイベントを監視することができます。

    API 説明
    onError 通話中のエラーコールバック
    onCallReceived 通話リクエストのコールバック
    onCallCancelled 通話キャンセルのコールバック
    onCallBegin 通話接続のコールバック
    onCallEnd 通話終了のコールバック
    onCallMediaTypeChanged 通話メディアタイプ変更発生のコールバック
    onUserReject xxxxユーザーによる通話拒否のコールバック
    onUserNoResponse xxxxユーザーの応答なしのコールバック
    onUserLineBusy xxxxユーザーが通話中である場合のコールバック
    onUserJoin xxxxユーザーの通話参加のコールバック
    onUserLeave xxxxユーザーの通話からの退出のコールバック
    onUserVideoAvailable xxxユーザーのビデオストリームの有無のコールバック
    onUserAudioAvailable xxxユーザーのオーディオストリームの有無のコールバック
    onUserVoiceVolumeChanged 全ユーザーの音量レベルフィードバックのコールバック
    onUserNetworkQualityChanged 全ユーザーのネットワーク品質フィードバックのコールバック

    主要なタイプの定義

    API 説明
    TUICallDefine.MediaType 通話のメディアタイプ。列挙タイプ:ビデオ通話、音声通話
    TUICallDefine.Role 通話のロール。列挙タイプ:発呼側、着呼側
    TUICallDefine.Status 通話の状態。列挙タイプ:アイドル状態、応答待ち、応答中
    TUICommonDefine.RoomId オーディオビデオルームID。数字、文字列の2種類をサポートしています
    TUICommonDefine.Camera カメラIDパラメータ。列挙タイプ:フロントカメラ、リアカメラ
    TUICommonDefine.AudioPlaybackDevice 音声再生デバイス。列挙タイプ:スピーカー、ヘッドホン
    TUICommonDefine.NetworkQualityInfo 現在のネットワーク品質情報
    お問い合わせ

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

    テクニカルサポート

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

    電話サポート(24 時間365日対応)