メニュー

Expand
ページを評価:

はじめましょう

Want to add VoIP calling to your iOS application?

Start by downloading the Voice Quickstart for Swift application source code. Prefer working with Objective-C? Follow the quickstart on the Voice Quickstart for Objective-C source code instead.

Next, follow the step-by-step instructions below (for Swift) to get you up and running quickly using Twilio’s Programmable Voice SDK.

Twilio Voice Quickstart for iOS

Please see our iOS 13 Migration Guide for the latest information on iOS 13.

Get started with Voice on iOS

参照

Voice iOS SDK Versions

クイックスタート

To get started with the quickstart application follow these steps. Steps 1-5 will enable the application to make a call. The remaining steps 6-9 will enable the application to receive incoming calls in the form of push notifications using Apple’s VoIP Service.

  1. Install the TwilioVoice framework
  2. Use Twilio CLI to deploy access token and TwiML application to Twilio Serverless
  3. Create a TwiML application for the access token
  4. Generate an access token for the quickstart
  5. Run the Swift Quickstart app
  6. Create a Push Credential with your VoIP Service Certificate
  7. 着信通話を受ける
  8. Make client to client call
  9. Make client to PSTN call

1. Install the TwilioVoice framework

Swift Package Manager

Twilio Voice is now distributed via Swift Package Manager. To consume Twilio Voice using Swift Package Manager, add the https://github.com/twilio/twilio-voice-ios repository as a Swift Pacakge.

2. Use Twilio CLI to deploy access token and TwiML application to Twilio Serverless

You must have the following installed:

  • Node.js v10+
  • NPM v6+ (comes installed with newer Node versions)

Run npm install to install all dependencies from NPM.

Install twilio-cli with:

$ npm install -g twilio-cli

Login to the Twilio CLI. You will be prompted for your Account SID and Auth Token, both of which you can find on the dashboard of your Twilio console.

$ twilio login

Once successfully logged in, an API Key, a secret get created and stored in your keychain as the twilio-cli password in SKxxxx|secret format. Please make a note of these values to use them in the Server/.env file.

This app requires the Serverless plug-in. Install the CLI plugin with:

$ twilio plugins:install @twilio-labs/plugin-serverless

Before deploying, create a Server/.env by copying from Server/.env.example

$ cp Server/.env.example Server/.env

Update Server/.env with your Account SID, auth token, API Key and secret

ACCOUNT_SID=ACxxxx
AUTH_TOKEN=xxxxxx
API_KEY_SID=SKxxxx
API_SECRET=xxxxxx
APP_SID=APxxxx (available in step 3)
PUSH_CREDENTIAL_SID=CRxxxx (available in step 6)

The Server folder contains a basic server component which can be used to vend access tokens or generate TwiML response for making call to a number or another client. The app is deployed to Twilio Serverless with the serverless plug-in:

$ cd Server
$ twilio serverless:deploy

The server component that's baked into this quickstart is in Node.js. If you’d like to roll your own or better understand the Twilio Voice server side implementations, please see the list of starter projects in the following supported languages below:

Follow the instructions in the project's README to get the application server up and running locally and accessible via the public Internet.

3. Create a TwiML application for the Access Token

次に、TwiMLアプリケーションの作成が必要になります。 TwiMLアプリケーションは、TwiMLの通話制御指示を取得するための公開URLの特定に使用されます。 iOS AppがTwilioクラウドに通話を発信する際、TwilioはWebhookリクエストをこのURLに発行し、ユーザーのアプリケーションサーバーがTwiMLを生成してこれに応答、Twilioはこれに基づいて指示を実行します。

Use Twilio CLI to create a TwiML app with the make-call endpoint you have just deployed

$ twilio api:core:applications:create \
    --friendly-name=my-twiml-app \
    --voice-method=POST \
    --voice-url="https://my-quickstart-dev.twil.io/make-call"

You should receive an Appliciation SID that looks like this

APxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

4. Generate an access token for the quickstart

Install the token plug-in

$ twilio plugins:install @twilio-labs/plugin-token

Use the TwiML App SID you just created to generate an access token

$ twilio token:voice --identity=alice --voice-app-sid=APxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Copy the access token string. Your iOS app will use this token to connect to Twilio.

5. Run the Swift Quickstart app

Now let’s go back to the VoiceQuickstart.xcworkspace. Update the placeholder of accessToken with access token string you just copied

import UIKit
import AVFoundation
import PushKit
import CallKit
import TwilioVoice

let accessToken = "PASTE_YOUR_ACCESS_TOKEN_HERE"
let twimlParamTo = "to"

let kCachedDeviceToken = "CachedDeviceToken"

class ViewController: UIViewController {
    ...
}

