Docs Overview/
Call/
Android/
基本機能/
UI のカスタマイズ/

UI のカスタマイズ

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

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

ご提供するUIソースコードを直接変更することで、TUICallKitのユーザーインターフェースを調整します。TUICallKitのインターフェースソースコードはGithubのAndroid/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
説明
TUICallEngineインスタンスの作成（シングルトンモード）
TUICallEngineインスタンスの破棄（シングルトンモード）
オーディオビデオ通話基本機能の認証完了
イベントコールバックの追加
コールバックインターフェースの削除
1v1通話の開始
グループ通話の開始
通話応答
通話拒否
通話終了
通話を無視
グループ通話中に他の人を招待
現在のグループ通話に自主的に参加
通話メディアタイプの切り替え。ビデオ通話からオーディオ通話への切り替えなど
リモートユーザービデオストリームのサブスクリプション開始
リモートユーザービデオストリームのサブスクリプション停止
カメラの起動
カメラの終了
フロント/リアカメラの切り替え
マイクをオンにする
マイクをオフにする
オーディオ再生デバイスの選択（ヘッドホン/スピーカー）
ユーザーのニックネーム、プロフィール画像の設定
TUICallEngineのマルチデバイスログインモードのオン/オフ （プレミアム版パッケージのみサポート）

TUICallObserver

TUICallObserverはTUICallEngineに対応するコールバックイベントクラスです。このコールバックによって、関心のあるコールバックイベントを監視することができます。
API
説明
通話中のエラーコールバック
通話リクエストのコールバック
通話キャンセルのコールバック
通話接続のコールバック
通話終了のコールバック
通話メディアタイプ変更発生のコールバック
xxxxユーザーによる通話拒否のコールバック
xxxxユーザーの応答なしのコールバック
xxxxユーザーが通話中である場合のコールバック
xxxxユーザーの通話参加のコールバック
xxxxユーザーの通話からの退出のコールバック
xxxユーザーのビデオストリームの有無のコールバック
xxxユーザーのオーディオストリームの有無のコールバック
全ユーザーの音量レベルフィードバックのコールバック
全ユーザーのネットワーク品質フィードバックのコールバック

主要なタイプの定義

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