Crea un'app per le chiamate

Un'app per le chiamate consente agli utenti di ricevere o effettuare chiamate audio o videochiamate sul proprio dispositivo. Le app per le chiamate utilizzano una propria interfaccia utente anziché utilizzare l'interfaccia predefinita dell'app Telefono, come mostrato nello screenshot seguente.

Un esempio di app per le chiamate
Esempio di app di chiamata che utilizza la propria interfaccia utente

Il framework Android include il pacchetto android.telecom, che contiene classi che aiutano a creare un'app per le chiamate secondo il il modello di machine learning. Creare l'app in base al framework per le telecomunicazioni fornisce la i seguenti vantaggi:

  • La tua app interagisce correttamente con il sottosistema di telecomunicazioni nativo nella dispositivo.
  • La tua app interagisce correttamente con altre app di chiamata che rispettano anche le il framework.
  • Il framework consente all'app di gestire il routing audio e video.
  • Il framework aiuta la tua app a determinare se le chiamate sono state attivate.

Dichiarazioni e autorizzazioni del file manifest

Nel file manifest dell'app, dichiara che l'app utilizza la classe MANAGE_OWN_CALLS come mostrato nell'esempio seguente:

<manifest … >
    <uses-permission android:name="android.permission.MANAGE_OWN_CALLS"/>
</manifest>

Per ulteriori informazioni sulla dichiarazione delle autorizzazioni app, vedi Autorizzazioni.

Devi dichiarare un servizio che specifica la classe che implementa ConnectionService corso nella tua app. Il settore delle telecomunicazioni richiede che il servizio dichiari che l'autorizzazione BIND_TELECOM_CONNECTION_SERVICE essere in grado di associarsi. L'esempio seguente mostra come dichiarare il servizio in del file manifest dell'app:

<service android:name="com.example.MyConnectionService"
    android:permission="android.permission.BIND_TELECOM_CONNECTION_SERVICE">
    <intent-filter>
        <action android:name="android.telecom.ConnectionService" />
    </intent-filter>
</service>

Per ulteriori informazioni sulla dichiarazione dei componenti dell'app, inclusi i servizi, vedi Componenti dell'app.

Implementare il servizio di connessione

L'app per le chiamate deve fornire un'implementazione della classe ConnectionService a cui il sottosistema di telecomunicazioni può associarsi. L'implementazione di ConnectionService dovrebbe sostituire utilizza i seguenti metodi:

onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest)

Il sottosistema di telecomunicazioni chiama questo metodo in risposta a la tua app chiama placeCall(Uri, Bundle) per creare una nuova chiamata in uscita. L'app restituisce una nuova istanza dell'implementazione della classe Connection. Per ulteriori informazioni, consulta Implementa la connessione) per rappresentare la nuova chiamata in uscita. Puoi personalizzare ulteriormente la connessione in uscita eseguendo le seguenti azioni:

onCreateOutgoingConnectionFailed(PhoneAccountHandle, ConnectionRequest)

Il sottosistema di telecomunicazioni chiama questo metodo quando la tua app chiama il metodo placeCall(Uri, Bundle) e la chiamata in uscita non può in fase di posizionamento. In risposta a questa situazione, l'app deve informare l'utente (ad ad esempio usando una casella di avviso o un avviso popup) che non è stato possibile inserito. La tua app potrebbe non riuscire a effettuare una chiamata se è in corso un chiamata di emergenza o se è in corso una chiamata in un'altra app che non può essere mettilo in attesa prima di effettuare la chiamata.

onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest)

Il sottosistema di telecomunicazioni chiama questo metodo quando la tua app chiama il metodo addNewIncomingCall(PhoneAccountHandle, Bundle) per informare il sistema di una nuova chiamata in arrivo nella tua app. La tua app restituisce un nuova istanza dell'implementazione Connection (ad per maggiori informazioni, consulta Implementare la connessione). per rappresentare la nuova chiamata in arrivo. Puoi personalizzare ulteriormente la connessione eseguendo le seguenti azioni:

onCreateIncomingConnectionFailed(PhoneAccountHandle, ConnectionRequest)

Il sottosistema di telecomunicazioni chiama questo metodo quando la tua app chiama il metodo addNewIncomingCall(PhoneAccountHandle, Bundle) per informare Telecom di una nuova chiamata in arrivo, ma non è consentita (per maggiori informazioni, consulta i vincoli di chiamata). La tua app dovrebbe rifiutare automaticamente la chiamata in arrivo, pubblicando una notifica per informare l'utente della chiamata senza risposta.

