86234fa8创建于 2024年6月6日历史提交
/*
 * Copyright (c) 2022 Huawei Device Co., Ltd.
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *     http://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

#ifndef INPUTMETHOD_EXTENSION_CONTEXT_H
#define INPUTMETHOD_EXTENSION_CONTEXT_H

#include "ability_connect_callback.h"
#include "connection_manager.h"
#include "extension_context.h"
#include "start_options.h"
#include "want.h"

namespace OHOS {
namespace AbilityRuntime {
/**
 * @brief context supply for inputmethod
 *
 */
class InputMethodExtensionContext : public ExtensionContext {
public:
    InputMethodExtensionContext() = default;
    virtual ~InputMethodExtensionContext() = default;

    /**
   * @brief Starts a new ability.
   * An ability using the AbilityInfo.AbilityType.INPUTMETHOD or
   * AbilityInfo.AbilityType.PAGE template uses this method to start a specific
   * ability. The system locates the target ability from installed abilities
   * based on the value of the want parameter and then starts it. You can
   * specify the ability to start using the want parameter.
   *
   * @param want Indicates the Want containing information about the target
   * ability to start.
   *
   * @return errCode ERR_OK on success, others on failure.
   */
    ErrCode StartAbility(const AAFwk::Want &want) const;

    ErrCode StartAbility(const AAFwk::Want &want, const AAFwk::StartOptions &startOptions) const;

    /**
   * @brief Connects the current ability to an ability using the
   * AbilityInfo.AbilityType.INPUTMETHOD template.
   *
   * @param want Indicates the want containing information about the ability to
   * connect
   *
   * @param conn Indicates the callback object when the target ability is
   * connected.
   *
   * @return True means success and false means failure
   */
    bool ConnectAbility(const AAFwk::Want &want, const sptr<AbilityConnectCallback> &connectCallback) const;

    /**
   * @brief Starts a new ability.
   * An ability using the AbilityInfo.AbilityType.INPUTMETHOD or
   * AbilityInfo.AbilityType.PAGE template uses this method to start a specific
   * ability. The system locates the target ability from installed abilities
   * based on the value of the want parameter and then starts it. You can
   * specify the ability to start using the want parameter.
   *
   * @param want Indicates the Want containing information about the target
   * ability to start.
   * @param accountId caller user.
   *
   * @return errCode ERR_OK on success, others on failure.
   */
    ErrCode StartAbilityWithAccount(const AAFwk::Want &want, int accountId) const;

    ErrCode StartAbilityWithAccount(const AAFwk::Want &want, int accountId,
        const AAFwk::StartOptions &startOptions) const;

    /**
   * @brief Connects the current ability to an ability using the
   * AbilityInfo.AbilityType.INPUTMETHOD template.
   *
   * @param want Indicates the want containing information about the ability to
   * connect.
   *
   * @param accountId caller user.
   *
   * @param conn Indicates the callback object when the target ability is
   * connected.
   *
   * @return True means success and false means failure.
   */
    bool ConnectAbilityWithAccount(const AAFwk::Want &want, int accountId,
        const sptr<AbilityConnectCallback> &connectCallback) const;

    /**
   * @brief Disconnects the current ability from an ability.
   *
   * @param conn Indicates the IAbilityConnection callback object passed by
   * connectAbility after the connection is set up. The IAbilityConnection
   * object uniquely identifies a connection between two abilities.
   *
   * @return errCode ERR_OK on success, others on failure.
   */
    ErrCode DisconnectAbility(const AAFwk::Want &want, const sptr<AbilityConnectCallback> &connectCallback) const;

    /**
   * @brief Destroys the current ability.
   *
   * @return errCode ERR_OK on success, others on failure.
   */
    ErrCode TerminateAbility();

    using SelfType = InputMethodExtensionContext;
    static const size_t CONTEXT_TYPE_ID;

protected:
    bool IsContext(size_t contextTypeId) override
    {
        return contextTypeId == CONTEXT_TYPE_ID || ExtensionContext::IsContext(contextTypeId);
    }

private:
    static int ILLEGAL_REQUEST_CODE;
    /**
   * @brief Get Current Ability Type
   *
   * @return Current Ability Type
   */
    OHOS::AppExecFwk::AbilityType GetAbilityInfoType() const;
};
} // namespace AbilityRuntime
} // namespace OHOS
#endif // INPUTMETHOD_EXTENSION_CONTEXT_H