Willy's Fish教學筆記』

Agora 是什麼？

他是一套專門用來做 Real-Time 通訊的套件

實際內容可以做到直播、視訊、通話，甚至是互動遊戲

是一套滿好用的 Library 

不過是要付費的，所以要看專案有沒有實際需求來決定是否使用

正好公司就是有做到通訊軟體的案子

趁著這次機會，就把實作方式給記錄下來

那麼就開始囉!!

1、Agora SDK

首先就是怎麼取得 Agora

這裡可以到官方下載最新的 SDK 目前是到 2.8.0

我們可以依照需求下載相應的 SDK

這裡我們下載 Video SDK 試試

2、註冊 Agora Developer Account 

這一步是必需的，人家必竟是付費的嘛…

請大家至官網註冊一個吧

點我註冊

3、將 SDK 置入專案之中

下載下來後，會看到這些檔案

第一個是 jar 檔

將他放在專案的 app/libs 目錄下

然後在 build.gradle 去 implementation 它

dependencies {
    implementation fileTree(include: ['*.jar'], dir: 'libs')
}

上面這段的意思就是 libs 下面的所有 jar 檔都將被引入

再來，因為有用到 JNI 

所以我們要將下面這些資料夾放到 jniLibs

arm64-v8a

armeabi-v7a

include

x86

這樣其實就可以了

但若有些人吃不到 jniLibs 的話

可以在 guilb.gradle 再增加 jniLibs.srcDirs 的值

用來設定正確的路徑

android {
    ...
    sourceSets {
        main {
            jniLibs.srcDirs = ['../../../libs']
        }
    }
}

4、設定 Android NDK

請到 File -> Project Structure -> SDK Location 的最下方下載 Android NDK

若要自行下載指定的版本也是可以

只要有設定好 Android NDK location 即可

最後會像這樣

設定好後，如果 local.properties 沒有自動加入 path 也可以手動加入 path

像這樣，路徑請選擇您下載的 ndk 存放位置即可

ndk.dir=/Users/willy-yan/Library/Android/sdk/ndk-bundle

5、加入權限

請確認需要的權限是否都有

使用 Agora 需要以下的權限

<uses-permission 
android:name="android.permission.READ_PHONE_STATE" />
<uses-permission 
android:name="android.permission.INTERNET" />
<uses-permission 
android:name="android.permission.RECORD_AUDIO" />
<uses-permission 
android:name="android.permission.CAMERA" />
<uses-permission 
android:name="android.permission.MODIFY_AUDIO_SETTINGS" />
<uses-permission 
android:name="android.permission.ACCESS_NETWORK_STATE" />
<!-- The Agora SDK requires Bluetooth permissions 
     in case users are using Bluetooth devices.-->
<uses-permission 
android:name="android.permission.BLUETOOTH" />
<uses-permission 
android:name="android.permission.ACCESS_WIFI_STATE" />

6、防止混淆

由於安全性的問題

大多公司都會採用程式碼混淆

若是我們 Agora SDK 的 public class names 被混掉

產生找不到 method 的錯誤

請在 proguard-rules.pro 這個檔案加入這行

-keep class io.agora.**{*;}

到這裡

Agora SDK 的環境算是正式完成了

接下來就是怎麼實作 Real-Time 直播、視訊…等功能了。

請看下篇

Android Agora 介紹、入門教學、實作範例 Real-Time 直播、視訊、通話、互動遊戲 ( 二 ) 』Willy's Fish教學筆記