Implementa la connessione

L'app deve creare una sottoclasse Connection per che rappresentano le chiamate nella tua app. Devi sostituire i seguenti metodi in la tua implementazione:

onShowIncomingCallUi()

Il sottosistema di telecomunicazioni chiama questo metodo quando aggiungi una nuova chiamata in arrivo e nell'app dovrebbe essere visualizzata la UI delle chiamate in arrivo.

onCallAudioStateChanged(CallAudioState)

Il sottosistema di telecomunicazioni chiama questo metodo per informare la tua app che l'audio corrente o la modalità di navigazione sono cambiate. Viene chiamato in risposta al cambiamento dell'app modalità audio utilizzando setAudioRoute(int) . Questo metodo può essere chiamato anche se il sistema cambia il percorso audio. (ad esempio, quando si disconnettono le cuffie Bluetooth).

onHold()

Il sottosistema di telecomunicazioni chiama questo metodo quando vuole mettere una chiamata in attesa. In risposta a questa richiesta, l'app deve sospendere la chiamata e richiamare il metodo setOnHold() metodo per informare il sistema che la chiamata è in attesa. Il sottosistema di telecomunicazioni può chiamare questo metodo quando un servizio durante le chiamate, come Android Auto, che indica che la chiamata vuole inoltrare la richiesta di un utente di mettere la chiamata in attesa. Il sottosistema di telecomunicazioni chiama anche questo metodo se l'utente effettua una chiamata attiva in un'altra app. Per ulteriori informazioni informazioni sui servizi disponibili durante le chiamate, vedi InCallService.

onUnhold()

Il sottosistema di telecomunicazioni chiama questo metodo quando vuole riprendere una chiamata che è stata messa in attesa. Una volta ripresa l'app la chiamata, dovrebbe richiamare setActive() per informare il sistema che la chiamata non è più in attesa. Il settore delle telecomunicazioni potrebbe chiamare questo metodo quando un servizio in-call, come Android Auto, che indica che la tua chiamata vuole inoltrare una richiesta per riprenderla. Per Per ulteriori informazioni sui servizi disponibili durante le chiamate, consulta InCallService.

onAnswer()

Il sottosistema di telecomunicazioni chiama questo metodo per informare alla tua app di rispondere a una chiamata in arrivo. Dopo che l'app ha risposto la chiamata, dovrebbe richiamare setActive() per informare il sistema che la chiamata ha ricevuto risposta. Il settore delle telecomunicazioni il sottosistema potrebbe chiamare questo metodo quando la tua app aggiunge una nuova chiamata in arrivo e è già in corso una chiamata in un'altra app che non può essere messa in attesa. Il sottosistema di telecomunicazioni visualizza l'UI delle chiamate in arrivo per conto della tua app in queste istanze. Il framework offre un metodo di sovraccarico che fornisce per specificare lo stato del video in cui rispondere alla chiamata. Per ulteriori informazioni informazioni, vedi onAnswer(int).

onReject()

Il sottosistema di telecomunicazioni chiama questo metodo quando vuole rifiutare un messaggio in arrivo chiamata. Una volta che l'app ha rifiutato la chiamata, deve chiamare setDisconnected(DisconnectCause) e specificare REJECTED come parametro. La tua app dovrebbe quindi chiama il metodo destroy() per informare il sistema su cui l'app ha elaborato la chiamata. Il sottosistema di telecomunicazione questo metodo quando l'utente rifiuta una chiamata in arrivo dalla tua app.

onDisconnect()

Il sottosistema di telecomunicazioni chiama questo metodo quando vuole disconnettere una chiamata. Al termine della chiamata, l'app deve chiamare il metodo setDisconnected(DisconnectCause) e specificare LOCAL come parametro per indicare che richiesta dell'utente ha causato la disconnessione della chiamata. L'app dovrebbe quindi chiamare Metodo destroy() per informare il servizio di telecomunicazioni sottosistema con cui l'app ha elaborato la chiamata. Il sistema potrebbe chiamare questo metodo Quando l'utente ha disconnesso una chiamata tramite un altro servizio interno, come Android Auto. Il sistema chiama questo metodo anche quando la chiamata deve essere disconnesso per consentire l'esecuzione di altre chiamate, ad esempio se l'utente vuole per effettuare una chiamata di emergenza. Per ulteriori informazioni sui servizi disponibili durante le chiamate, vedi InCallService.

