AddonClient

@PublicApi
public interface AddonClient

Giao diện chính để bắt đầu và dừng một phiên tiện ích bổ sung.

Lưu ý: Chỉ có một phiên có thể hoạt động tại một thời điểm, nếu không ListenableFuture do begin trả về sẽ phân giải bằng tệp . Một phiên có thể tự kết thúc (ví dụ: người dùng đã rời khỏi cuộc họp) và gọi onSessionEnded, hoặc phiên có thể bị chấm dứt bằng cách gọi endSession.

Ví dụ về cách sử dụng: 

class AwesomeAddonSessionHandler implements AddonSessionHandler {}

class AwesomeCoWatchingHandler implements CoWatchingHandler {}

public void registerStatusListener() {
  AddonClient meetClient = AddonClientFactory.getClient();
  meetClient.registerMeetingStatusListener(
      appContext,
      meetingStatus -> {
        switch (meetingStatus.status()) {
          case NO_MEETING:
            // User is not in a meeting currently.
            break;
          case MEETING:
            // User is in a meeting, check if they want to start an add-on session.
            showStartAddonSessionDialog();
            break;
          case ADDON_SESSION:
            // User is in a meeting that already hosts an add-on session, check if they want
            // to join the ongoing session.
            showJoinAddonSessionDialog();
            break;
        }
      },
      Optional.empty());
}

public ListenableFuture<AddonClient> initialSetup() {
  AddonClient meetClient = AddonClientFactory.getClient();
  return meetClient
      .newSessionBuilder(appContext, new AwesomeAddonSessionHandler())
      .withCoWatching(new AwesomeCoWatchingHandler())
      .begin();
}

Tóm tắt

Các loại lồng nhau

Biểu thị một sự kiện lỗi xảy ra trước, trong hoặc sau phiên tiện ích bổ sung.

Phương thức công khai
abstract AddonSession.Builder

Trả về trình tạo cho một phiên tiện ích bổ sung mới.
abstract void
notifyAddonFailureEvent(
    Context appContext,
    AddonClient.AddonFailureEventType failureEventType
)

Thông báo cho Meet về sự kiện xảy ra lỗi với tiện ích bổ sung.
abstract void
registerMeetingStatusListener(
    Context appContext,
    MeetingStatusListener listener,
    Optional<Handler> handler
)

Đăng ký trình nghe để nhận thông báo về những thay đổi đối với trạng thái của cuộc họp và các phiên tiện ích bổ sung.
abstract void

Huỷ đăng ký trình nghe đang hoạt động cho các thay đổi về MeetingStatus.

Phương thức công khai

newSessionBuilder

abstract AddonSession.Builder newSessionBuilder(AddonSessionHandler handler)

Trả về trình tạo cho một phiên tiện ích bổ sung mới. Phiên sẽ chỉ bắt đầu sau khi begin được gọi.

Để bắt đầu một phiên, trước tiên hãy liên kết withCoWatching, withCoDoing hoặc cả hai vào trình tạo này.

Ví dụ về cách sử dụng: 

ListenableFuture<AddonSession> session = meetClient
    .newSessionBuilder(appContext, new AwesomeAddonSessionHandler())
    .withCoWatching(new AwesomeCoWatchingHandler())
    .withCoDoing(new AwesomeCoDoingHandler())
    .begin();
Để tận dụng chức năng siêu dữ liệu của người tham gia, hãy gọi withPARTICIPANTMetadata trên chuỗi trình tạo để chỉ định trạng thái ban đầu và đăng ký trình nghe cho những người tham gia khác. Ví dụ: 
ListenableFuture<AddonSession> session = meetClient
    .newSessionBuilder(new AwesomeAddonSessionHandler())
    .withCoWatching(new AwesomeCoWatchingHandler())
    .withParticipantMetadata(new AwesomeMetadataHandler(), myMetadataBytes)
    .begin(appContext);
Hãy xem begin để biết thêm thông tin về cách bắt đầu một phiên.
Thông số
AddonSessionHandler handler

lệnh gọi lại áp dụng cho tất cả các phiên của tiện ích bổ sung
Giá trị trả về
AddonSession.Builder

trình tạo cho thực thể AddonSession mới
Gửi
java.lang.NullPointerException

nếu bất kỳ đối số nào đã cho là rỗng

notifyAddonFailureEvent

abstract void notifyAddonFailureEvent(
    Context appContext,
    AddonClient.AddonFailureEventType failureEventType
)

Thông báo cho Meet về sự kiện xảy ra lỗi với tiện ích bổ sung.

Thông số
Context appContext

giá trị getApplicationContext của ứng dụng đang dùng SDK của tiện ích bổ sung Meet
AddonClient.AddonFailureEventType failureEventType

loại sự kiện lỗi gặp phải trước, trong hoặc sau phiên chia sẻ trực tiếp
Gửi
java.lang.NullPointerException

nếu bất kỳ đối số nào đã cho là rỗng

registerMeetingStatusListener

abstract void registerMeetingStatusListener(
    Context appContext,
    MeetingStatusListener listener,
    Optional<Handler> handler
)

Đăng ký trình nghe để nhận thông báo về những thay đổi đối với trạng thái của cuộc họp và các phiên tiện ích bổ sung.

Trình nghe đã đăng ký sẽ được thông báo do một trong các trạng thái sau:

  • MEETING – Có một cuộc họp đang diễn ra trong ứng dụng Meet
  • ADDON_SESSION – Có một phiên tiện ích bổ sung đang hoạt động. Bạn chỉ có thể làm việc này nếu có một cuộc họp đang diễn ra.
  • NO_MEETING – Không có phiên họp hoặc tiện ích bổ sung
Thông số
Context appContext

giá trị getApplicationContext của ứng dụng đang dùng SDK của tiện ích bổ sung Meet
MeetingStatusListener listener

MeetingStatusListener để được thông báo về các thay đổi trạng thái
Optional<Handler> handler

Optional của Handler để thực thi không đồng bộ. Nếu một giá trị không được cung cấp, logic kết quả có thể chạy trên luồng giao diện người dùng.
Gửi
java.lang.IllegalStateException

Nếu phương thức này được gọi trước khi gọi unregisterMeetingStatusListener cho một trình nghe đã được đăng ký

unregisterMeetingStatusListener

abstract void unregisterMeetingStatusListener(Context appContext)

Huỷ đăng ký trình nghe đang hoạt động cho các thay đổi về MeetingStatus.

Thông số
Context appContext

giá trị getApplicationContext của ứng dụng đang dùng SDK của tiện ích bổ sung Meet
Gửi
java.lang.IllegalStateException

Nếu phương thức này được gọi trước khi gọi registerMeetingStatusListener.