Java tutorial
/* * Copyright (C) 2015 The Android Open Source Project * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use this file except in compliance with the License. * You may obtain a copy of the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. * See the License for the specific language governing permissions and * limitations under the License */ package com.mobileglobe.android.customdialer.common; import com.mobileglobe.android.customdialer.common.compat.CompatUtils; import com.mobileglobe.android.customdialer.common.compat.PhoneAccountSdkCompat; import com.mobileglobe.android.customdialer.common.util.PermissionsUtil; import com.mobileglobe.android.customdialer.common.util.PhoneNumberHelper; import android.Manifest; import android.content.Context; import android.content.Intent; import android.content.pm.PackageManager; import android.net.Uri; import android.os.Build; import android.support.annotation.RequiresApi; import android.support.v4.app.ActivityCompat; import android.telecom.PhoneAccount; import android.telecom.PhoneAccountHandle; import android.telecom.TelecomManager; import android.telecom.VideoProfile; import android.text.TextUtils; import java.util.List; /** * Utilities related to calls that can be used by non system apps. These * use {@link Intent#ACTION_CALL} instead of ACTION_CALL_PRIVILEGED. * * The privileged version of this util exists inside Dialer. */ public class CallUtil { /** * Indicates that the video calling is not available. */ public static final int VIDEO_CALLING_DISABLED = 0; /** * Indicates that video calling is enabled, regardless of presence status. */ public static final int VIDEO_CALLING_ENABLED = 1; /** * Indicates that video calling is enabled, but the availability of video call affordances is * determined by the presence status associated with contacts. */ public static final int VIDEO_CALLING_PRESENCE = 2; /** * Return an Intent for making a phone call. Scheme (e.g. tel, sip) will be determined * automatically. */ @RequiresApi(api = Build.VERSION_CODES.M) public static Intent getCallWithSubjectIntent(String number, PhoneAccountHandle phoneAccountHandle, String callSubject) { final Intent intent = getCallIntent(getCallUri(number)); intent.putExtra(TelecomManager.EXTRA_CALL_SUBJECT, callSubject); if (phoneAccountHandle != null) { intent.putExtra(TelecomManager.EXTRA_PHONE_ACCOUNT_HANDLE, phoneAccountHandle); } return intent; } /** * Return an Intent for making a phone call. Scheme (e.g. tel, sip) will be determined * automatically. */ public static Intent getCallIntent(String number) { return getCallIntent(getCallUri(number)); } /** * Return an Intent for making a phone call. A given Uri will be used as is (without any * sanity check). */ public static Intent getCallIntent(Uri uri) { return new Intent(Intent.ACTION_CALL, uri); } /** * A variant of {@link #getCallIntent} for starting a video call. */ public static Intent getVideoCallIntent(String number, String callOrigin) { final Intent intent = new Intent(Intent.ACTION_CALL, getCallUri(number)); intent.putExtra(TelecomManager.EXTRA_START_CALL_WITH_VIDEO_STATE, VideoProfile.STATE_BIDIRECTIONAL); if (!TextUtils.isEmpty(callOrigin)) { intent.putExtra(PhoneConstants.EXTRA_CALL_ORIGIN, callOrigin); } return intent; } /** * Return Uri with an appropriate scheme, accepting both SIP and usual phone call * numbers. */ public static Uri getCallUri(String number) { if (PhoneNumberHelper.isUriNumber(number)) { return Uri.fromParts(PhoneAccount.SCHEME_SIP, number, null); } return Uri.fromParts(PhoneAccount.SCHEME_TEL, number, null); } /** * @return Uri that directly dials a user's voicemail inbox. */ public static Uri getVoicemailUri() { return Uri.fromParts(PhoneAccount.SCHEME_VOICEMAIL, "", null); } /** * Determines if video calling is available, and if so whether presence checking is available * as well. * * Returns a bitmask with {@link #VIDEO_CALLING_ENABLED} to indicate that video calling is * available, and {@link #VIDEO_CALLING_PRESENCE} if presence indication is also available. * * @param context The context * @return A bit-mask describing the current video capabilities. */ @RequiresApi(api = Build.VERSION_CODES.M) public static int getVideoCallingAvailability(Context context) { if (!PermissionsUtil.hasPermission(context, android.Manifest.permission.READ_PHONE_STATE) || !CompatUtils.isVideoCompatible()) { return VIDEO_CALLING_DISABLED; } TelecomManager telecommMgr = (TelecomManager) context.getSystemService(Context.TELECOM_SERVICE); if (telecommMgr == null) { return VIDEO_CALLING_DISABLED; } if (ActivityCompat.checkSelfPermission(context, Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) { // TODO: Consider calling // ActivityCompat#requestPermissions // here to request the missing permissions, and then overriding // public void onRequestPermissionsResult(int requestCode, String[] permissions, // int[] grantResults) // to handle the case where the user grants the permission. See the documentation // for ActivityCompat#requestPermissions for more details. return 0; } List<PhoneAccountHandle> accountHandles = telecommMgr.getCallCapablePhoneAccounts(); for (PhoneAccountHandle accountHandle : accountHandles) { PhoneAccount account = telecommMgr.getPhoneAccount(accountHandle); if (account != null) { if (account.hasCapabilities(PhoneAccount.CAPABILITY_VIDEO_CALLING)) { // Builds prior to N do not have presence support. if (!CompatUtils.isVideoPresenceCompatible()) { return VIDEO_CALLING_ENABLED; } int videoCapabilities = VIDEO_CALLING_ENABLED; if (account .hasCapabilities(PhoneAccountSdkCompat.CAPABILITY_VIDEO_CALLING_RELIES_ON_PRESENCE)) { videoCapabilities |= VIDEO_CALLING_PRESENCE; } return videoCapabilities; } } } return VIDEO_CALLING_DISABLED; } /** * Determines if one of the call capable phone accounts defined supports video calling. * * @param context The context. * @return {@code true} if one of the call capable phone accounts supports video calling, * {@code false} otherwise. */ @RequiresApi(api = Build.VERSION_CODES.M) public static boolean isVideoEnabled(Context context) { return (getVideoCallingAvailability(context) & VIDEO_CALLING_ENABLED) != 0; } /** * Determines if one of the call capable phone accounts defined supports calling with a subject * specified. * * @param context The context. * @return {@code true} if one of the call capable phone accounts supports calling with a * subject specified, {@code false} otherwise. */ @RequiresApi(api = Build.VERSION_CODES.M) public static boolean isCallWithSubjectSupported(Context context) { if (!PermissionsUtil.hasPermission(context, android.Manifest.permission.READ_PHONE_STATE) || !CompatUtils.isCallSubjectCompatible()) { return false; } TelecomManager telecommMgr = (TelecomManager) context.getSystemService(Context.TELECOM_SERVICE); if (telecommMgr == null) { return false; } if (ActivityCompat.checkSelfPermission(context, Manifest.permission.READ_PHONE_STATE) != PackageManager.PERMISSION_GRANTED) { // TODO: Consider calling // ActivityCompat#requestPermissions // here to request the missing permissions, and then overriding // public void onRequestPermissionsResult(int requestCode, String[] permissions, // int[] grantResults) // to handle the case where the user grants the permission. See the documentation // for ActivityCompat#requestPermissions for more details. return false; } List<PhoneAccountHandle> accountHandles = telecommMgr.getCallCapablePhoneAccounts(); for (PhoneAccountHandle accountHandle : accountHandles) { PhoneAccount account = telecommMgr.getPhoneAccount(accountHandle); if (account != null && account.hasCapabilities(PhoneAccount.CAPABILITY_CALL_SUBJECT)) { return true; } } return false; } }