패키지, 저장소 및 앱 카테고리 검색

패키지 상세v0.1.0

flutter_ios_voip_kit

Flutter iOS 앱에서 CallKit 및 PushKit를 사용한 1:1 비디오 통화.

AndroidiOS
30일 다운로드
47
좋아요
53
Pub 점수
130

패키지 설치

flutter pub add flutter_ios_voip_kit

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

iOS에서 CallKit과 PushKit을 사용하여 시스템의 네이티브 전화 인터페이스와 원활하게 통합되는 1:1 영상 통화를 가능하게 하는 플러터 패키지입니다. 수신 통화 알림, 백그라운드 처리 및 네이티브에 가까운 통화 경험을 제공합니다. 이 패키지는 iOS 전용으로 설계되었으며, 신뢰할 수 있는 실시간 통신을 보장하기 위해 플랫폼 고유의 API를 활용합니다. 구성상 안드로이드도 지원하지만 핵심 기능은 iOS에 집중되어 있습니다. VoIP 푸시 인증서와 푸시 알림을 위한 백엔드 지원이 필요합니다.

사용 사례

  • 실시간 비디오 통화 앱
  • iOS 네이티브 통화 경험
  • 백그라운드 호출 처리
  • 푸시 기반 콜 시작
  • CallKit UI와의 통합

주요 기능

  • CallKit 통합
  • PushKit 지원
  • 백그라운드 호출 기능
  • 네이티브 iOS 호출 인터페이스
  • VoIP 푸시 알림 처리

적합한 대상

  • iOS 중심의 비디오 통화 앱
  • 시스템 레벨 호출 통합이 필요한 앱
  • 원격의료 또는 메시징 플랫폼을 구축하는 개발자
  • 백그라운드 호출 지속성이 필요한 프로젝트

고려 사항

  • iOS 전용 구성이 필요합니다
  • VoIP 푸시 인증서 설정이 필요합니다
  • 백엔드 푸시 알림 서비스 필요
  • 제한된 안드로이드 기능
  • Apple 개발자 포털과 함께하는 복잡한 초기 설정

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

flutter_ios_voip_kit

One-to-one video call using CallKit and PushKit with flutter iOS app.

Motivation

We need to use CallKit to handle incoming VoIP notifications from iOS 13. Check the WWDC2019 video for more information. So instead of using CallKit and PushKit separately, there is a growing need to use them together. However, there are still few VoIP notification samples on the net that use CallKit and PushKit (especially for Flutter). I decided to create a flutter plugin with the minimum required functions. You can use this plugin, but the actual purpose is to help you create a VoIPKit tailored to your service.

Requirement

  • iOS only, not support Android.
  • iOS 10 or above.
  • one-to-one call only, not support group call.
  • need to a server for pushing VoIP notification with APNs.
  • to actually make a video or call, you need to link to a service such as WebRTC(ex: Agora, SkyWay, Amazon Kinesis Video Streams).

Usage

1. install
  • Add flutter_ios_voip_kit as a dependency in your pubspec.yaml file.
2. setting Capability in Xcode
  1. Select Background Modes > Voice over IP and Remote notifications is ON.
  2. Select Push Notifications.
  3. Changed ios/Runner/Info.plist after selected Capability.
<key>UIBackgroundModes</key>
<array>
    <string>remote-notification</string>
    <string>voip</string>
</array>
2. edit Info.plist
  • Edit ios/Runner/Info.plist as below.
<key>FIVKIconName</key>
<string>AppIcon-VoIPKit</string>
<key>FIVKLocalizedName</key>
<string>VoIP-Kit</string>
<key>FIVKSupportVideo</key>
<true/>
<key>FIVKSkipRecallScreen</key>
<true/>
3. add New Image set for CallKit
  • Add an icon(.png or .pdf) ios/Runner/Assets.xcassets/AppIcon-VoIPKit to use on the screen when a call comes in while locked iPhone.
4. create VoIP Services Certificate
Create .p12 from .cer with KeyChainAccess
openssl pkcs12 -in voip_services.p12 -out voip_services.pem -nodes -clcerts

If you're running OpenSSL version 3 or later, please note that you may need to include the "-legacy" option.

openssl pkcs12 -legacy -in voip_services.p12 -out voip_services.pem -nodes -clcerts
5. request VoIP notification APNs from your server
  • See Apple document.
  • https://developer.apple.com/documentation/usernotifications/setting_up_a_remote_notification_server/sending_notification_requests_to_apns
  • Add data(payload) like a below.
{
    "aps": {
        "alert": {
          "uuid": <Version 4 UUID (e.g.: https://www.uuidgenerator.net/version4) >,
          "incoming_caller_id": <your service user id>,
          "incoming_caller_name": <your service user name>,
        }
    }
}
  • You can use curl to test VoIP notifications as follows.
curl -v \
-d '{"aps":{"alert":{"uuid":"982cf533-7b1b-4cf6-a6e0-004aab68c503","incoming_caller_id":"0123456789","incoming_caller_name":"Tester"}}}' \
-H "apns-push-type: voip" \
-H "apns-expiration: 0" \
-H "apns-priority: 0" \
-H "apns-topic: <your app’s bundle ID>.voip" \
--http2 \
--cert ./voip_services.pem \
https://api.sandbox.push.apple.com/3/device/<VoIP device Token for your iPhone>

Try out example app

Select call role 🤙 Caller page 🔔 Callee page
🔔 Callee(incoming call) 🔔 Callee(locked) 🔔 Callee(locked) 🔔 Callee(recall)
🔔 Callee(unanswered local notification) 🔔 Callee(unanswered local notification)

Q&A

Does CallKit have a call and outgoing call screen?
  • No. CallKit support incoming call screen only. You need to make your own a call and outgoing call screens.
Can I use remote push device token instead of VoIP device token?
  • No. Since the specifications of VoIP token and push token are different, it is necessary to manage them separately in your database.
Can't get VoIP token on iOS13
  • Please uninstall the app, restart the terminal and reinstall the app. You can get it after a while.
Don't receive VoIP notifications
  • Please check the following items.
    1. Is the VoIP device token correct?
    2. Did you set your app’s bundle ID with .voip to apns-topic?
    3. Did you set voip to apns-push-type?
    4. Is the APNs endpoint(Development or Production) correct?
    5. For iOS13, VoIP notifications may not be received if call kit call fails many times. Please uninstall the app, restart the terminal and reinstall the app.
No icon is displayed on the incoming call screen when locked
  • The icon image should be a square with side length of 40 points. The color is ignored. Please design with the difference of alpha.
  • If created in PDF, checked Preserve Vector Data for Resizing and change Single Scale for Scales.
create icon (e.g.: sketch) Xcode Image Set

Reference

  • https://developer.apple.com/documentation/callkit
  • https://developer.apple.com/documentation/pushkit
  • https://developer.apple.com/documentation/callkit/making_and_receiving_voip_calls_with_callkit

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트

아직 데이터가 없습니다.