Gestire scenari di chiamata comuni

Utilizzo dell'API ConnectionService nella chiamata prevede l'interazione con le altre classi nell'android.telecom pacchetto. Le seguenti sezioni descrivono scenari di chiamata comuni e il modo in cui devono utilizzare le API per gestirli.

Risposta alle chiamate in arrivo

Il flusso per gestire le chiamate in arrivo cambia se sono presenti chiamate in altre app o meno. Il motivo della differenza nei flussi è che il framework per le telecomunicazioni devi stabilire alcuni vincoli quando ci sono chiamate attive in altre app per garantire un ambiente stabile per tutte le app di chiamata sul dispositivo. Per ulteriori informazioni informazioni, consulta la sezione Limitazioni delle chiamate.

Nessuna chiamata attiva in altre app

Per rispondere alle chiamate in arrivo quando non ci sono chiamate attive in altre app, segui questi passaggi:

  1. L'app riceve una nuova chiamata in arrivo utilizzando i suoi consueti meccanismi.
  2. Usa il metodo addNewIncomingCall(PhoneAccountHandle, Bundle) per informare il sottosistema di telecomunicazioni della nuova chiamata in arrivo.
  3. Il sottosistema di telecomunicazioni si collega all'implementazione di ConnectionService della tua app e richiede una nuova istanza della classe Connection che rappresenta la nuova utilizzando il metodo onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest).
  4. Il sottosistema di telecomunicazioni comunica alla tua app che deve mostrare la chiamata in arrivo utente usando il metodo onShowIncomingCallUi().
  5. La tua app mostra la UI in entrata tramite una notifica con un intent a schermo intero. Per ulteriori informazioni, vedi onShowIncomingCallUi().
  6. Chiama il metodo setActive() se l'utente accetta la chiamata in arrivo o setDisconnected(DisconnectCause) specifica REJECTED come parametro seguito da al metodo destroy() se l'utente rifiuta la chiamata in arrivo.

Chiamate attive in altre app che non possono essere messe in attesa

Per rispondere alle chiamate in arrivo quando sono presenti chiamate attive in altre app che non possono essere messo in attesa, svolgi i seguenti passaggi:

  1. L'app riceve una nuova chiamata in arrivo utilizzando i suoi consueti meccanismi.
  2. Usa il metodo addNewIncomingCall(PhoneAccountHandle, Bundle) per informare il sottosistema di telecomunicazioni della nuova chiamata in arrivo.
  3. Il sottosistema di telecomunicazioni si collega all'implementazione di ConnectionService della tua app e richiede una nuova istanza dell'oggetto Connection che rappresenta il nuovo chiamata in arrivo con il metodo onCreateIncomingConnection(PhoneAccountHandle, ConnectionRequest).
  4. Il sottosistema di telecomunicazione visualizza l'UI della chiamata in arrivo per quella in arrivo.
  5. Se l'utente accetta la chiamata, il sottosistema di telecomunicazioni chiama il metodo onAnswer(). Devi chiamare il metodo setActive() per indicare al servizio di telecomunicazione a cui è ora connessa la chiamata.
  6. Se l'utente rifiuta la chiamata, il sottosistema di telecomunicazioni chiama il metodo onReject(). Devi chiamare il metodo setDisconnected(DisconnectCause) che specifica REJECTED come parametro seguito da un al metodo destroy().

Effettuare chiamate in uscita

Il flusso per effettuare una chiamata in uscita implica gestire la possibilità che impossibile effettuare una chiamata a causa dei vincoli imposti dal framework di telecom. Per ulteriori informazioni, consulta la sezione Limitazioni delle chiamate.