Build and run the app. Leave the text field empty and press the call button to start a call. You will hear the congratulatory message. Support for dialing another client or number is described in steps 8 and 9. Tap "Hang Up" to disconnect.

6. Create a Push Credential with your VoIP Service Certificate

The Programmable Voice SDK uses Apple’s VoIP Services to let your application know when it is receiving an incoming call. If you want your users to receive incoming calls, you’ll need to enable VoIP Services in your application and generate a VoIP Services Certificate.

Go to Apple Developer portal and generate a VoIP Service Certificate.

Once you have generated the VoIP Services Certificate, you will need to provide the certificate and key to Twilio so that Twilio can send push notifications to your app on your behalf.

Export your VoIP Service Certificate as a .p12 file from Keychain Access and extract the certificate and private key from the .p12 file using the openssl command.

$ openssl pkcs12 -in PATH_TO_YOUR_P12 -nokeys -out cert.pem -nodes
$ openssl pkcs12 -in PATH_TO_YOUR_P12 -nocerts -out key.pem -nodes
$ openssl rsa -in key.pem -out key.pem

Use Twilio CLI to create a Push Credential using the cert and key.

$ twilio api:chat:v2:credentials:create \
    --type=apn \
    --sandbox \
    --friendly-name="voice-push-credential (sandbox)" \
    --certificate="$(cat PATH_TO_CERT_PEM)" \
    --private-key="$(cat PATH_TO_KEY_PEM)"

This will return a Push Credential SID that looks like this

CRxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

The --sandbox option tells Twilio to send the notification requests to the sandbox endpoint of Apple's APNS service. Once the app is ready for distribution or store submission, create a separate Push Credential with a new VoIP Service certificate without the --sandbox option.

Note: we strongly recommend using different Twilio accounts (or subaccounts) to separate VoIP push notification requests for development and production apps.

Now let's generate another access token and add the Push Credential to the Voice Grant.

$ twilio token:voice \
    --identity=alice \
    --voice-app-sid=APxxxx \
    --push-credential-sid=CRxxxxs

7. Receive an incoming call

You are now ready to receive incoming calls. Update your app with the access token generated from step 6 and rebuild your app. The TwilioVoiceSDK.register() method will register your mobile client with the PushKit device token as well as the access token. Once registered, hit your application server's /place-call endpoint: https://my-quickstart-dev.twil.io/place-call?to=alice. This will trigger a Twilio REST API request that will make an inbound call to the identity registered on your mobile app. Once your app accepts the call, you should hear a congratulatory message.

Register your mobile client with the PushKit device token:

    TwilioVoiceSDK.register(accessToken: accessToken, deviceToken: cachedDeviceToken) { error in
        if let error = error {
            NSLog("An error occurred while registering: \(error.localizedDescription)")
        } else {
            NSLog("Successfully registered for VoIP push notifications.")                
        }
    }

Please note that your application must have voip enabled in the UIBackgroundModes of your app's plist in order to be able to receive push notifications.

8. Make client to client call

To make client to client calls, you need the application running on two devices. To run the application on an additional device, make sure you use a different identity in your access token when registering the new device.

Use the text field to specify the identity of the call receiver, then tap the "Call" button to make a call. The TwiML parameters used in TwilioVoice.connect() method should match the name used in the server.

9. Make client to PSTN call

To make client to number calls, first get a verified Twilio number to your account via https://www.twilio.com/console/phone-numbers/verified. Update your server code and replace the callerNumber variable with the verified number. Restart the server so it uses the new value.

サンプル

You will also find additional examples that provide more advanced use cases of the Voice SDK:

  • AudioDevice - Provide your own means to playback and record audio using a custom TVOAudioDevice and CoreAudio.

追加ドキュメント

You can find the API documentation of the Voice SDK:

Twilio ヘルパーライブラリ

TwiMLやProgrammable VoiceのCalls APIの使い方についての詳細については、TwiMLのクイックスタートをご確認ください。

Issues and Support

Please file any issues you find here on Github: Voice Swift Quickstart. Please ensure that you are not sharing any Personally Identifiable Information(PII) or sensitive account information (API keys, credentials, etc.) when reporting an issue.

For general inquiries related to the Voice SDK you can file a support ticket.

License

MIT

ページを評価:

ヘルプが必要ですか?

誰しもが一度は考える「コーディングって難しい」。そんな時は、お問い合わせフォームから質問してください。 または、Stack Overflow でTwilioタグのついた情報から欲しいものを探してみましょう。

        
        
        

        フィードバックくださりありがとうございます!

        We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        ステップ1

        Get link

        Get a free personal referral link here

        ステップ2:

        Give $10

        Your user signs up and upgrade using link

        ステップ3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more