TelecomManager.PlaceCall(Uri, Bundle) メソッド

定義

指定された追加のシステム 通信サービスを使用して、指定されたアドレスに新しい発信呼び出しを行います。

[Android.Runtime.Register("placeCall", "(Landroid/net/Uri;Landroid/os/Bundle;)V", "GetPlaceCall_Landroid_net_Uri_Landroid_os_Bundle_Handler", ApiSince=23)]
public virtual void PlaceCall(Android.Net.Uri? address, Android.OS.Bundle? extras);
[<Android.Runtime.Register("placeCall", "(Landroid/net/Uri;Landroid/os/Bundle;)V", "GetPlaceCall_Landroid_net_Uri_Landroid_os_Bundle_Handler", ApiSince=23)>]
abstract member PlaceCall : Android.Net.Uri * Android.OS.Bundle -> unit
override this.PlaceCall : Android.Net.Uri * Android.OS.Bundle -> unit

パラメーター

address
Uri

呼び出し先のアドレス。

extras
Bundle

呼び出しで使用する追加機能のバンドル。

属性

注釈

指定された追加のシステム 通信サービスを使用して、指定されたアドレスに新しい発信呼び出しを行います。

このメソッドは、 Intent#ACTION_CALLを使用して発信呼び出しを行うのと同じですが、発信呼び出しは常にシステム 通信サービス経由で送信されます。 メソッド呼び出し元がユーザーが選択した既定のダイヤラ アプリまたはプリロードされたシステム ダイヤラー アプリである場合、緊急通話も許可されます。

マネージド ConnectionService 経由で呼び出しを行うには、次のアクセス許可が必要です。 android.Manifest.permission#CALL_PHONE

使用例:

Uri uri = Uri.fromParts("tel", "12345", null);
            Bundle extras = new Bundle();
            extras.putBoolean(TelecomManager.EXTRA_START_CALL_WITH_SPEAKERPHONE, true);
            telecomManager.placeCall(uri, extras);

指定された追加機能では、次のキーがサポートされています。 <ul><li>#EXTRA_OUTGOING_CALL_EXTRAS</li><li>#EXTRA_PHONE_ACCOUNT_HANDLE</li><li>#EXTRA_START_CALL_WITH_SPEAKERPHONE</li><li>#EXTRA_START_CALL_WITH_VIDEO_STATE</li></ul>

セルフマネージド ConnectionService API を実装するアプリは、 #placeCall(Uri, Bundle) を使用して、Telecom に新しい発信呼び出しを通知します。 自己管理ConnectionServiceには、関連付けられているandroid.telecom.PhoneAccountHandleを指定するための#EXTRA_PHONE_ACCOUNT_HANDLEを含める必要があります。

セルフマネージド ConnectionServiceには、アクセス許可の android.Manifest.permission#MANAGE_OWN_CALLSが必要です。

<strong>Note:</strong> このメソッドを使用して緊急通報を行う場合、呼び出しが#EXTRA_PHONE_ACCOUNT_HANDLEエクストラ (指定されている場合) に提供されるPhoneAccountに配置されることは保証されず、ネットワークの状態やモデム/SIM の状態などの外部要因に応じて、PhoneAccount#CAPABILITY_PLACE_EMERGENCY_CALLS機能を備えた別のPhoneAccountに配置される可能性があります。

<b>Note</b>: 通知を無視できないよう、呼び出しが行われた後に android.app.Notification.CallStyle 通知を投稿する必要があります。

<b>Note</b>: 着信転送 MMI コードは、ユーザー定義の既定のダイヤラーまたはシステム ダイヤラ ロールとして構成されているアプリケーションでのみダイヤルできます。 呼び出し転送 MMI コードを含む呼び出しが、これらのロールのいずれかに含まれていないアプリケーションによって配置された場合、ダイヤルは、呼び出しが行われる前にユーザーがアクションを確認できるように、既に設定されている MMI コードを示す UI で起動されます。

<b>Note</b>: ダイヤラ アプリケーションは、呼び出しログ レコードを指定するアドレスの URI パラメーターを設定できます。 これにより、ダイヤラーは関連アプリケーションを起動して、特定の呼び出しログ エントリのコールバックを開始できます。 ダイヤラーには、通話ログ レコードにアクセスするためのREAD_CALL_LOGSアクセス許可が必要です。 特定の呼び出しログ レコードの ContentUri は、呼び出しログ レコードのandroid.provider.BaseColumns#_IDであるandroid.content.ContentUri#withAppendedId(CallLog.Calls.CONTENT_URI, callLogId)で取得できます。

Javaドキュメント。

このページの一部は、Androidオープンソースプロジェクトによって作成および共有された作業に基づく変更でありCreative Commons 2.5属性ライセンスに記載されている条件に従って使用されます。

適用対象