Giới thiệu
Module TTS là một service của Fcloud được phát triển bởi Ftech. Module cho phép chuyển đổi giọng nói của khách hàng thành văn bản thông qua việc ứng dụng công nghệ điện tử. Để tích hợp và sử dụng dịch vụ này phải sử dụng SDK của Fcloud. Và sau đây là hướng dân tích hợp SDK.
Xác thực
Để gọi được các API chúng ta sẽ phải init SDK tham số truyền vào là ClientID và SecretKey được lấy khi bạn tạo Application trên CMS dành cho đối tác theo hướng dẫn sau:
- Đăng nhập CMS Partner với username/password được cung cấp (https://fcloud-partner-cms.ftech.ai)
- Mua gói dịch vụ
- Tạo App
Server Integrator
Sau khi tích hợp SDK, service Fcloud hỗ trợ callback server-server giúp hỗ trợ việc lấy thông tin request nhanh và chính xác nhất.
Web SDK
Android SDK
Install SDK Android
Setup gradle maven
- Với Gradle v1.x - v5.x
Mở thư mục
build.grade
và thêm vàomaven
allprojects {
repositories {
google()
mavenCentral()
maven { url 'https://jitpack.io' } <- add this line
}
}
- Với Gradle v6.x+
Mở thư mục
build.grade
và thêm vàomaven
dependencyResolutionManagement {
repositoriesMode.set(RepositoriesMode.PREFER_SETTINGS)
repositories {
google()
mavenCentral()
maven { url 'https://jitpack.io' } <- add this line
}
}
Open file app/build.grade
then add sdk
dependencies {
...
implementation "com.github.FTechMobile:fstt-android:1.0.7"
}
Init in file Application
- Java
@Override
public void onCreate(@Nullable Bundle savedInstanceState, @Nullable PersistableBundle persistentState) {
super.onCreate(savedInstanceState, persistentState);
...
STTManager.init(getApplicationContext());
}
- Kotlin
override fun onCreate() {
super.onCreate()
...
STTManager.init(this)
}
SDK Android Feature
Init
Tham số | Kiểu | Mô tả |
---|---|---|
appId | String | Application id |
secretKey | String | Secret key |
- Java
STTManager.initGateway("your_app_id", "your_secret_key", new IInitGatewayCallback() {
@Override
public void onSuccess() {
}
@Override
public void onFail(@Nullable AppException error) {
}
});
- Kotlin
STTManager.initGateway(appId, secretKey, object : IInitGatewayCallback {
override fun onSuccess() {
}
override fun onFail(error: AppException?) {
}
})
Register callback
Sau khi đăng ký, SDK sẽ trả về trạng thái tương ứng trong callback
Status | Description |
---|---|
onStart | Được gọi khi bắt đầu ghi âm |
onRecording | Được gọi khi đang ghi âm |
onSuccess | Được gọi khi trả về kết quả |
onFail | Được gọi khi xảy ra lỗi trong quá trình |
- Java
STTManager.registerSTTCallback(new ISTTCallback() {
@Override
public void onStart() {
}
@Override
public void onRecording() {
}
@Override
public void onFail(@Nullable AppException error) {
}
@Override
public void onSuccess(@NonNull String result) {
}
});
- Kotlin
STTManager.registerSTTCallback(object : ISTTCallback {
override fun onStart() {
}
override fun onRecording() {
}
override fun onFail(error: AppException?) {
}
override fun onSuccess(result: String) {
})
})
Start
- Được sử dụng để bắt đầu ghi cho STT
- Khi khởi động thành công, SDK bắt đầu chuyển sang trạng thái ghi,
onStart()
callback sẽ được triệu gọi - Khi bắt đầu ghi không thành công, callback
onFail()
sẽ được triệu gọi
STTManager.startSTT();
Stop
- Được sử dụng để dừng ghi và xử lý bản ghi thành kết quả văn bản
- Khi thành công, SDK sẽ trả về kết quả văn bản vào
onSuccess()
callback - Khi không thành công, callback
onFail()
sẽ được triệu gọi
STTManager.stopSTT();
IOS SDK
Install SDK IOS
Add package dependencies
https://github.com/FTechMobile/fekyc
SDK IOS Integration
Register callback
FTechSSTManager.instance().delegate = self
Init
Param | Type | Description |
---|---|---|
appId | String | Application id |
key | String | Secret key |
FTechSSTManager.instance().initSDK(appId: "", key: "")
Implement FTechSSTManagerDelegate
- Sau khi đăng ký, SDK sẽ trả về trạng thái tương ứng trong callback
Trạng thái | Mô tả |
---|---|
onStart | Được gọi khi bắt đầu bản ghi |
onRecording | Được gọi khi đang trong quá trình ghi |
onCompletion | Được gọi khi hoàn tất quá trình ghi và trả về kết quả |
onFailure | Được gọi khi xảy ra lỗi trong quá trình ghi tiến trình |
extension ViewController: FTechSSTManagerDelegate {
func onStart() {
}
func onRecording() {
}
func onCompletion(data: STTResponse) {
}
func onFailure(error: FTError) {
}
}
SDK IOS Feature
Start
- Được sử dụng để bắt đầu ghi cho STT
- Khi khởi động thành công, SDK bắt đầu chuyển sang trạng thái ghi, nó sẽ được gọi
onStart()
callback - Khi bản ghi bắt đầu không thành công, nó sẽ được xử lý tại
onFailure()
callback
FTechSSTManager.instance().startRecording()
Stop
- Được sử dụng để dừng ghi và xử lý bản ghi thành kết quả văn bản
- Khi thành công, SDK sẽ trả về kết quả văn bản trên
onCompletion()
callback - Khi không thành công, nó sẽ được xử lý tại callback
onFailure()
FTechSSTManager.instance().stopRecoding()