Per effettuare una chiamata in uscita:

  1. L'utente avvia una chiamata in uscita all'interno dell'app.
  2. Utilizza il metodo placeCall(Uri, Bundle) per informare il un sottosistema di telecomunicazioni sulla nuova chiamata in uscita. Prendi le seguenti considerazioni sui parametri del metodo:
    • Il parametro Uri rappresenta l'indirizzo in cui a cui viene effettuata la chiamata. Per i numeri di telefono normali, utilizza l'URI tel: .
    • Il parametro Bundle ti consente di fornire informazioni sulla tua app per le chiamate, aggiungendo l'oggetto PhoneAccountHandle della tua app all'extra di EXTRA_PHONE_ACCOUNT_HANDLE. Il tuo l'app deve fornire l'oggetto PhoneAccountHandle a ogni chiamata in uscita.
    • Il parametro Bundle ti consente anche di specificare se la chiamata in uscita include il video specificando il valore STATE_BIDIRECTIONAL nel extra EXTRA_START_CALL_WITH_VIDEO_STATE. Tieni presente che, per impostazione predefinita, il sottosistema di telecomunicazioni instrada le videochiamate al vivavoce.
  3. Il sottosistema di telecomunicazioni si collega a ConnectionService dell'app implementazione.
  4. Se la tua app non è in grado di effettuare una chiamata in uscita, il sottosistema Telecomunicazioni il metodo onCreateOutgoingConnectionFailed(PhoneAccountHandle, ConnectionRequest) per comunicare alla tua app che non è possibile effettuare la chiamata al momento. La tua app Deve informare l'utente che non è possibile effettuare la chiamata.
  5. Se la tua app è in grado di effettuare la chiamata in uscita, il sottosistema di telecomunicazione onCreateOutgoingConnection(PhoneAccountHandle, ConnectionRequest) . L'app deve restituire un'istanza della classe Connection per rappresentare la nuova chiamata in uscita. Per sulle proprietà da impostare nella connessione, consulta Implementare il servizio di connessione.
  6. Dopo aver connesso la chiamata in uscita, chiama il metodo setActive() per informare il sottosistema di telecomunicazioni che la chiamata sia attiva.

Terminare una chiamata

Per terminare una chiamata, procedi nel seguente modo:

  1. Richiama setDisconnected(DisconnectCause) che invia LOCAL come parametro se l'utente hai terminato la chiamata o invia REMOTE come parametro se l'altra parte ha terminato la chiamata.
  2. Chiama il metodo destroy().

Vincoli delle chiamate

Per garantire agli utenti un'esperienza di chiamata semplice e coerente, lo strumento applica alcuni vincoli per la gestione delle chiamate sul dispositivo. Per Ad esempio, supponiamo che l'utente abbia installato due app di chiamata che implementano l'API ConnectionService autogestita, FooTalk BarTalk. In questo caso, si applicano i seguenti vincoli:

  • Sui dispositivi con livello API 27 o precedente, solo un'app può mantenere chiamata in corso in qualsiasi momento. Questo vincolo significa che, mentre un utente ha chiamata in corso tramite l'app FooTalk, l'app BarTalk non può avviare né ricevere una nuova chiamata.

    Sui dispositivi in esecuzione con livello API 28 o superiore, se sia FooTalk che BarTalk dichiarare CAPABILITY_SUPPORT_HOLD e CAPABILITY_HOLD autorizzazioni, l'utente può mantenere più di una chiamata in corso passare da un'app all'altra per avviare o rispondere a un'altra chiamata.

  • Se l'utente è impegnato in chiamate gestite standard (ad esempio, utilizzando integrata Telefono o Telefono), l'utente non può partecipare a chiamate app per chiamare. Ciò significa che se l'utente è in una normale chiamata utilizzando il suo operatore di telefonia mobile, non possono partecipare anche a una chiamata FooTalk o BarTalk.

  • Il sottosistema di telecomunicazioni disconnette le chiamate della tua app se l'utente chiama chiamata di emergenza.

  • L'app non può ricevere o effettuare chiamate mentre l'utente è in una chiamata di emergenza.

  • Se è in corso una chiamata in un'altra app per le chiamate quando l'app riceve una chiamata in arrivo, se si risponde alla chiamata in arrivo, tutte le chiamate in corso un'altra app. L'app non dovrebbe visualizzare la sua normale interfaccia utente per le chiamate in arrivo. Il framework di telecomunicazione visualizza l'interfaccia utente della chiamata in arrivo e informa l'utente che risponde alla nuova chiamata terminerà le chiamate in corso. Questo significa che se l'utente sta partecipando a una chiamata FooTalk e l'app BarTalk riceve chiamata in arrivo, il framework di telecomunicazione informa l'utente che ha una nuova chiamata BarTalk in arrivo e che rispondendo alla chiamata BarTalk Chiamata FooTalk.